JoyPro2 Discord GitHub
Games

IL-2 Sturmovik: Great Battles

Tonen:

IL-2 Great Battles bewaart één key mapping voor alle toestellen, in tekstbestanden in de installatie van de game (data\input). JoyPro leest die key mapping in je profiel, laat je de acties ervan in relaties koppelen aan je andere games ("Gear" in IL-2 en in DCS op dezelfde knop) en schrijft ze terug. De game compileert de bestanden bij het starten, dus tijdens het vliegen draait er niets van JoyPro.

IL-2 Sturmovik: Great Battles rechtstreeks (eigen toewijzingsbestanden)
Ondersteuning
rechtstreeks (eigen toewijzingsbestanden)
Engine-commando
engine il2
Toewijzingsbestand
<install>\data\input\*.actions, current.responses, global.pitch, current.devices; begeleidend bestand jp.actions
Inputs die de game leest
leest 128 knoppen, 8 assen, 4 hats per joystick (gedocumenteerd)
Commandolijst uit
de data\input\*.actions-bestanden die de game schrijft
In-game test
38/38 stappen geslaagd (2026-10-11)
  • ✓ Importeren
  • ✓ Exporteren
  • ✓ Toetsenbordtoewijzingen
  • ✓ Modifiers
  • ✓ Commandolijst gemaakt op je pc
  • ✓ Gamebewaking
  • ✓ Ascurves en dode zones
  • ✓ Bedieningsinstellingen van de game
  • ✓ Force-feedbackinstellingen in de game
  • ✓ Force feedback uit telemetrie
  • ◐ Telemetrie-opnameDe telemetrie van de game heeft geen positie in de wereld: opgenomen en geëxporteerd als CSV, geen Tacview (ACMI)-track.
  • ✓ Virtuele joystick (vJoy)
  • ◐ Virtuele Xbox-pad
  • ✓ Virtuele functies
  • ✓ Installatiewizard / Automatisch toewijzen
  • ✓ Cockpits
  • ✓ Spiekbrieven
  • ✓ In-game test

Uit de ondersteuningstabel, gegenereerd uit de code van de engine: alle games.

Voor beginners

#In 3 stappen aan de slag

  1. Alles voor me instellen
    op de startpagina
  2. Deze knoppen gebruiken
    bekijk eerst de lijst
  3. Naar mijn game schrijven
    houd IL-2 gesloten

Vooraf: laat IL-2 één keer zijn key mapping schrijven. Open Settings > Key mapping en druk op ACCEPT. Sluit IL-2.

Daarna: je toewijzingen staan in Settings > Key mapping, in elk IL-2-toestel.

Heb je eerder knoppen toegewezen in IL-2? Dan biedt de startpagina Importeren, dan gaten vullen aan. Je toewijzingen blijven, en alleen vrije knoppen krijgen nieuwe taken. Zie Snelstart: mijn stick laten werken.

#Rondkijken zonder headtracking

Geen TrackIR, geen VR? De installatie zet de snap views op één hat van je stick: vooruit, achteruit, links en rechts. De kijkassen komen op het ministickje van je throttle, als die er een heeft. Zie Headtracking en rondkijken.

#Wat JoyPro doet voor IL-2 Great Battles

  • Importeren: elke actie van de key mapping die op een stick, throttle, pedalen of paneel zit, komt in je profiel, met modifiers, het omkeren van de as en de rijen voor de asrespons. Toetsenbordtoetsen komen mee als je erom vraagt.
  • Relaties: één relatie is één functie in al je games. IL-2 heeft één key mapping voor elk toestel, dus de IL-2-actie van een relatie werkt in elk IL-2-toestel.
  • Exporteren: JoyPro schrijft de key-mappingbestanden in de map data\input van de game. IL-2 toont je toewijzingen in Settings > Key mapping.

#Je IL-2-toewijzingen importeren

  1. Open Start. De kaart van IL-2 Great Battles toont de afbeelding van de game. Vraagt de kaart om een commandolijst, druk dan op Lijst maken: JoyPro leest de key-mappingbestanden die je IL-2 heeft geschreven.
  2. Druk op Importeren op de kaart. Kies Aan mijn profiel toevoegen (of Opnieuw beginnen vanuit deze game) en vink Neem ook de toetsenbordtoetsen over aan als je je vliegtoetsen ook wilt.
  3. Druk op Nu importeren. Mijn relaties bekijken opent wat er binnenkwam.
De startpagina met je gamesDe startpagina met je games
De startpagina met je games (De afbeeldingen tonen de app in het Engels.)

#Relaties maken en controleren

Op de pagina Relaties staat elke IL-2-actie van een relatie naast dezelfde functie in je andere games. Gebruik de werkwijze voor relaties om ze samen te voegen en druk dan op Nu controleren op de pagina Exporteren: dat vindt een knop die twee dingen doet in IL-2, nog voordat de game dat doet (de controle).

