JoyPro2 Discord GitHub
Jogos

War Thunder

Mostrar:

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.bin por 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.

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 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.blk no próprio ficheiro. Tanques, navios, submarinos, infantaria e os menus nunca são tocados.

#Importar as suas atribuições do War Thunder

  1. 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.
  2. 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.
  3. Prima Importar agora. Ver as minhas relações abre o que entrou.
Configurações > Jogos: onde cada jogo guarda os seus controlos, e a opção da lista do War ThunderConfigurações > Jogos: onde cada jogo guarda os seus controlos, e a opção da lista do War Thunder
Configurações > Jogos: onde cada jogo guarda os seus controlos, e a opção da lista do War Thunder (As imagens mostram a aplicação em inglês.)

#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

  1. 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.
  2. Abra Exportar e marque o cartão do War Thunder.
  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.
A página ExportarA página Exportar
A página Exportar
No jogo: O que vê no War Thunder

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

#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=N do 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.
Detalhes técnicos internos

#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"]
O JoyPro escreve só o que difere da sua predefinição. No próximo login, o seu ficheiro prevalece sobre a cópia do servidor.

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ó pelo devId, 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 devices mostra 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 com controls.version abaixo de 5 são antigos e não são lidos.
  • Lista de comandos: engine warthunder refresh-db lê shortcutsgroupaircraft.nut e shortcutsgrouphelicopter.nut de gui.vromfs.bin e os títulos de lang.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 sem ID_ são eixos. --path aceita 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, forceGain 0..100, aileronsMultiplier ... em %, invertY, invertYHelicopter, invertT, holdThrottleForWEP, autotrim).
  • Telemetria: engine ffb telemetry setup e engine telemetry record; o JoyPro consulta /state 20 vezes por segundo e /indicators a 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.