X-Plane bewaart de toewijzingen van al je apparaten in één voorkeurenbestand in de installatie: een as-"use" (pitch, throttle, flaps ...) per hardware-as, een commando per knop, en optionele responscurves. JoyPro leest dat bestand in je profiel, koppelt het in relaties aan je andere games en schrijft het terug, waarbij alleen de vliegregels die het beheert veranderen. X-Plane 12 en X-Plane 11 zijn in JoyPro twee games, elk met een eigen installatie, commandolijst en instellingen; beide kunnen naast elkaar geïnstalleerd zijn.
X-Plane 12 rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine xplane12- Toewijzingsbestand
Output\preferences\X-Plane Joystick Settings.prf,control profiles\*.prf(regelgebaseerd)- Inputs die de game leest
- leest 160 knoppen, 25 assen, 1 hat per joystick (geverifieerd)
- Commandolijst uit
Resources\plugins\Commands.txt- In-game test
- 33/33 stappen geslaagd (2026-10-11)
- ✓ Importeren
- ✓ Exporteren
- ✗ Toetsenbordtoewijzingen
- ✗ Modifiers
- ✓ Commandolijst gemaakt op je pc
- ✓ Gamebewaking
- ✓ Ascurves en dode zones
- ✓ Bedieningsinstellingen van de game
- ◐ Force-feedbackinstellingen in de gameX-Plane 12: alleen de schakelaar per apparaat "control-loaded axes" voor force-feedbacksticks; de sim heeft zelf geen force-feedbackeffecten voor de stick (alleen plug-ins).
- ✗ Force feedback uit telemetrie
- ✓ Telemetrie-opname
- ✓ Virtuele joystick (vJoy)
- ◐ Virtuele Xbox-pad
- ✓ Virtuele functies
- ✓ Installatiewizard / Automatisch toewijzen
- ✓ Cockpits
- ✓ Spiekbrieven
- ✓ In-game test
X-Plane 11 rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine xplane11- Toewijzingsbestand
- zoals X-Plane 12
- Inputs die de game leest
- leest 160 knoppen, 25 assen, 1 hat per joystick (geverifieerd)
- Commandolijst uit
Resources\plugins\Commands.txt
- ✓ Importeren
- ✓ Exporteren
- ✗ Toetsenbordtoewijzingen
- ✗ Modifiers
- ✓ Commandolijst gemaakt op je pc
- ✓ Gamebewaking
- ✓ Ascurves en dode zones
- ✓ Bedieningsinstellingen van de game
- ✗ Force-feedbackinstellingen in de game
- ✗ Force feedback uit telemetrie
- ✓ Telemetrie-opname
- ✓ Virtuele joystick (vJoy)
- ◐ Virtuele Xbox-pad
- ✓ Virtuele functies
- ✓ Installatiewizard / Automatisch toewijzen
- ✓ Cockpits
- ✓ Spiekbrieven
- ✗ In-game test
Uit de ondersteuningstabel, gegenereerd uit de code van de engine: alle games.
#In 3 stappen aan de slag
- Alles voor me instellen
op de startpagina - Deze knoppen gebruiken
bekijk eerst de lijst - Naar mijn game schrijven
houd X-Plane gesloten
Vooraf: start X-Plane één keer met je apparaten aangesloten en sluit het dan af.
Daarna: kalibreer je apparaten in X-Plane (Settings > Joystick). Je toewijzingen staan daar ook.
Heb je eerder knoppen toegewezen in X-Plane? Dan biedt de Startpagina Importeren, dan gaten vullen aan. Je toewijzingen blijven, en alleen vrije knoppen krijgen nieuwe taken. Zie Snelstart: mijn stick laten werken.
#Wat JoyPro doet voor X-Plane
- Importeren: de asfuncties, knopcommando's, omkeervlaggen en responscurves van je apparaten komen in je profiel.
- Relaties: één relatie is één functie in al je games ("Gear" in X-Plane, MSFS en DCS op dezelfde knop). De vliegcommando's van X-Plane komen uit zijn eigen
Commands.txt. - Exporteren: JoyPro schrijft de joystickvoorkeuren van de versie die je exporteert. X-Plane toont je toewijzingen in Settings > Joystick.
#Je toewijzingen uit X-Plane importeren
- Open Start. De kaart van X-Plane 12 (of X-Plane 11) toont de afbeelding van de game. Vraagt hij om een commandolijst, druk dan op Lijst maken: JoyPro leest
Resources\plugins\Commands.txtvan de geïnstalleerde X-Plane. - Druk op de kaart op Importeren en kies Aan mijn profiel toevoegen (X-Plane heeft in dit bestand geen toetsenbordtoewijzingen).
- Druk op Nu importeren. Mijn relaties bekijken opent wat er binnenkwam.


