JoyPro2 Discord GitHub
Spiele

X-Plane 12 / 11

Zeigen:

X-Plane speichert die Zuweisungen aller Ihrer Geräte in einer Einstellungsdatei in seiner Installation: eine Achsen-„Verwendung“ (Nicken, Schub, Klappen ...) pro Hardware-Achse, ein Befehl pro Taste und optionale Antwortkurven. JoyPro liest diese Datei in Ihr Profil, verbindet sie in Relationen mit Ihren anderen Spielen und schreibt sie zurück, wobei es nur die Fluglinien ändert, die es verwaltet. X-Plane 12 und X-Plane 11 sind in JoyPro zwei Spiele, jedes mit eigener Installation, Befehlsliste und eigenen Einstellungen; beide können nebeneinander installiert sein.

X-Plane 12 direkt (eigene Belegungsdateien)
Unterstützung
direkt (eigene Belegungsdateien)
Engine-Befehl
engine xplane12
Belegungsdatei
Output\preferences\X-Plane Joystick Settings.prf, control profiles\*.prf (zeilenbasiert)
Eingaben, die das Spiel liest
liest pro Joystick 160 Tasten, 25 Achsen, 1 Hat (geprüft)
Befehlsliste aus
Resources\plugins\Commands.txt
Test im Spiel
33/33 Schritte bestanden (2026-10-11)
  • ✓ Importieren
  • ✓ Exportieren
  • ✗ Tastaturbelegungen
  • ✗ Modifikatoren
  • ✓ Befehlsliste auf Ihrem PC erstellt
  • ✓ Spielüberwachung
  • ✓ Achsenkurven und Totzonen
  • ✓ Steuerungseinstellungen des Spiels
  • ◐ Force-Feedback-Einstellungen im SpielX-Plane 12: nur der Schalter „control-loaded axes“ pro Gerät für Force-Feedback-Sticks; der Simulator hat selbst keine Force-Feedback-Effekte für den Stick (nur Plugins).
  • ✗ Force Feedback aus Telemetrie
  • ✓ Telemetrie-Aufzeichnung
  • ✓ Virtueller Joystick (vJoy)
  • ◐ Virtuelles Xbox-Pad
  • ✓ Virtuelle Funktionen
  • ✓ Einrichtungsassistent / Auto Assign
  • ✓ Cockpits
  • ✓ Spickzettel
  • ✓ Test im Spiel
X-Plane 11 direkt (eigene Belegungsdateien)
Unterstützung
direkt (eigene Belegungsdateien)
Engine-Befehl
engine xplane11
Belegungsdatei
wie X-Plane 12
Eingaben, die das Spiel liest
liest pro Joystick 160 Tasten, 25 Achsen, 1 Hat (geprüft)
Befehlsliste aus
Resources\plugins\Commands.txt
  • ✓ Importieren
  • ✓ Exportieren
  • ✗ Tastaturbelegungen
  • ✗ Modifikatoren
  • ✓ Befehlsliste auf Ihrem PC erstellt
  • ✓ Spielüberwachung
  • ✓ Achsenkurven und Totzonen
  • ✓ Steuerungseinstellungen des Spiels
  • ✗ Force-Feedback-Einstellungen im Spiel
  • ✗ Force Feedback aus Telemetrie
  • ✓ Telemetrie-Aufzeichnung
  • ✓ Virtueller Joystick (vJoy)
  • ◐ Virtuelles Xbox-Pad
  • ✓ Virtuelle Funktionen
  • ✓ Einrichtungsassistent / Auto Assign
  • ✓ Cockpits
  • ✓ Spickzettel
  • ✗ Test im Spiel

Aus der Unterstützungsmatrix, erzeugt aus dem Code der Engine: alle Spiele.

Für Einsteiger

#In 3 Schritten zum Laufen bringen

  1. Alles für mich einrichten
    auf der Seite Start
  2. Diese Tasten verwenden
    zuerst die Liste ansehen
  3. In mein Spiel schreiben
    X-Plane geschlossen lassen

Vorher: Starten Sie X-Plane einmal mit angeschlossenen Geräten und beenden Sie es dann.

