JoyPro2 Discord GitHub
Engine (CLI)

engine ac8 (ACE COMBAT 8: Wings of Theve)

Show:

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

#engine ac8 paths

written
engine ac8 paths
For beginners

Shows where JoyPro finds ACE COMBAT 8's settings on this PC: %LOCALAPPDATA%\BANDAI NAMCO Entertainment\ACE COMBAT 8\Saved\SaveGames\System.sav. JoyPro reads only the gamepad keys you set from it. Detect in the import wizard's Expert import section runs it.

engine ac8 paths --text
Advanced
  • No options. Listed: your own config location of engine games config set first, then System.sav when it exists.
  • Read-only; also works when the game is not installed or switched off.
Technical internals
  • Output: JSON (Game, DisplayName, ConfigPaths, Warnings), or with --text ACE COMBAT 8: Wings of Theve Config Paths, Paths: <n> and the file. Exit code 0; an unknown option fails with Unknown AceCombat8 paths argument(s): ....
  • Related: engine ac8 refresh-db, engine games paths; game page ace-combat.

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 ac8 paths --text

#engine ac8 catalog

written
engine ac8 catalog
For beginners

Lists the ACE COMBAT 8 actions JoyPro knows: the controls of the Xbox pad the game reads, each with the pad control it is on. Bind your HOTAS to them; the virtual Xbox pad passes them on (engine vjoy mode AceCombat8 xbox).

engine ac8 catalog --text
Advanced
  • No options; read-only, also when the game is not installed.
  • Fixed in the game: pitch and roll (left stick) and the camera (right stick). Set in the game: yaw left and right, throttle up and down, gun, missile, change weapon, switch target and radar map.
  • Before engine ac8 refresh-db read your pad keys, the list shows the game's default layout.
Technical internals
  • Output: JSON (Game, Source, Actions with Id, Title, IsAxis, Category, Warnings), or with --text one line per action <id> | axis|button | Gamepad | <title> (ids Pad_...). Exit code 0.
  • File: %LOCALAPPDATA%\JoyPro2\GameData\DB\AceCombat8\actions.tsv; the fifth column holds the pad control (Gamepad_LeftY, Gamepad_FaceButton_Bottom ...), which the virtual pad uses.
  • Related: engine ac8 refresh-db, engine vjoy map; game page ace-combat.

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 ac8 catalog --text

#engine ac8 scan

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

ACE COMBAT 8: Wings of Theve stores no joystick binds, so a scan shows none; it only reports that. Your HOTAS reaches the game through the virtual Xbox pad. Look first in the import wizard runs it.

engine ac8 scan --text
Advanced
  • The step line says the game "stores no joystick binds" and names engine vjoy mode AceCombat8 xbox. The pad keys you set in the game go into the command list with engine ac8 refresh-db.
  • A path (positional or --path) and --ignore-device(s) are accepted and change nothing.
  • Refused when the game is not installed or switched off in Settings > Games.
Technical internals
  • Output: JSON (BindingsRead 0, Steps, Warnings, Errors), or a text report with --text.
  • Exit code 0; 1 when System.sav is not found (No ACE COMBAT 8: Wings of Theve config file found. Pass the path explicitly.) or for an unknown option (Unknown AceCombat8 scan argument(s): ...).
  • Related: engine ac8 import, engine vjoy status; game page ace-combat.

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 ACE COMBAT 8: Wings of Theve's files only; nothing changes in the game. A scan only shows what an import would bring and does not change the profile. ACE COMBAT 8: Wings of Theve details · what each mode changes

Example

engine ac8 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 ac8 import

written
engine ac8 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

ACE COMBAT 8: Wings of Theve stores no joystick binds, so this import brings no relations; it only reports that. Your HOTAS reaches the game through JoyPro's virtual Xbox pad instead. The GUI's Import on the ACE COMBAT 8 card runs it.

