JoyPro2 Discord GitHub
Games

X4: Foundations

Tonen:

X4: Foundations bewaart je toewijzingen in inputmap.xml en noemt een joystick naar zijn vak (1 tot 8), niet naar zijn naam. Welk apparaat in welk vak zit, staat in config.xml. JoyPro leest de ruimtevluchttoewijzingen in je profiel en schrijft ze ter plekke terug, naar de vakken die X4 aan je apparaten heeft vastgezet. Omkeringen en de dode zone gelden in X4 voor de hele game, dus JoyPro stelt ze vanuit je relaties in voor de hele game.

X4: Foundations rechtstreeks (eigen toewijzingsbestanden)
Ondersteuning
rechtstreeks (eigen toewijzingsbestanden)
Engine-commando
engine x4
Toewijzingsbestand
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + de slots in config.xml
Inputs die de game leest
leest 64 knoppen, 8 assen, 1 hat per joystick (geverifieerd)
Commandolijst uit
de naamtabellen van X4.exe en de .cat/.dat-archieven
In-game test
36/36 stappen geslaagd (2026-10-11)
  • ✓ Importeren
  • ✓ Exporteren
  • ✓ Toetsenbordtoewijzingen
  • ◐ ModifiersX4: Shift/Ctrl op toetsenbordtoewijzingen; joysticktoewijzingen krijgen geen modifier.
  • ✓ Commandolijst gemaakt op je pc
  • ✓ Gamebewaking
  • ✗ Ascurves en dode zonesX4: alleen de game-brede dode zone en het omkeren (Game settings), niets per toewijzing.
  • ✓ 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
X Rebirth alleen beschreven
Ondersteuning
alleen beschreven
Engine-commando
geen
  • — 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
X3 (Reunion, Terran Conflict, Albion Prelude) alleen beschreven
Ondersteuning
alleen beschreven
Engine-commando
geen
  • — 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.

Voor beginners

#In 3 stappen aan de slag

  1. Alles voor me instellen
    op de startpagina
  2. Deze knoppen gebruiken
    bekijk eerst de lijst
  3. Naar mijn game schrijven
    houd X4 gesloten

Vooraf: geef elk apparaat één keer een vak. Open in de bedieningsinstellingen van X4 Manage Controllers/Joysticks. Wijs elk apparaat toe aan een vak en verlaat de game dan normaal.

Daarna: je toewijzingen staan in Settings > Controls.

Heb je eerder knoppen toegewezen in X4? 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 X4

  • Importeren: de ruimtevluchttoewijzingen van je sticks, throttles en pedalen komen in je profiel, met de omkeringen en de throttlemodus van de game.
  • Relaties: één relatie is één functie in elke game. "Boost" kan dezelfde knop zijn in X4, Elite Dangerous en Star Citizen.
  • Exporteren: JoyPro bewerkt inputmap.xml ter plekke, op de vakken van je apparaten. Toewijzingen voor menu, first-person, toetsenbord en muis blijven.

#Je toewijzingen uit X4 importeren

  1. Open Start. Vraagt de kaart van X4 om een commandolijst, druk dan op Lijst maken: JoyPro leest de bediening van de game uit je installatie (alleen lezen).
  2. Druk op de kaart van X4 op Importeren. Laat Aan mijn profiel toevoegen staan. Vink Neem ook de toetsenbordtoetsen over aan als je je vliegtoetsen ook in JoyPro wilt.
  3. Druk op Nu importeren. Mijn relaties bekijken opent wat er binnenkwam.

#Relaties maken en controleren

Koppel dezelfde functie van je games met de werkwijze voor relaties en druk dan op Controleren op de pagina Exporteren. Houd je joysticktoewijzingen zonder modifiers: X4 neemt geen modifier op een joysticktoewijzing.

#Naar X4 exporteren

  1. Sluit X4. De game schrijft inputmap.xml en config.xml als een sessie eindigt, dus JoyPro weigert te schrijven zolang hij draait.
  2. Open Exporteren en vink de kaart van X4 aan.
  3. Laat Vervangen op mijn apparaten met Ook mijn andere apparaten wissen staan als je je sticks in JoyPro instelt. Druk op Nu exporteren op de kaart.
In de game: Wat je in X4 ziet

Start de game en open Settings > Controls. Je toewijzingen staan in de kolom controller / joystick van elke ruimtevluchtbediening, op het vak van je apparaat. Invert Controller / Joystick Axes toont de omkeringen die JoyPro heeft ingesteld, en de rijen voor de bidirectionele throttle, de dode zone van de joystick en adaptief sturen tonen je waarden. Auto-roll en rumble staan in de game-instellingen.

#Wat je zelf doet in X4

  • Geef elk apparaat één keer een vak. Open in de bedieningsinstellingen van X4 Manage Controllers/Joysticks en wijs elke stick, throttle en set pedalen toe aan een vak, en verlaat de game dan normaal. X4 onthoudt het apparaat dan in config.xml. Een apparaat zonder zo'n vermelding verschuift van de ene sessie naar de volgende tussen vakken, dus JoyPro slaat het over ("wijs het apparaat één keer toe aan een vak in X4"). Een apparaat dat daar op "none" staat, wordt ook overgeslagen.
  • Sluit je apparaten aan voordat je exporteert.

