微软模拟飞行 2024

FFB-Bridge 通过 SimConnect 的 TCP 传输与 MSFS 2024 进行通信。在全新安装 MSFS 2024 时，它可以在 Windows 上开箱即用，并且需要在 Linux / Proton 下进行一次配置调整。这座桥的医生页面可以为您进行调整 - 本指南涵盖一键路径和手动路径。

您安装了什么 MSFS？

默认 SimConnect 位置取决于 MSFS 的安装方式。 FFB-Bridge 会自动检测所有三种情况，但如果出现问题，它有助于了解您所处的情况。

安装	`SimConnect.xml` location
赢蒸汽/独立	`%APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml`
赢 Microsoft 商店/Xbox 游戏通行证	`%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml`
Linux 蒸汽+质子	`~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml`

窗户 — 开箱即用

Every stock MSFS 2024 install ships with SimConnect TCP enabled on port 500, bound to all IPv4 interfaces. The bridge defaults to 127.0.0.1:500 on Windows. Launch MSFS, then launch FFB-Bridge — the 西姆仪表板上的芯片应在 SIM 卡到达主菜单后一两秒内变为绿色。

如果没有，请打开医生. The SimConnect 配置 row 告诉您它在 XML 中找到了什么以及它正在使用的端口是否与桥接器正在通信的端口匹配。

500 以外的端口

Some tools — FSUIPC, SPAD.neXt — add their own TCP entries in the same SimConnect.xml. If MSFS is listening on a different port than the bridge expects, the SimConnect 配置 医生行提供内联 使用端口：X 按钮。单击它，网桥的首选项将更新为该端口；无需重新启动 MSFS。

Linux — 通过 Doctor 一键修复

MSFS under Proton ships the same stock SimConnect.xml as the Windows build, with TCP listening on port 500. But Linux treats ports below 1024 as privileged, and the Proton user-namespace process cannot bind them. The listen silently fails and no socket ever opens.

The fix is to add a parallel <SimConnect.Comm> entry on an unprivileged port (the bridge uses 5111 by default). Open 医生;的 SimConnect 配置 行将显示特权端口并提供 修复... 按钮。

Linux 上的 FFB-Bridge Doctor 修复对话框显示检测到的 Proton 前缀及其将安装的 SimConnect TCP 端口 — Figure 1. Doctor's Fix dialog on Linux. Shows the Proton prefix path it found and the port it's about to add. Clicking Install merges a new entry — existing entries are left alone.

修复... merges a new entry into the existing XML (never rewrites it). If the existing file is unparseable, the installer first backs it up as SimConnect.xml.bak-YYYY-MM-DD-HHMMSS and writes a fresh generated config. Either way, restart MSFS after the install so it re-reads SimConnect.xml.

哪个质子前缀？

FFB-Bridge probes the well-known prefixes for Steam, Steam-Flatpak, Heroic, and Lutris. If you run MSFS from a non-standard location, set FFB_BRIDGE_MSFS_PREFIX=/path/to/prefix in your environment before launching the bridge. For a bare-metal override of just the XML file, FFB_BRIDGE_MSFS_CONFIG=/path/to/SimConnect.xml takes precedence.

手动配置

如果您愿意手动编辑，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的 模拟 SimConnect 页面，将输入源切换回直播，桥接器将采用新的配置。在 Linux 上，您还可以访问诊断并观察日志 SimConnect 已连接 重新启动 MSFS 后。

SimVars 桥读取

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

空速（指示、真实）、高度、垂直速度、俯仰、坡度、航向
重力、迎角、失速警告、超速警告
升降舵、副翼和方向舵偏转（调整后和原始）
配平位置（升降舵、副翼、方向舵）
档位手柄状态、襟翼手柄索引、扰流板手柄位置
每个发动机的 RPM 百分比和燃烧状态，反向推力已启用
表面类型枚举（跑道、草地、冰）、制动踏板偏转
自动驾驶仪主状态，自动驾驶仪命令俯仰/倾斜

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

故障排除

参见故障排除对于：

MSFS 连接但没有力量 — 最常见的是顶部条中的 ARM 仪表仍然处于 DISARMED 状态；覆盖在那里。
MSFS 暂停/主动暂停应该在 beta.11 中立即消除动态效果，并在暂停时保持中性弹簧。
如果长时间的卡顿或暂停会在恢复后降低滚动力，请从同一会话中导出支持包和文件反馈。