Documentation en version bêta. Certains textes et images seront retravaillés au fur et à mesure que l'application s'installera dans la version 1.0. Si une section est obsolète, signalez-la via le formulaire de commentaires.

Microsoft Flight Simulator 2024

FFB-Bridge communique avec MSFS 2024 via le transport TCP de SimConnect. Sur une nouvelle installation de MSFS 2024, cela fonctionne immédiatement sous Windows et nécessite un seul ajustement de configuration sous Linux/Proton. Le pont Docteur La page peut faire le réglage pour vous – ce guide couvre à la fois le chemin en un clic et le chemin manuel.

De quelle installation MSFS disposez-vous ?

L'emplacement par défaut de SimConnect dépend de la façon dont MSFS a été installé. FFB-Bridge détecte automatiquement les trois cas, mais il est utile de savoir sur lequel vous vous trouvez si quelque chose tourne mal.

InstallerSimConnect.xml location
Gagner Steam / autonome %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
Gagner Microsoft Store/Xbox Game Pass %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml
Linux Vapeur + Proton ~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml

Fenêtres - hors de la boîte

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 La puce du tableau de bord devrait devenir verte une seconde ou deux après que la carte SIM ait atteint le menu principal.

Si ce n'est pas le cas, ouvrez Docteur. The Configuration SimConnect La ligne vous indique ce qu'elle a trouvé dans le XML et si le port qu'elle utilise correspond au port auquel le pont communique.

Ports autres que 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 Configuration SimConnect Row sur Doctor propose un inline Utiliser le port :X bouton. Cliquez dessus et les préférences du pont sont mises à jour sur ce port ; aucun redémarrage MSFS n'est nécessaire.

Linux - correction en un clic via 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 Docteur; le Configuration SimConnect la ligne affichera le port privilégié et proposera un Corriger… bouton.

Boîte de dialogue FFB-Bridge Doctor's Fix sous Linux affichant un préfixe Proton détecté et le port TCP SimConnect qu'il installera
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.

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

Quel préfixe Proton ?

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.

Configuration manuelle

Si vous préférez le modifier manuellement, le XML ressemble à ceci :

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

Après avoir enregistré, ouvrez FFB-Bridge Simulation de SimConnect page, remettez la source d’entrée sur En direct, et le pont récupérera la nouvelle configuration. Sous Linux, vous pouvez également accéder à Diagnostic et surveillez le journal pour SimConnect connecté après avoir relancé MSFS.

SimVars le pont lit

Pour référence (vous n'avez pas besoin de configurer quoi que ce soit de tout cela), voici l'ensemble de MSFS SimVars auquel le pont est abonné :

  • Vitesse (indiquée, vraie), altitude, vitesse verticale, tangage, inclinaison, cap
  • Force G, angle d'attaque, avertissement de décrochage, avertissement de survitesse
  • Déflexion de la gouverne de profondeur, des ailerons et du gouvernail (rognés et bruts)
  • Positions de trim (profondeur, aileron, gouvernail)
  • État de la poignée de vitesses, index de la poignée des volets, position de la poignée du spoiler
  • Pourcentage de régime par moteur et état de combustion, poussée inversée engagée
  • Énumération du type de surface (piste vs herbe vs glace), déviation de la pédale de frein
  • État principal du pilote automatique, pas/inclinaison commandé par le pilote automatique

Si MSFS ne reconnaît pas un nom de variable, le pont l'enregistre sous forme d'avertissement sur le serveur. Diagnostic page mais continue - les variables manquantes sont par défaut des zéros raisonnables. C'est ainsi que le pont tolère les avions tiers qui n'implémentent pas chaque SimVar.

Dépannage

Voir Dépannage pour :

  • MSFS se connecte mais ne force pas – le plus souvent, la jauge ARM dans la bande supérieure est toujours DÉSARMÉE ; couvert là.
  • La pause MSFS/Active Pause devrait immédiatement calmer les effets dynamiques dans la version bêta.11 et maintenir un ressort neutre pendant la pause.
  • Si un long bégaiement ou une pause diminue la force de roulis après la reprise, exportez un ensemble de support et enregistrez les commentaires de la même session.