Documentazione in versione beta. Alcuni testi e immagini verranno rielaborati man mano che l'app si installa nella versione 1.0. Se una sezione risulta obsoleta, segnalala tramite il file modulo di feedback.

Simulatore di volo Microsoft 2024

FFB-Bridge comunica con MSFS 2024 tramite il trasporto TCP di SimConnect. In una nuova installazione di MSFS 2024 funziona immediatamente su Windows e richiede una singola modifica della configurazione in Linux/Proton. Quella del ponte Dottore page può fare la modifica per te: questa guida copre sia il percorso con un clic che quello manuale.

Che installazione MSFS hai?

La posizione predefinita di SimConnect dipende da come è stato installato MSFS. FFB-Bridge rileva automaticamente tutti e tre i casi, ma è utile sapere su quale ti trovi se qualcosa va storto.

InstallaSimConnect.xml location
Vinci Vapore/autonomo %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
Vinci Microsoft Store/Xbox Game Pass %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml
Linux Vapore + Protone ~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml

Finestre – fuori dagli schemi

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 Il chip sulla dashboard dovrebbe diventare verde entro un secondo o due dal momento in cui la sim raggiunge il menu principale.

In caso contrario, apri Dottore. The Configurazione SimConnect row ti dice cosa ha trovato nell'XML e se la porta che sta utilizzando corrisponde alla porta con cui sta comunicando il bridge.

Porte diverse da 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 Configurazione SimConnect fila su Doctor offre un file in linea Usa la porta:X pulsante. Fare clic e le preferenze del bridge verranno aggiornate su quella porta; non è necessario il riavvio di MSFS.

Linux - correzione con un clic tramite 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 Dottore; il Configurazione SimConnect la riga mostrerà la porta privilegiata e offrirà a Correggi… pulsante.

Finestra di dialogo Fix di FFB-Bridge Doctor su Linux che mostra un prefisso Proton rilevato e la porta TCP SimConnect che verrà installata
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.

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

Quale prefisso 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.

Configurazione manuale

Se preferisci modificare manualmente, l'XML si presenta così:

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

Dopo aver salvato, apri FFB-Bridge Simulazione simulata di SimConnect pagina, ripristinare la sorgente di ingresso Vivie il bridge rileverà la nuova configurazione. Su Linux puoi anche andare su Diagnostica e guarda il registro SimConnect connesso dopo aver riavviato MSFS.

SimVars letti dal bridge

Per riferimento, non è necessario configurare nulla di tutto ciò, ecco il set di MSFS SimVar a cui si iscrive il bridge:

  • Velocità (indicata, vera), altitudine, velocità verticale, beccheggio, virata, rotta
  • Forza G, angolo di attacco, avviso di stallo, avviso di velocità eccessiva
  • Deviazione di elevatore, alettone e timone (trimmati e grezzi)
  • Posizioni del trim (elevatore, alettone, timone)
  • Stato della maniglia del cambio, indice della maniglia dei flap, posizione della maniglia dello spoiler
  • Percentuale di giri al minuto per motore e stato di combustione, spinta inversa inserita
  • Enumerazione del tipo di superficie (pista vs erba vs ghiaccio), deflessione del pedale del freno
  • Stato principale dell'autopilota, inclinazione/inclinazione comandate dall'autopilota

Se MSFS non riconosce un nome di variabile, il bridge lo registra come avviso sul file Diagnostica pagina ma continua: le variabili mancanti vengono impostate automaticamente su zeri ragionevoli. Questo è il modo in cui il bridge tollera gli aerei di terze parti che non implementano ogni SimVar.

Risoluzione dei problemi

Vedi Risoluzione dei problemi per:

  • MSFS si connette ma non forza: molto spesso l'indicatore ARM nella striscia superiore è ancora DISINSERITO; coperto lì.
  • La pausa MSFS/Pausa attiva dovrebbe silenziare immediatamente gli effetti dinamici nella beta.11 e mantenere una molla neutra durante la pausa.
  • Se un lungo balbettio o una pausa riducono la forza di rollio dopo la ripresa, esporta un pacchetto di supporto e invia il feedback dalla stessa sessione.