Version actuelle. FFB-Bridge v1.2.1 est disponible. Cette documentation suit l'application actuelle décrite par le manifeste de version. Si une section semble désuète, signalez-la avec le formulaire de commentaires.

Microsoft Flight Simulator 2024 et 2020

FFB-Bridge communique avec Microsoft Flight Simulator via le transport TCP de SimConnect - les deux MSFS 2024 et MSFS 2020 sont pris en charge. Sur une nouvelle installation, cela fonctionne immédiatement sous Windows et nécessite un seul ajustement de configuration sous Linux / Proton. Le pont Page Support (barre latérale → Support → Vérifications de santé) peut effectuer la modification à votre place — ce guide couvre à la fois le chemin en un clic et le chemin manuel.

Windows et Linux uniquement

MSFS se connecte sous Windows et Linux. La version macOS prend uniquement en charge X-Plane – voir X-Plane 11 / 12.

De quelle installation MSFS disposez-vous ?

L'emplacement par défaut de SimConnect dépend de la manière dont MSFS a été installé. Les chemins ci-dessous concernent MSFS 2024, que FFB-Bridge détecte automatiquement sur les trois sources d'installation. Il est utile de savoir sur lequel vous vous trouvez si quelque chose tourne mal.

MSFS 2020

MSFS 2020 se connecte de la même manière via SimConnect TCP. La détection automatique du pont et les correctifs de contrôle de santé en un clic ciblent le fichier de configuration 2024, donc en 2020, vous devrez peut-être confirmer le port utilisé par le pont (il est par défaut 500 sous Windows). Si 2020 écoute sur un port non standard, configurez-le depuis le Configuration SimConnect ligne de vérification de santé, ou pointez le pont directement vers le fichier avec FFB_BRIDGE_MSFS_CONFIG=<path-to-SimConnect.xml>.

InstallateurSimConnect.xml emplacement
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 Steam + Proton ~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml

Windows — prêt à l'emploi

Chaque installation MSFS 2024 d'origine est livrée avec SimConnect TCP activé sur le port 500, relié à toutes les interfaces IPv4. Le pont est par défaut 127.0.0.1:500 sous Windows. Lancez MSFS, puis lancez FFB-Bridge - le Sim La puce du tableau de bord devrait devenir verte une seconde ou deux après que le simulateur a atteint le menu principal.

Si ce n'est pas le cas, ouvrez le Page Support et exécutez les vérifications de santé. Le 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

Certains outils — FSUIPC, SPAD.neXt — ajoutent leurs propres entrées TCP dans le même SimConnect.xml. Si MSFS écoute sur un port différent de celui attendu par le pont, le Configuration SimConnect La ligne de l'onglet Vérifications de santé de la page Support propose une 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 - correctif en un clic via la page Support

MSFS sous Proton expédie le même stock SimConnect.xml comme la version Windows, avec écoute TCP sur le port 500. Mais Linux traite les ports inférieurs à 1024 comme privilégiés et le processus d'espace de noms utilisateur Proton ne peut pas les lier. L'écoute échoue silencieusement et aucun socket ne s'ouvre jamais.

La solution consiste à ajouter un parallèle <SimConnect.Comm> entrée sur un port non privilégié (le pont utilise 5111 par défaut). Ouvrez le Page Support → Vérifications de santé ; le Configuration SimConnect la ligne affichera le port privilégié et proposera un Corriger… bouton.

Boîte de dialogue Fix de la page de support FFB-Bridge sous Linux affichant un préfixe Proton détecté et le port TCP SimConnect qu'il installera Boîte de dialogue Fix de la page de support FFB-Bridge sous Linux affichant un préfixe Proton détecté et le port TCP SimConnect qu'il installera
Figure 1. Boîte de dialogue de correction sous Linux (Support → Vérifications de santé → ligne de configuration SimConnect). Affiche le chemin du préfixe Proton qu'elle a trouvé et le port qu'elle est sur le point d'ajouter. Cliquer sur Installer fusionne une nouvelle entrée — les entrées existantes sont laissées intactes.

Corriger… fusionne une nouvelle entrée dans le XML existant (ne la réécrit jamais). Si le fichier existant ne peut pas être analysé, le programme d'installation le sauvegarde d'abord sous SimConnect.xml.bak-YYYY-MM-DD-HHMMSS et écrit une nouvelle configuration générée. Quoi qu'il en soit, redémarrez MSFS après l'installation pour qu'il relise SimConnect.xml.

Quel préfixe Proton ?

FFB-Bridge sonde les préfixes bien connus pour Steam, Steam-Flatpak, Heroic et Lutris. Si vous exécutez MSFS à partir d'un emplacement non standard, définissez FFB_BRIDGE_MSFS_PREFIX=/path/to/prefix dans votre environnement avant de lancer le pont. Pour un remplacement direct du seul fichier XML, FFB_BRIDGE_MSFS_CONFIG=/path/to/SimConnect.xml est prioritaire.

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 Mock Sim page, remettez la source d'entrée sur En direct, et le pont récupérera la nouvelle configuration. Vous pouvez également vous rendre au Page Support → Diagnostics 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 des SimVars MSFS auxquelles le pont s'abonne :

  • 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 de la gouverne de direction (compensés et bruts)
  • Positions de trim (profondeur, aileron, gouvernail)
  • État de la poignée du train, index de la poignée des volets, position de la poignée du spoiler
  • Pourcentage de régime par moteur et état de combustion, inversion de poussé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, tangage/inclinaison commandés par le pilote automatique

Si MSFS ne reconnaît pas un nom de variable, le pont l'enregistre comme un avertissement sur le Diagnostics 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 aucune force — le plus souvent, la jauge ARM dans la bande supérieure est encore DÉSARMÉE ; couvert là.
  • La pause MSFS / Active Pause calme immédiatement les effets dynamiques et conserve un ressort neutre pendant la pause.
  • Si un long bégaiement ou une pause fait chuter la force de roulis après la reprise, exportez un ensemble de support et soumettez une rétroaction depuis la même session.