| Title | Support | Engine command | Bind file | In-game test |
|---|---|---|---|---|
| X-Plane 12 | native | engine xplane12 | Output\preferences\X-Plane Joystick Settings.prf, control profiles\*.prf (line based) | 33/33 |
| X-Plane 11 | native | engine xplane11 | as X-Plane 12 |
The game page in plain words: X-Plane 12 / 11. Full matrix: Game support. What an export does in this kind of game: Export flow, in the game.
From docs/games/xplane.md in the repository (generated, always the current text).
JoyPro handles X-Plane 11 and X-Plane 12 as two games side by side (game ids XPlane11 / XPlane12, CLI
engine xplane11 / engine xplane12; the old engine xplane is X-Plane 12): each has its own installation,
Output\preferences folder, catalog and settings model, and both can be installed at the same time. See "Two
versions" below.
#Files
- Install roots: X-Plane's installer writes every install folder of a version to
%LOCALAPPDATA%\x-plane_install_<version>.txt(one path per line, slashes mixed:D:\SteamLibrary/steamapps/common/X-Plane 12/[OBS, X-Plane 12.4.3 on Steam]). A version installed by Steam and never started has no such file [OBS: X-Plane 11]; its Steam folder (steamapps\common\X-Plane 11/X-Plane 12, app 269950 / 2014780) is the install then. - Preferences inside the install:
Output\preferences\(created on the first start):X-Plane Joystick Settings.prf,X-Plane Keys.prf: current/global.control profiles\<Name> - Joysticks.prf,<Name> - Keys.prf(XP 11.10+, XP12). Profiles cover all devices (not one file per device). The global file seems to mirror the active profile [INF].- Not user preferences:
Resources\joystick configs\<VID>-<PID> <OS> <name>.joy(679 files in X-Plane 12) are Laminar's default device configurations (one per known device, with pictures), which X-Plane applies to a new device. X-Plane 12.4.3 keeps the user's assignments of all devices in the singleX-Plane Joystick Settings.prf(for example 8562 lines, 6 device slots) [OBS], the same file and keys as X-Plane 11 [SRC: the stringsJoystick Settings.prf,- Joysticks.prf,_joy_AXIS_use,_joy_BUTN_use,_joy_unique_id,_joy_damp,axis_response_curvein both X-Plane.exe]. Miscellaneous.prf: aircraft → profile (P acf_profile Boeing___737-800X B738, spaces become___).
- Rewritten when the settings window closes and on exit: edit only while X-Plane is closed.
#Joysticks.prf (line based)
I
10 Version
_joy_unique_id2 VID:1103PID:45322
_joy_location1 \\?\hid#vid_045e&pid_028e&ig_00#...
_joy_AXIS_use50 2
_joy_rev_axis53 0
_joy_BUTN_use320 sim/operation/pause_toggle
_joy_BUTN_use323 sim/flight_controls/landing_gear_toggle
axis_response_curve52 INTERP_MODE CATMULL_ROM | 0.000000 0.000000 | 0.500000 0.500000 | 1.000000 1.000000
- 20 device slots:
_joy_unique_id<slot> VID:<dec>PID:<dec>(decimal!),_joy_location<slot>(HID path),_joy_lru_time<slot>. - Global indices: axis = slot×25 + a (500 entries), button = slot×160 + b (3200 entries). [INF]
- The first hat becomes 8 virtual buttons after the device's buttons, clockwise from up. [OBS/INF]
_joy_AXIS_use<i>= use code,_joy_rev_axis<i>= 0/1,_joy_BUTN_use<i>= command path (sim/none/none= unassigned), optional_joy_BUTN_use_desc<i>.- Custom-command axes (use 52):
_joy_AXIS_cmnd<axis*4+slot>. - Response curves (XP 11.30+, "Add/Edit Response Curve" per axis): general curves with any number of stops, not only
dead zones. Format (X-Plane 12 exe format strings):
axis_response_curve<axis> [FIXED_RANGE_TYPE <type> FIXED_PT_0 <int> FIXED_PT_1 <int> FIXED_PT_2 <int> ; ]INTERP_MODE <mode> | x y | x y ...with%fnumbers, two spaces before each|and a trailing space. x, y in 0..1 (x = deflection magnitude on centred axes [INF], travel on one-sided axes). ModesLINEAR,CATMULL_ROM,CUBIC_AVG. Fixed ranges (throttle, prop and mixture curves):beta_reverse_range,feather_range,mixture_cutoff_range,helo_thro_detent_range,fadec_thro_range,fadec_thro_with_reverse_range,feathershutoff_range(units ofFIXED_PT_*UNVERIFIED). The game writes the lines at the end of the file. A curve overrides the Control Sensitivity of its axis (manual). - Control settings per axis use code
u:_joy_prat<u>= Control Sensitivity "Control Response" slider 0..1 (pitch 1, roll 2, yaw 3; XP12 also copilot 68/69/70),_joy_damp<u>= Stability Augmentation 0..1 (X-Plane 11 only),_axis_is_required<u>(unknown). Per hardware axis:_joy_ffb_axis<i>= control-loaded for trim (X-Plane 12, .joy tagffb),_joy_axis_delta_sec<i>(unknown). Per file:_discretize_flap_axis(flap detents). - Never write calibration keys (
_joy_center,_joy_null,_joy_*_raw_dat,_joy_axis_is_calibrated_override,_joy_axis_wants_relaxed_calibration),_eq_pfc_*, or slots JoyPro does not manage. The null zone is calibration. - Joystick buttons have no modifier/combo concept (only keyboard combos in Keys.prf).
Axis order on Windows may follow HID report order rather than DirectInput X-first [INF/UNVERIFIED]: validate against existing assignments.
#Axis use codes [SRC Joystick Datarefs]
0 none, 1 pitch, 2 roll, 3 yaw, 4 throttle, 5 collective, 6/7 left/right toe brake, 8 prop, 9 mixture, 10 carb heat, 11 flaps, 12 thrust vector, 13 wing sweep, 14 speedbrakes, 15 displacement, 16 reverse, 17/18/19 elevator/aileron/rudder trim, 20–23 throttle 1–4, 24–27 prop 1–4, 28–31 mixture 1–4, 32–35 reverse 1–4, 36 gear, 37 nosewheel tiller, 38 backup throttle, 39 cowl flaps, 41–43 view, 44–46 camera, 47–48 gun/bomb, 49–51 VR, 52 custom command(s), 53–56 throttle 5–8, 57–64 cowl flaps 1–8, 65/66 throttle vertical/horizontal (40 is unused).
X-Plane 12 adds, numbered from the joy_use_* string table in X-Plane.exe (it lists 0..66 in exactly the documented
order, then these 14; the per-use _joy_prat/_axis_is_required arrays in user files have 67 (XP11), 74, 79 and
81 entries, which matches these groups): 67 throttle 9, 68/69/70 copilot pitch/roll/yaw, 71/72 copilot left/right
toe brake, 73 copilot tiller, 74/75 rudd_lft/rudd_rgt, 76/77 circ_lr/circ_ud, 78 wheel brakes (both),
79/80 viewpoint left-right/up-down. JoyPro catalogs 67-73 and 78; 74-77 (meaning unverified) and 79/80 (view) are not
cataloged. The numbering is still to be confirmed in the game (joystick_axis_assignments after picking "Copilot
pitch" in the UI, see tools\e2e\games\XPlaneCurves.ps1).
#Commands (DB)
<XP>\Resources\plugins\Commands.txt: <path><spaces><description> (~2900 in XP12). Plugin/aircraft commands exist only at runtime (XP 12.1.4+ Web API GET http://localhost:8086/api/v2/commands).
Flight prefixes: sim/flight_controls, engines, autopilot, fuel, electrical, lights, systems, radios, instruments, GPS, FMS, magnetos, starters, ignition, igniters, bleed_air, pressurization, ice, annunciator, transponder, audio_panel, weapons, fadec, oxy. Not flight: sim/view, operation, general, map, replay, VR, developer, ground_ops.
#Keys.prf
I
1005 Version
F4 ALT sim/operation/quit
Space SHIFT sim/operation/screenshot
F1 <NONE> sim/engines/throttle_down
Modifiers <NONE>, SHIFT, CTRL, ALT, joined with +.
#Two versions
X-Plane 11 (XPlane11) |
X-Plane 12 (XPlane12) |
|
|---|---|---|
| CLI | engine xplane11 (xp11) |
engine xplane12 (xp12; old names xplane, xp) |
| Install | override, else x-plane_install_11.txt + Steam app 269950 |
override, else x-plane_install_12.txt + Steam app 2014780 |
| Joystick file | X-Plane Joystick Settings.prf, same format |
same |
| Axis use codes | 0..66 (string table of the X-Plane 11 exe ends with joy_use_thro_hrz) |
0..80 (adds throttle 9, copilot axes, wheel brakes, ...) |
| Catalog | DB\XPlane11\actions.tsv: axes 1..66 + the flight groups of X-Plane 11's Commands.txt (2066 actions, refreshed 2026-10-11 from the installed X-Plane 11, build 6916183) |
DB\XPlane12\actions.tsv (X-Plane 12.4 Commands.txt) |
Settings (engine ffb set --game ...) |
control response, stability augmentation (_joy_damp), flap detents |
control response incl. copilot, flap detents, control-loaded axes (_joy_ffb_axis) |
| Function map (Auto Group, from-text) | DB\Functions\XPlane11.tsv (the X-Plane 12 rows whose command X-Plane 11 has) |
DB\Functions\XPlane12.tsv |
Both use the same code (engine\Games\XPlaneIntegration.cs, one instance per version) and the axis model xplane
(tuning scopes game:XPlane11, game:XPlane12, and family:xplane for both). The process is X-Plane.exe for both
versions, so an export is refused while either runs.
Profiles and settings saved before the split (game XPlane) are migrated when they are loaded
(engine\Games\LegacyGameIds.cs): a node XPlane:<id> becomes an XPlane12 node and, when X-Plane 11's catalog has
the action, an XPlane11 node (X-Plane 12-only axes such as axis/copilot_pitch stay X-Plane 12 only); game:XPlane
tuning becomes family:xplane; ffb settings of XPlane go to both versions (each keeps the settings its model
knows). A folder set for "X-Plane" in Settings > Games goes to the version it belongs to (listed in an installer file,
else the folder name), "I do not have X-Plane" hides both. --node XPlane:<id> still works and adds a node per
version. The watcher's records (<data>\Sync\XPlane.json) are not carried over; the next export records the files
of each version again.
#JoyPro implementation (engine xplane12 ..., engine xplane11 ...)
- Files:
X-Plane Joystick Settings.prfandcontrol profiles\<Name> - Joysticks.prfof the version's installs (the folder set in Settings > Games, else every install listed in%LOCALAPPDATA%\x-plane_install_<version>.txtand the version's Steam folder);--pathfor any other file. Keys.prf is never touched. A version that was never started has no preferences yet: start it once with the devices connected. - Written:
_joy_AXIS_use<i>/_joy_rev_axis<i>for the flight axis codes above (not view, camera, VR or custom-command axes), theiraxis_response_curve<i>,_joy_BUTN_use<i>for cataloged commands, and the control settings below. A changed button loses its stale_joy_BUTN_use_desc<i>line; every other line keeps its text. - Device slots:
_joy_unique_idVID:PID; when identical devices exist, the DirectInput HID interface path (DIPROP_GUIDANDPATH) must equal_joy_location. Slots of devices that are not connected are skipped. - Local axis index = DirectInput
EnumObjectsorder, which follows the HID report order like X-Plane [INF]. Buttons: device buttons, then the first hat as 8 buttons clockwise from up (diagonals included); other hats are not mapped. - No modifiers and no keyboard binds.
- Export modes (slots of devices that are not connected are never touched):
addwrites free inputs only; a profile bind on an input with another use or command is not written and listed under "Binds Not Written, Button Taken In The Game". An axis use the game has on another axis stays there (warning).mergereplaces the other use or command on the profile's input (the conflict) and keeps everything else, also a moved command's old button. An axis use moves (X-Plane ignores a use two axes share).merge-overwritealso releases the other axes and buttons of connected devices that hold a use or command the profile binds (with their curves).clean= merge + releases every other flight axis/command of the connected devices the export writes; other devices keep theirs (as in every game; an axis use still moves, see merge).<file>.joypro.jsonrecords the inputs JoyPro wrote or took over on import (A<index>axes,B<index>buttons) and its curves; it no longer decides which binds an export removes.
- Axis response (axis model
xplane,engine\AxisModels\XPlane.cs; tuning scopesgame:XPlane12/game:XPlane11->family:xplane-> base):- Import reads each flight axis's curve into the relation's
game:XPlane12(orgame:XPlane11) tuning: the exact stops (n.cpN,n.cpx<i>,n.cpy<i>),interp(0 LINEAR, 1 CATMULL_ROM, 2 CUBIC_AVG),rangeType(1..7 in the order above) andrangePt0..2, reverse, one-sided (from the use code), and the curve resampled as the 11-point user curve for the GUI editor. An imported curve is owned by JoyPro (curve:<axis>with a hash of the line in<file>.joypro.json). - Export writes
axis_response_curve<axis>for every axis it writes: the explicit stops, else the tuning's dead zone (flat first stop), saturation (last stops), curvature or 11-point curve (11 equally spaced stops) with the chosen mode. A bind without X-Plane tuning gets its base curve as LINEAR stops (adaptive, within 0.001 of the DCS curve). A linear tuning without a fixed range writes no line. An unchanged curve keeps its bytes. - A curve made in X-Plane (not imported, or changed in the game since JoyPro wrote it) stays when JoyPro's tuning is linear and in merge and add mode (warning); merge-overwrite replaces it (warning); clean replaces or removes it. Clean, nuke and merge-overwrite remove the curves of the axes they clear; a curve of an axis that stays assigned stays.
- Fixed ranges are written only on their kind of axis (beta/helicopter/FADEC: throttles, feather: props, cutoff: mixtures); otherwise a warning.
engine binds tuning set ... --scope game:XPlane12 --curve-points 0:0,0.4:0.3,1:1sets any stops (nonedrops them); changing dead zone, saturation or curvature replaces explicit stops (the fields define the curve then).- Preview, measured in X-Plane 12.4.3 (
tools\e2e\games\XPlaneCurves.ps1, sim/joystick/joy_mapped_axis_value over 40 positions, within 0.0001): LINEAR straight lines; CATMULL_ROM = uniform Catmull-Rom per segment, t linear in x, tangent (y[i+1]-y[i-1])/2 in units of t (so the slope jumps at stops with unequal neighbours), end stops repeated; CUBIC_AVG = cubic Hermite in x, slope at a stop = mean of the adjacent slopes, slope 0 at the first stop (0 at the last stop by symmetry, not measured); output clamped to 0..1. Not modelled: X-Plane's calibration/null zone and the Control Sensitivity of pitch/roll/yaw axes without a curve (law UNVERIFIED; it does not act on joy_mapped_axis_value: copilot pitch with_joy_prat680.39 measured exactly linear there, so it applies later). - Natural direction (measured, reverse off, raw 0 / 0.5 / 1): X-Plane reverses throttle (4), throttle 1-4 (20-23),
throttle 8 (56; 53-55 assumed the same) and throttle 9 (67) by itself (1 / 0.56 / 0), like DCS's thrust axes, so
_joy_rev_axis= the relation's invert unchanged. Not reversed: collective 5, prop 8, mixture 9, carb heat 10, flaps 11, wing sweep 13, speedbrakes 14, displacement 15, reverse 16/32, gear 36, backup throttle 38, cowl flaps 39, throttle vertical/horizontal 65/66, wheel brakes 78. Reverse and the natural flip cancel on a reversed throttle (X-Plane = curve(raw)); whether they act before or after the curve cannot be told apart from that. - X-Plane ignores a use that two connected axes share ("Multiple axes assigned to yaw", the value stays 0): the export warns when another connected device's axis has the use of an exported axis (nuke untouched devices or clean clears it).
- Import reads each flight axis's curve into the relation's
- Control settings (
engine ffb set --game XPlane12|XPlane11, one model per version inengine\FfbModels\XPlane.cs), written into the exported file: device*:pitchResponse/rollResponse/yawResponse(_joy_prat1..3),copilot*Response(_joy_prat68..70, X-Plane 12),pitchStability/rollStability/yawStability(_joy_damp1..3, X-Plane 11),discretizeFlaps(_discretize_flap_axis); per device:controlLoaded(X-Plane 12,_joy_ffb_axis<i>on the pitch/roll/yaw axes JoyPro exports for that device). Each version's model has only its own settings (ffb setrefuses the others). Only lines the file already has are changed (an XP12 file has no_joy_damp, an XP11 file no copilot or_joy_ffb_axislines): a warning otherwise. Not imported (the file keeps them until set). X-Plane has no DirectInput force feedback of its own (FFB only via plugins). - Catalog:
DB\XPlane12\actions.tsv/DB\XPlane11\actions.tsv= the version's axis table + flight command groups of itsResources\plugins\Commands.txt(engine xplane12 refresh-db/engine xplane11 refresh-db, optionally--path <X-Plane folder>;db check-updatescompares each version's Commands.txt). Plugin and aircraft commands are not cataloged, so JoyPro leaves them alone. - Before writing: X-Plane must be closed; the file is backed up once to
.jpbak.
Sources: https://developer.x-plane.com/article/joystick-datarefs/, https://developer.x-plane.com/article/creating-joystick-configuration-joy-files/, X-Plane 11/12 manuals, samples from github.com/daleclack/Xe-Project and github.com/WeisAir/weisair.