X-Plane 11 / 12

X-Plane 不需要特殊设置。 FFB-Bridge 订阅 X-Plane 的内置 UDP dataref 协议（参考文献）在端口 49000 上。X-Plane 端不需要安装任何东西，没有插件，没有 SimConnect 样式的 XML 文件。如果启动桥时 X-Plane 正在运行，则表示您已连接。

macOS 上唯一的模拟器

X-Plane 是新版 macOS（Apple Silicon）构建上受支持的模拟器——采用与此处描述相同的零配置 UDP 路径。MSFS 仅支持 Windows 和 Linux。

自动检测行为

启动时，桥接器会并行运行两个探针：SimConnect TCP 探针（用于 MSFS）和 X-Plane UDP 探针。以先返回真实响应的那个为准。实际上这意味着：

如果只有 X-Plane 正在运行，它会在几毫秒内获胜。
如果 MSFS 和 X-Plane 同时运行，则使用先响应的那个——如果这成为问题，您还可以通过 CLI 强制选择。
如果两者都没有运行，桥接程序就会进入空闲模式，直到出现一个。

当 X-Plane 运行且 FFB-Bridge 已成功订阅时，顶部状态条中的 SIM 指示灯会变为绿色（「模拟器已连接」），MODE 指示灯显示「Live」。DEVICE 指示灯是独立的——只要受支持的摇杆已插入并打开，它就呈绿色。

确保 X-Plane 未被防火墙挡在外面

UDP 49000 是 FFB-Bridge 在 X-Plane 一侧唯一使用的端口。全新安装 X-Plane 后的默认 Windows 防火墙规则通常会自动放行；Linux 桌面 firewalld 或 ufw 几乎从不阻止环回。如果 X-Plane 启动后桥的事件日志中没有显示任何内容，请打开 支持页面 （侧边栏 → 支持 → 健康检查） — X-Plane可达性 行会尝试探测并告诉您返回了什么（超时、连接被拒绝或实际数据包）。

FFB-Bridge 读取的 Dataref

该桥订阅了 24 个数据引用，这些数据引用与 X-Plane 公开的 MSFS 变量集密切相关。您不需要配置任何内容 - 此处列出以供参考和调试：

sim/flightmodel/position/indicated_airspeed
sim/flightmodel/position/true_airspeed
sim/flightmodel/position/vh_ind （垂直速度）
sim/flightmodel/position/theta （俯仰）
sim/flightmodel/position/phi （坡度）
sim/flightmodel/position/psi （标题）
sim/flightmodel/forces/g_nrml （负载系数）
sim/flightmodel/position/alpha （迎角）
sim/flightmodel2/controls/yoke_pitch_ratio
sim/flightmodel2/controls/yoke_roll_ratio
sim/flightmodel2/controls/pitch_trim
sim/flightmodel2/controls/roll_trim
sim/cockpit/warnings/annunciators/stall_warning
sim/flightmodel/failures/over_vne
sim/flightmodel2/controls/gear_handle_down
sim/flightmodel2/controls/flap_handle_deploy_ratio
sim/flightmodel2/controls/speedbrake_ratio
sim/flightmodel/engine/ENGN_running[0..3]
sim/flightmodel/engine/ENGN_N1_[0..3]
sim/cockpit2/autopilot/autopilot_on
sim/cockpit2/autopilot/heading_dial_deg_mag_pilot
sim/flightmodel2/gear/on_ground_fraction
sim/flightmodel/misc/h_ind （气压高度）
sim/operation/override/override_throttles （用于反向推力检测）

陈旧和重新连接

UDP 没有断开信号，因此 FFB-Bridge 运行自己的看门狗：如果三秒内没有 dataref 到达，它会将该会话视为已失效，并且 模拟器 芯片变红。重新启动 X-Plane 或加载新航班会自动重新建立连接 - 您无需重新启动桥接器。

暂停与加载

X-Plane 暂停时仍会继续发送 dataref（只是数值被冻结），因此桥接器保持 已连接 但过时看门狗不会跳闸。在菜单级屏幕（飞机选择、位置对话框）期间，X-Plane 短暂停止发射；当航班恢复时，驾驶台会将 SIM 指示灯恢复为灰色（“SIM 未运行”）并再次变为绿色。

非默认的 X-Plane 安装

免费和付费的 X-Plane 二进制文件默认绑定 UDP 49000。如果您更改了 X-Plane 的 UDP 端口（设置 → 网络 → UDP 端口），网桥当前不会公开备用端口的 UI — 使用 X-Plane 的默认值或告诉我们这样我们就可以优先考虑它。