Lay out with AI, step one: you say in words how you like your controls ("throttle and left-hand stick, trim on the
hat, curves softer for helis") and JoyPro prepares every change to binds, axis curves, force feedback and the virtual
joystick as a preview file. Phrase rules read the words; the optional local AI model only helps with sentences they do
not understand. Binds > Lay out with AI... > Preview runs it. It changes nothing.
engine arrange ask "throttle and left-hand stick, trim on the hat, curves softer for helis" --llm off --proposal "C:\Users\Pilot\Documents\JoyPro\layout.json" --profile "C:\Users\Pilot\Documents\JoyPro\My Sticks.pr0file" --text
Advanced
The words: every argument that is not an option. Without words the preferences kept in the profile are used.
--llm auto (default) or on: the local model rewrites the clauses the rules did not understand into phrases they
know (only when there are such clauses); off: never.
--games <g1,g2>: default the games of your relations that have a function catalog.
--add-missing also makes relations for functions you do not have yet; --forget-saved ignores the kept
preferences.
--proposal <file>: where the preview is written (default %TEMP%\JoyPro2\layout-ai\proposal.json).
Only relations a preference concerns, relations on a device whose role changed, and unbound relations move; the rules
of Auto Assign hold.
Technical internals
Output: the preview as JSON (understood preferences, not understood clauses, the changes with their ids and before /
after values, warnings), or --text; the same preview goes to the proposal file. The profile is not saved.
Exit code 1 with arrange ask needs your preferences in words, ... (no words and no kept preferences), Invalid --llm value: ... or a device option message.
What it does Lay out with AI: turns your preferences in words into the preferences JoyPro understood and every change of binds, axis curves, force feedback and the virtual joystick, as a preview (nothing is saved).
Option
Values
Meaning
--llm
autoonoff
--games
<g1,g2>
Game filter values as CSV. Example: DCS,IL2Game,StarCitizen.
--add-missing
switch (no value)
--forget-saved
switch (no value)
--proposal
<file>
--role
switch (no value)
--grip
switch (no value)
--add-device
switch (no value)
Every value as a command line
engine arrange ask --llm auto
engine arrange ask --llm on
engine arrange ask --llm off
Applies the preview in one history version; keeps the preferences in the profile
For beginners
Lay out with AI, step two: applies the preview file of arrange ask in one step and keeps your preferences in the
profile for next time. Binds > Lay out with AI... > Apply runs it with the changes you unticked as --skip;
Undo takes it back.
--skip <change id> (repeatable): bind:<relation>, split:<relation>, tuning:<relation>|<scope>,
ffb:<device>|<scope>, vjoy:<game>. Skipping a split also skips the new relation's bind.
Refused when the layout puts functions of the same aircraft on one input.
--dry-run counts without a change. Otherwise one profile version "Lay out with AI: N binds, ..." (one undo step).
Technical internals
Output: JSON of the result, or --text (Binds Set:, Relations Created:, Relations Split:, Axis Curves Set:,
Force Feedback Set:, Virtual Joystick Set:, skipped items and warnings). The profile is saved with --profile
unless --dry-run.
Exit code 1 with arrange apply needs --proposal <proposal.json> (from engine arrange ask)., The preview could not be read: ..., That file is no preview of engine arrange ask. or The layout puts functions of the same aircraft on one input: ....
Shows the layout preferences Lay out with AI keeps in the profile, or forgets one or all of them. When the Lay out with
AI panel opens, the GUI reads them; the cross on a preference and Forget all run remove and clear.
engine arrange prefs show --profile "C:\Users\Pilot\Documents\JoyPro\My Sticks.pr0file" --text
Advanced
show (default): the kept preferences with their keys.
remove <key>: forgets one; clear: forgets all. Each is one profile version (one undo step).
Forgetting changes no bind; the next engine arrange ask simply does not use it.
Technical internals
Output: JSON (the preferences), or --text (Saved preferences: <n> and - <description> | <key> lines). The
profile is saved with --profile after remove or clear.
Exit code 1 with arrange prefs remove <key>, No saved preference with the key ... or arrange prefs [show | clear | remove <key>].
What it does The layout preferences kept in the profile.