JoyPro2 Discord GitHub
Engine (CLI)

engine il2 (IL-2 Sturmovik: Great Battles)

Show:

3 commands of engine il2. Each with every option and every value it takes, what it does, which GUI buttons use it, and an example.

#engine il2 scan

written
engine il2 scan [<il2-root-path>] [--path <il2-root-path>] [--device <name>] [--devices <csv>] [--ignore-device <name>] [--ignore-devices <csv>] [--import-inverted] [--import-curvature] [--import-deadzone] [--confirm true|false]
For beginners

Shows what engine il2 import would bring from IL-2 Great Battles with the same options, without changing the profile or the game. On the Start page Look first in the import wizard and Scan in the expert import run it.

engine il2 scan "D:\Games\IL-2 Sturmovik Battle of Stalingrad" --text
Advanced
  • The path is the IL-2 folder (positional or --path); without one the installation is detected (Auto-detected IL2 root path: ... on stderr).
  • --device / --devices, --ignore-device / --ignore-devices, --import-inverted, --import-curvature, --import-deadzone and --confirm work as in engine il2 import.
  • Reads only. Refused when IL-2 is not installed.
Technical internals
  • Output: JSON of the scan, or a text report with --text. Exit code 0; 1 with il2 scan failed: ... (for example Missing global.actions: <file>) or without a path (il2 scan requires an IL2 root path. Try: engine games paths --game IL2 --text).
  • Save options (--save-profile, --save-last) and --mode are refused here.

What it does Parses IL2 input files and previews import results.

OptionValuesMeaning
--path<il2-root-path>Optional explicit path override. Use when you prefer option form over positional path.
--device<name>Include one device per flag. Example: --device LEFT VPC Throttle.
--devices<csv>Include devices as CSV. Example: --devices VKB Gladiator NXT,LEFT VPC Throttle.
--ignore-device<name>Exclude one device per flag. Example: --ignore-device Keyboard.
--ignore-devices<csv>Exclude devices, separated by commas, | or ;. Example: --ignore-devices Keyboard,Mouse.
--import-invertedswitch (no value)Include axis inversion settings.
--import-curvatureswitch (no value)Include axis curvature settings.
--import-deadzoneswitch (no value)Include axis deadzone settings.
--confirmtrue falseControls suggestion confirmation (true) vs auto-accept (false).
Every value as a command line
engine il2 scan --confirm true
engine il2 scan --confirm false

In the game Reads IL-2 Sturmovik: Great Battles's files only; nothing changes in the game. A scan only shows what an import would bring and does not change the profile. IL-2 Sturmovik: Great Battles details · what each mode changes

Used by the GUI Start: Look first · Start: Scan

Example

engine il2 scan 'D:\Games\IL-2 Sturmovik Great Battles' --ignore-device 'Keyboard' --text
How the options interact
  • If no device include filter is given, all devices are considered.
  • Ignore filters (--ignore-device, --ignore-devices) remove matches even if included.
  • --confirm false auto-accepts closest suggested device names.

#engine il2 import

written
engine il2 import [<il2-root-path>] [--path <il2-root-path>] [--merge] [--save-profile <path.pr0file>] [--save-last] [--device <name>] [--devices <csv>] [--ignore-device <name>] [--ignore-devices <csv>] [--import-inverted] [--import-curvature] [--import-deadzone] [--confirm true|false]
For beginners

Reads the binds you made in IL-2 Great Battles into your JoyPro profile, one relation per action and input. Nothing in IL-2 changes. Import now in the Start page's import wizard and Import in the expert import run it.

engine il2 import "D:\Games\IL-2 Sturmovik Battle of Stalingrad" --merge --import-inverted --profile "C:\Users\Pilot\Documents\JoyPro\My Sticks.pr0file"
Advanced

Reads data\input of the IL-2 folder: global.actions (required), devices.txt, current.responses (axis responses) and JoyPro's own jp.actions (relation names and groups of an earlier export).

  • --merge adds to the open profile (an action that fits an existing relation joins it); without it the import replaces the profile's relations and binds.
  • New relations get the group IL2 unless jp.actions names groups.
  • --device / --devices limit the import to these devices; --ignore-device / --ignore-devices leave devices out (the --vjoy-tunnel device is always left out). A name that does not match exactly is resolved to the closest device; --confirm false takes it without asking.
  • --import-inverted, --import-curvature, --import-deadzone bring that axis setting into the profile.
  • Safety: reads only; refused when IL-2 is not installed; the profile is kept as the version "Before import from IL-2" first.
Technical internals

What it does Parses IL2 input files and applies results to the in-memory profile.

