Star Citizen bewaart al je bediening in één bestand, actionmaps.xml, en nummert je sticks als joystickvakken js1 tot js8. JoyPro leest de schiptoewijzingen uit dat bestand in je profiel en schrijft ze ter plekke terug: alleen de schipacties en hun asinstellingen veranderen, elke andere regel blijft zoals de game hem schreef. Een apparaat houdt het vak dat de game het al gaf, dus je toewijzingen springen niet van de ene stick naar de andere.
Star Citizen rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine starcitizen- Toewijzingsbestand
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Commandolijst uit
Data.p4k(defaultProfile.xml) en je profielen- In-game test
- 54/54 stappen geslaagd (2026-10-10)
- ✓ 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 Star Citizen gesloten
Vooraf: sluit elk apparaat aan dat je gebruikt.
Daarna: je toewijzingen staan in Options > Controls.
Heb je eerder knoppen toegewezen in Star Citizen? 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 Star Citizen
- Importeren: je schiptoewijzingen op sticks, throttles en pedalen komen in je profiel, met hun dode zones, curves en omkeringen. De eigen standaard joysticktoewijzingen van de game op js1 komen ook mee, zodat een latere export ze niet kwijtraakt.
- Relaties: één relatie is één functie in elke game. "Landing gear" kan dezelfde schakelaar zijn in Star Citizen, DCS en Elite Dangerous.
- Exporteren: JoyPro bewerkt
actionmaps.xmlter plekke. Toewijzingen te voet, voor voertuigen en menu's, en muis- en gamepadtoewijzingen blijven zoals ze zijn.
#Je toewijzingen uit Star Citizen importeren
- Open Start. Vraagt de kaart van Star Citizen om een commandolijst, druk dan op Lijst maken: JoyPro leest de acties van de game uit je installatie (
Data.p4k, alleen lezen). Na een gamepatch voegt Bijwerken op de kaart nieuwe acties toe. - Druk op de kaart van Star Citizen op Importeren. Laat Aan mijn profiel toevoegen staan. Vink Neem ook de toetsenbordtoetsen over alleen aan als je je schiptoetsen ook in JoyPro wilt.
- Druk op Nu importeren. Mijn relaties bekijken opent wat er binnenkwam.


