O War Thunder guarda os seus controlos em machine.blk, um ficheiro de texto que contém só o que difere da predefinição de onde partiu. O JoyPro lê os controlos de aeronaves e helicópteros para o seu perfil e volta a escrevê-los no próprio ficheiro: os controlos de tanques, navios e menus ficam como estão. O jogo também guarda uma cópia do ficheiro no servidor da Gaijin; o JoyPro escreve de forma a que o seu ficheiro exportado prevaleça no próximo início de sessão.
War Thunder nativo (os seus próprios ficheiros de atribuições)
- Suporte
- nativo (os seus próprios ficheiros de atribuições)
- Comando do motor
engine warthunder- Ficheiro de atribuições
Documents\My Games\WarThunder\Saves\<uid>\production\machine.blk(texto BLK, um diff em relação ao preset)- Lista de comandos a partir de
gui.vromfs.bin/lang.vromfs.binpor predefinição; a lista do próprio JoyPro com--no-game-archives(Configurações > Jogos)- Teste no jogo
- 29/29 passos concluídos (2026-10-10)
- ✓ 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 War Thunder fechado
Antes: inicie sessão uma vez. Ligue os seus dispositivos, inicie o jogo e abra Controls uma vez. Depois saia.
Depois: inicie sessão. As suas atribuições estão em Controls.
Já atribuiu botões no War Thunder 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 War Thunder
- Importar: os atalhos e eixos de aeronaves e helicópteros nos seus dispositivos entram no seu perfil, com todos os valores da caixa de diálogo Axis setup do jogo, e as opções de controlo gerais do jogo (sensibilidade, inversão, WEP, autotrim, force feedback).
- Relações: uma relação é uma função em todos os jogos. "Gear" pode ser o mesmo interruptor no War Thunder, no DCS e no IL-2.
- Exportar: o JoyPro edita o
machine.blkno próprio ficheiro. Tanques, navios, submarinos, infantaria e os menus nunca são tocados.
#Importar as suas atribuições do War Thunder
- Abra Iniciar. Se o cartão do War Thunder pedir uma lista de comandos, prima Criar lista: o JoyPro lê as ações de aeronaves e helicópteros dos arquivos do jogo (só leitura; 290 ações). Configurações > Jogos pode desligar isto; o JoyPro usa então a sua própria lista, mais curta.
- Prima Importar no cartão do War Thunder. 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. O acelerador do avião e o coletivo do helicóptero num só eixo não é problema no War Thunder; duas ações de aeronave num só botão já é.
#Exportar para o War Thunder
- Feche o War Thunder. O jogo guarda o ficheiro de vez em quando enquanto está a correr e ao sair, por isso o JoyPro recusa-se a escrever enquanto ele está a correr.
- Abra Exportar e marque o cartão do War Thunder.
- 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 inicie sessão. No hangar, prima Esc e abra Controls. As suas atribuições estão nas secções de aeronaves e helicópteros; a caixa de diálogo Axis setup de um eixo mostra a zona morta, a não linearidade, o multiplicador, a correção e a inversão. As linhas de sensibilidade, o multiplicador de force feedback e o autotrim só aparecem nos modos de controlo Realistic e Full-real. Clicar nos separadores Mouse aim / Simplified / Realistic / Full-real muda o seu modo de controlo, não filtra a lista.
#O que faz sozinho no War Thunder
- Deixe o jogo listar cada dispositivo uma vez. O War Thunder numera os botões e eixos por dispositivo na sua própria tabela. Ligue o dispositivo, inicie o jogo e abra Controls: o jogo adiciona então o dispositivo ao
machine.blk. O JoyPro ignora um dispositivo que o jogo ainda não listou. - Inicie sessão uma vez antes da primeira exportação, para que o ficheiro da sua conta exista.
#Erros comuns
- "War Thunder está em execução": feche o jogo e exporte outra vez.
- Um dispositivo foi ignorado: o jogo não o listou, dois dispositivos ligados partilham o mesmo VID:PID, ou o número de botões ou eixos difere do que o jogo registou (todos os números ficariam errados). Abra Controls no jogo com o dispositivo ligado.
- As atribuições antigas voltaram depois de iniciar sessão: restaurou uma cópia à mão. Use antes Desfazer última exportação: o JoyPro aumenta então a versão do ficheiro, para que o servidor não o substitua.
- Diagonais do hat, botões do rato e modificadores de eixo não podem ser escritos.
#Ficheiros que o JoyPro lê e escreve
| Ficheiro | O que é |
|---|---|
%USERPROFILE%\Documents\My Games\WarThunder\Saves\<uid>\production\machine.blk |
os seus controlos (hotkeys{}, axes{}, params{}, deviceMapping{}) e os blocos de configurações do jogo; <uid> é a sua conta (Saves\lastlogin.blk nomeia-a; Saves\last antes de um login) |
...\production\machine.blk.joypro-meta.json |
Os nomes, grupos e ajustes do JoyPro para as atribuições escritas, lidos de novo pela próxima importação |
machine.blk.jpbak |
a cópia de antes da primeira escrita, mais o arquivo de backups com versões do JoyPro |
uma predefinição de controlos exportada (controls{} no topo) |
também pode ser importado e exportado; as opções globais do jogo só são escritas em machine.blk |
O machine.blk é uma diferença em relação à predefinição base nomeada em basePresetPaths: o primeiro bloco de um atalho substitui toda a lista da predefinição para ele, um ID_X{} vazio significa não atribuído, e um atributo de eixo em falta significa "o valor da predefinição". O JoyPro escreve os blocos de atalhos catalogados, axisId e os valores de eixo dos eixos catalogados, e as chaves de opção individuais que define. Todas as outras linhas mantêm o seu texto; deviceMapping{} é só lido.
#Os modos de exportação no War Thunder
Só contam os controlos catalogados de aeronave e de helicóptero. Um conflito é outro desses controlos na mesma entrada.
| Modo | O que acontece no machine.blk |
|---|---|
| Só adicionar | Um atalho só é escrito quando nenhum outro controlo de aeronave ou helicóptero usa essa entrada; nunca remove um bloco nem substitui um eixo atribuído. As atribuições ignoradas recebem a marca "Não escrito no jogo". |
| Atualizar, manter atribuições do jogo | Os seus atalhos entram ao lado dos outros atalhos do controlo; só os conflitos são removidos (um eixo de outro controlo no seu eixo recebe axisId -1). |
| Atualizar, o meu perfil ganha | Como acima, e um controlo que atribui perde os seus outros atalhos nos dispositivos ligados que o jogo lista (teclado só com a opção de teclado). |
| Substituir nos meus dispositivos | Como acima, e os outros atalhos e eixos de aeronave e helicóptero dos dispositivos escritos são libertados. |
| + Limpar também os meus outros dispositivos | O mesmo para os dispositivos ligados sem atribuições no seu perfil. |
Um ID_X{} vazio é substituído quando o JoyPro atribui o controlo. Um controlo que falta no ficheiro dá um aviso: o seu atalho substitui então a predefinição da predefinição base para ele.
#O que nunca é tocado
- Atalhos e eixos de tanque, navio, submarino, infantaria e menu.
deviceMapping{},config{}e todas as linhas de configuração que o JoyPro não define.- Atribuições de rato, dispositivos que não estão ligados, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
- O teclado, a menos que exporte atribuições de teclado.
- Controlo relativo, manter valor e o intervalo do eixo ficam como estão no ficheiro, a menos que os defina.
#Aeronaves, curvas, opções do jogo
- Granularidade: um conjunto de controlos para todas as aeronaves e um para todos os helicópteros (o jogo não tem atribuições por aeronave).
- Modificadores: o último botão de um atalho é a entrada principal, os outros botões e teclas do bloco são os seus modificadores. Até três alternativas por atalho.
- Curvas de eixo nas unidades próprias do jogo, tal como o diálogo Axis setup as mostra: zona morta (0 a 0.5), não linearidade (0 a 3, mostrada como 1 a 4), multiplicador, correção, inversão, controlo relativo com a sua sensibilidade e passo, manter valor para eixo desativado. Uma relação sem valores do War Thunder recebe a sua curva do JoyPro ajustada: multiplicador = 1 / saturação X, zona morta escalada com ele, a não linearidade mais próxima; num slider, o curso entre a zona morta e a saturação é mapeado para todo o intervalo. Um valor igual ao da predefinição base faz desaparecer a linha, tal como o próprio jogo grava.
- Opções do jogo: sensibilidade de roll, pitch e yaw para aeronaves e para helicópteros, inverter Y (aeronave, helicóptero), inverter acelerador, manter acelerador para WEP, autotrim, force feedback ligado (o jogo precisa de reiniciar) e o seu multiplicador. Defina-as em Configurações > Configurações de force feedback dos jogos (escolha War Thunder) ou com
engine ffb set. Também são escritas por uma exportação sem atribuições do War Thunder; a importação toma os valores do ficheiro. - Cópia na nuvem: ao fazer login, o jogo compara a primeira linha
version:i=Ndo ficheiro com a do servidor. O JoyPro mantém a versão, por isso o seu conteúdo novo é carregado. Desfazer última exportação dá ao ficheiro reposto uma versão acima daquela que substitui, para que a cópia do servidor não volte. - Force feedback por telemetria: a página Force feedback controla o seu manche com force feedback a partir do servidor web local do jogo (
127.0.0.1:8111, servido pelo jogo em execução; nada a configurar). Desligue o force feedback próprio do jogo para esse manche. - Gravação de telemetria: o JoyPro pode gravar uma surtida a partir do mesmo servidor e exportá-la como CSV ou para o Tacview (um mapa plano à volta de 0/0, porque o jogo não tem uma posição geográfica real).
- Monitor de jogos: uma atribuição, valor de eixo ou opção que altera no jogo é detetado depois de ele fechar; teclas reordenadas ou o estilo de diferenças do jogo não contam como alteração.
- HUD: o HUD encontra o jogo pelo seu processo e mostra as suas atribuições do War Thunder.
#Por dentro da integração do War Thunder
flowchart LR
P["O seu perfil<br/>(aeronaves + helicópteros)"] --> E["engine warthunder export"]
M[("deviceMapping<br/>dispositivos que o jogo listou")] --> E
E --> B["machine.blk<br/>atalhos, eixos, opções<br/>(diferença para a predefinição base)"]
B --> L["Próximo login: o seu ficheiro<br/>prevalece (mesma linha de versão);<br/>Controlos no War Thunder"]
Código: engine\Games\WarThunderIntegration.cs, engine\Games\WarThunderVromfs.cs, o modelo de eixo engine\AxisModels\WarThunder.cs e o modelo de configurações engine\FfbModels\WarThunder.cs.
- Dispositivos:
deviceMapping{ joystick{ devId:t="0738:2215" name:t="..." buttonsOffset:i= buttonsCount:i= axesOffset:i= axesCount:i= } }.devIdé o VID:PID do produto DirectInput; o jogo associa os dispositivos só pelodevId, por isso dois dispositivos idênticos fundem-se num só.joyButton= buttonsOffset + índice local (botões, depois quatro por hat: cima, direita, baixo, esquerda);axisId= axesOffset + índice local pela ordem DirectInput (X, Y, Z, Rx, Ry, Rz, dois sliders), depois dois por hat.engine games devicesmostra o que o JoyPro vê por dispositivo. - Formato: texto BLK,
name:type=value, os nomes de bloco repetem-se (analisados como uma lista ordenada), CRLF. Os ficheiros comcontrols.versionabaixo de 5 são antigos e não são lidos. - Lista de comandos:
engine warthunder refresh-dblêshortcutsgroupaircraft.nuteshortcutsgrouphelicopter.nutdegui.vromfs.bine os títulos delang.vromfs.bin(lang/controls.csv), descompactados numa pasta temporária que é apagada a seguir; só ficam os ids e os títulos.--no-game-archives(Configurações > Jogos: desmarque "War Thunder: ler a lista completa de comandos dos arquivos do jogo") usa a lista própria do JoyPro com 116 ações; os ids semID_são eixos.--pathaceita uma pasta com os scripts de controlo como ficheiros simples. - Importar / exportar:
engine warthunder import,engine warthunder scan;engine warthunder export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run. - Predefinições base: sem uma tabela dos valores das predefinições oficiais, a exportação escreve explicitamente cada atributo de eixo afinado (nunca retira uma linha por ser "igual à base"), por isso o ficheiro fica certo seja qual for a predefinição base; a importação usa as predefinições do código para os atributos que o ficheiro não define.
- Opções do jogo:
engine ffb set --device * --game WarThunder --param <key>=<value>(joyFX,forceGain0..100,aileronsMultiplier... em %,invertY,invertYHelicopter,invertT,holdThrottleForWEP,autotrim). - Telemetria:
engine ffb telemetry setupeengine telemetry record; o JoyPro consulta/state20 vezes por segundo e/indicatorsa cada segundo pedido, só enquanto o jogo está a correr.
#Limites conhecidos
- Não é distribuída nenhuma tabela dos valores das predefinições base (veja acima).
- Uma execução do monitor de jogos falhou uma vez uma alteração de "manter acelerador para WEP", e uma sensibilidade foi lida de volta com uma diferença de um.
- São lidos 128 botões e 4 hats por dispositivo; diagonais do hat, botões do rato e modificadores de eixo não são escritos.
- Testes: no jogo
tools\e2e\games\WarThunderSettings.ps1(atribuições em eixos vJoy, os diálogos Axis setup de pitch e throttle, os valores da página Controls e a importação do ficheiro que o jogo reescreveu).
Todas as notas técnicas sobre este jogo (geradas a partir do repositório): war-thunder.md.