JoyPro2 Discord GitHub
Engine (CLI)

engine il2codblitz (IL-2 Sturmovik: Cliffs of Dover Blitz)

Show:

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

#engine il2codblitz paths

written
engine il2codblitz paths
For beginners

Shows where JoyPro finds the binds of IL-2 Sturmovik: Cliffs of Dover Blitz on this PC: %USERPROFILE%\Documents\1C SoftClub\il-2 sturmovik cliffs of dover\confUser.ini; Blitz creates the folder on its first start. Detect in the import wizard's Expert import section runs it.

engine il2codblitz paths --text
Advanced
  • No options. Listed: your own config location of engine games config set first, then confUser.ini when it exists. Blitz and the original game share this file.
  • Read-only; also works when the game is not installed or switched off.
Technical internals
  • Output: JSON (Game, DisplayName, ConfigPaths, Warnings), or with --text IL-2 Sturmovik: Cliffs of Dover Blitz Config Paths, Paths: <n> and the file. Exit code 0; an unknown option fails with Unknown IL2CoDBlitz paths argument(s): ....
  • Related: engine il2codblitz scan, engine il2cod paths; game page il2-cliffs-of-dover.

What it does Lists where JoyPro looks for this game's controls on this machine: files, folders or registry keys (your config location from games config set first). A file the game has not written yet can be listed (e.g. Arma Reforger's JoyPro.conf, Project Wingman's Input.ini).

Example

engine il2codblitz paths --text

#engine il2codblitz catalog

written
engine il2codblitz catalog
For beginners

Lists the Cliffs of Dover Blitz commands JoyPro knows: the game's command names per section (pilotMove.aileron, ...), with axis or button and category.

engine il2codblitz catalog --text
Advanced
  • No options; read-only, also when the game is not installed.
  • Categories follow the game's sections: Axes, Aircraft, Common, Gunner, Views, Time, Orders, Game and Vehicle (the ground vehicles). Only pilotMove holds axes.
  • A fresh install has no list yet; the first scan, import, export or engine il2codblitz refresh-db builds it. Until then the command lists no action and warns IL-2 Sturmovik: Cliffs of Dover Blitz action catalog not found: <path>.
Technical internals
  • Output: JSON (Game, Source, Actions with Id, Title, IsAxis, Category, Warnings), or with --text one line per action <id> | axis|button | <category> | <title>; an id is <section>.<command>. Exit code 0.
  • File: %LOCALAPPDATA%\JoyPro2\GameData\DB\IL2CoDBlitz\actions.tsv.
  • Related: engine il2codblitz refresh-db, engine il2cod catalog; game page il2-cliffs-of-dover.

What it does Lists every action of JoyPro's command list of this game with its kind and category: <data>\GameData\DB\<Game>\actions.tsv, else the program folder's DB\<Game>.

Example

engine il2codblitz catalog --text

#engine il2codblitz scan

written
engine il2codblitz scan [<config-path>] [--path <config-path>] [--ignore-device <name>] [--ignore-devices <csv>]
For beginners

Shows the binds of Cliffs of Dover Blitz in confUser.ini, joystick and keyboard, with chords as modifiers, without changing your profile or the game. Look first in the import wizard runs it.

engine il2codblitz scan --text
Advanced
  • Reads the [HotKey <section>] lines of the file engine il2codblitz paths lists, or of the file given (positional or --path). Inputs held together with the firing one are shown as modifiers.
  • Blitz names a device <product name>-<id>: JoyPro matches name and id, else the name when only one connected device has it. A device it cannot match gives one warning.
  • Keys are listed without --include-keyboard (the import takes them only with it). The axis settings of [Config pilotMove] are read but not listed. A command that is not in the list yet gets a warning naming engine il2codblitz refresh-db.
  • --ignore-device <name> / --ignore-devices <a;b> leave the binds of those devices out.
  • Safety: reads only, also while the game runs; a fresh install first builds and saves the command list. Refused when the game is not installed or switched off in Settings > Games.
Technical internals
  • Output: JSON (Game, Action scan, ConfigPath, BindingsRead, Bindings with Reformers, Steps, Warnings, Errors), or a text report with --text.
  • Exit code 0; 1 on an error (No IL-2 Sturmovik: Cliffs of Dover Blitz config file found. Pass the path explicitly.). Unknown options fail with Unknown IL2CoDBlitz scan argument(s): ....
  • Related: engine il2codblitz import, engine games devices; game page il2-cliffs-of-dover.

