JoyPro2 Discord GitHub
Jogos

X-Plane 12 / 11

Mostrar:

O X-Plane guarda as atribuições de todos os seus dispositivos num só ficheiro de preferências dentro da sua instalação: um "uso" de eixo (picada, acelerador, flaps ...) por eixo de hardware, um comando por botão e curvas de resposta opcionais. O JoyPro lê esse ficheiro para o seu perfil, junta-o aos seus outros jogos em relações e volta a escrevê-lo, mudando só as linhas de voo que gere. O X-Plane 12 e o X-Plane 11 são dois jogos no JoyPro, cada um com a sua instalação, lista de comandos e configurações; ambos podem estar instalados lado a lado.

X-Plane 12 nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine xplane12
Ficheiro de atribuições
Output\preferences\X-Plane Joystick Settings.prf, control profiles\*.prf (por linhas)
Entradas que o jogo lê
lê 160 botões, 25 eixos, 1 hat por joystick (verificado)
Lista de comandos a partir de
Resources\plugins\Commands.txt
Teste no jogo
33/33 passos concluídos (2026-10-11)
  • ✓ Importar
  • ✓ Exportar
  • ✗ Atribuições de teclado
  • ✗ Modificadores
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ✓ Curvas de eixo e zonas mortas
  • ✓ Configurações de controlo do jogo
  • ◐ Configurações de force feedback no jogoX-Plane 12: só o interruptor por dispositivo "control-loaded axes" para manches com force feedback; o simulador não tem efeitos de force feedback próprios para o manche (só plugins).
  • ✗ Force feedback a partir da telemetria
  • ✓ Gravação de telemetria
  • ✓ Joystick virtual (vJoy)
  • ◐ Comando Xbox virtual
  • ✓ Funções virtuais
  • ✓ Assistente de configuração / Atribuição automática
  • ✓ Cockpits
  • ✓ Folhas de referência
  • ✓ Teste no jogo
X-Plane 11 nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine xplane11
Ficheiro de atribuições
igual ao X-Plane 12
Entradas que o jogo lê
lê 160 botões, 25 eixos, 1 hat por joystick (verificado)
Lista de comandos a partir de
Resources\plugins\Commands.txt
  • ✓ Importar
  • ✓ Exportar
  • ✗ Atribuições de teclado
  • ✗ Modificadores
  • ✓ Lista de comandos criada no seu PC
  • ✓ Monitor de jogos
  • ✓ Curvas de eixo e zonas mortas
  • ✓ Configurações de controlo do jogo
  • ✗ Configurações de force feedback no jogo
  • ✗ Force feedback a partir da telemetria
  • ✓ Gravação de telemetria
  • ✓ Joystick virtual (vJoy)
  • ◐ Comando Xbox virtual
  • ✓ Funções virtuais
  • ✓ Assistente de configuração / Atribuição automática
  • ✓ Cockpits
  • ✓ Folhas de referência
  • ✗ Teste no jogo

Da matriz de suporte, gerada a partir do código do motor: todos os jogos.

Para iniciantes

#Pôr a funcionar em 3 passos

  1. Configurar tudo por mim
    na página Início
  2. Usar estes botões
    veja primeiro a lista
  3. Escrever no meu jogo
    mantenha o X-Plane fechado

Antes: inicie o X-Plane uma vez com os seus dispositivos ligados e depois saia.

Depois: calibre os seus dispositivos no X-Plane (Settings > Joystick). As suas atribuições também aparecem aí.

Já atribuiu botões no X-Plane antes? Então a página Início oferece Importar e depois preencher lacunas. As suas atribuições ficam, e só os botões livres recebem novas funções. Veja Início rápido: pôr o meu manche a funcionar.

#O que o JoyPro faz pelo X-Plane

  • Importar: os usos dos eixos, os comandos dos botões, as marcas de inversão e as curvas de resposta dos seus dispositivos entram no seu perfil.
  • Relações: uma relação é uma função em todos os seus jogos ("Gear" no X-Plane, no MSFS e no DCS no mesmo botão). Os comandos de voo do X-Plane vêm do seu próprio Commands.txt.
  • Exportar: o JoyPro escreve as preferências de joystick da versão que exporta. O X-Plane mostra as suas atribuições em Settings > Joystick.

#Importar as suas atribuições do X-Plane

  1. Abra Iniciar. O cartão do X-Plane 12 (ou X-Plane 11) mostra a imagem do jogo. Se pedir uma lista de comandos, prima Criar lista: o JoyPro lê o Resources\plugins\Commands.txt do X-Plane instalado.
  2. Prima Importar no cartão e escolha Adicionar ao meu perfil (o X-Plane não tem atribuições de teclado neste ficheiro).
  3. Prima Importar agora. Ver as minhas relações abre o que entrou.
