Microsoft Flight Simulator 2024 e 2020
FFB-Bridge conversa com o Microsoft Flight Simulator através do transporte TCP do SimConnect - ambos MSFS 2024 e MSFS 2020 são suportados. Em uma nova instalação, isso funciona imediatamente no Windows e precisa de um único ajuste de configuração no Linux/Proton. A ponte Página de suporte (barra lateral → Suporte → Verificações de integridade) pode fazer o ajuste para você – este guia cobre tanto o caminho de um clique quanto o manual.
O MSFS conecta no Windows e no Linux. A versão do macOS oferece suporte apenas ao X-Plane — consulte X-Plane 11 / 12.
Qual instalação do MSFS você possui?
O local padrão do SimConnect depende de como o MSFS foi instalado. Os caminhos abaixo são para o MSFS 2024, que o FFB-Bridge detecta automaticamente em todas as três fontes de instalação. Ajuda saber em qual você está se algo der errado.
O MSFS 2020 se conecta da mesma maneira através do SimConnect TCP. A detecção automática da ponte e as correções de verificação de integridade com um clique têm como alvo o arquivo de configuração 2024, portanto, em 2020, você pode precisar confirmar a porta que a ponte está usando (o padrão é 500 no Windows). Se 2020 escutar em uma porta não padrão, configure-a no
Configuração do SimConnect Linha de verificação de integridade ou aponte a ponte diretamente para o arquivo com
FFB_BRIDGE_MSFS_CONFIG=<path-to-SimConnect.xml>.
| Instalar | SimConnect.xml localização |
|---|---|
| Win Steam / autônomo | %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 - fora da caixa
Cada instalação padrão do MSFS 2024 vem com SimConnect TCP habilitado na porta 500, vinculado a todas as interfaces IPv4. O padrão da ponte é 127.0.0.1:500 no Windows. Inicie o MSFS e, em seguida, inicie o FFB-Bridge - o
Sim O chip no painel deve ficar verde dentro de um ou dois segundos após o sim chegar ao menu principal.
Caso contrário, abra o Página de suporte e execute verificações de integridade. O Configuração do SimConnect informa o que foi encontrado no XML e se a porta que ele está usando corresponde à porta com a qual a ponte está se comunicando.
Portas diferentes de 500
Algumas ferramentas — FSUIPC, SPAD.neXt — adicionam suas próprias entradas TCP no mesmo SimConnect.xml. Se o MSFS estiver escutando em uma porta diferente da que a ponte espera, o
Configuração do SimConnect linha na aba Verificações de integridade da página de suporte oferece um(a) 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 na página de suporte
O MSFS sob Proton fornece o mesmo padrão de fábrica SimConnect.xml
como a compilação do Windows, com TCP escutando na porta
500. Mas o Linux trata as portas abaixo de 1024 como privilegiadas, e o processo de namespace do usuário Proton não pode vinculá-las. A escuta falha silenciosamente e nenhum soquete é aberto.
A solução é adicionar um paralelo <SimConnect.Comm>
entrada em uma porta sem privilégios (a ponte usa 5111 por padrão). Abra o Página de suporte → Verificações de saúde; o Configuração do SimConnect linha mostrará a porta privilegiada e oferecerá um Corrigir… botão.


Corrigir… mescla uma nova entrada no XML existente (nunca a reescreve). Se o arquivo existente não puder ser analisado, o instalador primeiro fará o backup dele como
SimConnect.xml.bak-YYYY-MM-DD-HHMMSS e grava uma nova configuração gerada. De qualquer forma, reinicie o MSFS após a instalação para que ele leia novamente o SimConnect.xml.
FFB-Bridge testa os prefixos conhecidos para Steam, Steam-Flatpak, Heroic e Lutris. Se você executar o MSFS em um local não padrão, defina
FFB_BRIDGE_MSFS_PREFIX=/path/to/prefix em seu ambiente antes de lançar a ponte. Para uma substituição bare-metal apenas do arquivo XML,
FFB_BRIDGE_MSFS_CONFIG=/path/to/SimConnect.xml
tem precedência.
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 Mock Sim página, mude a fonte de entrada de volta para Ao vivo, e a ponte pegará a nova configuração. Você também pode ir ao Página de suporte → Diagnóstico e observe o log para SimConnect conectado após reiniciar o MSFS.
SimVars que o bridge 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 (compensada e bruta)
- Posições de compensação (profundor, aileron, leme)
- Estado da alavanca do trem de pouso, índice da alavanca de flapes, 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, arfagem / inclinação comandadas 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 do MSFS / Active Pause silencia os efeitos dinâmicos imediatamente e mantém uma mola neutra enquanto pausado.
- 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.