What it does Reads the game's controls (its control file or folder, or registry values for Nuclear Option and Tiny Combat Arena; Ace Combat 8 stores none) and shows the joystick binds, without changing the profile. Without a command list yet (fresh install) it first builds the list from the game and saves it.

OptionValuesMeaning
--path<config-path>Optional explicit path override. Use when you prefer option form over positional path.
--ignore-device<name>Leave the binds of this device out (one per flag; a name without {GUID} means every device of that name). Example: --ignore-device 'vJoy Device'.
--ignore-devices<csv>Leave the binds of these devices out (separated by commas, | or ;). Example: --ignore-devices 'vJoy Device,Old Pedals'.

In the game Reads IL-2 Sturmovik: Cliffs of Dover Blitz'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: Cliffs of Dover Blitz details · what each mode changes

Example

engine il2codblitz scan --text
How the options interact
  • --ignore-device / --ignore-devices leave the binds of those devices out of the scan or import (the result names how many).

#engine il2codblitz import

written
engine il2codblitz import [<config-path>] [--path <config-path>] [--replace] [--include-keyboard] [--ignore-device <name>] [--ignore-devices <csv>]

--ignore-device(s): the binds of these devices are left out

For beginners

Reads the binds of IL-2 Sturmovik: Cliffs of Dover Blitz from confUser.ini into your JoyPro profile, with chords as modifiers and the axis settings of each command. Nothing in the game changes. The GUI runs it with Import on the Cliffs of Dover Blitz card of the Start page.

engine il2codblitz import --include-keyboard --profile "C:\Users\Pilot\Documents\JoyPro\My Sticks.pr0file" --text
Advanced

It reads %USERPROFILE%\Documents\1C SoftClub\il-2 sturmovik cliffs of dover\confUser.ini (the [HotKey ...] sections and [Config pilotMove]). Blitz creates the folder on its first start.

  • Default: adds to the open profile (--merge means the same); --replace replaces every relation of the profile by what the file has.
  • --include-keyboard also reads the keys. Inputs held together with the firing one become JoyPro modifiers (keys or joystick buttons).
  • Blitz names a device <product name>-<id>, the id taken from its USB path: JoyPro matches by name and id, else by name when only one connected device has it.
  • Safety: reads only, not refused while the game runs; the profile is kept as "Before import from IL-2 Sturmovik: Cliffs of Dover Blitz" first.
  • --ignore-device <name> / --ignore-devices <a;b> leave the binds of those devices out (a name without {GUID} means every device of that name); a step line says how many binds were left out.
Technical internals

What it does Imports the game's joystick binds into the loaded profile (merged by default; --replace starts from an empty relation list). Without a command list yet it first builds the list from the game.

OptionValuesMeaning
--path<config-path>Optional explicit path override. Use when you prefer option form over positional path.
--replaceswitch (no value)For game import: start from an empty relation list instead of merging into the loaded profile.
--include-keyboardswitch (no value)
--ignore-device<name>Leave the binds of this device out (one per flag; a name without {GUID} means every device of that name). Example: --ignore-device 'vJoy Device'.
--ignore-devices<csv>Leave the binds of these devices out (separated by commas, | or ;). Example: --ignore-devices 'vJoy Device,Old Pedals'.

In the game Reads IL-2 Sturmovik: Cliffs of Dover Blitz'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: Cliffs of Dover Blitz details · what each mode changes

Example

engine --profile 'C:\JoyPro\profiles\pilot_main.pr0file' il2codblitz import --text
How the options interact
  • --ignore-device / --ignore-devices leave the binds of those devices out of the scan or import (the result names how many).

#engine il2codblitz export

written
engine il2codblitz export [<config-path>] [--path <config-path>] [--mode clean|add|merge|merge-overwrite] [--dry-run] [--include-keyboard] [--nuke-untouched-devices] [--ignore-device <name>] [--ignore-devices <csv>]

Flight only: clean takes over the devices it writes, nuke clears unused devices; --ignore-device(s) and --vjoy-tunnel devices are never cleared

For beginners

Writes your binds into the flight sections of confUser.ini of IL-2 Sturmovik: Cliffs of Dover Blitz. Close the game first. The GUI's Export now on the Cliffs of Dover Blitz card runs it.

engine il2codblitz export --mode clean --nuke-untouched-devices --profile "C:\Users\Pilot\Documents\JoyPro\My Sticks.pr0file"
Advanced

