Huidige release. FFB-Bridge v1.2.1 is live. Deze documentatie volgt de huidige app zoals beschreven door het releasemanifest. Als een onderdeel verouderd lijkt, meld dat via het feedbackformulier.

Microsoft Flight Simulator 2024 en 2020

FFB-Bridge praat met Microsoft Flight Simulator via SimConnect's TCP-transport - beide MSFS 2024 en MSFS 2020 worden ondersteund. Bij een nieuwe installatie werkt dit out-of-the-box op Windows en is er een enkele configuratieaanpassing nodig onder Linux / Proton. Die van de brug Ondersteuningspagina (zijbalk → Ondersteuning → Gezondheidscontroles) kan de aanpassing voor u doen - deze handleiding behandelt zowel het pad met één klik als het handmatige pad.

Alleen Windows en Linux

MSFS maakt verbinding op Windows en Linux. De macOS-build ondersteunt alleen X-Plane - zie X-Plane 11 / 12.

Welke MSFS-installatie heb je?

De standaard SimConnect-locatie hangt af van hoe MSFS is geïnstalleerd. De onderstaande paden zijn voor MSFS 2024, die FFB-Bridge automatisch detecteert in alle drie de installatiebronnen. Het helpt om te weten op welke je zit als er iets misgaat.

MSFS 2020

MSFS 2020 maakt op dezelfde manier verbinding via SimConnect TCP. De automatische detectie van de bridge en de Health-check-oplossingen met één klik zijn gericht op het configuratiebestand van 2024, dus in 2020 moet u mogelijk de poort bevestigen die de bridge gebruikt (deze is standaard ingesteld op 500 op Windows). Als 2020 op een niet-standaard poort luistert, stel deze dan in vanuit de SimConnect-configuratie Gezondheidscontrolerij, of richt de brug recht op het bestand met FFB_BRIDGE_MSFS_CONFIG=<path-to-SimConnect.xml>.

InstallerenSimConnect.xml locatie
Win Steam / standalone %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
Win 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 – uit de doos

Elke standaard MSFS 2024-installatie wordt geleverd met SimConnect TCP ingeschakeld op de poort 500, gebonden aan alle IPv4-interfaces. De brug is standaard ingesteld op 127.0.0.1:500 op Windows. Start MSFS en vervolgens FFB-Bridge — de Sim chip op het Dashboard moet groen worden binnen een seconde of twee nadat de sim het hoofdmenu heeft bereikt.

Als dit niet het geval is, opent u de Ondersteuningspagina en voer statuscontroles uit. De SimConnect-configuratie row vertelt je wat het in de XML heeft gevonden en of de poort die het gebruikt overeenkomt met de poort waarmee de bridge praat.

Andere poorten dan 500

Sommige tools – FSUIPC, SPAD.neXt – voegen hun eigen TCP-items eraan toe SimConnect.xml. Als MSFS op een andere poort luistert dan de bridge verwacht, wordt het SimConnect-configuratie rij op het tabblad Gezondheidscontroles van de ondersteuningspagina biedt een inline Gebruik poort:X knop. Klik erop en de voorkeuren van de bridge worden bijgewerkt naar die poort; geen MSFS-herstart nodig.

Linux — oplossing met één klik via de ondersteuningspagina

MSFS onder Proton verzendt dezelfde voorraad SimConnect.xml zoals de Windows-build, waarbij TCP op poort luistert 500. Maar Linux behandelt poorten onder 1024 als bevoorrecht, en het Proton-gebruikersnaamruimteproces kan ze niet binden. Het luisteren mislukt stil en er gaat nooit een stopcontact open.

De oplossing is om een parallel toe te voegen <SimConnect.Comm> toegang op een poort zonder privileges (de bridge gebruikt standaard 5111). Open de Ondersteuningspagina → Gezondheidscontroles; de SimConnect-configuratie rij toont de bevoorrechte poort en biedt een Repareren… knop.