#Veelgemaakte fouten

  • "X4 draait": sluit de game af en exporteer opnieuw.
  • Een apparaat werd overgeslagen: het is in X4 niet aan een vak vastgezet. Wijs het toe onder Manage Controllers/Joysticks.
  • Een stick in vak 1 doet gamepaddingen: vak 1 is het gamepadvak van de standaardmap van X4, dus een stick daar erft de standaard gamepadtoewijzingen. Vervangen op mijn apparaten verwijdert ze.
  • Knoppen boven 64 of een tweede hat doen niets: X4 leest 64 knoppen, 8 assen en één hat per apparaat. JoyPro slaat toewijzingen daarboven over met een waarschuwing.
  • Een omkering bleef ongemoeid: één omkering geldt voor elk apparaat op die bediening. Zijn je relaties het oneens, of is een gamepad aan dezelfde bediening toegewezen, dan laat JoyPro de waarde van de game staan en waarschuwt.
Geavanceerd

#Bestanden die JoyPro leest en schrijft

Bestand Wat het is
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml de actieve toewijzingen (<action>, <state>, <range> per bedieningselement en input) en de <config>-parameters (omkeringen, dode zone, bidirectionele throttle, adaptieve besturing). <id> is de map van het Steam-account.
...\X4\<id>\config.xml de apparaatslots (<joysticks>) en game-instellingen zoals rumble, auto-roll en gamepadmodus; gelezen voor de slots, ter plekke bewerkt voor de instellingen
...\X4\<id>\inputmap.xml.joypro-meta.json de namen, groepen en afstemming van JoyPro voor de geschreven toewijzingen, teruggelezen bij de volgende import
inputmap.xml.jpbak, config.xml.jpbak kopieën van vóór de eerste keer schrijven, plus de opslag van JoyPro voor back-ups met versies

Het bestand wordt als tekst geschreven: de declaratie, regeleinden, inspringing, het commentaar bij de secties, <config>, de rootattributen en elke ongewijzigde regel blijven byte voor byte gelijk. Een nieuwe regel komt in zijn sectie na de laatste vermelding van dezelfde soort met een lager bedieningsnummer. JoyPro raakt de opgeslagen profielen inputmap_1.xml tot inputmap_5.xml en je savegames nooit aan. Steam Cloud synchroniseert de map; welke bestanden het synchroniseert, is nog niet bevestigd.

#De exportmodi in X4

Een conflict is een ander vliegbedieningselement op dezelfde slot en input. De tweelingen van een bedieningselement voor de kaart en de detailmonitor tellen als hetzelfde element.

Modus Wat er in inputmap.xml gebeurt
Alleen toevoegen Er wordt niets verwijderd. Een toewijzing waarvan de input al bij een ander vliegbedieningselement hoort, wordt niet geschreven en krijgt de markering "Niet in de game geschreven".
Bijwerken, toewijzingen van game behouden Je regels komen naast de andere inputs van het bedieningselement; alleen conflicten worden verwijderd.
Bijwerken, mijn profiel wint Zoals hierboven, en een bedieningselement dat je toewijst, verliest zijn andere regels op vastgezette slots van aangesloten apparaten (met de toetsenbordoptie ook zijn toetsenbordregels).
Vervangen op mijn apparaten De vliegtoewijzingen van de geschreven slots die niet in je profiel staan, worden verwijderd, ook de standaard vliegtoewijzingen voor de gamepad op slot 1.
+ Ook mijn andere apparaten wissen Hetzelfde voor slots die config.xml vastzet op aangesloten apparaten die de export niet gebruikt. Een slot zonder vastgezet apparaat blijft ongemoeid: het apparaat ervan is onbekend.

Het menu van X4 wijst sommige bedieningselementen samen toe: "Toggle Travel Mode" zet dezelfde input ook binnen de kaart, "Dock" koppelt ook af. JoyPro schrijft en verwijdert zulke groepen zoals het menu dat doet, en verwijdert nooit de "Interact"-tweeling voor de eerstepersoonsweergave.

#Wat nooit wordt aangeraakt

  • Bedieningselementen voor menu, kaart, eerstepersoonsweergave, opties en toegankelijkheid; items van het radiale menu.
  • Regels voor toetsenbord en muis; het toetsenbord wordt alleen met de toetsenbordoptie geschreven, alleen voor vliegbediening, nooit met de toetsen die het menu van X4 weigert (Escape, Delete, Ctrl+X/C/V ...).
  • Slots van apparaten die niet aangesloten of niet vastgezet zijn, gamepads, de apparaten die de import negeert en het vJoy-apparaat waar JoyPro naartoe doorstuurt.
  • Elke <config>-regel die JoyPro niet instelt.