engine ac8 import --profile "C:\Users\Pilot\Documents\JoyPro\My Sticks.pr0file" --text
Advanced
  • Nothing is read into the profile: the step line says the game "stores no joystick binds" and names engine vjoy mode AceCombat8 xbox.
  • The pad keys you set in the game (%LOCALAPPDATA%\BANDAI NAMCO Entertainment\ACE COMBAT 8\Saved\SaveGames\System.sav, read only) go into the command list with engine ac8 refresh-db, not into the profile.
  • --replace starts over from an empty import: every relation of the open profile would be replaced by nothing. Keep the default (add).
  • Safety: reads nothing of the game; the profile is still kept as "Before import from ACE COMBAT 8: Wings of Theve" 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
  • Output: JSON of the import result (BindingsRead 0) or a text report with --text; exit code 0, 1 when no config file is found.
  • Refused when the game is not installed; unknown options fail with Unknown AceCombat8 import argument(s): ....
  • Related: engine ac8 export, engine vjoy mode, engine ac7 import; game page ace-combat.

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 ACE COMBAT 8: Wings of Theve'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. ACE COMBAT 8: Wings of Theve details · what each mode changes

Example

engine --profile 'C:\JoyPro\profiles\pilot_main.pr0file' ac8 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 ac8 export

written
engine ac8 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>]

Writes nothing: the game reads only Xbox pads and checksums its settings; the binds reach it through the virtual Xbox pad, engine vjoy mode AceCombat8 xbox

For beginners

Writes nothing into ACE COMBAT 8: Wings of Theve and says so: your binds reach the game through the virtual Xbox pad, which Start on the Virtual Joystick page builds from your relations. The GUI's Export now on the ACE COMBAT 8 card runs it.

engine ac8 export --dry-run --profile "C:\Users\Pilot\Documents\JoyPro\My Sticks.pr0file" --text
Advanced
  • The step line counts your gamepad action binds and names engine vjoy mode AceCombat8 xbox; after you change a pad key in the game, run engine ac8 refresh-db and engine vjoy map.
  • A bind on an action that is not one of the catalog's gamepad actions is skipped with a warning.
  • --mode, --nuke-untouched-devices and --include-keyboard have no effect: no game file is written.
  • The game reads no joystick: outside the virtual mode, binds on a joystick get the warning "... reads no joystick ..." with the command that switches the game to the virtual pad.
  • Safety: the export is still refused while AceCombat8, AceCombat8-Win64-Shipping or start_protected_game runs (not with --dry-run), and the profile is kept as "Before export to ACE COMBAT 8: Wings of Theve".
Technical internals
  • Output: JSON of the export result (BindingsWritten 0, BindingsSkipped) or a text report with --text; exit code 0, 1 when the game runs or the mode is invalid.
  • The help note says "writes nothing": the game reads only Xbox pads and checksums its settings, so nothing is released or written.
  • Related: engine ac8 import, engine vjoy mode, engine vjoy status; game page ace-combat.

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 ac8 export --mode clean
engine ac8 export --mode add
engine ac8 export --mode merge
engine ac8 export --mode merge-overwrite

In the game Writes into ACE COMBAT 8: Wings of Theve's control files while the game is closed (refused while it runs), after a backup. Arcade flight games and shooters that read one joystick, only Xbox pads, or a fixed layout (docs: one-device-games.md). Bind file: ...\ACE COMBAT 8\Saved\SaveGames\System.sav (GVAS with a checksum): read only. ACE COMBAT 8: Wings of Theve details · what each mode changes

Example

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

#engine ac8 refresh-db

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

Rebuilds the catalog from the installed game or <source-path>: actions the game no longer has are dropped; writes it only when it changes

For beginners

Reads the gamepad keys you set in ACE COMBAT 8 into JoyPro's command list, so the virtual Xbox pad puts each HOTAS input on the control the game uses. Run it after you change a key in the game, then engine vjoy map. Update on the ACE COMBAT 8 card of the Start page runs it.

engine ac8 refresh-db --text
Advanced
  • Reads the <action>Key_Controller entries (and the control type) of System.sav; a path (positional or --path) may name another System.sav, a folder means the default file.
  • A key you did not set keeps the default; a pad key JoyPro has no row for gets a row of its own. Without a readable save the default layout is used (a step line says so).
  • The game file is only read, never written. --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 such as Read <n> gamepad key(s) from <file> (control type ...). 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\AceCombat8\actions.tsv.
  • Related: engine ac8 catalog, engine vjoy map, engine ac7 refresh-db; game page ace-combat.

What it does Rebuilds the catalog from the installed game or <source-path>: actions the game no longer has are dropped; 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 ac8 refresh-db --text