Lists where JoyPro finds the profiles of Arma 2: Operation Arrowhead on this PC. The first one is what
engine arma2oa scan, engine arma2oa import and engine arma2oa export use when you give no path. Detect in the
Other Games panel (Start page, Expert import) runs it and puts the first one into File / Folder.
engine arma2oa paths --text
Advanced
Every *.ArmA2OAProfile in %USERPROFILE%\Documents\ArmA 2\ and below Documents\ArmA 2 Other Profiles\, newest
first; .vars and .3den files are skipped. Combined Operations and the DayZ mod use the same profiles.
No options. Reads only; it also works while the game runs or when it is not installed.
Technical internals
Output: JSON (Game, DisplayName, ConfigPaths, Warnings), or text with --text ("Arma 2: Operation Arrowhead
Config Paths", "Paths: " and one line per location). Exit code 0, also when nothing was found (empty list).
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).
Lists the Arma 2: Operation Arrowhead actions JoyPro manages (its command list): id, axis or button, category and
title. An export writes only these actions, and the relation editor and the search list them.
engine arma2oa catalog --text
Advanced
The list is %LOCALAPPDATA%\JoyPro2\GameData\DB\Arma2OA\actions.tsv (when that folder does not exist, the
DB\Arma2OA folder next to the engine).
It is built from the game's config and your profile by engine arma2oa refresh-db, or by the first scan, import or
export.
catalog only shows the list; it never builds it. Titles that look like ids are shown readable.
No options. Reads only; works without the game installed.
Technical internals
Output: JSON (Game, Source, Actions with Id, Title, IsAxis, Category, Warnings), or text with
--text ("Arma 2: Operation Arrowhead Action Catalog", "Source:", "Actions: ", then <id> | axis|button | <category> | <title> per action).
Without a list: the warning Arma 2: Operation Arrowhead action catalog not found: <path> and an empty list, exit
code 0.
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>.
Shows the joystick binds Arma 2: Operation Arrowhead has now, without changing your profile or the game. Use it to
look before an import. Look first on the game's card of the Start page and Scan in the Other Games panel
run it.
engine arma2oa scan --text
Advanced
It reads the key lines of the cataloged actions and the devices of class JoysticksList (32 buttons per device; a
device in another mode than Custom counts as off), with each axis's sensitivity slider.
Path (positional or --path): another profile file.
--ignore-device <name> / --ignore-devices <a;b> (separated by | or ;, --ignore-devices also by commas) leave the binds of those devices out
(a name without {GUID} means every device of that name); a step line names them and counts the binds.
Keyboard binds are not read in this game.
Safety: reads only and is not refused while the game runs. It is refused when the game is not installed (set its
folder: engine games install set) or switched off in Settings > Games.
A fresh install has no command list yet: the first scan builds it from the installed game and saves it (a step line
says so).
Technical internals
Output: JSON (ConfigPath, BindingsRead, Bindings with ActionId, Device, Input, IsAxis, Reformers,
Inverted, then Steps, Warnings, Errors), or text with --text ("Arma 2: Operation Arrowhead Scan",
"Config:", "Bindings Read:" and the list).
Exit code 0; 1 when the result has errors, for example No Arma 2: Operation Arrowhead config file found. Pass the path explicitly.
Unknown options fail with Unknown Arma2OA scan argument(s): ...; MSFS options (--game-profile,
--include-disconnected, --include-sim-defaults) are refused.
Binds of the vJoy device JoyPro forwards into (--vjoy-tunnel) are left out.
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.
Option
Values
Meaning
--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'.
--ignore-device(s): the binds of these devices are left out
For beginners
Reads the aircraft and helicopter binds of your Arma 2: Operation Arrowhead profile into your JoyPro profile, with the
sensitivity slider of each axis. Nothing in the game changes. The GUI runs it with Import on the Operation
Arrowhead card of the Start page.
It reads %USERPROFILE%\Documents\ArmA 2\<name>.ArmA2OAProfile (or one in Documents\ArmA 2 Other Profiles\<name>\):
Operation Arrowhead, Combined Operations and the DayZ mod use this file.
Default: adds to the open profile (--merge means the same); --replace replaces every relation of the profile by
what the file has.
Keyboard binds are not read; --include-keyboard changes nothing. Arma 2 knows no joystick buttons with modifiers.
Both halves of an axis come back as one axis relation; stored full-axis codes are read too.
Safety: reads only, not refused while the game runs; the profile is kept as "Before import from Arma 2: Operation
Arrowhead" 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 or a text report with --text; exit code 1 on an error (No Arma 2: Operation Arrowhead config file found. Pass the path explicitly.).
Without a path it reads the profile engine arma2oa paths lists first; a fresh install builds the command list from
Expansion\dta\bin.pbo first.
With --profile the profile is saved afterwards; a game JoyPro never exported to is watched from now on.
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.
Option
Values
Meaning
--path
<config-path>
Optional explicit path override. Use when you prefer option form over positional path.
--replace
switch (no value)
For game import: start from an empty relation list instead of merging into the loaded profile.
--include-keyboard
switch (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 Arma 2: Operation Arrowhead'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. Arma 2: Operation Arrowhead details · what each mode changes
Only aircraft/helicopter actions: clean and nuke release those on the written / unused devices; --ignore-device(s) and --vjoy-tunnel devices are never cleared
For beginners
Writes your aircraft and helicopter binds into your Arma 2: Operation Arrowhead profile; only the key lines of the
flight actions change. Close the game first, and start it once with every device connected. The GUI's Export now
on the Operation Arrowhead card runs it.
Only the lines of cataloged aircraft and helicopter actions change; a missing cataloged key line is added after the last
key line.
--mode
In the profile
add
nothing is removed; a bind whose code another action of the same vehicle has gets a mark "Not written to the game"
merge
your codes go in; a code of another action of the same vehicle that you put elsewhere is dropped
merge-overwrite (engine default)
as merge, and an action you bind loses its other joystick codes of connected joysticks
clean (GUI default)
the flight lines also lose every other code of the written devices, the game's automatic defaults included
--nuke-untouched-devices: the same for other connected joysticks (not with add).
Axes are written as halves; the throttle ("Thrust (Analogue)") and the airbrake get both halves of the lever.
Sensitivity sliders are written only where you set them for Operation Arrowhead (or family:arma2) or they came from
the import. 32 buttons, 8 axes and the first hat per device.
Never touched: infantry, vehicle and menu lines, keyboard, mouse, TrackIR and pad codes, joysticks that are not
connected, --ignore-device(s), the --vjoy-tunnel device, new device entries, ArmA2OA.cfg.
Safety: refused while arma2oa or arma2oa_be runs; backed up first (undo: engine backups list); the profile is
kept as "Before export to Arma 2: Operation Arrowhead". --dry-run writes nothing.
Technical internals
Output: JSON of the export result or a text report with --text; exit code 1 on an error (the game runs, an
invalid --mode, no profile found, a binary profile).
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.
Option
Values
Meaning
--path
<config-path>
Optional explicit path override. Use when you prefer option form over positional path.
--mode
cleanaddmergemerge-overwrite
Export mode for DCS/IL2 export commands: clean, add, merge, merge-overwrite.
--dry-run
switch (no value)
Report what the export would write; the game's files are not changed.
In the game Writes into Arma 2: Operation Arrowhead's control files while the game is closed (refused while it runs), after a backup. Infantry sims with aircraft and helicopters: JoyPro writes only the cataloged aircraft and helicopter actions. Bind file: Documents\ArmA 2\<name>.ArmA2OAProfile (ParamFile text). Arma 2: Operation Arrowhead details · what each mode changes
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
Builds JoyPro's Arma 2: Operation Arrowhead command list from the installed game's config and your profile, or adds
the actions that are new. Run it after a game update, or when JoyPro says the list is missing. Refresh DB in the
Other Games panel (its DB Source box is the path) and the Start page's notice "Command lists to build or
update" run it.
engine arma2oa refresh-db --dry-run --text
Advanced
Without a path it reads Expansion\dta\bin.pbo of the game folder (the action list of CfgDefaultKeysMapping) with
the names of Expansion\dta\languagecore.pbo, and the first profile of engine arma2oa paths.
Path: a folder is read as the game folder, a file as a profile.
Kept: the flight actions (Heli, Flaps, LandGear, AutoHover, LaunchCM, NextCM), the actions JoyPro's function list
uses, and the weapon, view and push-to-talk actions a HOTAS often carries (Fire, SwitchWeapon, Eject, GetOut, the
look and zoom actions ...). JoyPro's axis relations (Axis.*) come from JoyPro itself.
Known actions keep their entry.
--dry-run reads everything and writes nothing (step "Dry run: nothing was written."). Without it the list is
written only when it changed.
Safety: only JoyPro's list changes, never a game file; it is refused when the game is not installed or switched off
in Settings > Games. The GUI can cancel it while the game's files are read; nothing is written then.
Technical internals
Output: JSON of the refresh (DryRun, FilesWritten, Steps with Actions: <old> -> <new>, Warnings,
Errors), or text with --text.
Exit code 0; 1 when nothing could be read: Arma 2: Operation Arrowhead: neither the game's config nor a profile was found. Set the game folder (Settings > Games) or pass --path.; the list stays unchanged.
Writes %LOCALAPPDATA%\JoyPro2\GameData\DB\Arma2OA\actions.tsv (with a header line that has the date). After a real
run the game's build is recorded for engine db check-updates.