#Relaties maken en controleren
Op de pagina Relaties staat het X-Plane-commando of de X-Plane-as van een relatie naast dezelfde functie in je andere games. Gebruik de werkwijze voor relaties om ze te koppelen en druk dan op Nu controleren op de pagina Exporteren (de controle).
#Naar X-Plane exporteren
- Sluit X-Plane. Het herschrijft zijn voorkeuren als het instellingenvenster sluit en bij het afsluiten. Beide versies draaien als
X-Plane.exe, dus JoyPro weigert zolang een van beide draait. - Open Exporteren. Elke geïnstalleerde versie heeft een eigen kaart.
- Laat Vervangen op mijn apparaten met Ook mijn andere apparaten wissen staan als je je apparaten in JoyPro instelt. Druk op Nu exporteren op de kaart.
Start X-Plane, open Settings > Joystick en kies je apparaat. Elke as toont de functie die JoyPro schreef, knoppen tonen hun commando's, en Edit Response Curve op een as toont de punten en de interpolatie die JoyPro schreef.
#Wat je zelf doet in X-Plane
- Start X-Plane één keer met je apparaten aangesloten en sluit het dan af. Een versie die nooit gestart is, heeft nog geen voorkeurenbestand. De allereerste start vliegt de tutorial, en X-Plane schrijft zijn joystickvoorkeuren bij het afsluiten.
- Kalibreer in X-Plane. Kalibratie en de null zone blijven van X-Plane (Settings > Joystick); JoyPro schrijft ze nooit.
- Commando's van plugins en toestellen staan niet in de lijst van JoyPro: wijs die toe in X-Plane, JoyPro laat ze ongemoeid.
#Veelgemaakte fouten
- Een as doet niets ("Multiple axes assigned to yaw"): X-Plane negeert een functie die twee aangesloten assen delen. De export waarschuwt; Ook mijn andere apparaten wissen of Vervangen wist de andere as.
- De throttle werkt omgekeerd: X-Plane keert throttle-assen zelf om. JoyPro schrijft je omkering ongewijzigd, dus laat omkeren uit, tenzij je hendel echt de andere kant op werkt.
- Een curve die je in X-Plane hebt gemaakt is veranderd: in de modi Bijwerken en Alleen toevoegen blijft hij als de afstelling van JoyPro lineair is (met een waarschuwing); "mijn profiel wint" en Vervangen schrijven de curve van JoyPro.
#Bestanden die JoyPro leest en schrijft
| Bestand | Wat het is |
|---|---|
<install>\Output\preferences\X-Plane Joystick Settings.prf |
de huidige toewijzingen van alle apparaten (per regel) |
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf |
opgeslagen bedieningsprofielen, hetzelfde formaat |
<file>.joypro.json, <file>.joypro-meta.json |
de inputs en curves die JoyPro schreef; namen, groepen en afstelling voor de volgende import |
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt |
waar het installatieprogramma van X-Plane zijn installaties vermeldt (alleen gelezen) |
X-Plane Keys.prf (toetsenbord) wordt nooit aangeraakt. Een versie die via Steam is geïnstalleerd en nooit is gestart, wordt in zijn Steam-map gevonden. Een andere map stel je in bij Instellingen > Games.
#De exportmodi in X-Plane
| Modus | Wat er in X-Plane gebeurt |
|---|---|
| Alleen toevoegen | Alleen vrije inputs. Een toewijzing op een input met een andere functie of een ander commando wordt niet geschreven en wordt vermeld; een asfunctie die X-Plane op een andere as heeft, blijft daar (waarschuwing). |
| Bijwerken, toewijzingen van game behouden | Vervangt de andere functie of het andere commando op je input en houdt al het andere; een asfunctie verhuist (X-Plane negeert een functie die twee assen delen). |
| Bijwerken, mijn profiel wint | Maakt ook de andere assen en knoppen van aangesloten apparaten vrij die een functie of commando hebben dat je toewijst, met hun curves. |
| Vervangen op mijn apparaten | Maakt ook elke andere vliegas en elk ander commando vrij op de apparaten die je schrijft. |
| + Ook mijn andere apparaten wissen | De aangesloten apparaten die je niet schrijft, verliezen hun vliegfuncties en commando's. |
#Wat nooit wordt aangeraakt
- Slots van apparaten die niet aangesloten zijn, de apparaten die de import negeert en het vJoy-apparaat waar JoyPro naartoe doorstuurt.
- Assen voor kijken, camera, VR en eigen commando's, commando's van plug-ins en toestellen, het toetsenbord.
- Kalibratiesleutels (
_joy_center,_joy_null, ruwe kalibratiegegevens),_eq_pfc_*en elke andere regel.
#Curves en instellingen
- Granulariteit: één bestand voor alle toestellen (X-Plane kan toestellen aan bedieningsprofielen koppelen; JoyPro schrijft de bestanden die het vindt).
- Responscurves (asmodel
xplane): een willekeurig aantal punten met LINEAR, CATMULL_ROM of CUBIC_AVG, en de vaste bereiken van throttle-, prop- en mixture-assen (beta, feather, cutoff, FADEC ...). De Standaardcurve wordt omgezet in punten; een ongewijzigde curve houdt zijn bytes. Afstelling kan voor één versie of voor beide worden ingesteld (family:xplane). - Omkeren:
_joy_rev_axis, je omkering ongewijzigd (X-Plane keert throttles zelf om). - Game-instellingen (Instellingen > Force-feedbackinstellingen van de games): control response van pitch, roll en yaw; X-Plane 12 ook de copilootassen en "control-loaded axes" voor force-feedbacksticks; X-Plane 11 de stability augmentation; beide de flapstanden. Alleen regels die het bestand al heeft, worden gewijzigd.
- Force feedback: X-Plane heeft zelf geen; alleen de schakelaar voor control-loaded.
- Telemetrie-opname: uit de UDP-data-uitvoer van X-Plane (poort 49000), met positie, dus een Tacview-track is mogelijk.
- Gamebewaking: wijzigingen in de voorkeuren worden opgemerkt nadat X-Plane is gesloten (de gamebewaking).
#De X-Plane-integratie van binnen
flowchart LR P["Je profiel<br/>(relaties + toewijzingen)"] --> E["engine xplane12 export<br/>(of xplane11)"] D["Apparaatslots<br/>VID:PID + HID-pad"] --> E E --> J["Output / preferences /<br/>X-Plane Joystick Settings.prf"] E --> C["control profiles /<br/>Name - Joysticks.prf"] J --> G["X-Plane: Settings > Joystick"] C --> G
Code: engine\Games\XPlaneIntegration.cs (één instantie per versie), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (profielen van vóór de splitsing in twee versies worden bij het laden gemigreerd).
- Regels:
_joy_AXIS_use<i>(functiecode),_joy_rev_axis<i>,_joy_BUTN_use<i>(commandopad,sim/none/none= vrij),axis_response_curve<i>. Globale indexen: as = slot × 25 + as, knop = slot × 160 + knop. - Apparaten: slots
_joy_unique_id<slot> VID:<dec>PID:<dec>; bij identieke apparaten moet het DirectInput-HID-interfacepad gelijk zijn aan_joy_location<slot>. Knoppen zijn de knoppen van het apparaat, dan de eerste hat als 8 knoppen met de klok mee vanaf boven; andere hats worden niet gekoppeld. Leest 160 knoppen en 25 assen per apparaat. - Functiecodes: 0 tot 66 in beide versies; X-Plane 12 voegt throttle 9, pitch/roll/yaw/remmen/tiller van de copiloot en beide wielremmen toe. Codes 74 tot 77 en de kijkassen zijn niet gecatalogiseerd.
- Commandolijst:
engine xplane12 refresh-db/engine xplane11 refresh-db: de astabel van de versie plus de vliegcommandogroepen uitCommands.txt(sim/flight_controls,engines,autopilot,lights...; nietsim/view,operation,replay...). - Importeren / exporteren:
engine xplane12 import,engine xplane12 scan,engine xplane12 export(--mode,--nuke-untouched-devices,--dry-run), hetzelfde voorengine xplane11 export. Eerst een back-up naar.jpbak. - Instellingen en curves:
engine ffb set--game XPlane12,engine binds tuning set--scope game:XPlane12 --curve-points 0:0,0.4:0.3,1:1,engine binds tuning preview(gemeten in X-Plane 12.4.3 binnen 0.0001).
#Bekende beperkingen
- De betekenis van functiecodes 74 tot 77; de asvolgorde van HID tegenover DirectInput is afgeleid.
- De Control Sensitivity van X-Plane zonder curve zit niet in het voorbeeld.
- X-Plane 11 is alleen tegen zijn geïnstalleerde bestanden gecontroleerd; de controle in het menu van de game staat nog open.
- Tests:
engine\tests\smoke\xplane.ps1; in de game (X-Plane 12) slaagden toewijzingen en responscurves voor 33 van de 33 stappen;tools\e2e\games\XPlaneCurves.ps1loopt elke as door en vergelijkt met het voorbeeld van JoyPro.
Alle technische notities over deze game (gegenereerd uit de repository): xplane.md.