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

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.

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á — Figure 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:

AIRSPEED INDICATED
AIRSPEED MACH
G FORCE
ELEVATOR POSITION
AILERON POSITION
ELEVATOR TRIM PCT
AILERON TRIM PCT
STALL WARNING
OVERSPEED WARNING
SIM ON GROUND
GROUND VELOCITY
VERTICAL SPEED
BRAKE LEFT POSITION
BRAKE RIGHT POSITION
GEAR HANDLE POSITION
FLAPS HANDLE INDEX
TRAILING EDGE FLAPS LEFT PERCENT
TRAILING EDGE FLAPS RIGHT PERCENT
AUTOPILOT MASTER
SPOILERS HANDLE POSITION
ROTATION VELOCITY BODY X
ROTATION VELOCITY BODY Z
GENERAL ENG REVERSE THRUST ENGAGED:1
SURFACE TYPE
GENERAL ENG PCT MAX RPM:1
GENERAL ENG COMBUSTION:1
TITLE
ATC MODEL
CATEGORY
CAMERA STATE
ACCELERATION BODY X
ROTATION ACCELERATION BODY X
ROTATION ACCELERATION BODY Z
ROTATION ACCELERATION BODY Y
CRASH FLAG
ELEVATOR DEFLECTION
AILERON LEFT DEFLECTION
INCIDENCE BETA
ENG VIBRATION:1
CONTACT POINT COMPRESSION:0
CONTACT POINT COMPRESSION:1
CONTACT POINT COMPRESSION:2
AUTOPILOT FLIGHT DIRECTOR BANK
AUTOPILOT FLIGHT DIRECTOR PITCH
ACCELERATION BODY Z
ROTOR RPM PCT:1
ROTOR GOV ACTIVE:1
COLLECTIVE POSITION

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.