It edits Documents\1C SoftClub\il-2 sturmovik cliffs of dover\confUser.ini with Blitz's device names. The original game writes the same file with other names (engine il2cod export).

--mode In the game
add nothing is removed; a bind on an input the game uses for another command is listed, not written
merge your binds go in; a game bind on an input you give another command is removed, the rest stays
merge-overwrite (engine default) as merge, and every command you bind loses its other inputs (keyboard only with --include-keyboard)
clean (GUI default) the devices you write keep only your binds in the managed sections
  • --nuke-untouched-devices: the other connected devices lose their lines in the managed sections (not with add).
  • --include-keyboard also writes keys. An old line of a device whose name changed with the USB port is renamed (warning).
  • Axis settings per command: sensitivity, centre and end dead zone for aileron, elevator and rudder, low and high dead zone for the others; in merge values set in the game stay when JoyPro's are all zero.
  • Never touched: [HotKey vehicle] (ground vehicles), mouse lines, keyboard lines without --include-keyboard, devices that are not connected, lines without a device, unknown sections, --ignore-device(s), the --vjoy-tunnel device; conf.ini, user.ini and "Save As" profiles.
  • Safety: refused while Blitz's Launcher64 runs; backed up first (undo: engine backups list); the profile is kept as "Before export to IL-2 Sturmovik: Cliffs of Dover Blitz". --dry-run writes nothing.
Technical internals

What it does Writes the profile's binds for this game. Only the flight actions JoyPro manages are changed, the game must be closed, and the game's files are backed up first (engine backups). Without a command list yet it first builds the list from the game.

OptionValuesMeaning
--path<config-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.
--dry-runswitch (no value)Report what the export would write; the game's files are not changed.
--include-keyboardswitch (no value)
--nuke-untouched-devicesswitch (no value)DCS 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 il2codblitz export --mode clean
engine il2codblitz export --mode add
engine il2codblitz export --mode merge
engine il2codblitz export --mode merge-overwrite

In the game Writes into IL-2 Sturmovik: Cliffs of Dover Blitz'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: confUser.ini as Cliffs of Dover; devices <product>-<hash of the HID path> (changes with the USB port). IL-2 Sturmovik: Cliffs of Dover Blitz details · what each mode changes

Example

engine --profile 'C:\JoyPro\profiles\pilot_main.pr0file' il2codblitz export --dry-run --text engine --profile 'C:\JoyPro\profiles\pilot_main.pr0file' il2codblitz export --mode merge-overwrite --text

#engine il2codblitz refresh-db

written
engine il2codblitz refresh-db [<source-path>] [--path <source-path>] [--dry-run]

Reads the installed game or <source-path> and adds its new actions to the catalog, the known ones stay; writes it only when it changes

For beginners

Adds new Cliffs of Dover Blitz commands to JoyPro's command list: JoyPro's own list of the game's commands, then every command found in confUser.ini and the game's default binds. Update on the Cliffs of Dover Blitz card of the Start page runs it.

engine il2codblitz refresh-db --text
Advanced
  • Rows the list already has stay; nothing is removed. Read without a path: the file of engine il2codblitz paths and confUser.ini in the installation folder (the defaults a never-started install has).
  • A path (positional or --path) reads only that file, or confUser.ini in that folder.
  • Command names with blanks are skipped. --dry-run writes nothing; otherwise the list is written only when it changed.
  • Refused when the game is not installed or switched off in Settings > Games; the game may run.
Technical internals
  • Output: JSON of the refresh (DryRun, FilesWritten, Steps with JoyPro's own ... command list: <n> new command(s)., Read <file>: <n> new command(s). and Actions: <old> -> <new>, Warnings), or a text report with --text.
  • Exit code 0; 1 only for a refusal or an unknown option.
  • Writes %LOCALAPPDATA%\JoyPro2\GameData\DB\IL2CoDBlitz\actions.tsv and records the game's Steam build for engine db check-updates.
  • Related: engine il2codblitz catalog, engine il2cod refresh-db; game page il2-cliffs-of-dover.

What it does Reads the installed game or <source-path> and adds its new actions to the catalog, the known ones stay; writes it only when it changes.

OptionValuesMeaning
--path<source-path>Same as <source-path>: the game's installation or a file of the game to read the actions from.
--dry-runswitch (no value)Report what the command would do; nothing is written or changed.

Example

engine il2codblitz refresh-db --text