Microsoft Flight Simulator 2024 和 2020

FFB-Bridge 通过 SimConnect 的 TCP 传输与 Microsoft Flight Simulator 进行通信 — 两者 MSFS 2024 和 MSFS 2020 支持。在全新安装时，它可以在 Windows 上开箱即用，并且需要在 Linux / Proton 下进行一次配置调整。这座桥的 支持页面 （侧边栏 → 支持 → 运行状况检查）可以为您进行调整 - 本指南涵盖一键路径和手动路径。

仅限 Windows 和 Linux

MSFS 在 Windows 和 Linux 上连接。macOS 版本仅支持 X-Plane——请参阅 X-Plane 11 / 12.

您安装了什么 MSFS？

默认的 SimConnect 位置取决于 MSFS 的安装方式。以下路径适用于 MSFS 2024，FFB-Bridge 会在全部三种安装来源中自动检测。万一出了问题，知道自己用的是哪一种会很有帮助。

MSFS 2020

MSFS 2020 通过 SimConnect TCP 以相同的方式进行连接。网桥的自动检测和一键运行状况检查修复针对 2024 年的配置文件，因此在 2020 年，您可能需要确认网桥正在使用的端口（默认为 500 Windows 上的）。如果 2020 监听非标准端口，请从 SimConnect 配置 运行状况检查行，或将桥直接指向文件 FFB_BRIDGE_MSFS_CONFIG=<path-to-SimConnect.xml>.

安装	`SimConnect.xml` 地点
赢 Steam / 独立版	`%APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml`
赢 Microsoft Store / Xbox Game Pass	`%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml`
Linux Steam + Proton	`~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml`

Windows — 开箱即用

每个库存 MSFS 2024 安装都附带在端口上启用的 SimConnect TCP 500，绑定到所有 IPv4 接口。桥接器默认为 127.0.0.1:500 在 Windows 上。启动 MSFS，然后启动 FFB-Bridge — 模拟器 仪表盘上的状态标记应在模拟器进入主菜单后一两秒内变为绿色。

如果没有，请打开 支持页面 并运行运行状况检查。该 SimConnect 配置 row 告诉您它在 XML 中找到了什么以及它正在使用的端口是否与桥接器正在通信的端口匹配。

500 以外的端口

一些工具——FSUIPC、SPAD.neXt——会在同一文件中添加自己的 TCP 条目 SimConnect.xml。如果 MSFS 侦听的端口与网桥期望的端口不同，则 SimConnect 配置 支持页面运行状况检查选项卡上的该行提供了一个内联的 使用端口：X 按钮。单击它，网桥的首选项将更新为该端口；无需重新启动 MSFS。

Linux — 通过支持页面一键修复

在 Proton 下运行的 MSFS 也附带相同的默认 SimConnect.xml 与 Windows 版本一样，使用 TCP 侦听端口 500。但 Linux 将 1024 以下的端口视为特权端口，并且 Proton 用户命名空间进程无法绑定它们。监听静静地失败，并且没有套接字打开。

解决办法是添加一个并行 <SimConnect.Comm> 非特权端口上的条目（网桥默认使用 5111）。打开 支持页面 → 健康检查；这 SimConnect 配置 行将显示特权端口并提供 修复... 按钮。

Linux 上的 FFB-Bridge 支持页面的“修复”对话框显示检测到的 Proton 前缀以及它将安装的 SimConnect TCP 端口 — Figure 1. 修复 Linux 上的对话框（支持 → 运行状况检查 → SimConnect 配置行）。显示它找到的 Proton 前缀路径以及它要添加的端口。单击“安装”会合并一个新条目 - 现有条目将保持不变。

修复... 将新条目合并到现有 XML 中（从不重写它）。如果现有文件不可解析，安装程序首先将其备份为 SimConnect.xml.bak-YYYY-MM-DD-HHMMSS 并写入新生成的配置。无论哪种方式，安装后重新启动 MSFS，以便它重新读取 SimConnect.xml。

哪个 Proton 前缀？