#Curves en game-instellingen

  • Granulariteit: één set toewijzingen voor elk schip (de bediening voor ruimtevluchten).
  • Omkeringen zijn één waarde per bedieningselement voor elk apparaat (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). Je relatie houdt de richting van DCS; de eigen HOTAS-maps van X4 tellen pitch, roll en throttle als omgekeerd, dus zet JoyPro voor die assen de parameter op je omkering, omgedraaid. Het zet een parameter alleen als elke JoyPro-as op dat bedieningselement het eens is.
  • Bidirectionele throttle volgt de Schuif van de throttlerelatie: Schuif = alleen vooruit, geen Schuif = het midden is nul stuwkracht.
  • Dode zone: X4 heeft één dode zone voor elke as van elke joystick. Dode zones van relaties worden niet geschreven (de export zegt dat); stel de dode zone van de game in bij Instellingen > Force-feedbackinstellingen van de games (kies X4) of met engine ffb set. Op dezelfde plek staan adaptieve besturing, rumble, auto-roll en gamepadmodus. Een instelling die je daar opslaat, wint van de relaties, met een waarschuwing als ze die omkeert.
  • Geen curves of verzadiging per as in X4; geen force feedback; geen telemetrie.
  • Gamebewaking: een toewijzing of optie die je in de game wijzigt, wordt opgemerkt nadat de game is gesloten (inputmap.xml en config.xml), en JoyPro vraagt of het die moet overnemen.
  • HUD: de HUD vindt de game aan zijn proces en toont je toewijzingen voor X4.

#X Rebirth en X3

X Rebirth gebruikt dezelfde woorden in inputmap.xml als X4, maar de commandolijst zou een eigen extractie uit een installatie nodig hebben. X3 (Reunion, Terran Conflict, Albion Prelude) heeft een andere engine en een onbekend bestandsformaat. Beide zijn alleen beschreven: JoyPro importeert of exporteert ze niet.

Technische details

#De X4-integratie van binnen

flowchart LR
  D["Je apparaat<br/>(instance-GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["Vastgezet op een slot:<br/>slot 1 ... 8"]
  C --> K["Niet vastgezet of uitgeschakeld:<br/>overgeslagen, wijs het<br/>één keer toe in X4"]
  P["Je profiel"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>toewijzingen per slot"]
  E --> O["opties voor de hele game:<br/>omkeringen, throttlemodus"]
X4 noemt een joystick naar zijn slot. Een apparaat zonder vaste slot wordt overgeslagen.

Code: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs en het instellingenmodel engine\FfbModels\X4.cs.

  • Slots: een toewijzing noemt een bron: INPUT_SOURCE_JOYBUTTONS (knoppen en hat) of INPUT_SOURCE_JOYAXES, zonder achtervoegsel voor slot 1 en _2 tot _8 voor de andere. config.xml koppelt apparaten aan slots via de DirectInput-instance-GUID, geschreven in de eigen vorm van X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); num 0 tot 7 is de slot, disabled="1" betekent geen. JoyPro schrijft alleen naar slots waarvan de huidige, ingeschakelde vermelding bij een aangesloten apparaat past.
  • Codes: knoppen 1 tot 11 gebruiken de gamepadnamen van X4 (INPUT_XBUTTON_A ... BIGBUTTON), 12 tot 64 INPUT_XBUTTON_12 ...; de hat INPUT_XBUTTON_DPAD_* (acht richtingen); assen INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Bereiken krijgen geen sgn. Toetsenbord: INPUT_KEYCODE_<DIK> met _SHIFT / _CONTROL.
  • Commandolijst: engine x4 refresh-db leest gameoptions.lua en de Engelse tekstpagina uit de .cat/.dat-archieven en de naamtabellen van X4.exe, alleen lezend; 128 bedieningselementen voor ruimtevluchten (6 assen, 122 knoppen). Rijen luiden bijvoorbeeld "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)". engine x4 catalog toont de lijst, engine x4 paths toont de gevonden bestanden.
  • Importeren / exporteren: 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.
  • Game-instellingen: engine ffb set --device * --game X4 --param <key>=<value>; parameters worden ter plekke bewerkt, een ontbrekende wordt als laatste regel van <config> toegevoegd. Een export zonder toewijzingen voor X4 schrijft toch de opgeslagen instellingen.

#Bekende beperkingen

  • Apparaten zonder vastgezette slot worden overgeslagen; JoyPro zet ze zelf nog niet vast.
  • Joystickmodifiers worden niet geschreven: hoe ze in het bestand worden opgemaakt, is nog niet bevestigd.
  • 64 knoppen, 8 assen en één hat per apparaat; acht slots, gedeeld met gamepads.
  • Rumble: de schuifregelaar van de game toont de waarde maal 100, afgekapt (21 % verschijnt als 20); het bestand houdt de exacte waarde.
  • Tests: engine\tests\smoke\x4.ps1 (ook het vernieuwen van de catalogus); in de game tools\e2e\games\X4.ps1 (toewijzingen en modusmatrix, in een eigen profielmap) en tools\e2e\games\X4Settings.ps1 (omkeringen, throttlemodus, game-instellingen).

Alle technische notities over deze game (gegenereerd uit de repository): x4.md.