Traduire un fork

Un fork s'écrit dans une seule langue, sa langue source, choisie à sa création. Tout s'édite dans cette langue : le titre, les textes du jeu, sur place comme dans le panneau. Les autres langues sont des traductions : vous téléchargez un fichier qui contient tous les textes du fork, vous le faites traduire hors de Maketools (par un traducteur, une agence ou votre propre assistant IA), puis vous l'importez.

Les joueurs ne voient une langue que lorsque sa traduction est complète : jamais de jeu à moitié traduit.

L'onglet Langues

Chaque fork a un onglet Langues, à côté d'Éditer, Releases et Accès. Il liste une ligne par langue :

Chaque traduction propose Télécharger le fichier, Importer un fichier et Retirer. Ajouter une langue télécharge le fichier d'une nouvelle langue, à traduire entièrement ; elle apparaît dans la liste dès que vous importez ce fichier.

Les Propriétaires, Admins et Éditeurs gèrent les langues d'un fork. La langue source se choisit à la création et ne change plus : pour écrire le jeu dans une autre langue, créez un nouveau fork dans cette langue.

Langues disponibles

Un fork peut être proposé en anglais, français, espagnol, portugais et allemand. Sa langue source est l'une des langues dans lesquelles le jeu est livré (indiquées sur sa fiche du catalogue) ; toute autre de ces cinq langues peut s'ajouter en traduction. Les textes propres au jeu (menu pause, écran de fin, compétences) suivent la langue du jeu. L'interface Maketools, les e-mails et les rapports restent en anglais ou en français.

Traduire en trois étapes

1. Téléchargez le fichier de la langue voulue (ou Ajouter une langue). Il contient chaque texte du fork dans la langue source, et la traduction déjà faite quand elle est à jour. Il est enregistré sous le nom <fork>.<source>-<cible>.json, par exemple onboarding-2026.fr-en.json.
2. Faites-le traduire : remplissez chaque target vide, à la main ou avec un outil. Le fichier contient ses propres consignes : un traducteur ou un assistant IA peut le traiter sans autre explication.
3. Importez le fichier sur la ligne de la même langue. Maketools vérifie chaque traduction et affiche un bilan (voir plus bas). L'import remplace la traduction de cette langue par celle du fichier : partez donc toujours du dernier fichier téléchargé, qui contient déjà les traductions à jour.

Recommencez quand vous voulez : après une modification du contenu, le fichier suivant ne contient à traduire que ce qui a changé.

Le fichier de traduction

Un fichier JSON lisible, pensé pour être traduit sans l'application. Exemple pour un fork de Prompt Quest écrit en français et traduit vers l'anglais :

{
  "format": "maketools.translation",
  "version": 1,
  "instructions": "Translate every entry from `sourceLocale` into `targetLocale`: write the translation in `target`, keeping `source` unchanged. Fill every empty `target`; keep an existing `target` unless it is wrong. Never change `id`. `context` tells where the text appears in the game. Respect `maxLength` (characters). Keep line breaks, numbers, names and {placeholders}; do not add HTML. Return the whole file as valid JSON.",
  "gameId": "prompt-quest",
  "major": 1,
  "forkId": "0192a4f0-7c1e-7b3a-9d2e-5f6a7b8c9d0e",
  "title": "Parcours prompt 2026",
  "sourceLocale": "fr",
  "targetLocale": "en",
  "exportedAt": "2026-09-24T09:30:00.000Z",
  "entries": [
    {
      "id": "/fork/title",
      "context": "Titre du fork",
      "maxLength": 80,
      "source": "Parcours prompt 2026",
      "target": "Prompt path 2026"
    },
    {
      "id": "/content/rounds/0/title",
      "context": "Manches › Manche 1 › Titre de manche",
      "maxLength": 60,
      "source": "Le village",
      "target": ""
    }
  ]
}

Les règles de texte sont celles de l'éditeur : texte brut, sans HTML (un < suivi d'une lettre, de /, ! ou ? est refusé, voir Éditer votre draft). Gardez les retours à la ligne, les nombres, les noms propres et les {variables}. Un fichier fait au plus 1 Mo.

Faire traduire par un assistant IA

Maketools n'appelle aucune IA : vous restez libre de l'outil et de ce qui en sort. Un assistant conversationnel traduit très bien ce fichier. Donnez-lui le fichier entier (en pièce jointe ou collé) avec une consigne comme celle-ci, à adapter :

Voici un fichier de traduction JSON Maketools. Traduis chaque texte du champ « source »
(français) en anglais, dans le champ « target » de la même entrée, en suivant le champ
« instructions » du fichier.
- Ne modifie aucun autre champ : ni « id », ni « source », ni « context », ni « maxLength »,
  ni l'en-tête du fichier. Ne supprime, n'ajoute ni ne réordonne aucune entrée.
