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 localização
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

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.

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

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 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 sob Proton envia o mesmo estoque 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). Abrir 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. Caixa de diálogo Doctor's Fix no Linux. 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 de próton?

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