JoyPro2 Discord GitHub
Jogos

IL-2 Sturmovik: Great Battles

Mostrar:

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 auxiliar jp.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\*.actions que 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.

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
    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\input do jogo. O IL-2 mostra as suas atribuições em Settings > Key mapping.

#Importar as suas atribuições do IL-2

  1. 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.
  2. 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.
  3. Prima Importar agora. Ver as minhas relações abre o que entrou.
A página Início com os seus jogosA página Início com os seus jogos
A página Início com os seus jogos (As imagens mostram a aplicação em inglês.)

#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

  1. Feche o IL-2. O JoyPro recusa escrever enquanto Il-2.exe estiver a correr.
  2. Abra Exportar. O cartão do IL-2 mostra quantas das suas relações estão atribuídas.
  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 do IL-2.
A página ExportarA página Exportar
A página Exportar
No jogo: O que vê no 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\input ainda não tiver global.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.cfg do 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).
Avançado

#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.map e 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).
Detalhes técnicos internos

#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"]
O IL-2 compila estes ficheiros (data/input: as suas atribuições em global.actions, mantendo a ordem do jogo, nomes e grupos em jp.actions, o número joy de cada dispositivo em devices.txt, as curvas em current.responses e global.pitch) no seu mapeamento de teclas no próximo arranque.

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.txt lista <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-il2 lê os ficheiros *.actions que o jogo escreve (não o jp.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>.jpbak e 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:IL2Game ou family:il2, engine binds tuning preview.
  • Telemetria: engine ffb telemetry setup il2 acrescenta uma linha de endereço 127.0.0.1:41994 à secção telemetrydevice do startup.cfg e nunca altera os endereços de outras ferramentas; --remove repõ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 jogo tools\e2e\games\IL2Game.ps1 (atribuições, 38 de 38 passos) e IL2GameCurves.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.