Danach: Kalibrieren Sie Ihre Geräte in X-Plane (Settings > Joystick). Dort erscheinen auch Ihre Zuweisungen.

Haben Sie in X-Plane schon Tasten belegt? Dann bietet die Startseite Importieren, dann Lücken füllen an. Ihre Belegungen bleiben, und nur freie Tasten bekommen neue Aufgaben. Siehe Schnellstart: Meinen Stick zum Laufen bringen.

#Was JoyPro für X-Plane tut

  • Importieren: Die Achsenverwendungen, Tastenbefehle, Umkehr-Markierungen und Antwortkurven Ihrer Geräte kommen in Ihr Profil.
  • Relationen: Eine Relation ist eine Funktion in allen Ihren Spielen („Fahrwerk“ in X-Plane, MSFS und DCS auf derselben Taste). Die Flugbefehle von X-Plane kommen aus seiner eigenen Commands.txt.
  • Exportieren: JoyPro schreibt die Joystick-Einstellungen der Version, in die Sie exportieren. X-Plane zeigt Ihre Zuweisungen unter Settings > Joystick.

#Ihre X-Plane-Zuweisungen importieren

  1. Öffnen Sie Start. Die Karte X-Plane 12 (oder X-Plane 11) zeigt das Bild des Spiels. Wenn sie nach einer Befehlsliste fragt, drücken Sie Liste erstellen: JoyPro liest Resources\plugins\Commands.txt des installierten X-Plane.
  2. Drücken Sie Importieren auf der Karte und wählen Sie Zu meinem Profil hinzufügen (X-Plane hat in dieser Datei keine Tastaturbelegungen).
  3. Drücken Sie Jetzt importieren. Meine Relationen ansehen öffnet, was hereingekommen ist.
Die Seite Start mit Ihren SpielenDie Seite Start mit Ihren Spielen
Die Seite Start mit Ihren Spielen (Die Bilder zeigen die App auf Englisch.)

#Relationen bauen und prüfen

Auf der Seite Relationen steht der X-Plane-Befehl oder die X-Plane-Achse einer Relation neben derselben Funktion in Ihren anderen Spielen. Verbinden Sie sie mit dem Ablauf Relationen und drücken Sie dann Jetzt prüfen auf der Seite Export (die Prüfung).

#Nach X-Plane exportieren

  1. Schließen Sie X-Plane. Es schreibt seine Einstellungen neu, wenn das Einstellungsfenster schließt und wenn es beendet wird. Beide Versionen laufen als X-Plane.exe, darum verweigert JoyPro das Schreiben, solange eine davon läuft.
  2. Öffnen Sie Exportieren. Jede installierte Version hat ihre eigene Karte.
  3. Lassen Sie Auf meinen Geräten ersetzen mit Auch meine anderen Geräte leeren gewählt, wenn Sie Ihre Geräte in JoyPro einrichten. Drücken Sie Jetzt exportieren auf der Karte.
Im Spiel: Was Sie in X-Plane sehen

Starten Sie X-Plane, öffnen Sie Settings > Joystick und wählen Sie Ihr Gerät. Jede Achse zeigt die Verwendung, die JoyPro geschrieben hat, Tasten zeigen ihre Befehle, und Edit Response Curve auf einer Achse zeigt die Stützpunkte und die Interpolation, die JoyPro geschrieben hat.

#Was Sie in X-Plane selbst tun

  • Starten Sie X-Plane einmal mit angeschlossenen Geräten und beenden Sie es dann. Eine Version, die nie gestartet wurde, hat noch keine Einstellungsdatei. Der allererste Start fliegt das Tutorial, und X-Plane schreibt seine Joystick-Einstellungen beim Beenden.
  • Kalibrieren Sie in X-Plane. Kalibrierung und Nullzone bleiben bei X-Plane (Settings > Joystick); JoyPro schreibt sie nie.
  • Plugin- und Flugzeugbefehle stehen nicht in JoyPros Liste: Belegen Sie diese in X-Plane, JoyPro lässt sie in Ruhe.

