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 inconfig.xml- Inputs die de game leest
- leest 64 knoppen, 8 assen, 1 hat per joystick (geverifieerd)
- Commandolijst uit
- de naamtabellen van
X4.exeen 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.
#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 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.xmlter plekke, op de vakken van je apparaten. Toewijzingen voor menu, first-person, toetsenbord en muis blijven.
#Je toewijzingen uit X4 importeren
- 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).
- 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.
- 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
- Sluit X4. De game schrijft
inputmap.xmlenconfig.xmlals een sessie eindigt, dus JoyPro weigert te schrijven zolang hij draait. - Open Exporteren en vink de kaart van X4 aan.
- 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.
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.
#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.xmlenconfig.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.
#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"]
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) ofINPUT_SOURCE_JOYAXES, zonder achtervoegsel voor slot 1 en_2tot_8voor de andere.config.xmlkoppelt 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});num0 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 64INPUT_XBUTTON_12...; de hatINPUT_XBUTTON_DPAD_*(acht richtingen); assenINPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Bereiken krijgen geensgn. Toetsenbord:INPUT_KEYCODE_<DIK>met_SHIFT/_CONTROL. - Commandolijst:
engine x4 refresh-dbleestgameoptions.luaen de Engelse tekstpagina uit de.cat/.dat-archieven en de naamtabellen vanX4.exe, alleen lezend; 128 bedieningselementen voor ruimtevluchten (6 assen, 122 knoppen). Rijen luiden bijvoorbeeld "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)".engine x4 catalogtoont de lijst,engine x4 pathstoont 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 gametools\e2e\games\X4.ps1(toewijzingen en modusmatrix, in een eigen profielmap) entools\e2e\games\X4Settings.ps1(omkeringen, throttlemodus, game-instellingen).
Alle technische notities over deze game (gegenereerd uit de repository): x4.md.