O IL-2 Great Battles guarda um mapeamento de teclas para todas as aeronaves, em ficheiros de texto dentro da instalação do jogo (data\input). O JoyPro lê esse mapeamento de teclas para o seu perfil, permite-lhe juntar as suas ações com os seus outros jogos em relações ("Gear" no IL-2 e no DCS no mesmo botão) e escreve-as de volta. O jogo compila os ficheiros quando arranca, por isso nada do JoyPro corre enquanto voa.
IL-2 Sturmovik: Great Battles nativo (os seus próprios ficheiros de atribuições)
- Suporte
- nativo (os seus próprios ficheiros de atribuições)
- Comando do motor
engine il2- Ficheiro de atribuições
<install>\data\input\*.actions,current.responses,global.pitch,current.devices; ficheiro auxiliarjp.actions- Entradas que o jogo lê
- lê 128 botões, 8 eixos, 4 hats por joystick (documentado)
- Lista de comandos a partir de
- os ficheiros
data\input\*.actionsque o jogo escreve - Teste no jogo
- 38/38 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 jogo
- ✓ Force feedback a partir da telemetria
- ◐ Gravação de telemetriaA telemetria do jogo não tem posição no mundo: é gravada e exportada como CSV, sem trajeto Tacview (ACMI).
- ✓ 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
com o IL-2 fechado
Antes: deixe o IL-2 escrever o seu mapeamento de teclas uma vez. Abra Settings > Key mapping e prima ACCEPT. Feche o IL-2.
Depois: as suas atribuições estão em Settings > Key mapping, em todas as aeronaves do IL-2.
Já atribuiu botões no IL-2 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.
#Olhar à volta sem head tracking
Sem TrackIR, sem VR? A configuração põe as vistas rápidas num hat do seu manche: para a frente, para trás, para a esquerda e para a direita. Os eixos de olhar vão para o mini-stick do seu acelerador, se tiver um. Veja Head tracking e olhar à volta.
#O que o JoyPro faz pelo IL-2 Great Battles
- Importar: cada ação do mapeamento de teclas que está num manche, acelerador, pedais ou painel entra no seu perfil, com os modificadores, a inversão dos eixos e as linhas de resposta dos eixos. As teclas do teclado entram quando as pede.
- Relações: uma relação é uma função em todos os seus jogos. O IL-2 tem um mapeamento de teclas para todas as aeronaves, por isso a ação do IL-2 de uma relação funciona em todas as aeronaves do IL-2.
- Exportar: o JoyPro escreve os ficheiros de mapeamento de teclas na pasta
data\inputdo jogo. O IL-2 mostra as suas atribuições em Settings > Key mapping.
#Importar as suas atribuições do IL-2
- Abra Iniciar. O cartão do IL-2 Great Battles mostra a imagem do jogo. Se pedir uma lista de comandos, prima Criar lista: o JoyPro lê os ficheiros de mapeamento de teclas que o seu IL-2 escreveu.
- Prima Importar no cartão. Escolha Adicionar ao meu perfil (ou Recomeçar a partir deste jogo) e marque Aceitar também as teclas do teclado se também quiser as suas teclas de voo.
- Prima Importar agora. Ver as minhas relações abre o que entrou.


#Criar e verificar relações
Na página Relações, cada ação do IL-2 de uma relação fica ao lado da mesma função nos seus outros jogos. Use o fluxo das relações para as juntar e depois prima Verificar agora na página Exportar: encontra um botão que faz duas coisas no IL-2 antes de o jogo o fazer (a Verificação).
#Exportar para o IL-2
- Feche o IL-2. O JoyPro recusa escrever enquanto
Il-2.exeestiver a correr. - Abra Exportar. O cartão do IL-2 mostra quantas das suas relações estão atribuídas.
- 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 do IL-2.


