FSX, FSX: Steam Edition et Prepar3D v4, v5 et v6 gardent vos commandes dans un fichier XML dans %APPDATA% : une map par périphérique avec ses axes, boutons et chapeau, plus le clavier. JoyPro lit ce fichier dans votre profil, le relie à vos autres jeux dans des relations et le réécrit bloc par bloc, en laissant la mise en forme, les commentaires et les autres maps tels quels. Chaque simulation est un jeu à part dans JoyPro, car chacune a son propre fichier.
Cette intégration a été écrite à partir de sources publiques et n'est couverte que par un fichier de test synthétique : aucune de ces simulations n'a encore été testée avec JoyPro sur une vraie installation. Après votre première exportation, ouvrez les commandes de la simulation et vérifiez les assignations, et merci de signaler ce qui diffère.
Microsoft Flight Simulator X natif (ses propres fichiers d'assignations)
- Prise en charge
- natif (ses propres fichiers d'assignations)
- Commande du moteur
engine fsx- Fichier d'assignations
%APPDATA%\Microsoft\FSX\Controls\Standard.XML(XML)- Entrées que le jeu lit
- lit 32 boutons, 8 axes par joystick (signalé)
- Liste de commandes issue de
- la liste d'événements propre à JoyPro (identifiants publics du SDK) + les événements de vos fichiers de commandes et du modèle de l'installation
- ✓ Importer
- ✓ Exporter
- ✓ Assignations clavier
- ◐ ModificateursFSX et Prepar3D : Ctrl/Shift/Alt sur les touches du clavier ; aucun modificateur sur les assignations de joystick.
- ✓ 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
Microsoft Flight Simulator X: Steam Edition natif (ses propres fichiers d'assignations)
- Prise en charge
- natif (ses propres fichiers d'assignations)
- Commande du moteur
engine fsxse- Fichier d'assignations
%APPDATA%\Microsoft\FSX-SE\Controls\(ou le dossier de FSX), XML- Entrées que le jeu lit
- lit 32 boutons, 8 axes par joystick (signalé)
- Liste de commandes issue de
- comme FSX
- ✓ Importer
- ✓ Exporter
- ✓ Assignations clavier
- ◐ ModificateursFSX et Prepar3D : Ctrl/Shift/Alt sur les touches du clavier ; aucun modificateur sur les assignations de joystick.
- ✓ 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
Prepar3D v4 natif (ses propres fichiers d'assignations)
- Prise en charge
- natif (ses propres fichiers d'assignations)
- Commande du moteur
engine p3d4- Fichier d'assignations
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml(XML)- Entrées que le jeu lit
- lit 32 boutons, 8 axes par joystick (signalé)
- Liste de commandes issue de
- la liste d'événements propre à JoyPro + vos fichiers de commandes + le
Standard.xmlxde l'installation
- ✓ Importer
- ✓ Exporter
- ✓ Assignations clavier
- ◐ ModificateursFSX et Prepar3D : Ctrl/Shift/Alt sur les touches du clavier ; aucun modificateur sur les assignations de joystick.
- ✓ 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
Prepar3D v5 natif (ses propres fichiers d'assignations)
- Prise en charge
- natif (ses propres fichiers d'assignations)
- Commande du moteur
engine p3d5- Fichier d'assignations
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml(XML)- Entrées que le jeu lit
- lit 32 boutons, 8 axes par joystick (signalé)
- Liste de commandes issue de
- comme Prepar3D v4
- ✓ Importer
- ✓ Exporter
- ✓ Assignations clavier
- ◐ ModificateursFSX et Prepar3D : Ctrl/Shift/Alt sur les touches du clavier ; aucun modificateur sur les assignations de joystick.
- ✓ 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
Prepar3D v6 natif (ses propres fichiers d'assignations)
- Prise en charge
- natif (ses propres fichiers d'assignations)
- Commande du moteur
engine p3d6- Fichier d'assignations
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml(XML)- Entrées que le jeu lit
- lit 32 boutons, 8 axes par joystick (signalé)
- Liste de commandes issue de
- comme Prepar3D v4
- ✓ Importer
- ✓ Exporter
- ✓ Assignations clavier
- ◐ ModificateursFSX et Prepar3D : Ctrl/Shift/Alt sur les touches du clavier ; aucun modificateur sur les assignations de joystick.
- ✓ 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 la simulation fermée
Avant : lancez la simulation une fois avec vos périphériques branchés, puis fermez-la.
Ensuite : ouvrez les paramètres de commandes de la simulation et vérifiez les assignations. Cette intégration n'a pas encore été testée sur une vraie installation : merci de signaler ce qui diffère.
Vous avez déjà assigné des boutons dans la simulation ? Alors la page Accueil propose Importer, puis combler les vides. Vos assignations restent, et seuls les boutons libres reçoivent de nouveaux rôles. Voir Démarrage rapide : faire marcher mon manche.
#Ce que JoyPro fait pour FSX et Prepar3D
- Importer : les axes, boutons et chapeaux de vos périphériques arrivent dans votre profil, avec la sensibilité et la zone neutre de chaque axe. Les touches clavier arrivent quand vous les demandez.
- Relations : une relation est une fonction dans tous vos jeux ("Gear" dans FSX, MSFS et X-Plane sur le même bouton). Les commandes sont les noms d'événements publics des simulations (
GEAR_TOGGLE,AXIS_AILERONS_SET...). - Exporter : JoyPro écrit le fichier de commandes actif de la simulation que vous exportez.
#Importer vos assignations
- Ouvrez Démarrer. La carte de votre simulation affiche son image. Si elle demande une liste de commandes, appuyez sur Créer la liste : JoyPro combine sa propre liste d'événements avec les événements que nomment vos fichiers de commandes (et les propres fichiers modèles de la simulation).
- Appuyez sur Importer sur la carte. Choisissez Ajouter à mon profil et cochez Prendre aussi les touches du clavier si vous voulez aussi vos touches.
- Appuyez sur Importer maintenant. Voir mes relations ouvre ce qui est arrivé.
#Créer et vérifier les relations
Sur la page Relations, l'événement de la simulation d'une relation se trouve à côté de la même fonction dans vos autres jeux. Utilisez le parcours des relations pour les réunir, puis appuyez sur Vérifier maintenant sur la page Exporter (la vérification).
#Exporter
- Fermez la simulation. Elle réécrit le fichier en quittant ; JoyPro refuse tant que
fsx.exeouPrepar3D.exetourne. - Ouvrez Exporter et utilisez la carte de votre simulation.
- Gardez Remplacer sur mes périphériques avec Effacer aussi mes autres périphériques si c'est dans JoyPro que vous configurez vos périphériques. Appuyez sur Exporter maintenant sur la carte.
Lancez la simulation et ouvrez ses paramètres de commandes : les assignations de vos périphériques s'y affichent, et la sensibilité et la zone neutre de chaque axe sur sa page de calibrage. Le chemin exact dans le menu et la façon dont les simulations affichent le fichier de JoyPro ne sont pas encore confirmés.
#Ce que vous faites vous-même dans FSX et Prepar3D
- Lancez la simulation une fois avec vos périphériques branchés, pour qu'elle écrive son fichier de commandes.
- Vérifiez le résultat après la première exportation (voir plus haut). C'est le premier vrai test de cette intégration sur votre PC.
- Un chapeau est assigné en entier et sert normalement au panoramique de la vue (
PAN_VIEW). Les autres événements sur des directions de chapeau seules ne sont pas écrits ; assignez-les dans la simulation.
#Pièges courants
- "La simulation est en cours d'exécution" : fermez-la et exportez à nouveau.
- Un périphérique a perdu ses assignations après avoir été rebranché : Windows peut donner un nouveau GUID à un périphérique. JoyPro trouve alors sa map par le nom quand exactement un périphérique branché le porte (avec un avertissement).
- Une assignation joystick avec modificateur manque : le format n'a pas de modificateurs sur les boutons de joystick. Les touches peuvent avoir Ctrl, Shift et Alt.
#Fichiers que JoyPro lit et écrit
| Simulateur | Fichier de commandes |
|---|---|
| FSX (boîte) | %APPDATA%\Microsoft\FSX\Controls\Standard.XML (fichier actif d'après fsx.cfg [CONTROLS] Controls_Current) |
| FSX: Steam Edition | %APPDATA%\Microsoft\FSX-SE\Controls\ à côté de FSX en boîte, %APPDATA%\Microsoft\FSX\Controls\ quand il est installé seul |
| Prepar3D v4 / v5 / v6 | %APPDATA%\Lockheed Martin\Prepar3D v<N>\Controls\Standard.xml (fichier actif d'après Prepar3D.cfg [CONTROLS]) |
| tous | <file>.joypro.json (les entrées que JoyPro a écrites), <file>.joypro-meta.json (noms, groupes et réglages pour la prochaine importation) |
Le Standard.xmlx de Prepar3D (presets de périphériques) et le modèle de FSX dans le dossier d'installation sont lus pour la liste de commandes et jamais écrits.
#Les modes d'exportation dans FSX et Prepar3D
| Mode | Ce qui se passe dans le simulateur |
|---|---|
| Ajouter seulement | Ne retire ni ne remplace jamais un bloc. Une assignation sur une entrée qui a un autre événement n'est pas écrite et est listée. |
| Mettre à jour, garder les assignations du jeu | Remplace l'événement sur votre entrée (le conflit) et garde tout le reste. |
| Mettre à jour, mon profil l'emporte | Retire aussi les autres entrées des événements que vous assignez (périphériques branchés ; le clavier seulement avec l'option clavier). |
| Remplacer sur mes périphériques | Les tables principales des périphériques que vous écrivez ne gardent que vos assignations. |
| + Effacer aussi mes autres périphériques | Les tables principales des autres périphériques branchés sont vidées (les tables restent). |
#Ce qui n'est jamais touché
- Les tables des périphériques non branchés, les périphériques ignorés de l'importation et le périphérique vJoy alimenté par JoyPro.
- Les tables de slew (
... SLEW {GUID}),Mouse Yoke,Mouse Look, les tables par SimObject de Prepar3D, et la table du clavier sauf si vous exportez des assignations clavier. - Les accords de deux touches simples, les commentaires, la mise en forme et les éléments inconnus.
#Courbes et réglages
- Granularité : globale, un seul fichier pour tous les appareils.
- Réglages des axes (modèle d'axes
fsx) : sensibilité (0 à 127) et zone nulle (0 à 127) par axe de périphérique, comme sur la page d'étalonnage. La Courbe par défaut est adaptée (zone morte vers zone nulle, saturation vers sensibilité) ; une forme de courbe n'a pas d'équivalent. En mode Mettre à jour, les valeurs réglées dans le simulateur restent quand celles de JoyPro sont la simple valeur par défaut. - Inverser : une sensibilité négative.
- Pas de retour de force, de réglages du jeu ni de télémétrie. La surveillance remarque les changements après la fermeture du simulateur.
#Dans l'intégration FSX et Prepar3D
flowchart LR
P["Votre profil<br/>(relations + assignations)"] --> E["engine fsx / fsxse /<br/>p3d4 / p3d5 / p3d6 export"]
E --> X["Controls / Standard.XML :<br/>une carte par périphérique<br/>(nom du périphérique {GUID}),<br/>KEYBOARD_MAIN (option<br/>clavier seulement)"]
X --> G["Les réglages des commandes du simulateur"]
Code : engine\Games\FsxIntegration.cs (une classe, un jeu par simulateur), engine\Games\FsxControlsFile.cs (modification en texte de blocs entiers), engine\Games\FsxEvents.cs (la liste d'événements de JoyPro).
- Format :
<SimControls.Map>avec<Name>,<Axis>(<Index>0 à 7 = X, Y, Z, Rx, Ry, Rz, Slider, second curseur ;<AxEvent>,<AxScale>,<AxNull>),<Entry>(<Index>de bouton à partir de 0,<Down>/<Up>,<DownRpt>1pour les événements répétés) et<POV>(un chapeau entier). En-têteencoding="Windows-1252". - Périphériques : une table par périphérique DirectInput nommée
<instance name>{<instance GUID>}; reconnue par GUID, sinon par nom quand exactement un périphérique branché le porte. Un périphérique que le fichier n'a pas reçoit une nouvelle table. 32 boutons et 8 axes par périphérique sont signalés. - Mappage :
JOY_X..JOY_SLIDER2vers<Index>0 à 7,JOY_BTN<n>vers<Index>n-1, un chapeau sur sa direction haut (JOY_BTN_POV1_U). - Liste de commandes :
engine fsx refresh-db(etfsxse,p3d4,p3d5,p3d6) : environ 150 événements avec les titres de JoyPro plus chaque événement que nomment vos fichiers de commandes et les modèles du simulateur ; les événementsAXIS_*sont des axes. - Importation / exportation :
engine fsx paths(le fichier actif d'abord),engine fsx import,engine fsx scan,engine fsx export, et de même pourengine fsxse export,engine p3d4 export,engine p3d5 export,engine p3d6 export. Sauvegarde avant la première écriture.
#Limites connues
- Tout doit être vérifié sur une vraie installation : l'en-tête de Prepar3D v4+ et si
<Name>porte encore le GUID, les octets exacts que les simulateurs écrivent, le nom d'axe du second curseur, et si un simulateur garde une nouvelle table que JoyPro ajoute pour un périphérique qu'il n'a pas encore vu. - Le nom du fichier de configuration de FSX: Steam Edition est déduit.
- Tests :
engine\tests\smoke\fsx.ps1avec un fichier synthétique construit d'après le format documenté.
Toutes les notes techniques sur ce jeu (générées à partir du dépôt) : fsx-p3d.md.