Versão atual. FFB-Bridge v1.2.1 está disponível. Esta documentação acompanha o app atual descrito pelo manifesto da versão. Se uma seção parecer desatualizada, avise pelo formulário de feedback.

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.

Somente Windows e Linux

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.

MSFS 2020

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

InstalarSimConnect.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.

Caixa de diálogo Correção da página de suporte do FFB-Bridge no Linux mostrando um prefixo Proton detectado e a porta SimConnect TCP que ele instalará Caixa de diálogo Correção da página de suporte do FFB-Bridge no Linux mostrando um prefixo Proton detectado e a porta SimConnect TCP que ele instalará
Figura 1. Caixa de diálogo de correção no Linux (Suporte → Verificações de integridade → Linha de configuração do SimConnect). Mostra o caminho do prefixo Proton encontrado e a porta que está prestes a adicionar. Clicar em Instalar mescla uma nova entrada – as entradas existentes são deixadas de lado.

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.

Qual prefixo do Proton?

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.