A página Início com os seus jogosA página Início com os seus jogos
A página Início com os seus jogos (As imagens mostram a aplicação em inglês.)

#Criar e verificar relações

Na página Relações, o comando ou eixo do X-Plane de uma relação fica ao lado da mesma função nos seus outros jogos. Use o fluxo de relações para os juntar e depois prima Verificar agora na página Exportar (a verificação).

#Exportar para o X-Plane

  1. Feche o X-Plane. Reescreve as suas preferências quando a janela de configurações fecha e ao sair. Ambas as versões correm como X-Plane.exe, por isso o JoyPro recusa-se enquanto qualquer uma delas estiver a correr.
  2. Abra Exportar. Cada versão instalada tem o seu próprio cartão.
  3. Mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos se é no JoyPro que configura os seus dispositivos. Prima Exportar agora no cartão.
No jogo: O que vê no X-Plane

Inicie o X-Plane, abra Settings > Joystick e escolha o seu dispositivo. Cada eixo mostra o uso que o JoyPro escreveu, os botões mostram os seus comandos e Edit Response Curve num eixo mostra os pontos e a interpolação que o JoyPro escreveu.

#O que faz sozinho no X-Plane

  • Inicie o X-Plane uma vez com os seus dispositivos ligados e depois saia. Uma versão que nunca foi iniciada ainda não tem ficheiro de preferências. O primeiríssimo arranque faz o tutorial, e o X-Plane escreve as suas preferências de joystick ao sair.
  • Calibre no X-Plane. A calibração e a null zone ficam a cargo do X-Plane (Settings > Joystick); o JoyPro nunca as escreve.
  • Os comandos de plugins e de aeronaves não estão na lista do JoyPro: atribua-os no X-Plane, o JoyPro não lhes mexe.

#Erros comuns

  • Um eixo não faz nada ("Multiple axes assigned to yaw"): o X-Plane ignora um uso partilhado por dois eixos ligados. A exportação avisa; Limpar também os meus outros dispositivos ou Substituir limpa o outro eixo.
  • O acelerador funciona ao contrário: o X-Plane inverte os eixos do acelerador sozinho. O JoyPro escreve a sua inversão sem alterações, por isso deixe a inversão desligada, a não ser que a sua alavanca funcione mesmo ao contrário.
  • Uma curva que criou no X-Plane mudou: nos modos Atualizar e Só adicionar, ela fica quando o ajuste do JoyPro é linear (com um aviso); "o meu perfil ganha" e Substituir escrevem a curva do JoyPro.
Avançado

#Ficheiros que o JoyPro lê e escreve

Ficheiro O que é
<install>\Output\preferences\X-Plane Joystick Settings.prf as atribuições atuais de todos os dispositivos (baseado em linhas)
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf perfis de controlo guardados, mesmo formato
<file>.joypro.json, <file>.joypro-meta.json as entradas e curvas que o JoyPro escreveu; nomes, grupos e afinação para a próxima importação
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt onde o instalador do X-Plane lista as suas instalações (só leitura)

X-Plane Keys.prf (teclado) nunca é tocado. Uma versão instalada pelo Steam e nunca iniciada é encontrada na sua pasta do Steam. Outra pasta define-se em Configurações > Jogos.

#Os modos de exportação no X-Plane

Modo O que acontece no X-Plane
Só adicionar Só entradas livres. Uma atribuição numa entrada com outro uso ou comando não é escrita e é listada; um uso de eixo que o X-Plane tem noutro eixo fica lá (aviso).
Atualizar, manter atribuições do jogo Substitui o outro uso ou comando na sua entrada e mantém tudo o resto; um uso de eixo muda de sítio (o X-Plane ignora um uso partilhado por dois eixos).
Atualizar, o meu perfil ganha Liberta também os outros eixos e botões de dispositivos ligados que têm um uso ou comando que atribui, com as suas curvas.
Substituir nos meus dispositivos Liberta também todos os outros eixos e comandos de voo nos dispositivos que escreve.
+ Limpar também os meus outros dispositivos Os dispositivos ligados que não escreve perdem os seus usos e comandos de voo.

#O que nunca é tocado

  • Slots de dispositivos que não estão ligados, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
  • Eixos de vista, câmara, VR e de comandos personalizados, comandos de plugins e de aeronaves, o teclado.
  • Chaves de calibração (_joy_center, _joy_null, dados de calibração brutos), _eq_pfc_* e todas as outras linhas.