Het Fix-dialoogvenster van de FFB-Bridge-ondersteuningspagina op Linux toont een gedetecteerd Proton-voorvoegsel en de SimConnect TCP-poort die het zal installeren Het Fix-dialoogvenster van de FFB-Bridge-ondersteuningspagina op Linux toont een gedetecteerd Proton-voorvoegsel en de SimConnect TCP-poort die het zal installeren
Figuur 1. Reparatiedialoog op Linux (Ondersteuning → Gezondheidscontroles → SimConnect-configuratierij). Toont het gevonden Proton-prefixpad en de poort die hij gaat toevoegen. Als je op Installeren klikt, wordt een nieuw item samengevoegd; bestaande items blijven ongemoeid.

Repareren… voegt een nieuw item samen in de bestaande XML (herschrijft het nooit). Als het bestaande bestand niet kan worden geparseerd, maakt het installatieprogramma er eerst een back-up van als SimConnect.xml.bak-YYYY-MM-DD-HHMMSS en schrijft een nieuw gegenereerde configuratie. Hoe dan ook, start MSFS na de installatie opnieuw op, zodat SimConnect.xml opnieuw wordt gelezen.

Welk protonvoorvoegsel?

FFB-Bridge onderzoekt de bekende voorvoegsels voor Steam, Steam-Flatpak, Heroic en Lutris. Als u MSFS vanaf een niet-standaardlocatie uitvoert, stelt u in FFB_BRIDGE_MSFS_PREFIX=/path/to/prefix in uw omgeving voordat u de brug lanceert. Voor een bare-metal overschrijving van alleen het XML-bestand: FFB_BRIDGE_MSFS_CONFIG=/path/to/SimConnect.xml heeft voorrang.

Handmatige configuratie

Als u liever handmatig bewerkt, ziet de XML er als volgt uit:

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

Open na het opslaan FFB-Bridge's Mock Sim pagina, schakelt u de ingangsbron terug naar Live, en de bridge zal de nieuwe configuratie overnemen. Je kunt ook naar de Ondersteuningspagina → Diagnostiek en bekijk het logboek SimConnect aangesloten na het opnieuw starten van MSFS.

SimVars die de bridge leest

Ter referentie – je hoeft hier niets van te configureren – hier is de set MSFS SimVars waarop de bridge zich abonneert:

  • Luchtsnelheid (aangegeven, waar), hoogte, verticale snelheid, pitch, dwarshelling, koers
  • G-kracht, aanvalshoek, overtrekwaarschuwing, waarschuwing voor te hoge snelheid
  • Hoogteroer-, rolroer- en roerdoorbuiging (getrimd en ruw)
  • Trimposities (elevator, rolroer, roer)
  • Staat van de landingsgestelhendel, index van de klephendel, positie van de spoilerhendel
  • RPM-percentage per motor en verbrandingsstatus, omgekeerde stuwkracht ingeschakeld
  • Oppervlaktetype enum (baan versus gras versus ijs), doorbuiging van het rempedaal
  • Stuurautomaat masterstatus, stuurautomaat bestuurde pitch / bank

Als MSFS een variabelenaam niet herkent, registreert de bridge deze als waarschuwing op de Diagnostiek pagina maar gaat verder: ontbrekende variabelen vallen standaard terug op verstandige nullen. Zo tolereert de bridge vliegtuigen van derden die niet elke SimVar implementeren.

Problemen oplossen

Zie Problemen oplossen voor:

  • MSFS maakt verbinding, maar geen krachten - meestal is de ARM-meter in de bovenste strip nog steeds UITGESCHAKELD; daar bedekt.
  • MSFS-pauze / Active Pause stilt dynamische effecten direct en houdt tijdens de pauze een neutrale veer aan.
  • Als een langdurig stotteren of pauzeren de rolkracht na het hervatten vermindert, exporteer dan een ondersteuningsbundel en dien feedback in van dezelfde sessie.