JoyPro2 Discord GitHub
Jogos

X4: Foundations

Mostrar:

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 em config.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.exe e 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.

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 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.xml no 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

  1. 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).
  2. 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.
  3. 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

  1. Feche o X4. O jogo escreve o inputmap.xml e o config.xml quando uma sessão termina, por isso o JoyPro recusa-se a escrever enquanto ele está a correr.
  2. Abra Exportar e marque o cartão do X4.
  3. 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.
No jogo: O que vê no X4

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.
Avançado

#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.xml e config.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.

Detalhes técnicos internos

#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"]
O X4 nomeia um joystick pelo seu slot. Um dispositivo sem slot fixo é ignorado.

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) ou INPUT_SOURCE_JOYAXES, sem sufixo para o slot 1 e _2 a _8 para os outros. O config.xml associa 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}); num 0 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 64 INPUT_XBUTTON_12 ...; o hat INPUT_XBUTTON_DPAD_* (oito direções); os eixos INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Os intervalos não recebem sgn. Teclado: INPUT_KEYCODE_<DIK> com _SHIFT / _CONTROL.
  • Lista de comandos: engine x4 refresh-db lê gameoptions.lua e a página de texto em inglês dos arquivos .cat/.dat e as tabelas de nomes de X4.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 catalog lista-a, engine x4 paths mostra 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 jogo tools\e2e\games\X4.ps1 (atribuições e matriz de modos, na sua própria pasta de perfil) e tools\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.