X4: Foundations speichert Ihre Belegungen in inputmap.xml und benennt einen Joystick nach seinem Platz (1 bis 8), nicht nach seinem Namen. Welches Gerät auf welchem Platz sitzt, steht in config.xml. JoyPro liest die Raumflug-Belegungen in Ihr Profil und schreibt sie direkt dort zurück, auf die Plätze, die X4 Ihren Geräten fest zugewiesen hat. Invertierungen und die Totzone gelten in X4 für das ganze Spiel, darum setzt JoyPro sie aus Ihren Relationen für das ganze Spiel.
X4: Foundations direkt (eigene Belegungsdateien)
- Unterstützung
- direkt (eigene Belegungsdateien)
- Engine-Befehl
engine x4- Belegungsdatei
Documents\Egosoft\X4\<id>\inputmap.xml(XML) + die Slots inconfig.xml- Eingaben, die das Spiel liest
- liest pro Joystick 64 Tasten, 8 Achsen, 1 Hat (geprüft)
- Befehlsliste aus
- die Namenstabellen von
X4.exeund die.cat/.dat-Archive - Test im Spiel
- 36/36 Schritte bestanden (2026-10-11)
- ✓ Importieren
- ✓ Exportieren
- ✓ Tastaturbelegungen
- ◐ ModifikatorenX4: Shift/Ctrl auf Tastaturbelegungen; Joystick-Belegungen nehmen keinen Modifikator.
- ✓ Befehlsliste auf Ihrem PC erstellt
- ✓ Spielüberwachung
- ✗ Achsenkurven und TotzonenX4: nur die spielweite Totzone und die Invertierungen (Game settings), nichts pro Belegung.
- ✓ 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
X Rebirth nur dokumentiert
- Unterstützung
- nur dokumentiert
- Engine-Befehl
- keine
- — 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
X3 (Reunion, Terran Conflict, Albion Prelude) nur dokumentiert
- Unterstützung
- nur dokumentiert
- Engine-Befehl
- keine
- — 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.
#In 3 Schritten zum Laufen bringen
- Alles für mich einrichten
auf der Seite Start - Diese Tasten verwenden
zuerst die Liste ansehen - In mein Spiel schreiben
X4 geschlossen lassen
Vorher: Geben Sie jedem Gerät einmal einen Platz. Öffnen Sie in den Steuerungseinstellungen von X4 Manage Controllers/Joysticks. Weisen Sie jedes Gerät einem Platz zu und verlassen Sie das Spiel dann normal.
Danach: Ihre Belegungen stehen unter Settings > Controls.
Haben Sie in X4 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 X4 tut
- Importieren: Die Raumflug-Belegungen Ihrer Sticks, Schubhebel und Pedale kommen in Ihr Profil, mit den Invertierungen und dem Schubmodus des Spiels.
- Relationen: Eine Relation ist eine Funktion in jedem Spiel. „Boost“ kann dieselbe Taste in X4, Elite Dangerous und Star Citizen sein.
- Exportieren: JoyPro bearbeitet
inputmap.xmldirekt, auf den Plätzen Ihrer Geräte. Belegungen für Menü, Ego-Perspektive, Tastatur und Maus bleiben.
#Ihre X4-Belegungen importieren
- Öffnen Sie Start. Wenn die X4-Karte nach einer Befehlsliste fragt, drücken Sie Liste erstellen: JoyPro liest die Steuerung des Spiels aus Ihrer Installation (nur lesend).
- Drücken Sie Importieren auf der X4-Karte. Lassen Sie Zu meinem Profil hinzufügen gewählt. Haken Sie Auch die Tastaturbelegungen übernehmen an, wenn Sie Ihre Flugtasten auch in JoyPro haben möchten.
- Drücken Sie Jetzt importieren. Meine Relationen ansehen öffnet, was hereingekommen ist.
#Relationen bauen und prüfen
Verbinden Sie dieselbe Funktion Ihrer Spiele mit dem Ablauf Relationen und drücken Sie dann Prüfen auf der Seite Export. Lassen Sie Ihre Joystick-Belegungen ohne Modifikatoren: X4 nimmt auf einer Joystick-Belegung keinen Modifikator an.
#Nach X4 exportieren
- Schließen Sie X4. Das Spiel schreibt
inputmap.xmlundconfig.xml, wenn eine Sitzung endet, darum schreibt JoyPro nicht, solange es läuft. - Öffnen Sie Exportieren und haken Sie die X4-Karte an.
- Lassen Sie Auf meinen Geräten ersetzen mit Auch meine anderen Geräte leeren gewählt, wenn Sie Ihre Sticks in JoyPro einrichten. Drücken Sie Jetzt exportieren auf der Karte.
Starten Sie das Spiel und öffnen Sie Settings > Controls. Ihre Belegungen stehen in der Spalte Controller / Joystick jeder Raumflugsteuerung, auf dem Platz Ihres Geräts. Invert Controller / Joystick Axes zeigt die Invertierungen, die JoyPro gesetzt hat, und die Zeilen für bidirektionalen Schub, Joystick-Totzone und adaptive Steuerung zeigen Ihre Werte. Auto-Roll und Vibration stehen in den Spieleinstellungen.
#Was Sie in X4 selbst tun
- Geben Sie jedem Gerät einmal einen Platz. Öffnen Sie in den Steuerungseinstellungen von X4 Manage Controllers/Joysticks, weisen Sie jeden Stick, Schubhebel und jedes Pedal-Set einem Platz zu und verlassen Sie das Spiel dann normal. X4 merkt sich das Gerät dann in
config.xml. Ein Gerät ohne solchen Eintrag wandert von einer Sitzung zur nächsten zwischen den Plätzen, darum überspringt JoyPro es („Gerät in X4 einmal einem Platz zuweisen“). Ein Gerät, das dort auf „none“ steht, wird ebenfalls übersprungen. - Schließen Sie Ihre Geräte vor dem Export an.
#Häufige Stolperfallen
- „X4 läuft“: Beenden Sie das Spiel und exportieren Sie erneut.
- Ein Gerät wurde übersprungen: Es ist in X4 keinem Platz fest zugewiesen. Weisen Sie es unter Manage Controllers/Joysticks zu.
- Ein Stick auf Platz 1 macht Gamepad-Dinge: Platz 1 ist der Gamepad-Platz der Standardbelegung von X4, darum erbt ein Stick dort die mitgelieferten Gamepad-Belegungen. Auf meinen Geräten ersetzen entfernt sie.
- Tasten über 64 oder ein zweiter Hat tun nichts: X4 liest 64 Tasten, 8 Achsen und einen Hat pro Gerät. JoyPro überspringt Belegungen darüber hinaus mit einer Warnung.
- Eine Invertierung wurde nicht angefasst: Eine Invertierung gilt für jedes Gerät auf dieser Steuerung. Wenn Ihre Relationen sich widersprechen oder ein Gamepad auf dieselbe Steuerung belegt ist, lässt JoyPro den Wert des Spiels und warnt.
#Dateien, die JoyPro liest und schreibt
| Datei | Was es ist |
|---|---|
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml |
die aktiven Belegungen (<action>, <state>, <range> pro Steuerung und Eingabe) und die <config>-Parameter (Invertierungen, Totzone, bidirektionaler Schub, adaptive Lenkung). <id> ist der Ordner des Steam-Kontos. |
...\X4\<id>\config.xml |
die Geräte-Slots (<joysticks>) und Spieleinstellungen wie Rumble, Auto-Roll und Gamepad-Modus; für die Slots gelesen, für die Einstellungen an Ort und Stelle bearbeitet |
...\X4\<id>\inputmap.xml.joypro-meta.json |
JoyPros Namen, Gruppen und Tuning der geschriebenen Belegungen, beim nächsten Import zurückgelesen |
inputmap.xml.jpbak, config.xml.jpbak |
Kopien von vor dem ersten Schreiben, dazu JoyPros versionierter Sicherungsspeicher |
Die Datei wird als Text geschrieben: Die Deklaration, Zeilenenden, Einrückung, die Abschnittskommentare, <config>, die Wurzelattribute und jede unberührte Zeile bleiben Byte für Byte gleich. Eine neue Zeile kommt in ihren Abschnitt nach dem letzten Eintrag derselben Art mit einer niedrigeren Steuerungsnummer. JoyPro berührt nie die gespeicherten Profile inputmap_1.xml bis inputmap_5.xml oder Ihre Spielstände. Steam Cloud synchronisiert den Ordner; welche Dateien es synchronisiert, ist noch nicht bestätigt.
#Die Exportmodi in X4
Ein Konflikt ist eine andere Flugsteuerung auf demselben Slot und derselben Eingabe. Die Karten- und Detailmonitor-Zwillinge einer Steuerung zählen als dieselbe Steuerung.
| Modus | Was in inputmap.xml passiert |
|---|---|
| Nur hinzufügen | Nichts wird entfernt. Eine Belegung, deren Eingabe eine andere Flugsteuerung hat, wird nicht geschrieben und bekommt die Markierung „Nicht ins Spiel geschrieben“. |
| Aktualisieren, Belegungen des Spiels behalten | Ihre Zeilen kommen neben die anderen Eingaben der Steuerung; nur Konflikte werden entfernt. |
| Aktualisieren, mein Profil gewinnt | Wie oben, und eine Steuerung, die Sie belegen, verliert ihre anderen Zeilen auf festgelegten Slots angeschlossener Geräte (mit der Tastatur-Option auch ihre Tastaturzeilen). |
| Auf meinen Geräten ersetzen | Die Flugbelegungen der geschriebenen Slots, die nicht in Ihrem Profil sind, werden entfernt, auch die Standard-Gamepad-Flugbelegungen auf Slot 1. |
| + Auch meine anderen Geräte leeren | Dasselbe für Slots, die config.xml an angeschlossene Geräte bindet, die der Export nicht nutzt. Ein Slot ohne festgelegtes Gerät bleibt unberührt: Sein Gerät ist unbekannt. |
Das Menü von X4 belegt manche Steuerungen gemeinsam: „Toggle Travel Mode“ setzt dieselbe Eingabe auch in der Karte, „Dock“ dockt auch ab. JoyPro schreibt und entfernt solche Gruppen so wie das Menü und entfernt nie den Ego-Perspektive-Zwilling von „Interact“.
#Was nie angefasst wird
- Steuerungen für Menü, Karte, Ego-Perspektive, Optionen und Barrierefreiheit; Einträge des Radialmenüs.
- Tastatur- und Mauszeilen; die Tastatur wird nur mit der Tastatur-Option geschrieben, nur für Flugsteuerungen, nie mit den Tasten, die das Menü von X4 ablehnt (Escape, Delete, Ctrl+X/C/V ...).
- Slots von Geräten, die nicht angeschlossen oder nicht festgelegt sind, Gamepads, die beim Import ignorierten Geräte und das vJoy-Gerät, in das JoyPro einspeist.
- Jede
<config>-Zeile, die JoyPro nicht setzt.
#Kurven und Spieleinstellungen
- Granularität: ein Satz Belegungen für jedes Schiff (die Raumflugsteuerung).
- Invertierungen sind ein Wert pro Steuerung für jedes Gerät (
invert_steering_yaw,_pitch,_roll,invert_throttle,invert_strafe_*). Ihre Relation behält die Richtung von DCS; die eigenen HOTAS-Maps von X4 zählen Pitch, Roll und Schub als invertiert, darum setzt JoyPro den Parameter für diese auf Ihre Invertierung umgekehrt. Es setzt einen Parameter nur, wenn alle JoyPro-Achsen auf dieser Steuerung übereinstimmen. - Bidirektionaler Schub folgt dem Schieberegler der Schub-Relation: Schieberegler = nur vorwärts, kein Schieberegler = die Mitte ist null Schub.
- Totzone: X4 hat eine Totzone für jede Achse jedes Joysticks. Totzonen der Relationen werden nicht geschrieben (der Export sagt das); stellen Sie die Totzone des Spiels unter Einstellungen > Force-Feedback-Einstellungen der Spiele ein (X4 wählen) oder mit
engine ffb set. An derselben Stelle stehen adaptive Lenkung, Rumble, Auto-Roll und Gamepad-Modus. Eine Einstellung, die Sie dort speichern, gewinnt gegen die Relationen, mit einer Warnung, wenn sie sie umkehrt. - Keine Kurven oder Sättigung pro Achse in X4; kein Force Feedback; keine Telemetrie.
- Überwachung: Eine Belegung oder Option, die Sie im Spiel ändern, bemerkt JoyPro, nachdem es geschlossen wurde (
inputmap.xmlundconfig.xml), und fragt, ob es sie übernehmen soll. - HUD: Das HUD erkennt das Spiel an seinem Prozess und zeigt Ihre X4-Belegungen.
#X Rebirth und X3
X Rebirth nutzt dieselben inputmap.xml-Wörter wie X4, aber seine Befehlsliste müsste eigens aus einer Installation ausgelesen werden. X3 (Reunion, Terran Conflict, Albion Prelude) hat eine andere Engine und ein unbekanntes Dateiformat. Beide sind nur dokumentiert: JoyPro importiert oder exportiert sie nicht.
#Im Inneren der X4-Anbindung
flowchart LR D["Ihr Gerät<br/>(Instanz-GUID)"] --> C["config.xml<br/>joysticks"] C --> S["An einen Slot gebunden:<br/>Slot 1 ... 8"] C --> K["Nicht gebunden oder deaktiviert:<br/>übersprungen, einmal<br/>in X4 zuweisen"] P["Das Profil"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>Belegungen pro Slot"] E --> O["spielweite Optionen:<br/>Invertierungen, Schubmodus"]
Code: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs und das Einstellungsmodell engine\FfbModels\X4.cs.
- Slots: Eine Belegung nennt eine Quelle:
INPUT_SOURCE_JOYBUTTONS(Tasten und Hat) oderINPUT_SOURCE_JOYAXES, ohne Zusatz für Slot 1 und mit_2bis_8für die anderen.config.xmlordnet Geräte über die DirectInput-Instanz-GUID Slots zu, in der eigenen Schreibweise von X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00});num0 bis 7 ist der Slot,disabled="1"bedeutet keiner. JoyPro schreibt nur in Slots, deren aktueller, aktivierter Eintrag zu einem angeschlossenen Gerät passt. - Codes: Die Tasten 1 bis 11 nutzen die Gamepad-Namen von X4 (
INPUT_XBUTTON_A...BIGBUTTON), 12 bis 64INPUT_XBUTTON_12...; der HatINPUT_XBUTTON_DPAD_*(acht Richtungen); AchsenINPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Bereiche bekommen keinsgn. Tastatur:INPUT_KEYCODE_<DIK>mit_SHIFT/_CONTROL. - Befehlsliste:
engine x4 refresh-dbliestgameoptions.luaund die englische Textseite aus den.cat/.dat-Archiven und den Namenstabellen vonX4.exe, nur lesend; 128 Raumflugsteuerungen (6 Achsen, 122 Tasten). Zeilen lauten etwa „Yaw (Primary Steering Axis)“, „Roll (Secondary Steering Axis)“.engine x4 cataloglistet sie,engine x4 pathszeigt die gefundenen Dateien. - Import / Export:
engine x4 import,engine x4 scan;engine x4 export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run. - Spieleinstellungen:
engine ffb set --device * --game X4 --param <key>=<value>; Parameter werden an Ort und Stelle bearbeitet, ein fehlender wird als letzte Zeile von<config>hinzugefügt. Ein Export ohne X4-Belegungen schreibt trotzdem die gespeicherten Einstellungen.
#Bekannte Grenzen
- Geräte ohne festgelegten Slot werden übersprungen; JoyPro legt sie noch nicht selbst fest.
- Joystick-Modifikatoren werden nicht geschrieben: Ihre Schreibweise in der Datei ist noch nicht bestätigt.
- 64 Tasten, 8 Achsen und ein Hat pro Gerät; acht Slots, gemeinsam mit Gamepads.
- Rumble: Der Regler des Spiels zeigt den Wert mal 100 abgeschnitten (21 % erscheint als 20); die Datei behält den genauen Wert.
- Tests:
engine\tests\smoke\x4.ps1(auch die Katalog-Aktualisierung); im Spieltools\e2e\games\X4.ps1(Belegungen und Modus-Matrix, in einem eigenen Profilordner) undtools\e2e\games\X4Settings.ps1(Invertierungen, Schubmodus, Spieleinstellungen).
Alle technischen Hinweise zu diesem Spiel (erzeugt aus dem Repository): x4.md.