JoyPro2 Discord GitHub
Jeux

IL-2 Sturmovik: Great Battles

Afficher :

IL-2 Great Battles garde un seul key mapping pour tous les appareils, dans des fichiers texte de l'installation du jeu (data\input). JoyPro lit ce key mapping dans votre profil, vous laisse relier ses actions à vos autres jeux dans des relations ("Gear" dans IL-2 et dans DCS sur le même bouton) et les réécrit. Le jeu compile les fichiers à son lancement, donc rien de JoyPro ne tourne pendant que vous volez.

IL-2 Sturmovik: Great Battles natif (ses propres fichiers d'assignations)
Prise en charge
natif (ses propres fichiers d'assignations)
Commande du moteur
engine il2
Fichier d'assignations
<install>\data\input\*.actions, current.responses, global.pitch, current.devices ; fichier annexe jp.actions
Entrées que le jeu lit
lit 128 boutons, 8 axes, 4 chapeaux par joystick (documenté)
Liste de commandes issue de
les fichiers data\input\*.actions que le jeu écrit
Test en jeu
38/38 étapes réussies (2026-10-11)
  • ✓ Importer
  • ✓ Exporter
  • ✓ Assignations clavier
  • ✓ Modificateurs
  • ✓ Liste de commandes créée sur votre PC
  • ✓ Surveillance des jeux
  • ✓ Courbes d'axe et zones mortes
  • ✓ Paramètres de commandes du jeu
  • ✓ Paramètres de retour de force en jeu
  • ✓ Retour de force par télémétrie
  • ◐ Enregistrement de la télémétrieLa télémétrie du jeu n'a pas de position dans le monde : elle est enregistrée et exportée en CSV, sans trace Tacview (ACMI).
  • ✓ Joystick virtuel (vJoy)
  • ◐ Manette Xbox virtuelle
  • ✓ Fonctions virtuelles
  • ✓ Assistant de configuration / Assignation auto
  • ✓ Cockpits
  • ✓ Aide-mémoires
  • ✓ Test en jeu

D'après la matrice de prise en charge, générée à partir du code du moteur : tous les jeux.

Pour les débutants

#Le faire marcher en 3 étapes

  1. Tout configurer pour moi
    sur la page Accueil
  2. Utiliser ces boutons
    regardez d'abord la liste
  3. Écrire dans mon jeu
    gardez IL-2 fermé

Avant : laissez IL-2 écrire une fois son key mapping. Ouvrez Settings > Key mapping et appuyez sur ACCEPT. Fermez IL-2.

Ensuite : vos assignations sont dans Settings > Key mapping, dans chaque appareil IL-2.

Vous avez déjà assigné des boutons dans IL-2 ? Alors la page Accueil propose Importer, puis combler les vides. Vos assignations restent, et seuls les boutons libres reçoivent de nouveaux rôles. Voir Démarrage rapide : faire marcher mon manche.

#Regarder autour sans suivi de la tête

Pas de TrackIR, pas de VR ? La configuration met les vues rapides sur un chapeau de votre manche : avant, arrière, gauche et droite. Les axes de regard vont sur le mini-stick de votre manette des gaz, si elle en a un. Voir Suivi de la tête et regarder autour.

#Ce que JoyPro fait pour IL-2 Great Battles

  • Importer : chaque action du key mapping placée sur un manche, une manette des gaz, un palonnier ou un panneau arrive dans votre profil, avec les modificateurs, l'inversion d'axe et les lignes de réponse des axes. Les touches clavier arrivent quand vous les demandez.
  • Relations : une relation est une fonction dans tous vos jeux. IL-2 a un seul key mapping pour tous les appareils, donc l'action IL-2 d'une relation marche dans chaque appareil IL-2.
  • Exporter : JoyPro écrit les fichiers de key mapping dans le dossier data\input du jeu. IL-2 affiche vos assignations dans Settings > Key mapping.

#Importer vos assignations IL-2

  1. Ouvrez Démarrer. La carte IL-2 Great Battles affiche l'image du jeu. Si elle demande une liste de commandes, appuyez sur Créer la liste : JoyPro lit les fichiers de key mapping que votre IL-2 a écrits.
  2. Appuyez sur Importer sur la carte. Choisissez Ajouter à mon profil (ou Recommencer à partir de ce jeu) et cochez Prendre aussi les touches du clavier si vous voulez aussi vos touches de vol.
  3. Appuyez sur Importer maintenant. Voir mes relations ouvre ce qui est arrivé.
La page Accueil avec vos jeuxLa page Accueil avec vos jeux
La page Accueil avec vos jeux (Les images montrent l'application en anglais.)

#Créer et vérifier les relations

Sur la page Relations, chaque action IL-2 d'une relation se trouve à côté de la même fonction dans vos autres jeux. Utilisez le parcours des relations pour les réunir, puis appuyez sur Vérifier maintenant sur la page Exporter : cela trouve un bouton qui fait deux choses dans IL-2 avant que le jeu ne le fasse (la vérification).

#Exporter vers IL-2

  1. Fermez IL-2. JoyPro refuse d'écrire tant que Il-2.exe tourne.
  2. Ouvrez Exporter. La carte IL-2 montre combien de ses relations sont assignées.
  3. Gardez Remplacer sur mes périphériques avec Effacer aussi mes autres périphériques si c'est dans JoyPro que vous configurez vos manches. Appuyez sur Exporter maintenant sur la carte IL-2.
La page ExporterLa page Exporter
La page Exporter
Dans le jeu: Ce que vous voyez dans IL-2

Lancez IL-2 et ouvrez Settings > Key mapping. Vos assignations sont dans les lignes d'action de chaque onglet (par exemple Plane controls), sur vos périphériques. Les réponses d'axe écrites par JoyPro sont celles que le jeu utilise à partir de ce lancement. Les valeurs de retour de force et de filtre de bruit réglées par JoyPro s'affichent dans Settings > Input devices.

#Ce que vous faites vous-même dans IL-2

  • Laissez IL-2 écrire une fois son key mapping. Si data\input n'a pas encore de global.actions, ouvrez Settings > Key mapping et appuyez sur ACCEPT. Sans ce fichier, il n'y a rien à importer, et la liste de commandes ne contient que les actions que le jeu a écrites.
  • Pour les valeurs de retour de force et de filtre de bruit : ouvrez une fois Settings > Input devices et appuyez sur ACCEPT, pour que le jeu crée son fichier current.devices. JoyPro modifie ce fichier mais ne le crée pas.
  • Pour le propre retour de force de JoyPro à partir de la télémétrie du jeu, la page Retour de force ajoute l'adresse de JoyPro au startup.cfg du jeu (fermez d'abord IL-2). Puis désactivez le propre retour de force d'IL-2 pour ce manche.

#Pièges courants

  • "IL-2 est en cours d'exécution" : fermez complètement le jeu et exportez à nouveau.
  • Des assignations sur le mauvais périphérique : IL-2 distingue les périphériques par le numéro dans devices.txt. Un périphérique que JoyPro écrit garde son numéro ; un nouveau périphérique reçoit le plus petit numéro libre. Ne renumérotez pas les périphériques dans le jeu entre l'exportation et l'importation.
  • Une assignation manque après « Ajouter seulement » : le bouton était utilisé pour une autre action dans IL-2. La vérification la liste sous « Non écrit dans le jeu » ; exportez avec Mettre à jour ou déplacez l'assignation.
  • Les valeurs de retour de force n'ont pas changé : le jeu n'a pas encore de current.devices (voir plus haut).
Avancé

#Fichiers que JoyPro lit et écrit

Fichier De quoi il s'agit
<install>\data\input\global.actions le key mapping : une ligne par action, `action, input, invert
<install>\data\input\devices.txt la liste des périphériques : numéro, GUID DirectInput et nom de chaque joystick
<install>\data\input\current.responses lignes de réponse des axes par action (centrés, à un seul côté), pour tous les appareils
<install>\data\input\global.pitch la ligne de tangage avec un décalage du centre (créée seulement quand vous en réglez un)
<install>\data\input\jp.actions la copie de JoyPro avec les noms, groupes, modificateurs et réglages des relations, relue par la prochaine importation
<install>\data\input\current.devices Settings > Input devices : le retour de force et le filtre de bruit du joystick (modifiés sur place)
<install>\data\startup.cfg les valeurs du retour de force et l'adresse de télémétrie de JoyPro

current.map est compilé par IL-2 à partir de ces fichiers à chaque lancement ; JoyPro ne l'écrit jamais.

#Les modes d'exportation dans IL-2

Mode Ce qui se passe dans IL-2
Ajouter seulement Rien n'est retiré. Une assignation dont l'entrée est déjà utilisée par IL-2 pour une autre action n'est pas écrite et reçoit une marque « Non écrit dans le jeu ».
Mettre à jour, garder les assignations du jeu Vos assignations entrent ; les autres assignations d'IL-2 restent, sauf une assignation d'une autre action sur une entrée que vous utilisez.
Mettre à jour, mon profil l'emporte Comme ci-dessus, et chaque action que vous assignez perd ses autres entrées (joysticks ; le clavier seulement avec l'option clavier).
Remplacer sur mes périphériques Les joysticks que vous écrivez ne gardent que vos assignations.
+ Effacer aussi mes autres périphériques Les joysticks branchés sans assignation dans votre profil perdent leurs assignations.

global.actions garde l'ordre du jeu ; les nouvelles lignes vont à la fin.

#Ce qui n'est jamais touché

  • Les lignes d'un joystick non branché, les périphériques ignorés de l'importation et le périphérique vJoy alimenté par JoyPro.
  • Les lignes souris (aussi les entrées souris avec des touches du clavier), TrackIR et les lignes avec une entrée que JoyPro ne sait pas lire.
  • Le clavier, sauf si vous exportez des assignations clavier.
  • current.map et les autres fichiers du jeu.

#Appareils, courbes, retour de force

  • Granularité : globale. Un seul key mapping et une ligne de réponse par action couvrent tous les appareils.
  • Courbes d'axe (modèle d'axes il2) : zone morte au centre, zone morte au bord et la courbe ("sensitivity balance") pour les axes centrés ; zones mortes basse et haute pour les axes à un seul côté comme la manette des gaz ; un décalage du centre pour le tangage. La Courbe par défaut est adaptée au modèle d'IL-2 ; vous pouvez aussi en régler une pour IL-2 seulement, ou pour la famille IL-2 (Great Battles et Korea lisent les valeurs l'un de l'autre). L'inversion est écrite sur la ligne de l'action.
  • Réglages du jeu (Paramètres > Paramètres de retour de force des jeux) : filtre de bruit du joystick, retour de force activé, puissance du retour et secousses. Une exportation sans assignations IL-2 les écrit quand même.
  • Retour de force par télémétrie : les effets propres à JoyPro à partir de la sortie de télémétrie du jeu (Retour de force). La même sortie alimente l'enregistrement de la télémétrie (CSV ; la télémétrie n'a pas de position dans le monde, donc pas de piste Tacview).
  • HUD : affiche les assignations IL-2 des boutons appuyés pendant qu'IL-2 tourne (HUD).
  • Surveillance : une assignation que vous changez dans Key mapping est remarquée après la fermeture d'IL-2 ; JoyPro demande s'il doit la reprendre (la surveillance des jeux).
Détails techniques

#Dans l'intégration IL-2

flowchart LR
  P["Votre profil"] --> 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/>(au démarrage)"]
  D --> G
  R --> G
  G --> K["Settings ><br/>Key mapping"]
IL-2 compile ces fichiers (data/input : vos assignations dans global.actions en gardant l'ordre du jeu, les noms et groupes dans jp.actions, le numéro joy de chaque périphérique dans devices.txt, les courbes dans current.responses et global.pitch) dans son assignation des touches à son prochain démarrage.

Code : engine\EngineIl2.cs (importation, exportation, fichiers), engine\EngineIl2DbRefresh.cs (liste de commandes), engine\AxisModels (modèle il2), engine\EngineFfbTelemetry.cs (configuration de la télémétrie).

  • Entrées : joy<N>_b<button, 0-based>, joy<N>_axis_<x|y|z|...>, joy<N>_pov<hat>_<angle>, les touches du clavier par leur nom DirectInput, les paires d'axe comme <input>/<input>, les modificateurs comme <modifier>+<input>. IL-2 numérote les chapeaux à partir de 0, JoyPro à partir de 1 (JOY_BTN_POV1_* est pov0).
  • Périphériques : devices.txt liste <number>,"<GUID>",<name>| ; IL-2 écrit les 8 derniers octets du GUID d'instance DirectInput à l'envers en un seul groupe. Chaque mode garde les numéros déjà listés.
  • Liste de commandes : engine db refresh-il2 lit les fichiers *.actions que le jeu écrit (pas jp.actions) ; les onglets du jeu (Service, Camera controls, Plane controls, Weapons controls ...) sont les catégories. Le jeu n'écrit que les actions qui ont une entrée, donc la liste d'une installation neuve contient environ 376 actions.
  • Importation / exportation : engine il2 import, engine il2 scan, engine il2 export (--mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --ignore-device <d>). Sauvegardes : chaque fichier vers <file>.jpbak et dans le stockage de sauvegardes avant la première écriture.
  • Réglages et courbes : engine ffb set --device * --game IL2Game, engine binds tuning set --scope game:IL2Game ou family:il2, engine binds tuning preview.
  • Télémétrie : engine ffb telemetry setup il2 ajoute une ligne d'adresse 127.0.0.1:41994 à la section telemetrydevice de startup.cfg et ne change jamais les adresses des autres outils ; --remove restaure le fichier octet par octet.
  • Surveillance : engine sync status, engine sync diff (surveillés : global.actions, devices.txt, current.responses, current.devices, startup.cfg).

#Limites connues

  • Les actions sans entrée dans les fichiers du jeu ne sont pas dans une liste de commandes fraîchement construite.
  • Le retour de force propre au jeu doit être désactivé pour un manche qui reçoit le retour de force par télémétrie de JoyPro.
  • Tests : engine\tests\smoke\il2.ps1 ; dans le jeu tools\e2e\games\IL2Game.ps1 (assignations, 38 étapes sur 38) et IL2GameCurves.ps1 (réponses compilées par le jeu, comparées à l'aperçu de JoyPro).

Toutes les notes techniques sur ce jeu (générées à partir du dépôt) : README.md.