Documentação em beta. Alguns textos e imagens serão retrabalhados à medida que o aplicativo se adapta à versão 1.0. Se uma seção estiver obsoleta, sinalize-a através do formulário de comentários.

Simulador de vôo Microsoft 2024

O FFB-Bridge se comunica com o MSFS 2024 pelo transporte TCP do SimConnect. Em uma nova instalação do MSFS 2024, isso funciona imediatamente no Windows e precisa de um único ajuste de configuração no Linux/Proton. A ponte Doutor page pode fazer o ajuste para você - este guia cobre tanto o caminho de um clique quanto o manual.

Qual instalação do MSFS você possui?

A localização padrão do SimConnect depende de como o MSFS foi instalado. O FFB-Bridge detecta todos os três casos automaticamente, mas ajuda saber em qual deles você está se algo der errado.

InstalarSimConnect.xml location
Ganhar Vapor/autônomo %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
Ganhar Microsoft Store/Xbox Game Pass %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml
Linux Vapor + Próton ~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml

Janelas - fora da caixa

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 O chip no painel deve ficar verde dentro de um ou dois segundos após o sim chegar ao menu principal.

Se não, abra Doutor. The Configuração do SimConnect row informa o que foi encontrado no XML e se a porta que está usando corresponde à porta com a qual a ponte está se comunicando.

Portas diferentes de 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 Configuração do SimConnect linha no Doctor oferece um inline Usar porta:X botão. Clique nele e as preferências da ponte serão atualizadas para aquela porta; nenhuma reinicialização do MSFS é necessária.

Linux - correção com um clique 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 Doutor; o Configuração do SimConnect linha mostrará a porta privilegiada e oferecerá um Corrigir… botão.

Caixa de diálogo FFB-Bridge Doctor's Fix no Linux mostrando um prefixo Proton detectado e a porta SimConnect TCP que ele 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.

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

Qual prefixo de próton?

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.

Configuração manual

Se você preferir editar manualmente, o XML ficará assim:

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

Após salvar, abra o FFB-Bridge Simulação SimConnect página, mude a fonte de entrada de volta para Ao vivo, e a ponte pegará a nova configuração. No Linux você também pode ir para Diagnóstico e observe o registro para SimConnect conectado após reiniciar o MSFS.

SimVars que a ponte lê

Para referência - você não precisa configurar nada disso - aqui está o conjunto de MSFS SimVars que a ponte assina:

  • Velocidade no ar (indicada, verdadeira), altitude, velocidade vertical, inclinação, inclinação, rumo
  • Força G, ângulo de ataque, aviso de estol, aviso de velocidade excessiva
  • Deflexão do profundor, aileron e leme (trimmed e raw)
  • Posições de compensação (elevador, aileron, leme)
  • Estado da alavanca de câmbio, índice da alavanca do flap, posição da alavanca do spoiler
  • Porcentagem de RPM por motor e estado de combustão, impulso reverso ativado
  • Enumeração do tipo de superfície (pista vs grama vs gelo), deflexão do pedal do freio
  • Estado mestre do piloto automático, inclinação/banco comandado pelo piloto automático

Se o MSFS não reconhecer um nome de variável, a ponte o registrará como um aviso no Diagnóstico página, mas continua - as variáveis ausentes são padronizadas como zeros sensíveis. É assim que a ponte tolera aeronaves de terceiros que não implementam todos os SimVar.

Solução de problemas

Veja Solução de problemas para:

  • MSFS conecta, mas não força – na maioria das vezes o medidor ARM na faixa superior ainda está DESARMADO; coberto lá.
  • A pausa MSFS / Pausa Ativa deve silenciar os efeitos dinâmicos imediatamente na versão beta.11 e manter uma mola neutra durante a pausa.
  • Se uma longa interrupção ou pausa diminuir a força de rolagem após a retomada, exporte um pacote de suporte e arquive o feedback da mesma sessão.