#Relaties maken en controleren
Elke schipactie is één item in een relatie. Koppel dezelfde functie van je andere games met de werkwijze voor relaties en druk dan op Controleren op de pagina Exporteren: het vindt een knop die op je schip twee dingen doet, voordat de game dat doet.
#Naar Star Citizen exporteren
- Sluit Star Citizen. De game herschrijft
actionmaps.xmlbij het afsluiten, dus JoyPro weigert te schrijven zolang hij draait. - Open Exporteren en vink de kaart van Star Citizen 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 Options > Controls vanuit het hoofdmenu. Kies je apparaat (Joystick / HOTAS 1, 2 ...): de dode zone en saturatie zijn die je in JoyPro hebt ingesteld; Inversion Settings en Joystick Sensitivity Curves (Flight > Flight Movement) tonen je omkeringen, exponenten en curves. Je schiptoewijzingen staan op het joystickvak van elk apparaat. Standaardwaarden van de game die JoyPro heeft uitgezet, zijn leeg. Het menu toont de saturatie 0,01 hoger dan het bestand bevat (0.87 wordt 0.88); de game houdt de exacte waarde.
#Wat je zelf doet in Star Citizen
- Verder niets voor de toewijzingen. Sluit elk apparaat dat je gebruikt aan voordat je exporteert: een apparaat dat niet aangesloten is, houdt zijn vak en zijn toewijzingen, maar JoyPro kan het geen nieuwe geven.
- Staat de game in een andere map dan de gevonden map, stel het pad dan één keer in op de pagina Exporteren onder Opties en paden (voor experts), of koppel de map in Instellingen > Games.
#Veelgemaakte fouten
- "Star Citizen draait": sluit de game (ook vanuit de launcher) en exporteer opnieuw.
- Toewijzingen kwamen op de verkeerde stick terecht: laat SC: lokale volgorde verkiezen aan (de standaard). Staat het uit, dan volgen de vakken de volgorde waarin Windows de apparaten meldt, en die kan elke toewijzing van een apparaat naar een ander js-nummer verplaatsen.
- Een apparaat kreeg geen vak: de game heeft acht joystickvakken. JoyPro voegt dubbele items van één stick (de naam van de game en de naam van JoyPro) samen in één vak, maar meer dan acht aangesloten apparaten met toewijzingen passen er niet in.
- Een standaardtoewijzing kwam terug op js1: die komt terug als het apparaat op js1 bij de export niet aangesloten is. Sluit het aan en exporteer opnieuw met Vervangen.
#Bestanden die JoyPro leest en schrijft
| Bestand | Wat het is |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
je rebinds, de joystickslots (<options type="joystick" instance="1..8" Product="...">), de optiegroepen per slot (omkeren, exponent, curve, gevoeligheid) en de apparaatopties (dode zone, verzadiging per fysieke as) |
...\Profiles\default\attributes.xml |
instellingen voor de hele game (<Attr name="..." value="..."/>), alleen de waarden die afwijken van de standaardwaarden van de game |
...\Profiles\default\actionmaps.jp |
de kopie van JoyPro van het geschreven bestand met relatienamen als commentaar, teruggelezen bij de volgende import |
...\Profiles\default\actionmaps.xml.joypro.json |
de asinstellingen die JoyPro het laatst schreef, zodat "Bijwerken" een waarde die jij in de game hebt gewijzigd kan onderscheiden van een eigen waarde |
actionmaps.xml.jpbak, attributes.xml.jpbak |
kopieën van vóór de eerste schrijfactie van een export, plus de back-upopslag met versies van JoyPro |
De export bewerkt actionmaps.xml ter plekke: alleen schiprebinds en de asinstellingen van de asrebinds die JoyPro schrijft, veranderen. Andere actionmaps, rebinds voor muis en gamepad, activeringsmodi, modifiers, andere optiegroepen en apparaatopties blijven byte voor byte gelijk. Een profiel zonder toewijzingen voor Star Citizen laat het bestand zoals het is.
#De joystickslots
Star Citizen noemt elke joysticktoewijzing naar zijn slot: js1_button3, js2_x. Het bestand vermeldt welk apparaat welke slot heeft, met de DirectInput-productnaam en de product-GUID van het apparaat.
- Lokale volgorde verkiezen (standaard aan): een aangesloten apparaat dat het bestand al noemt, houdt die slot. Andere apparaten vullen de vrije slots in de volgorde waarin Windows ze meldt.
- Eén apparaat, één slot: dezelfde stick die twee keer vermeld staat (onder de naam van de game en onder de instancenaam van JoyPro, of een oude tweede vermelding), neemt één slot in. De export verwijdert de dubbele vermeldingen en verplaatst hun toewijzingen naar de slot die het apparaat houdt. Vermeldingen van apparaten die niet aangesloten zijn, blijven.
- Twee aangesloten apparaten van hetzelfde model blijven gescheiden.
- Een apparaat dat van slot wisselt, neemt zijn optiegroepen (omkeren, curves) mee. Een apparaat dat geen slot krijgt, verliest de groepen van zijn oude slot, met een waarschuwing.
#De exportmodi in Star Citizen
Elke modus wijzigt alleen schipacties. De maps voor te voet, voertuigen en menu's blijven byte voor byte gelijk.
| Modus | Wat er in de game gebeurt |
|---|---|
| Alleen toevoegen | Er verandert geen toewijzing van de game. Een actie waarvan de joystickslot al een rebind of een actieve standaardtoewijzing heeft, houdt die. Een toewijzing op een input die een andere schipactie gebruikt, wordt niet geschreven en krijgt de markering "Niet in de game geschreven". |
| Bijwerken, toewijzingen van game behouden | Je input gaat in de joystickslot van de actie (Star Citizen heeft er één per actie en inputtype). Een gametoewijzing op een input die je aan een andere schipactie geeft, wordt vrijgemaakt: de rebind verdwijnt, of wordt een lege js1_ als de actie een standaardtoewijzing heeft, zodat die standaard niet terugkomt. |
| Bijwerken, mijn profiel wint | Zoals hierboven; met de toetsenbordoptie verliest een actie die je toewijst ook haar toetsenbord-rebind. |
| Vervangen op mijn apparaten | De geschreven apparaten houden alleen je schiptoewijzingen. Met een apparaat op js1 worden de js1-standaardtoewijzingen van de game die niet in je profiel staan, uitgezet. |
| + Ook mijn andere apparaten wissen | Aangesloten apparaten zonder toewijzingen in je profiel verliezen hun schiptoewijzingen; de standaardtoewijzingen van js1 worden uitgezet als js1 niet gebruikt wordt. |
Opties op de pagina Exporteren (onder Opties en paden (voor experts)):
- SC: standaardtoetsen behouden (aan): het toetsenbord houdt de standaardtoetsen van de game. Uit: je toetsenbordtoewijzingen worden geschreven en de standaardtoetsen die ze innemen, worden vrijgemaakt.
- SC: lokale volgorde verkiezen (aan): zie de joystickslots hierboven.