#Häufige Stolperfallen

  • Eine Achse tut nichts („Multiple axes assigned to yaw“): X-Plane ignoriert eine Verwendung, die sich zwei angeschlossene Achsen teilen. Der Export warnt; Auch meine anderen Geräte leeren oder Ersetzen leert die andere Achse.
  • Der Schubhebel läuft verkehrt herum: X-Plane kehrt Schubachsen von selbst um. JoyPro schreibt Ihre Invertierung unverändert, also lassen Sie die Invertierung aus, außer Ihr Hebel läuft wirklich andersherum.
  • Eine Kurve, die Sie in X-Plane gemacht haben, hat sich geändert: In den Aktualisieren-Modi und bei Nur hinzufügen bleibt sie, wenn JoyPros Abstimmung linear ist (mit einer Warnung); „mein Profil gewinnt“ und Ersetzen schreiben JoyPros Kurve.
Erweitert

#Dateien, die JoyPro liest und schreibt

Datei Was es ist
<install>\Output\preferences\X-Plane Joystick Settings.prf die aktuellen Zuweisungen aller Geräte (zeilenbasiert)
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf gespeicherte Steuerungsprofile, gleiches Format
<file>.joypro.json, <file>.joypro-meta.json die Eingaben und Kurven, die JoyPro geschrieben hat; Namen, Gruppen und Abstimmung für den nächsten Import
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt wo der Installer von X-Plane seine Installationen auflistet (nur gelesen)

X-Plane Keys.prf (Tastatur) wird nie berührt. Eine Version, die über Steam installiert und nie gestartet wurde, wird in ihrem Steam-Ordner gefunden. Einen anderen Ordner stellen Sie unter Einstellungen > Spiele ein.

#Die Exportmodi in X-Plane

Modus Was in X-Plane passiert
Nur hinzufügen Nur freie Eingaben. Eine Belegung auf einer Eingabe mit einer anderen Verwendung oder einem anderen Befehl wird nicht geschrieben und aufgelistet; eine Achsenverwendung, die X-Plane auf einer anderen Achse hat, bleibt dort (Warnung).
Aktualisieren, Belegungen des Spiels behalten Ersetzt die andere Verwendung oder den anderen Befehl auf Ihrer Eingabe und behält alles andere; eine Achsenverwendung wird verschoben (X-Plane ignoriert eine Verwendung, die sich zwei Achsen teilen).
Aktualisieren, mein Profil gewinnt Gibt außerdem die anderen Achsen und Tasten angeschlossener Geräte frei, die eine Verwendung oder einen Befehl haben, den Sie belegen, mitsamt ihren Kurven.
Auf meinen Geräten ersetzen Gibt außerdem jede andere Flugachse und jeden anderen Befehl auf den Geräten frei, die Sie schreiben.
+ Auch meine anderen Geräte leeren Die angeschlossenen Geräte, die Sie nicht schreiben, verlieren ihre Flugverwendungen und -befehle.

#Was nie angefasst wird

  • Slots von Geräten, die nicht angeschlossen sind, die beim Import ignorierten Geräte und das vJoy-Gerät, in das JoyPro einspeist.
  • Achsen für Blick, Kamera, VR und eigene Befehle, Plugin- und Flugzeugbefehle, die Tastatur.
  • Kalibrierungsschlüssel (_joy_center, _joy_null, rohe Kalibrierungsdaten), _eq_pfc_* und jede andere Zeile.

