X-Plane 11 / 12

O X-Plane não precisa de configuração especial. FFB-Bridge assina o protocolo dataref UDP integrado do X-Plane (RREF) na porta 49000. Nada para instalar no lado do X-Plane, nenhum plugin, nenhum arquivo XML no estilo SimConnect. Se o X-Plane estiver em execução quando você lançar a ponte, você estará conectado.

O único sim no macOS

X-Plane é o simulador compatível na nova versão do macOS (Apple Silicon) - o mesmo caminho UDP de configuração zero descrito aqui. MSFS é apenas para Windows e Linux.

Comportamento de detecção automática

Na inicialização, a ponte executa duas sondagens em paralelo: uma sonda SimConnect TCP (para MSFS) e uma sonda X-Plane UDP. O primeiro a retornar uma resposta real vence. Na prática isso significa:

Se apenas o X-Plane estiver em execução, ele vencerá em alguns milissegundos.
Se o MSFS e o X-Plane estiverem em execução, o que responder primeiro será usado - e você poderá forçar uma escolha na CLI se isso for um problema.
Se nenhum deles estiver funcionando, a ponte entra em Inativo modo até que um apareça.

Quando o X-Plane está em execução e a ponte foi inscrita com sucesso, a lâmpada SIM na faixa superior fica verde (“Sim conectado”) e a lâmpada MODE indica “Live”. A lâmpada DEVICE é independente — verde enquanto um joystick compatível estiver conectado e aberto.

Certifique-se de que o X-Plane não esteja protegido por firewall

UDP 49000 é a única porta que a ponte usa no lado do X-Plane. As regras padrão do Firewall do Windows em uma nova instalação do X-Plane geralmente permitem isso automaticamente; desktops Linux com firewalld ou ufw quase nunca bloqueia o loopback. Se nada estiver aparecendo no log de eventos da ponte após a inicialização do X-Plane, abra o Página de suporte (barra lateral → Suporte → Verificações de integridade) — o Acessibilidade do X-Plane row tenta uma investigação e informa o que retornou (tempo limite, conexão recusada ou pacotes reais).

Datarefs que a ponte lê

A ponte assina 24 datarefs que espelham o conjunto de variáveis MSFS tão próximo quanto o X-Plane os expõe. Você não precisa configurar nada — listado aqui para referência e depuração:

sim/flightmodel/position/indicated_airspeed
sim/flightmodel/position/true_airspeed
sim/flightmodel/position/vh_ind (velocidade vertical)
sim/flightmodel/position/theta (arfagem)
sim/flightmodel/position/phi (banco)
sim/flightmodel/position/psi (título)
sim/flightmodel/forces/g_nrml (fator de carga)
sim/flightmodel/position/alpha (AoA)
sim/flightmodel2/controls/yoke_pitch_ratio
sim/flightmodel2/controls/yoke_roll_ratio
sim/flightmodel2/controls/pitch_trim
sim/flightmodel2/controls/roll_trim
sim/cockpit/warnings/annunciators/stall_warning
sim/flightmodel/failures/over_vne
sim/flightmodel2/controls/gear_handle_down
sim/flightmodel2/controls/flap_handle_deploy_ratio
sim/flightmodel2/controls/speedbrake_ratio
sim/flightmodel/engine/ENGN_running[0..3]
sim/flightmodel/engine/ENGN_N1_[0..3]
sim/cockpit2/autopilot/autopilot_on
sim/cockpit2/autopilot/heading_dial_deg_mag_pilot
sim/flightmodel2/gear/on_ground_fraction
sim/flightmodel/misc/h_ind (altitude barométrica)
sim/operation/override/override_throttles (para detecção de reverso)

Estabilidade e reconexão

O UDP não tem sinal de desconexão, então a ponte executa seu próprio watchdog: se nenhum dataref chegar por três segundos, ela trata a sessão como morta e o Sim chip fica vermelho. Reiniciar o X-Plane ou carregar um novo voo restabelece a conexão automaticamente – você não precisa reiniciar a ponte.

Pausar vs carregar

A pausa do X-Plane continua enviando datarefs (apenas valores congelados), então a ponte permanece conectado mas o cão de guarda do envelhecimento não tropeça. Durante as telas de menu (seleção de aeronave, diálogo de localização), o X-Plane para de emitir brevemente; a ponte deixará a lâmpada do SIM de volta à cinza ("sem sim funcionando") e ficará verde novamente quando o vôo for retomado.

Instalação não padrão do X-Plane

Os binários X-Plane gratuitos e pagos vinculam o UDP 49000 por padrão. Se você alterou a porta UDP do X-Plane (Configurações → Rede → Portas UDP), a ponte atualmente não expõe uma UI para a porta alternativa - use o padrão do X-Plane ou diga-nos para que possamos priorizá-lo.