Inicie o IL-2 e abra Settings > Key mapping. As suas atribuições estão nas linhas de ações de cada separador (por exemplo Plane controls), nos seus dispositivos. As respostas de eixo que o JoyPro escreveu são as que o jogo usa a partir deste arranque. Os valores de force feedback e de filtro de ruído que o JoyPro definiu aparecem em Settings > Input devices.
#O que faz você mesmo no IL-2
- Deixe o IL-2 escrever o seu mapeamento de teclas uma vez. Se
data\inputainda não tiverglobal.actions, abra Settings > Key mapping e prima ACCEPT. Sem esse ficheiro não há nada para importar, e a lista de comandos só contém as ações que o jogo escreveu. - Para os valores de force feedback e de filtro de ruído: abra Settings > Input devices uma vez e prima ACCEPT, para que o jogo crie o seu ficheiro
current.devices. O JoyPro altera esse ficheiro, mas não o cria. - Para o force feedback próprio do JoyPro a partir da telemetria do jogo, a página Force Feedback adiciona o endereço do JoyPro ao
startup.cfgdo jogo (feche primeiro o IL-2). Depois desligue o force feedback do próprio IL-2 para esse manche.
#Erros comuns
- "O IL-2 está a correr": feche o jogo por completo e exporte outra vez.
- Atribuições no dispositivo errado: o IL-2 distingue os dispositivos pelo número em
devices.txt. Um dispositivo que o JoyPro escreve mantém o seu número; um dispositivo novo recebe o número livre mais baixo. Não renumere dispositivos no jogo entre a exportação e a importação. - Falta uma atribuição depois de "Só adicionar": o botão era usado para outra ação no IL-2. A Verificação lista-a em "Não escrito no jogo"; exporte com Atualizar ou mova a atribuição.
- Os valores de force feedback não mudaram: o jogo ainda não tem
current.devices(veja acima).
#Ficheiros que o JoyPro lê e escreve
| Ficheiro | O que é |
|---|---|
<install>\data\input\global.actions |
o mapeamento de teclas: uma linha por ação, `action, input, invert |
<install>\data\input\devices.txt |
a lista de dispositivos: número, GUID DirectInput e nome de cada joystick |
<install>\data\input\current.responses |
linhas de resposta dos eixos por ação (centrado, de um só lado), para todas as aeronaves |
<install>\data\input\global.pitch |
a linha da picada com um desvio do centro (só criada quando define um) |
<install>\data\input\jp.actions |
A cópia do JoyPro com os nomes das relações, grupos, modificadores e ajustes, lida de novo pela próxima importação |
<install>\data\input\current.devices |
Settings > Input devices: force feedback e o filtro de ruído do joystick (alterados no próprio sítio) |
<install>\data\startup.cfg |
os valores de force feedback e o endereço de telemetria do JoyPro |
O current.map é compilado pelo IL-2 a partir destes ficheiros a cada arranque; o JoyPro nunca o escreve.
#Os modos de exportação no IL-2
| Modo | O que acontece no IL-2 |
|---|---|
| Só adicionar | Nada é removido. Uma atribuição cuja entrada o IL-2 já usa para outra ação não é escrita e recebe uma marca "Não escrito no jogo". |
| Atualizar, manter atribuições do jogo | As suas atribuições entram; as outras atribuições do IL-2 ficam, exceto a atribuição de outra ação numa entrada que usa. |
| Atualizar, o meu perfil ganha | Como acima, e cada ação que atribui perde as suas outras entradas (joysticks; o teclado só com a opção de teclado). |
| Substituir nos meus dispositivos | Os joysticks que escreve ficam só com as suas atribuições. |
| + Limpar também os meus outros dispositivos | Os joysticks ligados sem atribuições no seu perfil perdem as suas atribuições. |
O global.actions mantém a ordem do jogo; as linhas novas vão para o fim.
#O que nunca é tocado
- As linhas de um joystick que não está ligado, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
- As linhas do rato (também entradas do rato com teclas do teclado), o TrackIR e as linhas com uma entrada que o JoyPro não consegue ler.
- O teclado, a menos que exporte atribuições de teclado.
- O
current.mape os outros ficheiros do jogo.
#Aeronaves, curvas, force feedback
- Granularidade: global. Um mapeamento de teclas e uma linha de resposta por ação cobrem todas as aeronaves.
- Curvas de eixo (modelo de eixos
il2): zona morta central, zona morta nas pontas e a curva ("sensitivity balance") para eixos centrados; zonas mortas baixa e alta para eixos de um só lado, como o acelerador; um desvio do centro para a picada. A Curva predefinida é ajustada ao modelo do IL-2; também pode definir uma só para o IL-2 ou para a família IL-2 (o Great Battles e o Korea leem os valores um do outro). A inversão é escrita na linha da ação. - Configurações do jogo (Configurações > Configurações de force feedback dos jogos): filtro de ruído do joystick, force feedback ligado, força do feedback e vibração. Uma exportação sem atribuições do IL-2 escreve-as na mesma.
- Force feedback por telemetria: os efeitos próprios do JoyPro a partir da saída de telemetria do jogo (Force feedback). A mesma saída alimenta a gravação de telemetria (CSV; a telemetria não tem posição no mundo, por isso não há trajeto Tacview).
- HUD: mostra as atribuições do IL-2 dos botões premidos enquanto o IL-2 corre (HUD).
- Monitor de jogos: uma atribuição que mude em Key mapping é detetada depois de o IL-2 fechar; o JoyPro pergunta se a deve adotar (o monitor de jogos).
#Por dentro da integração do IL-2
flowchart LR P["O seu perfil"] --> E["engine il2 export"] E --> A["global.actions<br/>+ jp.actions"] E --> D["devices.txt"] E --> R["current.responses<br/>global.pitch"] A --> G["current.map<br/>(ao arrancar)"] D --> G R --> G G --> K["Settings ><br/>Key mapping"]
Código: engine\EngineIl2.cs (importação, exportação, ficheiros), engine\EngineIl2DbRefresh.cs (lista de comandos), engine\AxisModels (modelo il2), engine\EngineFfbTelemetry.cs (configuração da telemetria).
- Entradas:
joy<N>_b<button, 0-based>,joy<N>_axis_<x|y|z|...>,joy<N>_pov<hat>_<angle>, teclas do teclado pelo nome DirectInput, pares de eixo como<input>/<input>, modificadores como<modifier>+<input>. O IL-2 numera os hats a partir de 0, o JoyPro a partir de 1 (JOY_BTN_POV1_*épov0). - Dispositivos:
devices.txtlista<number>,"<GUID>",<name>|; o IL-2 escreve os últimos 8 bytes do GUID de instância DirectInput invertidos, como um só grupo. Todos os modos mantêm os números já listados. - Lista de comandos:
engine db refresh-il2lê os ficheiros*.actionsque o jogo escreve (não ojp.actions); os separadores do jogo (Service, Camera controls, Plane controls, Weapons controls ...) são as categorias. O jogo só escreve ações que têm uma entrada, por isso a lista de uma instalação nova tem cerca de 376 ações. - Importação / exportação:
engine il2 import,engine il2 scan,engine il2 export(--mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --ignore-device <d>). Backups: cada ficheiro para<file>.jpbake para o arquivo de backups antes da primeira escrita. - Configurações e curvas:
engine ffb set--device * --game IL2Game,engine binds tuning set--scope game:IL2Gameoufamily:il2,engine binds tuning preview. - Telemetria:
engine ffb telemetry setupil2acrescenta uma linha de endereço127.0.0.1:41994à secçãotelemetrydevicedostartup.cfge nunca altera os endereços de outras ferramentas;--removerepõe o ficheiro byte a byte. - Monitor de jogos:
engine sync status,engine sync diff(monitorizados:global.actions,devices.txt,current.responses,current.devices,startup.cfg).
#Limites conhecidos
- As ações sem entrada nos ficheiros do jogo não estão numa lista de comandos acabada de criar.
- O force feedback próprio do jogo tem de estar desligado para um manche que recebe o force feedback por telemetria do JoyPro.
- Testes:
engine\tests\smoke\il2.ps1; no jogotools\e2e\games\IL2Game.ps1(atribuições, 38 de 38 passos) eIL2GameCurves.ps1(respostas compiladas pelo jogo comparadas com a pré-visualização do JoyPro).
Todas as notas técnicas sobre este jogo (geradas a partir do repositório): README.md.