#Exporteren naar IL-2

  1. Sluit IL-2. JoyPro weigert te schrijven zolang Il-2.exe draait.
  2. Open Exporteren. De IL-2-kaart toont hoeveel van zijn relaties zijn toegewezen.
  3. Laat Vervangen op mijn apparaten met Ook mijn andere apparaten wissen staan als je je sticks in JoyPro instelt. Druk op Nu exporteren op de IL-2-kaart.
De pagina ExporterenDe pagina Exporteren
De pagina Exporteren
In de game: Wat je ziet in IL-2

Start IL-2 en open Settings > Key mapping. Je toewijzingen staan in de actierijen van elk tabblad (bijvoorbeeld Plane controls), op je apparaten. De asrespons die JoyPro schreef, gebruikt de game vanaf deze start. De waarden voor force feedback en ruisfilter die JoyPro instelde, staan op Settings > Input devices.

#Wat je zelf doet in IL-2

  • Laat IL-2 één keer zijn key mapping schrijven. Heeft data\input nog geen global.actions, open dan Settings > Key mapping en druk op ACCEPT. Zonder dat bestand is er niets om te importeren, en bevat de commandolijst alleen de acties die de game heeft geschreven.
  • Voor waarden voor force feedback en ruisfilter: open één keer Settings > Input devices en druk op ACCEPT, zodat de game zijn bestand current.devices maakt. JoyPro wijzigt dat bestand, maar maakt het niet aan.
  • Voor de eigen force feedback van JoyPro uit de telemetrie van de game voegt de pagina Force feedback het adres van JoyPro toe aan startup.cfg van de game (sluit eerst IL-2). Zet dan de eigen force feedback van IL-2 uit voor die stick.

#Veelgemaakte fouten

  • "IL-2 draait": sluit de game helemaal af en exporteer opnieuw.
  • Toewijzingen op het verkeerde apparaat: IL-2 onderscheidt apparaten aan het nummer in devices.txt. Een apparaat dat JoyPro schrijft, houdt zijn nummer; een nieuw apparaat krijgt het laagste vrije nummer. Nummer apparaten in de game niet opnieuw tussen export en import.
  • Een toewijzing ontbreekt na "Alleen toevoegen": de knop werd in IL-2 voor een andere actie gebruikt. De controle toont die onder "Niet in de game geschreven"; exporteer met Bijwerken of verplaats de toewijzing.
  • De waarden voor force feedback zijn niet veranderd: de game heeft nog geen current.devices (zie hierboven).
Geavanceerd

#Bestanden die JoyPro leest en schrijft

