Star Citizen garde toutes vos commandes dans un seul fichier, actionmaps.xml, et numérote vos manches comme emplacements joystick js1 à js8. JoyPro lit les assignations de vaisseau de ce fichier dans votre profil et les réécrit sur place : seules les actions de vaisseau et leurs réglages d'axe changent, toutes les autres lignes restent comme le jeu les a écrites. Un périphérique garde l'emplacement que le jeu lui a déjà donné, vos assignations ne sautent donc pas d'un manche à l'autre.
Star Citizen natif (ses propres fichiers d'assignations)
- Prise en charge
- natif (ses propres fichiers d'assignations)
- Commande du moteur
engine starcitizen- Fichier d'assignations
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Liste de commandes issue de
Data.p4k(defaultProfile.xml) et vos profils- Test en jeu
- 54/54 étapes réussies (2026-10-10)
- ✓ Importer
- ✓ Exporter
- ✓ Assignations clavier
- ✓ Modificateurs
- ✓ Liste de commandes créée sur votre PC
- ✓ Surveillance des jeux
- ✓ Courbes d'axe et zones mortes
- ✓ Paramètres de commandes du jeu
- ✗ Paramètres de retour de force en jeu
- ✗ Retour de force par télémétrie
- ✗ Enregistrement de la télémétrie
- ✓ Joystick virtuel (vJoy)
- ◐ Manette Xbox virtuelle
- ✓ Fonctions virtuelles
- ✓ Assistant de configuration / Assignation auto
- ✓ Cockpits
- ✓ Aide-mémoires
- ✓ Test en jeu
D'après la matrice de prise en charge, générée à partir du code du moteur : tous les jeux.
#Le faire marcher en 3 étapes
- Tout configurer pour moi
sur la page Accueil - Utiliser ces boutons
regardez d'abord la liste - Écrire dans mon jeu
gardez Star Citizen fermé
Avant : branchez tous les périphériques que vous utilisez.
Ensuite : vos assignations sont dans Options > Controls.
Vous avez déjà assigné des boutons dans Star Citizen ? Alors la page Accueil propose Importer, puis combler les vides. Vos assignations restent, et seuls les boutons libres reçoivent de nouvelles tâches. Voir Démarrage rapide : faire marcher mon manche.
#Ce que JoyPro fait pour Star Citizen
- Importer : vos assignations de vaisseau sur manches, manettes des gaz et palonniers arrivent dans votre profil, avec leurs zones mortes, courbes et inversions. Les assignations joystick par défaut du jeu sur js1 arrivent aussi, pour qu'une exportation plus tard ne les perde pas.
- Relations : une relation est une fonction dans chaque jeu. "Landing gear" peut être le même interrupteur dans Star Citizen, DCS et Elite Dangerous.
- Exporter : JoyPro modifie
actionmaps.xmlsur place. Les assignations à pied, de véhicule et de menu, ainsi que celles de souris et de manette, restent telles quelles.
#Importer vos assignations Star Citizen
- Ouvrez Démarrer. Si la carte Star Citizen demande une liste de commandes, appuyez sur Créer la liste : JoyPro lit les actions du jeu dans votre installation (
Data.p4k, en lecture seule). Après un patch du jeu, Mettre à jour sur la carte ajoute les nouvelles actions. - Appuyez sur Importer sur la carte Star Citizen. Gardez Ajouter à mon profil. Cochez Prendre aussi les touches du clavier seulement si vous voulez aussi vos touches de vaisseau dans JoyPro.
- Appuyez sur Importer maintenant. Voir mes relations ouvre ce qui est arrivé.


#Créer et vérifier les relations
Chaque action de vaisseau est une entrée dans une relation. Reliez la même fonction de vos autres jeux avec le flux des relations, puis appuyez sur Vérifier sur la page Exporter : elle trouve un bouton qui fait deux choses sur votre vaisseau avant que le jeu ne le fasse.
#Exporter vers Star Citizen
- Fermez Star Citizen. Le jeu réécrit
actionmaps.xmlen quittant, JoyPro refuse donc d'écrire tant qu'il tourne. - Ouvrez Exporter et cochez la carte Star Citizen.
- Gardez Remplacer sur mes périphériques avec Effacer aussi mes autres périphériques si c'est dans JoyPro que vous configurez vos manches. Appuyez sur Exporter maintenant sur la carte.


Lancez le jeu et ouvrez Options > Controls depuis le menu principal. Choisissez votre périphérique (Joystick / HOTAS 1, 2 ...) : sa zone morte et sa saturation sont celles que vous avez réglées dans JoyPro ; Inversion Settings et Joystick Sensitivity Curves (Flight > Flight Movement) montrent vos inversions, exposants et courbes. Vos assignations de vaisseau sont sur l'emplacement joystick de chaque périphérique. Les réglages par défaut du jeu que JoyPro a désactivés apparaissent vides. Le menu affiche la saturation 0,01 plus haut que ce que contient le fichier (0.87 s'affiche 0.88) ; le jeu garde la valeur exacte.
#Ce que vous faites vous-même dans Star Citizen
- Rien d'autre pour les assignations. Branchez tous les périphériques que vous utilisez avant d'exporter : un périphérique non branché garde son emplacement et ses assignations, mais JoyPro ne peut pas lui en donner de nouvelles.
- Si le jeu est dans un autre dossier que celui détecté, réglez le chemin une fois sur la page Exporter sous Options et chemins (pour experts), ou liez le dossier dans Paramètres > Jeux.
#Pièges courants
- "Star Citizen est en cours d'exécution" : quittez le jeu (aussi depuis le launcher) et exportez à nouveau.
- Les assignations ont atterri sur le mauvais manche : gardez SC : préférer l'ordre local activé (par défaut). Désactivé, les emplacements suivent l'ordre dans lequel Windows signale les périphériques, ce qui peut déplacer toutes les assignations d'un périphérique vers un autre numéro js.
- Un périphérique n'a pas reçu d'emplacement : le jeu a huit emplacements joystick. JoyPro fusionne les doublons d'un même manche (le nom du jeu et celui de JoyPro) en un seul emplacement, mais plus de huit périphériques branchés avec des assignations ne rentrent pas.
- Une assignation par défaut est revenue sur js1 : elle revient quand le périphérique de js1 n'est pas branché au moment de l'exportation. Branchez-le et exportez à nouveau avec Remplacer.
#Fichiers que JoyPro lit et écrit
| Fichier | De quoi il s'agit |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
vos réassignations, les emplacements joystick (<options type="joystick" instance="1..8" Product="...">), les groupes d'options par emplacement (inversion, exposant, courbe, sensibilité) et les options de périphérique (zone morte, saturation par axe physique) |
...\Profiles\default\attributes.xml |
paramètres globaux du jeu (<Attr name="..." value="..."/>), uniquement les valeurs qui diffèrent des valeurs par défaut du jeu |
...\Profiles\default\actionmaps.jp |
la copie de JoyPro du fichier écrit, avec les noms des relations en commentaires, relue par le prochain import |
...\Profiles\default\actionmaps.xml.joypro.json |
les réglages d'axe que JoyPro a écrits en dernier, pour que « Mettre à jour » distingue une valeur que vous avez changée dans le jeu de la sienne |
actionmaps.xml.jpbak, attributes.xml.jpbak |
des copies d'avant la première écriture d'une exportation, plus le stockage de sauvegardes versionné de JoyPro |
L'exportation modifie actionmaps.xml sur place : seules changent les réassignations de vaisseau et les réglages d'axe des réassignations d'axe que JoyPro écrit. Les autres action maps, les réassignations souris et manette, les modes d'activation, les modificateurs, les autres groupes d'options et les options de périphérique restent identiques à l'octet près. Un profil sans assignations Star Citizen laisse le fichier tel quel.
#Les emplacements joystick
Star Citizen nomme chaque assignation joystick par son emplacement : js1_button3, js2_x. Le fichier indique quel périphérique occupe quel emplacement, par le nom de produit DirectInput et le GUID produit du périphérique.
- Préférer l'ordre local (activé par défaut) : un périphérique branché que le fichier nomme déjà garde son emplacement. Les autres périphériques remplissent les emplacements libres dans l'ordre où Windows les signale.
- Un périphérique, un emplacement : le même manche listé deux fois (sous le nom du jeu et sous le nom d'instance de JoyPro, ou une ancienne deuxième entrée) prend un seul emplacement. L'exportation supprime les entrées en double et déplace leurs assignations vers l'emplacement que le périphérique garde. Les entrées des périphériques non branchés restent.
- Deux périphériques branchés du même modèle restent séparés.
- Un périphérique qui change d'emplacement emporte ses groupes d'options (inversion, courbes). Un périphérique qui n'obtient pas d'emplacement perd les groupes de son ancien emplacement, avec un avertissement.
#Les modes d'exportation dans Star Citizen
Chaque mode ne change que les actions de vaisseau. Les maps à pied, de véhicule et de menu restent identiques à l'octet près.
| Mode | Ce qui se passe dans le jeu |
|---|---|
| Ajouter seulement | Aucune assignation du jeu ne change. Une action dont l'emplacement joystick contient déjà une réassignation ou une valeur par défaut active la garde. Une assignation sur une entrée qu'une autre action de vaisseau utilise n'est pas écrite et reçoit la marque « Non écrit dans le jeu ». |
| Mettre à jour, garder les assignations du jeu | Votre entrée va dans l'emplacement joystick de l'action (Star Citizen en a un par action et par type d'entrée). Une assignation du jeu sur une entrée que vous donnez à une autre action de vaisseau est libérée : sa réassignation disparaît, ou devient un js1_ vide quand l'action a une valeur par défaut, pour que la valeur par défaut ne revienne pas. |
| Mettre à jour, mon profil l'emporte | Comme ci-dessus ; avec l'option clavier, une action que vous assignez perd aussi sa réassignation clavier. |
| Remplacer sur mes périphériques | Les périphériques écrits ne gardent que vos assignations de vaisseau. Avec un périphérique sur js1, les valeurs par défaut js1 du jeu que votre profil n'a pas sont désactivées. |
| + Effacer aussi mes autres périphériques | Les périphériques branchés sans assignation dans votre profil perdent leurs assignations de vaisseau ; les valeurs par défaut de js1 sont désactivées quand js1 n'est pas utilisé. |
Options sur la page Exporter (sous Options et chemins (pour experts)) :
- SC : garder les défauts du clavier (activé) : le clavier garde les touches par défaut du jeu. Désactivé : vos assignations clavier sont écrites et les touches par défaut qu'elles prennent sont libérées.
- SC : préférer l'ordre local (activé) : voir les emplacements joystick ci-dessus.


#Les assignations joystick par défaut du jeu
Star Citizen a des assignations joystick par défaut qui agissent sur js1 tant qu'une action n'y a pas de réassignation (tangage sur Y, lacet sur X, roulis sur la rotation Z, quelques boutons). L'import prend chaque valeur par défaut active comme une assignation du périphérique js1, votre profil contient donc ce que le jeu fait vraiment. L'exportation n'écrit aucune réassignation pour une assignation égale à la valeur par défaut (seulement les vraies différences). Remplacer et Effacer aussi désactivent les valeurs par défaut que votre profil n'a pas avec une réassignation vide js1_ , comme le menu du jeu écrit une assignation effacée, et seulement quand le périphérique sur js1 est branché. Donc importer, puis Remplacer + Effacer aussi, laisse actionmaps.xml comme il était.
#Ce qui n'est jamais touché
- Les assignations à pied, de véhicule terrestre et de menu (les véhicules terrestres de Star Citizen comptent comme leur propre classe de véhicule).
- Les périphériques non branchés : ils gardent leur emplacement et leurs réassignations.
- Les périphériques ignorés de l'importation et le périphérique vJoy alimenté par JoyPro.
- Les assignations souris et manette ; le clavier, sauf si vous exportez des assignations clavier.
- Les modes d'activation, les modificateurs, les autres groupes d'options et les options de périphérique.
#Vaisseaux, courbes, réglages du jeu
- Granularité : un seul jeu d'assignations de vaisseau pour tous les vaisseaux (le jeu n'a pas d'assignations par vaisseau).
- Courbes d'axe, à deux endroits comme le jeu les garde : zone morte et saturation par périphérique et axe physique ; inversion, exposant (1 à 3), une courbe à 11 points et sensibilité par emplacement et groupe d'options. Exposant et courbe s'excluent, comme dans le menu du jeu. Une relation sans valeurs Star Citizen reçoit sa courbe JoyPro ajustée : zone morte et saturation vont sur l'axe du périphérique, la courbure devient l'exposant le plus proche, ou la courbe quand aucun exposant ne convient. Il n'y a pas d'axe à un seul côté : la manette des gaz absolue et la relative du jeu sont des actions séparées.
- Mettre à jour garde une valeur d'axe que vous avez changée dans le jeu (avec un avertissement) ; Remplacer et Mon profil l'emporte appliquent les valeurs de votre profil. Une relation neutre laisse la valeur propre du jeu (le free look garde son exposant par défaut de 2.5).
- Paramètres globaux du jeu (
attributes.xml) : la bascule d'inversion de poussée HOTAS, le temps et le seuil du cran de la manette des gaz relative, les modificateurs de sensibilité IFCS, ESP activé, sa force et son amortissement, l'ESP des tourelles, les valeurs de vol par défaut (sticky throttle, limiteur de vitesse, coupled, G-safe, auto precision, frein spatial), l'inversion du contrôleur de vol et Vibration. Réglez-les dans Paramètres > Paramètres de retour de force des jeux (choisissez Star Citizen) ou avecengine ffb set. JoyPro ne change que les lignes que vous réglez, sur place, et ne crée pas le fichier. Le curseur de force de l'ESP s'arrête à 1.00, JoyPro propose donc 0 à 1. - Retour de force : aucun. Vibration est le seul réglage de ce type dans le jeu.
- Surveillance : une assignation ou une valeur d'axe que vous changez dans le menu du jeu est remarquée après la fermeture du jeu, et JoyPro demande s'il faut la reprendre. Elle compare
actionmaps.xml(uniquement les action maps de vaisseau) et les réglages que JoyPro gère dansattributes.xml. - HUD : le HUD trouve le jeu par son processus et affiche vos assignations Star Citizen.
#Dans l'intégration de Star Citizen
flowchart LR
A[("actionmaps.xml")] --> S["Emplacement par périphérique"]
D["Périphériques connectés"] --> S
P["Votre profil"] --> 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, le modèle d'axe engine\AxisModels\StarCitizen.cs et le modèle de réglages engine\FfbModels\StarCitizen.cs.
- Noms des périphériques : le
Productde l'emplacement est le nom de produit DirectInput et le GUID produit, séparés par deux espaces (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Un emplacement ou un blocdeviceoptionsécrit sous un autre nom (un GUID d'instance) n'est pas reconnu par le jeu : il réécrit l'emplacement avec son produit et abandonne les groupes d'options de l'emplacement. JoyPro écrit donc le nom de produit du périphérique branché. - Liste de commandes :
engine db refresh-starcitizenlitData\Libs\Config\defaultProfile.xmldansData.p4k(ou une copie extraite avec--source) et l'écrit dansDB\StarCitizen\AllBinds.xml: chaque action avec son groupe d'options, l'arbre d'options joystick (parents et valeurs par défaut, quels groupes montrent une courbe) et l'entrée joystick par défaut de l'action.engine starcitizen labelsprend dansglobal.iniles noms que le jeu donne aux commandes. - Importer :
engine starcitizen import(--include-keyboard,--device,--ignore-device) ; chaque réassignation d'axe reçoit les valeurs que le jeu utilise (le groupe feuille de l'emplacement, sinon le parent le plus proche que vous avez réglé, sinon la valeur par défaut du jeu) et les options de périphérique de son axe, comme son réglagegame:StarCitizen.engine starcitizen scanmontre la même chose sans changer le profil ;engine starcitizen list-devicesliste les emplacements joystick du fichier. - Exporter :
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>. Un nouveau blocdeviceoptionsse place avant le premier<options>; plusieurs relations sur un même groupe d'options ou un même axe physique avec des valeurs différentes donnent un avertissement, et la première relation par ordre de nom l'emporte. - Paramètres du jeu :
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; une ligne existante reçoit la valeur, une nouvelle va à sa place dans l'ordre de tri. - Sauvegardes :
engine backups listliste les copies ; Annuler la dernière exportation sur la carte restaure la plus récente.
#Limites connues
- Huit emplacements joystick ; la limite de boutons par périphérique n'est pas connue (les sources se contredisent).
- L'endroit où le jeu veut un nouveau bloc
deviceoptions, l'interpolation de la courbe (le menu trace une spline lisse passant par les points), la plage de l'exposant et le fait que la sensibilité s'applique ou non aux joysticks ne sont pas encore confirmés. Les plages des paramètres globaux du jeu ne figurent pas dans les fichiers lisibles du jeu. - On ne sait pas encore si Vibration pilote un manche à retour de force DirectInput.
- Tests :
engine\tests\smoke\starcitizen.ps1(rafraîchissement du catalogue, import des groupes d'options et des courbes, import + exportation à l'octet près, chaque réglage d'axe, conflits, changements d'emplacement,attributes.xmlsur place) ; dans le jeutools\e2e\games\StarCitizenSettings.ps1(Options du menu principal : paramètres, assignations et courbes) ettools\e2e\games\StarCitizen.ps1(matrice des modes d'exportation et d'importation).
Toutes les notes techniques sur ce jeu (générées à partir du dépôt) : starcitizen.md.