X4: Foundations garde vos assignations dans inputmap.xml et nomme un joystick par son emplacement (1 à 8), pas par son nom. Quel périphérique est dans quel emplacement est indiqué dans config.xml. JoyPro lit les assignations de vol spatial dans votre profil et les réécrit sur place, dans les emplacements que X4 a attribués à vos périphériques. Les inversions et la zone morte sont globales dans X4, JoyPro les règle donc à partir de vos relations pour tout le jeu.
X4: Foundations natif (ses propres fichiers d'assignations)
- Prise en charge
- natif (ses propres fichiers d'assignations)
- Commande du moteur
engine x4- Fichier d'assignations
Documents\Egosoft\X4\<id>\inputmap.xml(XML) + les emplacements dansconfig.xml- Entrées que le jeu lit
- lit 64 boutons, 8 axes, 1 chapeau par joystick (vérifié)
- Liste de commandes issue de
- les tables de noms de
X4.exeet les archives.cat/.dat - Test en jeu
- 36/36 étapes réussies (2026-10-11)
- ✓ Importer
- ✓ Exporter
- ✓ Assignations clavier
- ◐ ModificateursX4 : Shift/Ctrl sur les assignations clavier ; les assignations de joystick ne prennent aucun modificateur.
- ✓ Liste de commandes créée sur votre PC
- ✓ Surveillance des jeux
- ✗ Courbes d'axe et zones mortesX4 : seulement la zone morte globale du jeu et les inversions (Game settings), rien par assignation.
- ✓ 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
X Rebirth seulement documenté
- Prise en charge
- seulement documenté
- Commande du moteur
- aucun
- — 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
X3 (Reunion, Terran Conflict, Albion Prelude) seulement documenté
- Prise en charge
- seulement documenté
- Commande du moteur
- aucun
- — 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 X4 fermé
Avant : donnez une fois un emplacement à chaque périphérique. Dans les réglages des commandes de X4, ouvrez Manage Controllers/Joysticks. Attribuez chaque périphérique à un emplacement, puis quittez le jeu normalement.
Ensuite : vos assignations sont dans Settings > Controls.
Vous avez déjà assigné des boutons dans X4 ? 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 X4
- Importer : les assignations de vol spatial de vos manches, manettes des gaz et palonniers arrivent dans votre profil, avec les inversions et le mode de manette des gaz du jeu.
- Relations : une relation est une fonction dans chaque jeu. "Boost" peut être le même bouton dans X4, Elite Dangerous et Star Citizen.
- Exporter : JoyPro modifie
inputmap.xmlsur place, sur les emplacements de vos périphériques. Les assignations de menu, à la première personne, de clavier et de souris restent.
#Importer vos assignations X4
- Ouvrez Démarrer. Si la carte X4 demande une liste de commandes, appuyez sur Créer la liste : JoyPro lit les commandes du jeu dans votre installation (en lecture seule).
- Appuyez sur Importer sur la carte X4. Gardez Ajouter à mon profil. Cochez Prendre aussi les touches du clavier si vous voulez aussi vos touches de vol dans JoyPro.
- Appuyez sur Importer maintenant. Voir mes relations ouvre ce qui est arrivé.
#Créer et vérifier les relations
Reliez la même fonction de vos jeux avec le flux des relations, puis appuyez sur Vérifier sur la page Exporter. Gardez vos assignations joystick sans modificateurs : X4 n'accepte aucun modificateur sur une assignation joystick.
#Exporter vers X4
- Fermez X4. Le jeu écrit
inputmap.xmletconfig.xmlà la fin d'une session, JoyPro refuse donc d'écrire tant qu'il tourne. - Ouvrez Exporter et cochez la carte X4.
- 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 Settings > Controls. Vos assignations sont dans la colonne manette / joystick de chaque commande de vol spatial, sur l'emplacement de votre périphérique. Invert Controller / Joystick Axes montre les inversions réglées par JoyPro, et les lignes de manette des gaz bidirectionnelle, de zone morte du joystick et de direction adaptative montrent vos valeurs. Le roulis automatique et les vibrations sont dans les réglages du jeu.
#Ce que vous faites vous-même dans X4
- Donnez une fois un emplacement à chaque périphérique. Dans les réglages des commandes de X4, ouvrez Manage Controllers/Joysticks et attribuez chaque manche, manette des gaz et palonnier à un emplacement, puis quittez le jeu normalement. X4 retient alors le périphérique dans
config.xml. Un périphérique sans cette entrée change d'emplacement d'une session à l'autre, JoyPro l'ignore donc ("assign the device to a slot in X4 once"). Un périphérique réglé sur "none" à cet endroit est ignoré aussi. - Branchez vos périphériques avant d'exporter.
#Pièges courants
- "X4 est en cours d'exécution" : quittez le jeu et exportez à nouveau.
- Un périphérique a été ignoré : il n'est attribué à aucun emplacement dans X4. Attribuez-le sous Manage Controllers/Joysticks.
- Un manche dans l'emplacement 1 fait des actions de manette : l'emplacement 1 est celui de la manette dans la disposition par défaut de X4, un manche à cet endroit hérite donc des assignations manette d'origine. Remplacer sur mes périphériques les retire.
- Les boutons au-delà de 64 ou un second chapeau ne font rien : X4 lit 64 boutons, 8 axes et un chapeau par périphérique. JoyPro ignore les assignations au-delà avec un avertissement.
- Une inversion n'a pas été touchée : une inversion vaut pour tous les périphériques de cette commande. Quand vos relations ne sont pas d'accord, ou qu'une manette est assignée à la même commande, JoyPro laisse la valeur du jeu et prévient.
#Fichiers que JoyPro lit et écrit
| Fichier | De quoi il s'agit |
|---|---|
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml |
les assignations actives (<action>, <state>, <range> par commande et entrée) et les paramètres <config> (inversions, zone morte, manette des gaz bidirectionnelle, direction adaptative). <id> est le dossier du compte Steam. |
...\X4\<id>\config.xml |
les emplacements de périphérique (<joysticks>) et des paramètres du jeu comme la vibration, le roulis automatique et le mode manette ; lus pour les emplacements, modifiés sur place pour les paramètres |
...\X4\<id>\inputmap.xml.joypro-meta.json |
Les noms, groupes et réglages de JoyPro pour les assignations écrites, relus par la prochaine importation |
inputmap.xml.jpbak, config.xml.jpbak |
des copies d'avant la première écriture, plus le stockage de sauvegardes versionnées de JoyPro |
Le fichier est écrit comme du texte : la déclaration, les fins de ligne, l'indentation, les commentaires de section, <config>, les attributs de la racine et chaque ligne non touchée restent identiques à l'octet près. Une nouvelle ligne va dans sa section après la dernière entrée du même type ayant un numéro de commande inférieur. JoyPro ne touche jamais les profils enregistrés inputmap_1.xml à inputmap_5.xml ni vos sauvegardes de partie. Steam Cloud synchronise le dossier ; on ne sait pas encore quels fichiers il synchronise.
#Les modes d'exportation dans X4
Un conflit, c'est une autre commande de vol sur le même emplacement et la même entrée. Les jumelles carte et écran de détail d'une commande comptent comme la même commande.
| Mode | Ce qui se passe dans inputmap.xml |
|---|---|
| Ajouter seulement | Rien n'est retiré. Une assignation dont l'entrée est occupée par une autre commande de vol n'est pas écrite et reçoit la marque « Non écrit dans le jeu ». |
| Mettre à jour, garder les assignations du jeu | Vos lignes s'ajoutent à côté des autres entrées de la commande ; seuls les conflits sont retirés. |
| Mettre à jour, mon profil l'emporte | Comme ci-dessus, et une commande que vous assignez perd ses autres lignes sur les emplacements fixés des périphériques branchés (avec l'option clavier, aussi ses lignes clavier). |
| Remplacer sur mes périphériques | Les assignations de vol des emplacements écrits qui ne sont pas dans votre profil sont retirées, y compris les assignations de vol de la manette d'origine sur l'emplacement 1. |
| + Effacer aussi mes autres périphériques | Pareil pour les emplacements que config.xml fixe à des périphériques branchés que l'exportation n'utilise pas. Un emplacement sans périphérique fixé est laissé tranquille : son périphérique est inconnu. |
Le menu de X4 assigne certaines commandes ensemble : « Toggle Travel Mode » règle aussi la même entrée dans la carte, « Dock » sert aussi à se désarrimer. JoyPro écrit et retire ces groupes comme le menu le fait, et ne retire jamais la jumelle « Interact » à la première personne.
#Ce qui n'est jamais touché
- Les commandes de menu, de carte, à la première personne, d'options et d'accessibilité ; les entrées du menu radial.
- Les lignes clavier et souris ; le clavier n'est écrit qu'avec l'option clavier, seulement pour les commandes de vol, jamais avec les touches que le menu de X4 refuse (Escape, Delete, Ctrl+X/C/V ...).
- Les emplacements des périphériques non branchés ou non fixés, les manettes, les périphériques ignorés de l'import et le périphérique vJoy vers lequel JoyPro redirige.
- Toutes les lignes
<config>que JoyPro ne règle pas.
#Courbes et paramètres du jeu
- Granularité : un seul jeu d'assignations pour tous les vaisseaux (les commandes de vol spatial).
- Les inversions sont une valeur par commande pour tous les périphériques (
invert_steering_yaw,_pitch,_roll,invert_throttle,invert_strafe_*). Votre relation garde le sens de DCS ; les cartes HOTAS propres à X4 comptent le tangage, le roulis et la manette des gaz comme inversés, JoyPro règle donc pour ceux-ci le paramètre sur votre inversion retournée. Il ne règle un paramètre que si tous les axes JoyPro de cette commande sont d'accord. - La manette des gaz bidirectionnelle suit le Curseur de la relation des gaz : Curseur = vers l'avant seulement, pas de Curseur = le centre est la poussée nulle.
- Zone morte : X4 a une seule zone morte pour tous les axes de tous les joysticks. Les zones mortes des relations ne sont pas écrites (l'exportation le dit) ; réglez la zone morte du jeu dans Paramètres > Paramètres de retour de force des jeux (choisissez X4) ou avec
engine ffb set. Au même endroit se trouvent la direction adaptative, la vibration, le roulis automatique et le mode manette. Un réglage que vous y enregistrez l'emporte sur les relations, avec un avertissement quand il les inverse. - Pas de courbes ni de saturation par axe dans X4 ; pas de retour de force ; pas de télémétrie.
- Surveillance : une assignation ou une option que vous changez dans le jeu est remarquée après sa fermeture (
inputmap.xmletconfig.xml), et JoyPro demande s'il faut la reprendre. - HUD : le HUD trouve le jeu par son processus et affiche vos assignations X4.
#X Rebirth et X3
X Rebirth utilise les mêmes mots inputmap.xml que X4, mais sa liste de commandes demanderait sa propre extraction depuis une installation. X3 (Reunion, Terran Conflict, Albion Prelude) a un autre moteur et un format de fichier inconnu. Les deux sont seulement documentés : JoyPro ne les importe ni ne les exporte.
#Dans l'intégration de X4
flowchart LR D["Votre périphérique<br/>(GUID d'instance)"] --> C["config.xml<br/>joysticks"] C --> S["Fixé à un emplacement :<br/>emplacement 1 ... 8"] C --> K["Non fixé ou désactivé :<br/>ignoré, attribuez-le<br/>une fois dans X4"] P["Votre profil"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>assignations par emplacement"] E --> O["options globales du jeu :<br/>inversions, mode des gaz"]
Code : engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs et le modèle de réglages engine\FfbModels\X4.cs.
- Emplacements : une assignation nomme une source :
INPUT_SOURCE_JOYBUTTONS(boutons et chapeau) ouINPUT_SOURCE_JOYAXES, sans suffixe pour l'emplacement 1 et_2à_8pour les autres.config.xmlassocie les périphériques aux emplacements par GUID d'instance DirectInput, écrit sous la forme propre à X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}) ;num0 à 7 est l'emplacement,disabled="1"signifie aucun. JoyPro n'écrit que dans les emplacements dont l'entrée actuelle et active correspond à un périphérique branché. - Codes : les boutons 1 à 11 utilisent les noms de manette de X4 (
INPUT_XBUTTON_A...BIGBUTTON), 12 à 64INPUT_XBUTTON_12... ; le chapeauINPUT_XBUTTON_DPAD_*(huit directions) ; les axesINPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Les plages n'ont pas desgn. Clavier :INPUT_KEYCODE_<DIK>avec_SHIFT/_CONTROL. - Liste de commandes :
engine x4 refresh-dblitgameoptions.luaet la page de texte anglaise dans les archives.cat/.datet les tables de noms deX4.exe, en lecture seule ; 128 commandes de vol spatial (6 axes, 122 boutons). Les lignes se lisent comme "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)".engine x4 catalogla liste,engine x4 pathsmontre les fichiers trouvés. - Import / exportation :
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. - Paramètres du jeu :
engine ffb set --device * --game X4 --param <key>=<value>; les paramètres sont modifiés sur place, un paramètre manquant est ajouté comme dernière ligne de<config>. Une exportation sans assignations X4 écrit quand même les réglages enregistrés.
#Limites connues
- Les périphériques sans emplacement fixé sont ignorés ; JoyPro ne les fixe pas encore lui-même.
- Les modificateurs joystick ne sont pas écrits : leur balisage dans le fichier n'est pas encore confirmé.
- 64 boutons, 8 axes et un chapeau par périphérique ; huit emplacements, partagés avec les manettes.
- Vibration : le curseur du jeu affiche la valeur fois 100 tronquée (21 % s'affiche 20) ; le fichier garde la valeur exacte.
- Tests :
engine\tests\smoke\x4.ps1(aussi le rafraîchissement du catalogue) ; dans le jeutools\e2e\games\X4.ps1(assignations et matrice des modes, dans son propre dossier de profil) ettools\e2e\games\X4Settings.ps1(inversions, mode des gaz, paramètres du jeu).
Toutes les notes techniques sur ce jeu (générées à partir du dépôt) : x4.md.