Documentación en beta. Algunos textos e imágenes se modificarán a medida que la aplicación se instale en la versión 1.0. Si una sección se lee obsoleta, márquela mediante el formulario de comentarios.

Simulador de vuelo de Microsoft 2024

FFB-Bridge se comunica con MSFS 2024 a través del transporte TCP de SimConnect. En una instalación nueva de MSFS 2024, esto funciona de inmediato en Windows y necesita un único ajuste de configuración en Linux/Proton. el puente medico La página puede hacer el ajuste por usted: esta guía cubre tanto la ruta de un clic como la manual.

¿Qué instalación de MSFS tienes?

La ubicación predeterminada de SimConnect depende de cómo se instaló MSFS. FFB-Bridge detecta los tres casos automáticamente, pero ayuda a saber en cuál estás si algo sale mal.

InstalarSimConnect.xml location
ganar Vapor / independiente %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
ganar Tienda Microsoft/Pase de juego Xbox %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml
linux Vapor + Protón ~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml

ventanas - fuera de la caja

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 El chip en el tablero debe volverse verde uno o dos segundos después de que el sim llegue al menú principal.

Si no es así, abre medico. The Configuración de SimConnect La fila le indica lo que encontró en el XML y si el puerto que está utilizando coincide con el puerto con el que está hablando el puente.

Puertos distintos del 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 Configuración de SimConnect fila en Doctor ofrece una línea Usar puerto :X botón. Haga clic en él y las preferencias del puente se actualizarán a ese puerto; no es necesario reiniciar MSFS.

linux — solución con un solo clic a través de 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 medico; el Configuración de SimConnect La fila mostrará el puerto privilegiado y ofrecerá una Arreglar… botón.

Cuadro de diálogo Fix de FFB-Bridge Doctor en Linux que muestra un prefijo de Proton detectado y el puerto TCP SimConnect que instalará
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.

Arreglar… 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.

¿Qué prefijo de protón?

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.

Configuración manual

Si prefiere editarlo manualmente, el XML se ve así:

<?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>

Después de guardar, abra FFB-Bridge Simulación simulada página, cambie la fuente de entrada nuevamente a en vivoy el puente aceptará la nueva configuración. En Linux también puedes ir a Diagnóstico y mira el registro para SimConnect conectado después de reiniciar MSFS.

SimVars el puente lee

Como referencia (no es necesario configurar nada de esto), aquí está el conjunto de MSFS SimVars al que se suscribe el puente:

  • Velocidad aérea (indicada, verdadera), altitud, velocidad vertical, cabeceo, inclinación, rumbo
  • Fuerza G, ángulo de ataque, advertencia de pérdida, advertencia de exceso de velocidad
  • Deflexión del elevador, alerones y timón (recortados y sin editar)
  • Posiciones de trimado (elevador, alerón, timón)
  • Estado de la palanca de cambios, índice de la manija de la aleta, posición de la manija del spoiler
  • Porcentaje de RPM por motor y estado de combustión, empuje inverso activado
  • Enumeración del tipo de superficie (pista, pasto o hielo), desviación del pedal de freno
  • Estado maestro del piloto automático, cabeceo/inclinación ordenado por el piloto automático

Si MSFS no reconoce el nombre de una variable, el puente lo registra como una advertencia en el Diagnóstico página pero continúa: las variables que faltan tienen por defecto ceros sensibles. Así es como el puente tolera aviones de terceros que no implementan todos los SimVar.

Solución de problemas

Ver Solución de problemas para:

  • MSFS se conecta pero no fuerza; la mayoría de las veces, el indicador ARM en la franja superior todavía está DESARMADO; cubierto allí.
  • La pausa MSFS/Pausa activa debería silenciar los efectos dinámicos inmediatamente en beta.11 y mantener un resorte neutral mientras está en pausa.
  • Si un tartamudeo prolongado o una pausa reducen la fuerza de avance después de la reanudación, exporte un paquete de soporte y envíe comentarios de la misma sesión.