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ê

sim/flightmodel/position/indicated_airspeed
sim/flightmodel/misc/machno
sim/flightmodel/forces/g_nrml
sim/joystick/yoke_pitch_ratio
sim/joystick/yoke_roll_ratio
sim/cockpit2/controls/elevator_trim
sim/cockpit2/controls/aileron_trim
sim/cockpit2/annunciators/stall_warning
sim/flightmodel/failures/onground_any
sim/flightmodel/position/groundspeed
sim/flightmodel/position/vh_ind
sim/cockpit2/controls/left_brake_ratio
sim/cockpit2/controls/right_brake_ratio
sim/cockpit2/controls/gear_handle_down
sim/cockpit2/controls/flap_handle_request_ratio
sim/cockpit2/autopilot/servos_on
sim/cockpit2/controls/speedbrake_ratio
sim/flightmodel2/controls/flap1_deploy_ratio
sim/flightmodel2/controls/flap2_deploy_ratio
sim/flightmodel/position/Q
sim/flightmodel/position/P
sim/flightmodel2/engines/thrust_reverser_deploy_ratio[0]
sim/flightmodel/ground/surface_texture_type
sim/cockpit2/engine/indicators/N1_percent[0]
sim/flightmodel/engine/ENGN_running[0]
sim/time/paused
sim/flightmodel/forces/g_side
sim/flightmodel/position/Q_dot
sim/flightmodel/position/P_dot
sim/flightmodel/position/R_dot
sim/weather/aircraft/turbulence[0]
sim/flightmodel2/misc/has_crashed
sim/flightmodel/controls/hstab1_elv1def
sim/flightmodel/controls/wing1l_ail1def
sim/flightmodel/position/beta
sim/cockpit2/engine/indicators/engine_vibration[0]
sim/flightmodel/forces/fnrml_gear
sim/cockpit/autopilot/flight_director_pitch
sim/cockpit/autopilot/flight_director_roll
sim/flightmodel/forces/g_axil
sim/cockpit2/engine/actuators/prop_rotation_speed_rad_sec[0]
sim/aircraft/view/acf_ui_name[0..249]
sim/aircraft/view/acf_descrip[0..259]
sim/aircraft/view/acf_ICAO[0..39]
sim/version/xplane_internal_version
sim/aircraft/controls/acf_flap_detents

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.