- Remplis chaque « target » vide. Garde un « target » déjà rempli, sauf s'il est faux.
- Ne dépasse jamais « maxLength » caractères ; raccourcis la traduction si nécessaire.
- Garde les retours à la ligne, les nombres, les noms propres et les {variables}.
  N'ajoute pas de HTML.
- Public : des professionnels en formation ; ton clair et direct. Termes à garder tels
  quels : « prompt », le nom de notre entreprise.
Rends le fichier complet, en JSON valide, sans aucun texte avant ni après.

Quelques précautions :

• Un long fichier peut être tronqué par l'assistant. Le bilan d'import liste les textes encore à traduire : redemandez la suite, ou découpez en demandant « les entrées 1 à 100 », puis « 101 à 200 », en recollant le résultat dans un seul fichier.
• Relisez avant de publier : testez le fork dans la langue traduite. Une IA peut mal traduire un terme métier ou une réponse attendue.
• Vos données : le fichier contient le contenu de votre jeu (pas de données de joueurs). L'envoyer à un service d'IA externe relève des règles de votre organisation.

Le bilan d'import

Après chaque import, Maketools affiche :

• les traductions importées ;
• les traductions refusées, avec leur raison : trop longue (au-delà de maxLength), texte refusé (HTML ou caractères interdits), ou identifiant en double dans le fichier. Corrigez-les dans le fichier et importez-le à nouveau ;
• les textes obsolètes : leur texte source a changé depuis l'export. Ils redeviennent « à traduire » ;
• les identifiants inconnus, ignorés : le texte a été supprimé du fork depuis l'export ;
• les textes restants à traduire, avec l'endroit où ils apparaissent dans le jeu.

Le fichier est refusé en entier, sans rien changer, s'il n'est pas un fichier de traduction Maketools valide (JSON mal formé, champ d'en-tête modifié), s'il vient d'un autre fork, ou s'il ne correspond pas à la langue source du fork ou à la langue de la ligne où vous l'importez. Téléchargez alors un fichier neuf depuis la bonne ligne.

Les textes traduits passent aussi les contrôles propres au jeu, comme en édition : par exemple, un passage à surligner doit figurer mot pour mot dans le texte qui le contient, dans chaque langue.

Quand vous modifiez un texte source

Modifier un texte dans la langue source le fait passer « à traduire » dans toutes les traductions : sa traduction ne correspond plus. L'éditeur indique le nombre de textes à traduire, et l'onglet Langues les détaille. Le prochain fichier téléchargé les contient avec un target vide.

• Réordonner ou dupliquer des éléments ne perd aucune traduction : un texte identique garde sa traduction, où qu'il soit.
• Si vous remettez un texte à sa valeur d'avant, sa traduction revient.
• La release déployée ne change pas : ses langues restent proposées aux joueurs tant que vous n'en déployez pas une nouvelle.

Ce que voient les joueurs

Une release fige le draft et ses traductions. Elle propose aux joueurs la langue source et les traductions complètes au moment de sa création. Une traduction incomplète n'y figure pas : le studio vous prévient avant de créer la release, pour que vous puissiez d'abord la terminer.

Le joueur joue dans la langue du site si la release la propose, sinon dans la langue source. Quand la release propose plusieurs langues, il la change avec le sélecteur Langue du jeu avant de jouer. Le titre du fork est traduit comme le reste du contenu.

Vérifier une traduction dans l'éditeur

Dans l'éditeur, le sélecteur de langue de l'aperçu montre le jeu dans la langue source ou dans une traduction. Une traduction s'affiche en lecture seule : les textes à traduire y apparaissent dans la langue source, et Mettre à jour la traduction mène à l'onglet Langues. Pour jouer une traduction du début à la fin, testez le fork dans cette langue.

Retirer une langue

Retirer supprime la traduction du draft, après confirmation. Les releases déjà créées la gardent : la release déployée continue de la proposer jusqu'au déploiement d'une release sans elle. Pour la remettre, téléchargez de nouveau son fichier depuis Ajouter une langue.

Les langues reprises du jeu

Les jeux du catalogue existent dans plusieurs langues. Quand vous forkez un jeu, ses autres langues sont reprises comme traductions de votre fork, complètes : un fork de Prompt Quest écrit en français est traduit en anglais dès sa création. Chaque texte que vous modifiez ensuite passe « à traduire » dans ces langues. Un titre de fork personnalisé est lui aussi à traduire.

Ensuite : testez votre fork dans chaque langue, puis créez une release.