JoyPro2 Discord GitHub
Étapes principales

Exporter vers vos jeux

Afficher :

L'exportation est l'étape qui fait marcher vos manches dans le jeu. JoyPro écrit vos relations et assignations dans les fichiers de réglages des commandes de chaque jeu, les mêmes fichiers que le menu Controls du jeu enregistre. Rien ne tourne en arrière-plan pendant que vous volez : une fois l'exportation faite, le jeu lit ses propres fichiers comme toujours.

flowchart LR
  C["1 Vérifier<br/>(facultatif)"] --> M["2 Choisir comment<br/>(4 choix)"]
  M --> G["3 Cocher les jeux,<br/>Exporter les jeux cochés"]
  G --> W["D'abord la sauvegarde,<br/>puis les fichiers<br/>du jeu sont écrits"]
L'étape 1 se contente de regarder ; elle n'arrête jamais l'exportation. Annuler la dernière exportation sur la carte d'un jeu remet ses fichiers en place. Pour les jeux uniquement Xbox, rien n'est écrit : ils utilisent Démarrer sur la page Joystick virtuel.
Pour les débutants

#Exporter en trois étapes

Ouvrez Exporter dans la barre du bas. La page se compose de trois cartes numérotées, de haut en bas :

La page Exporter : vérification, mode, jeuxLa page Exporter : vérification, mode, jeux
La page Exporter : vérification, mode, jeux (Les images montrent l'application en anglais.)
  1. Vérifiez votre profil. Appuyez sur Vérifier maintenant. JoyPro cherche ce qui irait mal dans le jeu, par exemple un bouton qui fait deux choses dans le même appareil. Corrigez ce qu'il trouve (un clic par problème) ou laissez tel quel ; la vérification ne bloque jamais l'exportation. Voir la vérification.
  2. Comment JoyPro écrit dans les jeux. Choisissez l'un des quatre choix. En cas de doute, gardez le premier : Remplacer sur mes périphériques avec Effacer aussi mes autres périphériques coché. Vos manches font alors exactement ce que dit votre profil, et rien d'autre.
  3. Exporter vers les jeux. Chaque jeu pour lequel votre profil a des assignations reçoit une carte avec son image. Cochez les jeux et appuyez sur Exporter les jeux cochés, ou appuyez sur Exporter maintenant sur une carte.

Fermez d'abord le jeu. Les jeux écrivent leurs fichiers de commandes en quittant, JoyPro refuse donc d'exporter vers un jeu qui tourne et vous le dit.

#Quel choix me convient ?

Choix Choisissez-le quand Ce qui arrive aux propres assignations du jeu
Remplacer sur mes périphériques JoyPro est l'endroit où vous configurez vos manches Sur les périphériques de votre profil, seules vos assignations restent (pour les appareils que vous exportez).
Mettre à jour, garder les assignations du jeu Vous assignez aussi des choses dans le jeu et voulez les garder Vos assignations sont ajoutées ; une assignation du jeu n'est retirée que là où elle est sur un bouton que vous utilisez pour autre chose.
Mettre à jour, mon profil l'emporte Comme ci-dessus, mais vous avez déplacé des actions vers d'autres boutons dans JoyPro Comme ci-dessus, et chaque action que vous assignez perd ses autres boutons dans le jeu, pour qu'un déplacement déplace vraiment.
Ajouter seulement Vous essayez JoyPro pour la première fois Rien n'est retiré. Si le jeu utilise déjà un bouton pour autre chose, votre assignation est laissée de côté et la vérification vous le dit.

Effacer aussi mes autres périphériques (une case sous les choix) : les périphériques branchés qui n'ont pas d'assignation dans votre profil perdent leurs assignations dans les appareils exportés. Laissez-la cochée si vous voulez repartir de zéro, décochez-la si vous utilisez un second périphérique uniquement dans le jeu.

#Sûr par conception

  • Avant que JoyPro ne modifie un fichier du jeu, il le copie dans une sauvegarde. Chaque carte a Annuler la dernière exportation : cela remet les fichiers exactement comme ils étaient, octet par octet.
  • La première exportation vers un jeu qui a déjà ses propres assignations demande une fois : « Importer d'abord ? ». Choisissez Importer d'abord si vous voulez garder ce que vous avez fait dans le jeu, Exporter quand même pour le remplacer.
  • Les périphériques non branchés gardent leurs assignations. Vos assignations de souris et de manette ne sont jamais touchées.

#Ce que vous remarquez dans le jeu

Lancez le jeu et ouvrez son menu des commandes : vos assignations y sont, dans la colonne de chaque périphérique, sous les noms qu'utilise le jeu. Dans DCS, elles s'affichent par appareil ; dans Star Citizen, par action de vaisseau ; dans IL-2, dans Key mapping. La section Dans le jeu ci-dessous liste chaque type de jeu.

#Les autres façons dont vos assignations arrivent dans le jeu

Moyen Ce qu'il fait
Écrire dans mon jeu (la configuration rapide) L'exportation de la configuration rapide. Elle écrit les jeux qu'elle a configurés, avec la même sauvegarde. Voir Démarrage rapide.
La fausse manette (manette Xbox virtuelle) Pour ACE COMBAT 8 et Hell Let Loose: Vietnam, rien n'est écrit. Leur exportation le dit. Votre manche pilote une fausse manette tant que Démarrer est actif. Voir Jeux uniquement Xbox.
La planchette de genou DCS Pas une exportation d'assignations : une page par appareil qui liste ce que font vos boutons, dans le cockpit. Voir la planchette de genou.
Avancé

#Les modes en détail

« Même entrée » signifie le même périphérique, le même bouton ou axe et les mêmes modificateurs, dans le même appareil (ou vaisseau, véhicule) quand le jeu garde les assignations par appareil. Chaque mode ne travaille que dans les appareils de l'exportation.

Ajouter seulement Mettre à jour, garder Mettre à jour, le profil l'emporte Remplacer
Vos assignations écrites là où l'entrée est libre rédigé rédigé rédigé
Une assignation du jeu sur une entrée que vous utilisez pour une autre action gardée ; votre assignation n'est pas écrite et est marquée retirée retirée retirée
Une assignation du jeu pour la même action sur une autre entrée (après un déplacement) conservé gardée (l'action est sur les deux entrées) retirée retirée sur les périphériques écrits
Autres assignations du jeu sur vos périphériques conservé conservé conservé retirées
Valeurs par défaut du jeu sur vos périphériques conservé conservé gardées sauf si elles portent une de vos actions retirées
Périphériques branchés sans assignation dans le profil conservé conservé vos actions en sont retirées gardées, sauf avec Effacer aussi mes autres périphériques
Périphériques non branchés, souris, manette jamais touchés jamais touchés jamais touchés jamais touchés
Clavier uniquement avec l'option clavier uniquement avec l'option clavier uniquement avec l'option clavier uniquement avec l'option clavier
Appareils hors de l'exportation jamais touchés jamais touchés jamais touchés jamais touchés (DCS : sauf avec l'option « perdre les assignations par défaut de DCS dans tous les autres appareils »)

Effacer aussi mes autres périphériques ne sert pas avec Ajouter seulement. Avec les autres modes, il efface les périphériques branchés que le profil n'utilise pas, dans les appareils exportés (DCS : leurs valeurs par défaut DCS aussi). Les périphériques que l'import ignore et le périphérique vJoy vers lequel JoyPro redirige ne sont jamais effacés.

Depuis la 2.5.0, le choix par défaut est Remplacer sur mes périphériques + Effacer aussi mes autres périphériques (comme dans JoyPro 1). Un mode que vous avez choisi vous-même est retenu.

#En bref : une de vos assignations, quatre modes

Mode Le jeu utilise votre bouton pour autre chose Votre action a d'autres boutons dans le jeu Autres périphériques branchés
Remplacer sur mes périphériques Cette assignation est retirée ; la vôtre est écrite Retirés sur les périphériques écrits Gardés, sauf avec Effacer aussi mes autres périphériques
Mettre à jour, mon profil l'emporte Cette assignation est retirée ; la vôtre est écrite Supprimé Vos actions en sont retirées
Mettre à jour, garder les assignations du jeu Cette assignation est retirée ; la vôtre est écrite Gardés : l'action est sur les deux Conservé
Ajouter seulement Gardée ; la vôtre n'est pas écrite et est marquée Conservé Conservé

#Options par jeu

Sous Options et chemins (pour experts) :

  • DCS : la liste Appareils... sur la carte DCS (seuls les appareils cochés sont écrits) ; DCS : garder les défauts du clavier (activé) ; mes périphériques perdent aussi les assignations par défaut de DCS dans tous les autres appareils (désactivé).
  • Star Citizen : SC : garder les défauts du clavier, préférer l'ordre local.
  • Les autres jeux : une case Essai à blanc qui montre ce qui changerait sans rien écrire.
  • Chemins : un autre dossier Saved Games ou de configuration par jeu ; Chemins et périphériques ignorés propres à ce profil donne au profil ouvert les siens au lieu de ceux du PC.

#Marques : « Non écrit dans le jeu »

Ajouter seulement (et tout mode où un jeu n'a pas de place libre pour une autre entrée, par exemple Elite Dangerous avec deux entrées par action) laisse certaines assignations de côté. Le profil retient chacune avec l'action du jeu qui occupe l'entrée et la date ; la vérification montre une carte par marque avec Exporter avec 'Mettre à jour' pour le remplacer, Déplacer vers un autre bouton et Laisser tel quel. Chaque exportation remplace les marques de son jeu et de ses appareils, une marque disparaît donc quand une exportation ultérieure écrit l'assignation.

#Réglages retenus

Le mode, la case Effacer aussi, les options par jeu et les chemins sont gardés dans les paramètres de JoyPro ; les jeux et appareils DCS que vous avez cochés vous-même sont gardés par profil. Remplacer et Effacer aussi demandent confirmation avant chaque exportation (Paramètres > Confirmations peut désactiver la question).

#Après l'exportation

  • Annuler la dernière exportation sur la carte restaure la sauvegarde la plus récente de ce jeu. La liste complète se trouve sous Sauvegardes de la config du jeu en bas de la page Exporter.
  • L'exportation enregistre les fichiers du jeu pour la surveillance des jeux : l'exportation de JoyPro elle-même ne demande jamais plus tard « reprendre les changements ? » ; un changement que vous faites ensuite dans le jeu, si (la surveillance).
  • JoyPro garde ses propres données à côté du fichier du jeu, un import ultérieur ramène donc les noms des relations, les groupes, les modificateurs et les courbes (réimportation).

#Dans le jeu

Ce que le joueur voit après une exportation dépend du type de jeu. Chaque jeu ci-dessous suit les mêmes règles : JoyPro n'écrit que les actions de sa liste de commandes, refuse d'écrire tant que le jeu tourne, sauvegarde d'abord les fichiers et ne devine jamais un périphérique ou une action qu'il ne peut pas faire correspondre (il l'ignore avec un avertissement).

Dans le jeu: Simulateurs de vol : DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

JoyPro prend en main les périphériques qu'il écrit. Avec Remplacer, toutes les autres assignations de ces périphériques disparaissent dans les appareils exportés ; avec Effacer aussi, les autres périphériques branchés sont effacés aussi (DCS : leurs réglages par défaut DCS également).

  • DCS World : dans Options > Controls, choisissez l'appareil : vos assignations sont dans la colonne du périphérique, les réglages par défaut retirés apparaissent comme cases vides, vos modificateurs sont dans la liste des modificateurs. Seuls les appareils cochés changent. JoyPro n'écrit que les différences avec les réglages par défaut de DCS, comme DCS lui-même.
  • IL-2 Great Battles : Settings > Key mapping montre vos assignations et les réponses des axes. Les lignes de souris et les lignes que JoyPro ne connaît pas restent.
  • IL-2 Korea : le profil de key mapping "General".
  • Falcon BMS : le launcher crée le fichier de touches et l'attribution des axes à son prochain Launch, lancez donc BMS par le launcher.
  • MSFS 2024 / 2020 : dans Controls, le périphérique montre le préréglage de JoyPro.
  • X-Plane 11 / 12 : Settings > Joystick montre les attributions.
Dans le jeu: Jeux avec infanterie, véhicules ou menus : Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

JoyPro ne touche que les actions de vol (avion, hélicoptère, vaisseau spatial). Vos assignations à pied, de véhicule et de menu restent octet par octet. Remplacer et Effacer aussi ne libèrent que les actions de vol que JoyPro connaît.

  • Star Citizen : Options > Keybindings montre les actions de vaisseau sur vos joysticks (js1, js2, ...). Avec Remplacer ou Effacer aussi, les assignations joystick par défaut du jeu sur js1 sont désactivées quand js1 est écrit ou inutilisé.
  • War Thunder : Controls montre les assignations d'avion ; les commandes de char et de navire ne changent pas.
  • Arma 3 / Arma 2 : les réglages de touches du profil ; seules les actions d'avion et d'hélicoptère changent.
Dans le jeu: Jeux spatiaux : Elite Dangerous, X4: Foundations
  • Elite Dangerous garde deux entrées par action (Primary et Secondary). Une assignation sans place libre reçoit une marque « Non écrit » avec « Déplacer vers un autre bouton » ou « Laisser tel quel ». Les assignations à pied et SRV restent.
  • X4 : les réglages d'entrée du jeu ; seules les actions de vaisseau cataloguées changent.
Dans le jeu: Jeux qui lisent un seul périphérique ou seulement une manette Xbox
  • Jeux réglés sur vJoy (jeux qui ne lisent que quelques périphériques) : l'exportation écrit les assignations sur le périphérique vJoy. JoyPro y copie vos manches pendant que vous jouez, et HidHide cache vos vrais périphériques pour ce jeu uniquement. Le jeu voit un seul périphérique avec tout dessus. Voir Joystick virtuel.
  • Jeux uniquement Xbox (ACE COMBAT 8, Hell Let Loose: Vietnam) : rien n'est écrit, et l'exportation le dit. Votre manche pilote une fausse manette (manette Xbox virtuelle) tant que Démarrer est actif. HidHide n'est pas nécessaire. Voir Jouer à un jeu uniquement Xbox avec un HOTAS.
Détails techniques

#Comment ça marche à l'intérieur

Une exportation, du clic jusqu'aux fichiers écrits :

# Qui Ce qui se passe
1 Vous Appuyez sur Exporter les jeux cochés sur la page Exporter.
2 JoyPro Interroge le moteur sur le jeu (profile game-state --game <id>) : importé, exporté, a des assignations.
3 JoyPro Vous demande si nécessaire : une première exportation (« Importer d'abord ? ») ou un mode qui retire des assignations (Paramètres > Confirmations).
4 Moteur Lance <game> export --mode <m> --nuke-untouched-devices <b> ... : il refuse tant que le jeu tourne, sauvegarde chaque fichier (GameBackups et .jpbak) et n'écrit que des actions cataloguées.
5 Moteur Enregistre l'enregistrement de synchronisation (empreinte et référence) et les marques d'exportation, puis répond : écrit, ignoré, SkippedTakenInputs.
6 JoyPro La carte du jeu affiche « Exporté 14:02 », et Annuler la dernière exportation est prêt.
  1. Interface. ExportSelectedGamesAsync / ExportGameNowAsync (MainWindowViewModel.ExportGames.cs) appellent AskAboutFirstExportAsync (engine profile game-state) et ConfirmRiskyExportAsync, puis ExportGameAsync choisit l'exportateur de la carte : dcs, il2, starcitizen ou un jeu du registre. La commande est construite à partir des réglages de la page, p. ex. RunDcsExportAsync : engine dcs export --mode clean --keep-keyboard-defaults true --nuke-untouched-devices true --clean-all-aircraft false --ignore-device <d> --planes F-16C_50|FA-18C_hornet. Chaque appel au moteur passe par un seul endroit, RunEngineAsync, avec --profile et --status true (la progression et Annuler de la zone d'activité), sérialisé pour que deux commandes n'écrivent jamais en même temps.
  2. Moteur. engine\Program.cs dirige dcs / il2 / starcitizen vers leurs exportateurs et tous les autres jeux vers Games.GameRegistry (une GameIntegration par jeu). DCS : EngineDcsExport.Modes.cs calcule, par fichier de périphérique, les assignations que DCS a actives (profil propre moins removed, plus added et changed), décide lesquelles doivent être actives et n'écrit que les vraies différences par rapport aux valeurs par défaut.
  3. Sécurité. GameExportSafety.BackupBeforeOverwrite copie chaque fichier en <file>.jpbak et dans le stockage de sauvegardes versionné (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\ avec manifest.json ; les 30 jeux de sauvegardes les plus récents par jeu sont gardés). Les jeux à registre (Nuclear Option) reçoivent un instantané des valeurs qu'ils peuvent changer. Un fichier que l'exportation crée est noté « n'existait pas », une restauration le supprime donc à nouveau.
  4. Ensuite. L'enregistrement de synchronisation (<data>\Sync\<game>.json : taille, heure et SHA-256 par fichier et un hachage de chaque assignation) fait taire la surveillance pour le propre changement de JoyPro. ExportSkippedBinds.cs remplit SkippedTakenInputs ; la commande d'exportation les transforme en marques du profil. L'historique du profil garde un point de restauration avant chaque exportation.

#Les fichiers que reçoit chaque jeu

Jeu Fichiers
DCS World par appareil et périphérique Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, un .jp à côté, le modifiers.lua de l'appareil
IL-2 Great Battles data\input\global.actions (nouvelles lignes à la fin, l'ordre gardé), les réponses d'axe, jp.actions
IL-2 Korea data\input\general.actions
Falcon BMS le User\Config\Setup.v100.* {GUID}.xml du lanceur par périphérique
MSFS 2024 / 2020 profils d'entrée (2024 : le paquet de presets joypro-input-profiles dans le dossier Community et les profils Steam)
X-Plane 11 / 12 les préférences joystick dans Output\preferences
Star Citizen LIVE\user\client\0\Profiles\default\actionmaps.xml et actionmaps.jp
War Thunder Documents\My Games\WarThunder\Saves\<id>\production\machine.blk
Jeux à registre leur fichier de configuration et <config>.joypro-meta.json

Marques des assignations non écrites : engine export-marks list, engine export-marks dismiss. Réglages : export-settings.json (ModeChosenByUser) ; sans --mode, le moteur utilise par défaut merge-overwrite.

#Chaque mode en ligne de commande

Choix dans l'interface Options du moteur
Remplacer sur mes périphériques + Effacer aussi mes autres périphériques (par défaut) --mode clean --nuke-untouched-devices true
Remplacer sur mes périphériques --mode clean --nuke-untouched-devices false
Mettre à jour, mon profil l'emporte (+ Effacer aussi) --mode merge-overwrite --nuke-untouched-devices true|false
Mettre à jour, garder les assignations du jeu (+ Effacer aussi) --mode merge --nuke-untouched-devices true|false
Ajouter seulement --mode add (nuke n'est pas utilisé)

Par jeu : engine dcs export, engine il2 export, engine starcitizen export, et engine <game> export pour chaque jeu du registre (par exemple engine warthunder export, engine msfs2024 export, engine xplane12 export ; chacun prend --mode, --dry-run, --include-keyboard et --nuke-untouched-devices). Annuler : engine backups restore. Tests : engine\tests\smoke\dcsexportmodes.ps1 (chaque mode, aller-retour, annulation à l'octet près) et engine\tests\smoke\roundtrip.ps1 (import, clean + nuke, un nouvel import laisse le jeu comme il était).