#Curvas e configurações

  • Granularidade: um ficheiro para todas as aeronaves (o X-Plane pode ligar aeronaves a perfis de controlo; o JoyPro escreve os ficheiros que encontra).
  • Curvas de resposta (modelo de eixo xplane): qualquer número de pontos com LINEAR, CATMULL_ROM ou CUBIC_AVG, e os intervalos fixos dos eixos de acelerador, hélice e mistura (beta, feather, cutoff, FADEC ...). A Curva predefinida passa a pontos; uma curva inalterada mantém os seus bytes. A afinação pode ser definida para uma versão ou para as duas (family:xplane).
  • Inversão: _joy_rev_axis, a sua inversão sem alteração (o X-Plane inverte os aceleradores sozinho).
  • Configurações do jogo (Configurações > Configurações de force feedback dos jogos): resposta dos controlos de pitch, roll e yaw; no X-Plane 12 também os eixos do copiloto e os "control-loaded axes" para manches com force feedback; no X-Plane 11 o aumento de estabilidade; em ambos os batentes dos flaps. Só mudam as linhas que o ficheiro já tem.
  • Force feedback: o X-Plane não tem force feedback próprio; só o interruptor control-loaded.
  • Gravação de telemetria: a partir da saída de dados UDP do X-Plane (porta 49000), com posição, por isso é possível uma trajetória no Tacview.
  • Monitor de jogos: as alterações nas preferências são detetadas depois de o X-Plane fechar (o monitor de jogos).
Detalhes técnicos internos

#Por dentro da integração do X-Plane

flowchart LR
  P["O seu perfil<br/>(relações + atribuições)"] --> E["engine xplane12 export<br/>(ou xplane11)"]
  D["Slots de dispositivo<br/>VID:PID + caminho HID"] --> E
  E --> J["Output / preferences /<br/>X-Plane Joystick Settings.prf"]
  E --> C["control profiles /<br/>Name - Joysticks.prf"]
  J --> G["X-Plane: Settings > Joystick"]
  C --> G
Cada versão do X-Plane tem o seu próprio ficheiro de preferências. A calibração e a zona nula continuam a ser do X-Plane.

Código: engine\Games\XPlaneIntegration.cs (uma instância por versão), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (os perfis de antes da divisão em duas versões são migrados ao carregar).

  • Linhas: _joy_AXIS_use<i> (código de uso), _joy_rev_axis<i>, _joy_BUTN_use<i> (caminho do comando, sim/none/none = livre), axis_response_curve<i>. Índices globais: eixo = slot × 25 + eixo, botão = slot × 160 + botão.
  • Dispositivos: slots _joy_unique_id<slot> VID:<dec>PID:<dec>; com dispositivos idênticos, o caminho da interface HID do DirectInput tem de ser igual a _joy_location<slot>. Os botões são os botões do dispositivo, depois o primeiro hat como 8 botões no sentido dos ponteiros do relógio a partir de cima; os outros hats não são mapeados. Lê 160 botões e 25 eixos por dispositivo.
  • Códigos de uso: 0 a 66 nas duas versões; o X-Plane 12 acrescenta o throttle 9, pitch/roll/yaw/travões/tiller do copiloto e ambos os travões das rodas. Os códigos 74 a 77 e os eixos de vista não estão catalogados.
  • Lista de comandos: engine xplane12 refresh-db / engine xplane11 refresh-db: a tabela de eixos da versão mais os grupos de comandos de voo de Commands.txt (sim/flight_controls, engines, autopilot, lights ...; não sim/view, operation, replay ...).
  • Importar / exportar: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), o mesmo para engine xplane11 export. Primeiro um backup para .jpbak.
  • Configurações e curvas: engine ffb set --game XPlane12, engine binds tuning set --scope game:XPlane12 --curve-points 0:0,0.4:0.3,1:1, engine binds tuning preview (medido no X-Plane 12.4.3 com margem de 0.0001).

#Limites conhecidos

  • O significado dos códigos de uso 74 a 77; a ordem dos eixos HID versus DirectInput é deduzida.
  • A Control Sensitivity do X-Plane sem curva não está na pré-visualização.
  • O X-Plane 11 só é verificado contra os seus ficheiros instalados; a verificação no menu do jogo está pendente.
  • Testes: engine\tests\smoke\xplane.ps1; no jogo (X-Plane 12), as atribuições e as curvas de resposta passaram 33 de 33 passos; tools\e2e\games\XPlaneCurves.ps1 percorre cada eixo e compara-o com a pré-visualização do JoyPro.

Todas as notas técnicas sobre este jogo (geradas a partir do repositório): xplane.md.