Bestand Wat het is
<install>\data\input\global.actions de key mapping: één regel per actie, `action, input, invert
<install>\data\input\devices.txt de apparatenlijst: nummer, DirectInput-GUID en naam van elke joystick
<install>\data\input\current.responses asresponsrijen per actie (gecentreerd, eenzijdig), voor alle toestellen
<install>\data\input\global.pitch de pitchrij met een middenverschuiving (alleen aangemaakt als je er een instelt)
<install>\data\input\jp.actions de kopie van JoyPro met namen van relaties, groepen, modifiers en afstemming, teruggelezen bij de volgende import
<install>\data\input\current.devices Settings > Input devices: force feedback en het ruisfilter van de joystick (ter plekke gewijzigd)
<install>\data\startup.cfg force-feedbackwaarden en het telemetrieadres van JoyPro

current.map wordt bij elke start door IL-2 uit deze bestanden gecompileerd; JoyPro schrijft het nooit.

#De exportmodi in IL-2

Modus Wat er in IL-2 gebeurt
Alleen toevoegen Er wordt niets verwijderd. Een toewijzing waarvan IL-2 de input al voor een andere actie gebruikt, wordt niet geschreven en krijgt de markering "Niet in de game geschreven".
Bijwerken, toewijzingen van game behouden Je toewijzingen gaan erin; de andere toewijzingen van IL-2 blijven, behalve een toewijzing van een andere actie op een input die jij gebruikt.
Bijwerken, mijn profiel wint Zoals hierboven, en elke actie die je toewijst, verliest haar andere inputs (joysticks; het toetsenbord alleen met de toetsenbordoptie).
Vervangen op mijn apparaten De joysticks die je schrijft, houden alleen jouw toewijzingen.
+ Ook mijn andere apparaten wissen Aangesloten joysticks zonder toewijzing in je profiel verliezen hun toewijzingen.

global.actions houdt de volgorde van de game; nieuwe regels komen aan het eind.

#Wat nooit wordt aangeraakt

  • Regels van een joystick die niet is aangesloten, de genegeerde apparaten van de import en het vJoy-apparaat waar JoyPro doorheen tunnelt.
  • Muisregels (ook muisinputs met toetsen), TrackIR en regels met een input die JoyPro niet kan lezen.
  • Het toetsenbord, tenzij je toetsenbordtoewijzingen exporteert.
  • current.map en de andere bestanden van de game.

#Toestellen, curves, force feedback

  • Granulariteit: globaal. Eén key mapping en één responsrij per actie gelden voor elk toestel.
  • As-curves (asmodel il2): dode zone in het midden, dode zone aan de rand en de curve ("sensitivity balance") voor gecentreerde assen; lage en hoge dode zones voor eenzijdige assen zoals de throttle; een middenverschuiving voor pitch. De Standaardcurve wordt aangepast aan het model van IL-2; je kunt er ook een instellen voor alleen IL-2, of voor de IL-2-familie (Great Battles en Korea lezen elkaars waarden). Omkeren wordt op de regel van de actie geschreven.
  • Game-instellingen (Instellingen > Force-feedbackinstellingen van de games): ruisfilter van de joystick, force feedback aan, feedbackkracht en schudden. Een export zonder toewijzingen voor IL-2 schrijft ze toch.
  • Force feedback uit telemetrie: de eigen effecten van JoyPro uit de telemetrie-uitvoer van de game (Force feedback). Dezelfde uitvoer voedt de telemetrie-opname (CSV; de telemetrie heeft geen positie in de wereld, dus geen Tacview-track).
  • HUD: toont de IL-2-toewijzingen van de ingedrukte knoppen terwijl IL-2 draait (HUD).
  • Bewaking: een toewijzing die je in Key mapping wijzigt, wordt opgemerkt nadat IL-2 is afgesloten; JoyPro vraagt of je die wilt overnemen (de gamebewaking).
Technische details

#Binnen in de IL-2-koppeling

flowchart LR
  P["Je profiel"] --> 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/>(bij de start)"]
  D --> G
  R --> G
  G --> K["Settings ><br/>Key mapping"]
IL-2 compileert deze bestanden (data/input: je toewijzingen in global.actions met de volgorde van de game behouden, namen en groepen in jp.actions, het joy-nummer per apparaat in devices.txt, de curves in current.responses en global.pitch) bij de volgende start tot zijn key mapping.

Code: engine\EngineIl2.cs (importeren, exporteren, bestanden), engine\EngineIl2DbRefresh.cs (commandolijst), engine\AxisModels (model il2), engine\EngineFfbTelemetry.cs (telemetrie instellen).

  • Inputs: joy<N>_b<button, 0-based>, joy<N>_axis_<x|y|z|...>, joy<N>_pov<hat>_<angle>, toetsen op hun DirectInput-naam, asparen als <input>/<input>, modifiers als <modifier>+<input>. IL-2 nummert hats vanaf 0, JoyPro vanaf 1 (JOY_BTN_POV1_* is pov0).
  • Apparaten: devices.txt bevat <number>,"<GUID>",<name>|; IL-2 schrijft de laatste 8 bytes van de DirectInput-instance-GUID omgekeerd als één groep. Elke modus houdt de nummers die er al staan.
  • Commandolijst: engine db refresh-il2 leest de *.actions-bestanden die de game schrijft (niet jp.actions); de tabbladen van de game (Service, Camera controls, Plane controls, Weapons controls ...) zijn de categorieën. De game schrijft alleen acties die een input hebben, dus de lijst van een verse installatie bevat ongeveer 376 acties.
  • Importeren / exporteren: engine il2 import, engine il2 scan, engine il2 export (--mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --ignore-device <d>). Back-ups: elk bestand naar <file>.jpbak en naar de back-upopslag vóór de eerste keer schrijven.
  • Instellingen en curves: engine ffb set --device * --game IL2Game, engine binds tuning set --scope game:IL2Game of family:il2, engine binds tuning preview.
  • Telemetrie: engine ffb telemetry setup il2 voegt één adresregel 127.0.0.1:41994 toe aan de sectie telemetrydevice van startup.cfg en wijzigt nooit de adressen van andere tools; --remove zet het bestand byte voor byte terug.
  • Bewaking: engine sync status, engine sync diff (bewaakt: global.actions, devices.txt, current.responses, current.devices, startup.cfg).

#Bekende beperkingen

  • Acties zonder input in de bestanden van de game staan niet in een vers opgebouwde commandolijst.
  • De eigen force feedback van de game moet uit staan voor een stick die de force feedback uit telemetrie van JoyPro krijgt.
  • Tests: engine\tests\smoke\il2.ps1; in de game tools\e2e\games\IL2Game.ps1 (toewijzingen, 38 van 38 stappen) en IL2GameCurves.ps1 (door de game gecompileerde responsen vergeleken met het voorbeeld van JoyPro).

Alle technische notities over deze game (gegenereerd uit de repository): README.md.