#Kurven und Einstellungen

  • Granularität: eine Datei für alle Flugzeuge (X-Plane kann Flugzeuge mit Steuerungsprofilen verknüpfen; JoyPro schreibt die Dateien, die es findet).
  • Antwortkurven (Achsenmodell xplane): beliebig viele Stützpunkte mit LINEAR, CATMULL_ROM oder CUBIC_AVG und die festen Bereiche der Schub-, Propeller- und Gemischachsen (Beta, Feather, Cutoff, FADEC ...). Die Standardkurve wird zu Stützpunkten; eine unveränderte Kurve behält ihre Bytes. Die Abstimmung kann für eine Version oder für beide gesetzt werden (family:xplane).
  • Umkehren: _joy_rev_axis, Ihre Invertierung unverändert (X-Plane kehrt Schubhebel selbst um).
  • Spieleinstellungen (Einstellungen > Force-Feedback-Einstellungen der Spiele): Steuerungsansprechen von Pitch, Roll und Yaw; X-Plane 12 außerdem die Copilot-Achsen und „control-loaded axes“ für Force-Feedback-Sticks; X-Plane 11 die Stabilitätserhöhung; beide die Klappenrasten. Nur Zeilen, die die Datei schon hat, werden geändert.
  • Force Feedback: X-Plane hat kein eigenes; nur den Schalter control-loaded.
  • Telemetrie-Aufzeichnung: aus der UDP-Datenausgabe von X-Plane (Port 49000), mit Position, sodass eine Tacview-Spur möglich ist.
  • Überwachung: Änderungen in den Einstellungen bemerkt JoyPro, nachdem X-Plane geschlossen wurde (die Überwachung).
Technische Details

#Im Inneren der X-Plane-Anbindung

flowchart LR
  P["Ihr Profil<br/>(Relationen + Belegungen)"] --> E["engine xplane12 export<br/>(oder xplane11)"]
  D["Geräte-Slots<br/>VID:PID + HID-Pfad"] --> 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
Jede X-Plane-Version hat ihre eigene Einstellungsdatei. Kalibrierung und Nullzone bleiben bei X-Plane.

Code: engine\Games\XPlaneIntegration.cs (eine Instanz pro Version), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (Profile von vor der Aufteilung in zwei Versionen werden beim Laden umgestellt).

  • Zeilen: _joy_AXIS_use<i> (Verwendungscode), _joy_rev_axis<i>, _joy_BUTN_use<i> (Befehlspfad, sim/none/none = frei), axis_response_curve<i>. Globale Indizes: Achse = Slot × 25 + Achse, Taste = Slot × 160 + Taste.
  • Geräte: Slots _joy_unique_id<slot> VID:<dec>PID:<dec>; bei gleichen Geräten muss der DirectInput-HID-Schnittstellenpfad gleich _joy_location<slot> sein. Tasten sind die Tasten des Geräts, dann der erste Hat als 8 Tasten im Uhrzeigersinn ab oben; andere Hats werden nicht zugeordnet. Liest 160 Tasten und 25 Achsen pro Gerät.
  • Verwendungscodes: 0 bis 66 in beiden Versionen; X-Plane 12 fügt Schub 9, Copilot-Pitch/-Roll/-Yaw/-Bremsen/-Bugradsteuerung und beide Radbremsen hinzu. Die Codes 74 bis 77 und die Blickachsen sind nicht katalogisiert.
  • Befehlsliste: engine xplane12 refresh-db / engine xplane11 refresh-db: die Achsentabelle der Version plus die Flugbefehlsgruppen von Commands.txt (sim/flight_controls, engines, autopilot, lights ...; nicht sim/view, operation, replay ...).
  • Import / Export: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), dasselbe für engine xplane11 export. Zuerst Sicherung nach .jpbak.
  • Einstellungen und Kurven: 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 (in X-Plane 12.4.3 auf 0.0001 genau gemessen).

#Bekannte Grenzen

  • Die Bedeutung der Verwendungscodes 74 bis 77; die Achsenreihenfolge HID gegenüber DirectInput ist erschlossen.
  • Die Control Sensitivity von X-Plane ohne Kurve ist nicht in der Vorschau.
  • X-Plane 11 ist nur gegen seine installierten Dateien geprüft; die Prüfung im Menü des Spiels steht noch aus.
  • Tests: engine\tests\smoke\xplane.ps1; im Spiel (X-Plane 12) haben Belegungen und Antwortkurven 33 von 33 Schritten bestanden; tools\e2e\games\XPlaneCurves.ps1 fährt jede Achse ab und vergleicht sie mit der Vorschau von JoyPro.

Alle technischen Hinweise zu diesem Spiel (erzeugt aus dem Repository): xplane.md.