OptionValuesMeaning
--path<il2-root-path>Optional explicit path override. Use when you prefer option form over positional path.
--mergeswitch (no value)Merge import results into existing in-memory profile.
--save-profile<path.pr0file>After import, save profile to this .pr0file path.
--save-lastswitch (no value)After import, save to last profile path.
--device<name>Include one device per flag. Example: --device LEFT VPC Throttle.
--devices<csv>Include devices as CSV. Example: --devices VKB Gladiator NXT,LEFT VPC Throttle.
--ignore-device<name>Exclude one device per flag. Example: --ignore-device Keyboard.
--ignore-devices<csv>Exclude devices, separated by commas, | or ;. Example: --ignore-devices Keyboard,Mouse.
--import-invertedswitch (no value)Include axis inversion settings.
--import-curvatureswitch (no value)Include axis curvature settings.
--import-deadzoneswitch (no value)Include axis deadzone settings.
--confirmtrue falseControls suggestion confirmation (true) vs auto-accept (false).
Every value as a command line
engine il2 import --confirm true
engine il2 import --confirm false

In the game Reads IL-2 Sturmovik: Great Battles's files only; nothing changes in the game. The binds come into the profile as relations; JoyPro's own data next to the game file brings back names, groups, modifiers and curves. IL-2 Sturmovik: Great Battles details · what each mode changes

Used by the GUI Start: Import now · Start: Import

Example

engine il2 import 'D:\Games\IL-2 Sturmovik Great Battles' --devices 'VKB Gladiator NXT,LEFT VPC Throttle' --save-last --text
How the options interact
  • If no device include filter is given, all devices are considered.
  • Ignore filters (--ignore-device, --ignore-devices) remove matches even if included.
  • --confirm false auto-accepts closest suggested device names.
  • --save-profile and --save-last are valid on import commands only.

#engine il2 export

written
engine il2 export [<il2-root-path>] [--path <il2-root-path>] [--mode clean|add|merge|merge-overwrite] [--nuke-untouched-devices true|false] [--ignore-device <name>] [--ignore-devices <csv>]

--ignore-device(s) and --vjoy-tunnel devices are never cleared; add never removes and skips a bind whose input the game uses for another action; merge also removes the game's bind on an input the profile gives another action; merge-overwrite also takes the profile's actions off their other inputs; clean releases the other binds of the written devices, nuke the connected joysticks the profile does not use; mouse lines, lines JoyPro cannot read and devices that are not connected stay

For beginners

Writes your profile's binds into IL-2 Great Battles. Use it after you changed binds in JoyPro; close IL-2 first. The Export page's Export now on the IL-2 card runs it.

engine il2 export "D:\Games\IL-2 Sturmovik Battle of Stalingrad" --mode clean --nuke-untouched-devices true --profile "C:\Users\Pilot\Documents\JoyPro\My Sticks.pr0file" --text
Advanced

Writes the profile into IL-2's data\input files (global.actions keeps its order, new lines at the end; the axis responses) and JoyPro's jp.actions.

  • --mode: add never removes and skips a bind whose input the game uses for another action; merge also removes the game's bind on an input the profile gives another action; merge-overwrite also takes the profile's actions off their other inputs; clean releases the other binds of the written devices.
  • --nuke-untouched-devices true also clears the connected joysticks the profile does not use.
  • Never touched: mouse lines, lines JoyPro cannot read, devices that are not connected, devices passed with --ignore-device(s) and the --vjoy-tunnel device.
  • Safety: refused while IL-2 runs; every file is backed up first (undo: engine backups restore); the profile is kept as the version "Before export to IL-2".
Technical internals

What it does Exports current profile mappings to IL2-compatible files.

OptionValuesMeaning
--path<il2-root-path>Optional explicit path override. Use when you prefer option form over positional path.
--modeclean add merge merge-overwriteExport mode for DCS/IL2 export commands: clean, add, merge, merge-overwrite.
--nuke-untouched-devicestrue falseDCS export only: delete untouched device .diff.lua/.jp files under Config\\Input (true/false).
--ignore-device<name>Exclude one device per flag. Example: --ignore-device Keyboard.
--ignore-devices<csv>Exclude devices, separated by commas, | or ;. Example: --ignore-devices Keyboard,Mouse.
Every value as a command line
engine il2 export --mode clean
engine il2 export --mode add
engine il2 export --mode merge
engine il2 export --mode merge-overwrite
engine il2 export --nuke-untouched-devices true
engine il2 export --nuke-untouched-devices false

In the game Writes into IL-2 Sturmovik: Great Battles's control files while the game is closed (refused while it runs), after a backup. Combat flight sims and combat flight games that read several joysticks. Bind file: <install>\data\input\*.actions, current.responses, global.pitch, current.devices; jp.actions sidecar. IL-2 Sturmovik: Great Battles details · what each mode changes

Used by the GUI Start: Export · Export: Preview · Export: Export now · Export: Export IL-2

Example

engine il2 export 'D:\Games\IL-2 Sturmovik Great Battles' --mode merge-overwrite --text
How the options interact
  • Import-only filters/settings are not valid for export commands.
  • --mode is valid for DCS export and IL2 export.