#De standaard joysticktoewijzingen van de game
Star Citizen heeft standaard joysticktoewijzingen die op js1 werken totdat een actie daar een rebind krijgt (pitch op Y, yaw op X, roll op Z-rotatie, een paar knoppen). De import neemt elke actieve standaardtoewijzing over als toewijzing van het js1-apparaat, zodat je profiel bevat wat de game echt doet. De export schrijft geen rebind voor een toewijzing die gelijk is aan de standaard (alleen echte verschillen). Vervangen en Ook wissen zetten de standaardtoewijzingen die niet in je profiel staan uit met een lege rebind js1_ , zoals het eigen menu van de game een gewiste toewijzing schrijft, en alleen als het apparaat op js1 aangesloten is. Dus importeren en dan Vervangen + Ook wissen laat actionmaps.xml zoals het was.
#Wat nooit wordt aangeraakt
- Toewijzingen voor te voet, grondvoertuigen en menu's (de grondvoertuigen van Star Citizen tellen als een eigen voertuigklasse).
- Apparaten die niet aangesloten zijn: ze houden hun slot en hun rebinds.
- De genegeerde apparaten van de import en het vJoy-apparaat waar JoyPro doorheen tunnelt.
- Toewijzingen voor muis en gamepad; het toetsenbord, tenzij je toetsenbordtoewijzingen exporteert.
- Activeringsmodi, modifiers, andere optiegroepen en apparaatopties.
#Schepen, curves, game-instellingen
- Granulariteit: één set schiptoewijzingen voor elk schip (de game heeft geen toewijzingen per schip).
- As-curves, op twee plaatsen, zoals de game ze bewaart: dode zone en verzadiging per apparaat en fysieke as; omkeren, exponent (1 tot 3), een curve met 11 punten en gevoeligheid per slot en optiegroep. Exponent en curve sluiten elkaar uit, zoals in het menu van de game. Een relatie zonder waarden voor Star Citizen krijgt haar JoyPro-curve aangepast: dode zone en verzadiging gaan naar de as van het apparaat, de kromming wordt de dichtstbijzijnde exponent, of de curve als geen exponent past. Er is geen eenzijdige as: de absolute en de relatieve throttle van de game zijn aparte acties.
- Bijwerken houdt een aswaarde die je in de game hebt gewijzigd (met een waarschuwing); Vervangen en mijn profiel wint zetten de waarden van je profiel. Een neutrale relatie laat de eigen waarde van de game staan (free look houdt zijn standaardexponent 2.5).
- Instellingen voor de hele game (
attributes.xml): HOTAS thrust invert toggle, de trap-tijd en drempel van de relatieve throttle, de IFCS-gevoeligheidsmodifiers, ESP aan, sterkte en demping, turret ESP, de standaardwaarden voor vliegen (sticky throttle, speed limiter, coupled, G-safe, auto precision, space brake), invert flight controller en Vibration. Stel ze in bij Instellingen > Force-feedbackinstellingen van de games (kies Star Citizen) of metengine ffb set. JoyPro wijzigt alleen de regels die je instelt, ter plekke, en maakt het bestand niet aan. De schuifregelaar voor ESP-sterkte eindigt bij 1.00, dus JoyPro biedt 0 tot 1 aan. - Force feedback: geen. Vibration is de enige zulke instelling van de game.
- Gamebewaking: een toewijzing of aswaarde die je in het menu van de game wijzigt, wordt opgemerkt nadat de game is gesloten, en JoyPro vraagt of het die moet overnemen. Het vergelijkt
actionmaps.xml(alleen de actionmaps voor schepen) en de instellingen die JoyPro inattributes.xmlbeheert. - HUD: de HUD vindt de game aan zijn proces en toont je toewijzingen voor Star Citizen.
#De Star Citizen-integratie van binnen
flowchart LR
A[("actionmaps.xml")] --> S["Slot per apparaat"]
D["Aangesloten apparaten"] --> S
P["Je profiel"] --> E["engine starcitizen export"]
S --> E
E --> X["actionmaps.xml"]
E --> T["attributes.xml"]
X --> G["Options ><br/>Controls"]
Code: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, het asmodel engine\AxisModels\StarCitizen.cs en het instellingenmodel engine\FfbModels\StarCitizen.cs.
- Apparaatnamen: de
Productvan de slot is de DirectInput-productnaam en de product-GUID, met twee spaties ertussen (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Een slot ofdeviceoptions-blok dat onder een andere naam (een instance-GUID) is geschreven, herkent de game niet: hij herschrijft de slot met zijn product en laat de optiegroepen van de slot vallen. Daarom schrijft JoyPro de productnaam van het aangesloten apparaat. - Commandolijst:
engine db refresh-starcitizenleestData\Libs\Config\defaultProfile.xmluitData.p4k(of een uitgepakte kopie met--source) inDB\StarCitizen\AllBinds.xml: elke actie met haar optiegroep, de boom van joystickopties (ouders en standaardwaarden, welke groepen een curve tonen) en de standaard joystickinput van de actie.engine starcitizen labelshaalt de namen die de game aan de bedieningselementen geeft uitglobal.ini. - Importeren:
engine starcitizen import(--include-keyboard,--device,--ignore-device); elke as-rebind krijgt de waarden die de game gebruikt (de onderste groep van de slot, anders de dichtstbijzijnde ouder die je hebt ingesteld, anders de standaard van de game) en de apparaatopties van zijn as, als zijngame:StarCitizen-afstelling.engine starcitizen scantoont hetzelfde zonder het profiel te wijzigen;engine starcitizen list-devicessomt de joystickslots van het bestand op. - Exporteren:
engine starcitizen export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --keep-keyboard-defaults true|false --prefer-local-order true|false --include-keyboard true|false --ignore-device <d>. Een nieuwdeviceoptions-blok komt vóór de eerste<options>; meerdere relaties op één optiegroep of één fysieke as met verschillende waarden geven een waarschuwing, en de eerste relatie op naam wint. - Game-instellingen:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; een bestaande regel krijgt de waarde, een nieuwe komt op zijn gesorteerde plaats. - Back-ups:
engine backups listsomt de kopieën op; Laatste export ongedaan maken op de kaart zet de nieuwste terug.
#Bekende beperkingen
- Acht joystickslots; de knoppenlimiet per apparaat is niet bekend (bronnen spreken elkaar tegen).
- Waar de game een nieuw
deviceoptions-blok wil hebben, de interpolatie van de curve (het menu tekent een vloeiende spline door de punten), het bereik van de exponent en of gevoeligheid voor joysticks geldt, is nog niet bevestigd. De bereiken van de instellingen voor de hele game staan niet in de leesbare bestanden van de game. - Of Vibration een DirectInput-stick met force feedback aanstuurt, is nog niet bevestigd.
- Tests:
engine\tests\smoke\starcitizen.ps1(catalogus vernieuwen, import van optiegroepen en curves, import + export byte voor byte, elke asinstelling, conflicten, slotwijzigingen,attributes.xmlter plekke); in de gametools\e2e\games\StarCitizenSettings.ps1(Options in het hoofdmenu: instellingen, toewijzingen en curves) entools\e2e\games\StarCitizen.ps1(matrix van export- en importmodi).
Alle technische notities over deze game (gegenereerd uit de repository): starcitizen.md.