O X4: Foundations guarda as suas atribuições em inputmap.xml e identifica um joystick pela sua posição (1 a 8), não pelo nome. Que dispositivo está em que posição fica em config.xml. O JoyPro lê as atribuições de voo espacial para o seu perfil e volta a escrevê-las no próprio ficheiro, nas posições que o X4 fixou para os seus dispositivos. As inversões e a zona morta valem para todo o jogo no X4, por isso o JoyPro define-as a partir das suas relações para o jogo inteiro.
X4: Foundations nativo (os seus próprios ficheiros de atribuições)
- Suporte
- nativo (os seus próprios ficheiros de atribuições)
- Comando do motor
engine x4- Ficheiro de atribuições
Documents\Egosoft\X4\<id>\inputmap.xml(XML) + as posições emconfig.xml- Entradas que o jogo lê
- lê 64 botões, 8 eixos, 1 hat por joystick (verificado)
- Lista de comandos a partir de
- as tabelas de nomes do
X4.exee os arquivos.cat/.dat - Teste no jogo
- 36/36 passos concluídos (2026-10-11)
- ✓ Importar
- ✓ Exportar
- ✓ Atribuições de teclado
- ◐ ModificadoresX4: Shift/Ctrl nas atribuições de teclado; as atribuições de joystick não aceitam modificador.
- ✓ Lista de comandos criada no seu PC
- ✓ Monitor de jogos
- ✗ Curvas de eixo e zonas mortasX4: só a zona morta global do jogo e as inversões (Game settings), nada por atribuição.
- ✓ 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
X Rebirth apenas documentado
- Suporte
- apenas documentado
- Comando do motor
- nenhum
- — 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
X3 (Reunion, Terran Conflict, Albion Prelude) apenas documentado
- Suporte
- apenas documentado
- Comando do motor
- nenhum
- — 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 X4 fechado
Antes: dê uma vez uma posição a cada dispositivo. Nas configurações de controlos do X4, abra Manage Controllers/Joysticks. Atribua cada dispositivo a uma posição e depois saia do jogo normalmente.
Depois: as suas atribuições estão em Settings > Controls.
Já atribuiu botões no X4 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 X4
- Importar: as atribuições de voo espacial dos seus manches, aceleradores e pedais entram no seu perfil, com as inversões e o modo do acelerador do jogo.
- Relações: uma relação é uma função em todos os jogos. "Boost" pode ser o mesmo botão no X4, no Elite Dangerous e no Star Citizen.
- Exportar: o JoyPro edita o
inputmap.xmlno próprio ficheiro, nas posições dos seus dispositivos. As atribuições de menu, de primeira pessoa, de teclado e de rato ficam.
#Importar as suas atribuições do X4
- Abra Iniciar. Se o cartão do X4 pedir uma lista de comandos, prima Criar lista: o JoyPro lê os controlos do jogo a partir da sua instalação (só leitura).
- Prima Importar no cartão do X4. Mantenha Adicionar ao meu perfil. Marque Aceitar também as teclas do teclado se também quiser as suas teclas de voo no JoyPro.
- Prima Importar agora. Ver as minhas relações abre o que entrou.
#Criar e verificar relações
Junte a mesma função dos seus jogos com o fluxo de relações e depois prima Verificar na página Exportar. Mantenha as suas atribuições de joystick sem modificadores: o X4 não aceita modificadores numa atribuição de joystick.
#Exportar para o X4
- Feche o X4. O jogo escreve o
inputmap.xmle oconfig.xmlquando uma sessão termina, por isso o JoyPro recusa-se a escrever enquanto ele está a correr. - Abra Exportar e marque o cartão do X4.
- Mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos se é no JoyPro que configura os seus manches. Prima Exportar agora no cartão.
Inicie o jogo e abra Settings > Controls. As suas atribuições estão na coluna de comando / joystick de cada controlo de voo espacial, na posição do seu dispositivo. Invert Controller / Joystick Axes mostra as inversões que o JoyPro definiu, e as linhas do acelerador bidirecional, da zona morta do joystick e da direção adaptativa mostram os seus valores. O auto-roll e a vibração estão nas configurações do jogo.
#O que faz sozinho no X4
- Dê uma vez uma posição a cada dispositivo. Nas configurações de controlos do X4, abra Manage Controllers/Joysticks e atribua cada manche, acelerador e conjunto de pedais a uma posição, e depois saia do jogo normalmente. O X4 memoriza então o dispositivo em
config.xml. Um dispositivo sem essa entrada muda de posição de uma sessão para a outra, por isso o JoyPro ignora-o ("assign the device to a slot in X4 once"). Um dispositivo definido como "none" aí também é ignorado. - Ligue os seus dispositivos antes de exportar.
#Erros comuns
- "X4 está em execução": saia do jogo e exporte outra vez.
- Um dispositivo foi ignorado: não está fixado a uma posição no X4. Atribua-o em Manage Controllers/Joysticks.
- Um manche na posição 1 faz coisas de comando: a posição 1 é a posição do comando no mapa predefinido do X4, por isso um manche aí herda as atribuições de comando de origem. Substituir nos meus dispositivos remove-as.
- Botões acima de 64 ou um segundo hat não fazem nada: o X4 lê 64 botões, 8 eixos e um hat por dispositivo. O JoyPro ignora as atribuições além disso, com um aviso.
- Uma inversão ficou como estava: uma inversão vale para todos os dispositivos nesse controlo. Quando as suas relações não concordam, ou um comando está atribuído ao mesmo controlo, o JoyPro mantém o valor do jogo e avisa.
#Ficheiros que o JoyPro lê e escreve
| Ficheiro | O que é |
|---|---|
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml |
as atribuições ativas (<action>, <state>, <range> por controlo e entrada) e os parâmetros de <config> (inversões, zona morta, acelerador bidirecional, direção adaptativa). <id> é a pasta da conta Steam. |
...\X4\<id>\config.xml |
os slots de dispositivo (<joysticks>) e configurações do jogo como vibração, auto-roll e modo de comando; lido para os slots, editado no próprio ficheiro para as configurações |
...\X4\<id>\inputmap.xml.joypro-meta.json |
Os nomes, grupos e ajustes do JoyPro para as atribuições escritas, lidos de novo pela próxima importação |
inputmap.xml.jpbak, config.xml.jpbak |
cópias de antes da primeira escrita, mais o arquivo de backups com versões do JoyPro |
O ficheiro é escrito como texto: a declaração, os fins de linha, a indentação, os comentários de secção, <config>, os atributos da raiz e todas as linhas não tocadas ficam byte a byte. Uma linha nova entra na sua secção depois da última entrada do mesmo tipo com um número de controlo inferior. O JoyPro nunca toca nos perfis guardados inputmap_1.xml a inputmap_5.xml nem nas suas gravações. O Steam Cloud sincroniza a pasta; ainda não está confirmado que ficheiros sincroniza.
#Os modos de exportação no X4
Um conflito é outro controlo de voo no mesmo slot e entrada. Os gémeos de um controlo no mapa e no monitor de detalhe contam como o mesmo controlo.
| Modo | O que acontece no inputmap.xml |
|---|---|
| Só adicionar | Nada é removido. Uma atribuição cuja entrada outro controlo de voo tem não é escrita e recebe a marca "Não escrito no jogo". |
| Atualizar, manter atribuições do jogo | As suas linhas entram ao lado das outras entradas do controlo; só os conflitos são removidos. |
| Atualizar, o meu perfil ganha | Como acima, e um controlo que atribui perde as suas outras linhas nos slots fixados de dispositivos ligados (com a opção de teclado, também as suas linhas de teclado). |
| Substituir nos meus dispositivos | As atribuições de voo dos slots escritos que não estão no seu perfil são removidas, também as atribuições de voo de origem do comando no slot 1. |
| + Limpar também os meus outros dispositivos | O mesmo para os slots que o config.xml fixa a dispositivos ligados que a exportação não usa. Um slot sem dispositivo fixado fica como está: o seu dispositivo é desconhecido. |
O menu do X4 atribui alguns controlos em conjunto: "Toggle Travel Mode" define a mesma entrada também dentro do mapa, "Dock" também desacopla. O JoyPro escreve e remove esses grupos como o menu faz, e nunca remove o gémeo "Interact" da primeira pessoa.
#O que nunca é tocado
- Controlos de menu, mapa, primeira pessoa, opções e acessibilidade; entradas do menu radial.
- Linhas de teclado e rato; o teclado só é escrito com a opção de teclado, só para controlos de voo, nunca com as teclas que o menu do X4 recusa (Escape, Delete, Ctrl+X/C/V ...).
- Slots de dispositivos que não estão ligados ou não estão fixados, comandos, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
- Todas as linhas de
<config>que o JoyPro não define.
#Curvas e configurações do jogo
- Granularidade: um conjunto de atribuições para todas as naves (os controlos de voo espacial).
- As inversões são um valor por controlo para todos os dispositivos (
invert_steering_yaw,_pitch,_roll,invert_throttle,invert_strafe_*). A sua relação mantém a direção do DCS; os mapas HOTAS próprios do X4 contam pitch, roll e throttle como invertidos, por isso o JoyPro define o parâmetro com a sua inversão trocada para esses. Só define um parâmetro quando todos os eixos do JoyPro nesse controlo concordam. - O acelerador bidirecional segue o Slider da relação do acelerador: Slider = só para a frente, sem Slider = o centro é impulso zero.
- Zona morta: o X4 tem uma zona morta para todos os eixos de todos os joysticks. As zonas mortas das relações não são escritas (a exportação avisa); defina a zona morta do jogo em Configurações > Configurações de force feedback dos jogos (escolha X4) ou com
engine ffb set. No mesmo sítio estão a direção adaptativa, a vibração, o auto-roll e o modo de comando. Uma configuração que guarda aí prevalece sobre as relações, com um aviso quando as inverte. - Sem curvas nem saturação por eixo no X4; sem force feedback; sem telemetria.
- Monitor de jogos: uma atribuição ou opção que altera no jogo é detetada depois de ele fechar (
inputmap.xmleconfig.xml), e o JoyPro pergunta se a deve adotar. - HUD: o HUD encontra o jogo pelo seu processo e mostra as suas atribuições do X4.
#X Rebirth e X3
O X Rebirth usa as mesmas palavras de inputmap.xml que o X4, mas a sua lista de comandos precisaria de uma extração própria a partir de uma instalação. O X3 (Reunion, Terran Conflict, Albion Prelude) tem outro motor e um formato de ficheiro desconhecido. Ambos estão apenas documentados: o JoyPro não os importa nem exporta.
#Por dentro da integração do X4
flowchart LR D["O seu dispositivo<br/>(GUID de instância)"] --> C["config.xml<br/>joysticks"] C --> S["Fixado num slot:<br/>slot 1 ... 8"] C --> K["Não fixado ou desativado:<br/>ignorado, atribua-o<br/>uma vez no X4"] P["O seu perfil"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>atribuições por slot"] E --> O["opções globais do jogo:<br/>inversões, modo do acelerador"]
Código: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs e o modelo de configurações engine\FfbModels\X4.cs.
- Slots: uma atribuição nomeia uma fonte:
INPUT_SOURCE_JOYBUTTONS(botões e hat) ouINPUT_SOURCE_JOYAXES, sem sufixo para o slot 1 e_2a_8para os outros. Oconfig.xmlassocia dispositivos a slots pelo GUID de instância DirectInput, escrito na forma própria do X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00});num0 a 7 é o slot,disabled="1"significa nenhum. O JoyPro só escreve nos slots cuja entrada atual e ativa corresponde a um dispositivo ligado. - Códigos: os botões 1 a 11 usam os nomes de comando do X4 (
INPUT_XBUTTON_A...BIGBUTTON), 12 a 64INPUT_XBUTTON_12...; o hatINPUT_XBUTTON_DPAD_*(oito direções); os eixosINPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Os intervalos não recebemsgn. Teclado:INPUT_KEYCODE_<DIK>com_SHIFT/_CONTROL. - Lista de comandos:
engine x4 refresh-dblêgameoptions.luae a página de texto em inglês dos arquivos.cat/.date as tabelas de nomes deX4.exe, só em leitura; 128 controlos de voo espacial (6 eixos, 122 botões). As linhas leem-se como "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)".engine x4 cataloglista-a,engine x4 pathsmostra os ficheiros encontrados. - Importar / exportar:
engine x4 import,engine x4 scan;engine x4 export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run. - Configurações do jogo:
engine ffb set --device * --game X4 --param <key>=<value>; os parâmetros são editados no próprio ficheiro, um que falte é acrescentado como última linha de<config>. Uma exportação sem atribuições do X4 continua a escrever as configurações guardadas.
#Limites conhecidos
- Os dispositivos sem slot fixado são ignorados; o JoyPro ainda não os fixa sozinho.
- Os modificadores de joystick não são escritos: a sua marcação no ficheiro ainda não está confirmada.
- 64 botões, 8 eixos e um hat por dispositivo; oito slots, partilhados com os comandos.
- Vibração: o slider do jogo mostra o valor vezes 100 truncado (21 % aparece como 20); o ficheiro guarda o valor exato.
- Testes:
engine\tests\smoke\x4.ps1(também a atualização do catálogo); no jogotools\e2e\games\X4.ps1(atribuições e matriz de modos, na sua própria pasta de perfil) etools\e2e\games\X4Settings.ps1(inversões, modo do acelerador, configurações do jogo).
Todas as notas técnicas sobre este jogo (geradas a partir do repositório): x4.md.