FFB-Bridge 探测 Steam、Steam-Flatpak、Heroic 和 Lutris 的众所周知的前缀。如果从非标准位置运行 MSFS，请设置 FFB_BRIDGE_MSFS_PREFIX=/path/to/prefix 在启动 FFB-Bridge 之前在您的环境中设置。如果只想对 XML 文件进行裸机覆盖， FFB_BRIDGE_MSFS_CONFIG=/path/to/SimConnect.xml 优先。

手动配置

如果您愿意手动编辑，XML 如下所示：

<?xml version="1.0" encoding="Windows-1252"?>
<SimBase.Document Type="SimConnect" version="1,0">
  <Descr>SimConnect Client Configurations</Descr>
  <Filename>SimConnect.xml</Filename>
  <!-- FFB-Bridge: unprivileged TCP for Proton-on-Linux -->
  <SimConnect.Comm>
    <Descr>FFB-Bridge TCP</Descr>
    <Protocol>IPv4</Protocol>
    <Scope>local</Scope>
    <Port>5111</Port>
    <MaxClients>64</MaxClients>
    <MaxRecvSize>41088</MaxRecvSize>
    <DisableNagle>False</DisableNagle>
  </SimConnect.Comm>
  <!-- Keep any existing entries below this line. -->
</SimBase.Document>

保存后，打开FFB-Bridge的 Mock Sim 页面，将输入源切换回直播，桥接器将采用新的配置。您还可以前往 支持页面 →「诊断」，并观察日志中的 SimConnect 已连接 重新启动 MSFS 后。

SimVars 桥读取

作为参考 — 您无需配置任何内容 — 以下是网桥订阅的 MSFS SimVar 集：

AIRSPEED INDICATED
AIRSPEED MACH
G FORCE
ELEVATOR POSITION
AILERON POSITION
ELEVATOR TRIM PCT
AILERON TRIM PCT
STALL WARNING
OVERSPEED WARNING
SIM ON GROUND
GROUND VELOCITY
VERTICAL SPEED
BRAKE LEFT POSITION
BRAKE RIGHT POSITION
GEAR HANDLE POSITION
FLAPS HANDLE INDEX
TRAILING EDGE FLAPS LEFT PERCENT
TRAILING EDGE FLAPS RIGHT PERCENT
AUTOPILOT MASTER
SPOILERS HANDLE POSITION
ROTATION VELOCITY BODY X
ROTATION VELOCITY BODY Z
GENERAL ENG REVERSE THRUST ENGAGED:1
SURFACE TYPE
GENERAL ENG PCT MAX RPM:1
GENERAL ENG COMBUSTION:1
TITLE
ATC MODEL
CATEGORY
CAMERA STATE
ACCELERATION BODY X
ROTATION ACCELERATION BODY X
ROTATION ACCELERATION BODY Z
ROTATION ACCELERATION BODY Y
CRASH FLAG
ELEVATOR DEFLECTION
AILERON LEFT DEFLECTION
INCIDENCE BETA
ENG VIBRATION:1
CONTACT POINT COMPRESSION:0
CONTACT POINT COMPRESSION:1
CONTACT POINT COMPRESSION:2
AUTOPILOT FLIGHT DIRECTOR BANK
AUTOPILOT FLIGHT DIRECTOR PITCH
ACCELERATION BODY Z
ROTOR RPM PCT:1
ROTOR GOV ACTIVE:1
COLLECTIVE POSITION

如果 MSFS 无法识别变量名称，网桥会将其记录为警告诊断页但继续 — 缺失的变量默认为合理的零。这就是桥接器容忍未实现每个 SimVar 的第三方飞机的方式。

故障排除

参见故障排除对于：

MSFS 连接但没有力量 — 最常见的是顶部条中的 ARM 仪表仍然处于 DISARMED 状态；覆盖在那里。
MSFS 暂停 / Active Pause 会立即静默动态效果，并在暂停期间保持中性弹簧。
如果长时间的卡顿或暂停在恢复后导致滚转力消失，请导出支持包，并从同一会话提交反馈。