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.
#Pôr a funcionar em 3 passos
- Configurar tudo por mim
na página Início - Usar estes botões
veja primeiro a lista - 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
- 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.txtdo X-Plane instalado. - Prima Importar no cartão e escolha Adicionar ao meu perfil (o X-Plane não tem atribuições de teclado neste ficheiro).
- Prima Importar agora. Ver as minhas relações abre o que entrou.


#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
- 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. - Abra Exportar. Cada versão instalada tem o seu próprio cartão.
- 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.
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.
#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).
#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
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 deCommands.txt(sim/flight_controls,engines,autopilot,lights...; nãosim/view,operation,replay...). - Importar / exportar:
engine xplane12 import,engine xplane12 scan,engine xplane12 export(--mode,--nuke-untouched-devices,--dry-run), o mesmo paraengine 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.ps1percorre 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.