Comment traduire un roman visuel Kirikiri / KAG en anglais

Kirikiri (吉里吉里) et sa couche de scénario KAG animent une énorme part des romans visuels japonais — y compris la majeure partie du catalogue bishoujo commercial. Le hic : Kirikiri empaquette ses scripts, son art et son audio dans des archives .xp3 chiffrées, et de nombreux studios appliquent par-dessus un schéma de chiffrement propre au jeu. C'est pourquoi Kirikiri a la réputation d'être difficile à traduire. Ce guide parcourt le processus de bout en bout avec RuneTranslate : lire le .xp3, gérer le chiffrement, traduire les scénarios KAG .ks, et exporter un patch que le jeu charge automatiquement.

Ce qu'il vous faut

• RuneTranslate pour Windows — gratuit, chaque moteur et fournisseur débloqué.
• Un dossier de jeu Kirikiri — le répertoire avec le .exe du jeu et une ou plusieurs archives .xp3 (couramment data.xp3, scenario.xp3, etc.). Les builds KirikiriZ signés avec des fichiers .exe.emb / .xp3.sig sont aussi reconnus.
• Une langue cible — anglais, espagnol, français, allemand, portugais, russe, chinois, italien, turc, vietnamien, et plus de 20 autres.
• Un fournisseur de traduction. Les romans visuels sont riches en dialogues, donc un LLM (OpenAI / Anthropic) ou DeepL offre généralement la meilleure lecture ; Google Translate gratuit fonctionne d'emblée.

Étape 1 : Ouvrir le jeu et déballer le XP3

Lancez RuneTranslate, cliquez sur Nouveau projet, et pointez-le vers le répertoire du jeu Kirikiri. La détection du moteur s'exécute automatiquement. Le lecteur XP3 intégré ouvre l'index de l'archive — y compris l'en-tête d'index compressé de 17 octets qu'utilisent les grandes archives — et en extrait les fichiers de scénario. Vos archives d'origine ne sont jamais modifiées.

Si l'archive est chiffrée, RuneTranslate tente de la déchiffrer avec une bibliothèque d'environ deux douzaines de schémas de chiffrement GARbro portés, plus un solveur générique par force brute de XOR à un octet pour les brouillages par fichier plus simples. La plupart des jeux commerciaux tombent dans l'un d'eux. Les schémas qui nécessitent un état d'exécution par archive ou une clé détenue par le studio restent non pris en charge — ce sont les exceptions véritablement verrouillées.

Étape 2 : Comment le dialogue Kirikiri est extrait

Kirikiri stocke le dialogue dans des scripts de scénario KAG .ks. RuneTranslate les analyse et liste le texte traduisible dans l'éditeur :

• Dialogue et narration — les lignes de scénario brutes.
• Extraction intelligente d'attributs — le texte lisible à l'intérieur de balises comme [ruby/], [ch text="..."], [name text="..."], et [button text="..."] est extrait et traduit, tandis que la structure de balise elle-même est préservée.

Les balises de contrôle KAG en ligne sont masquées derrière des espaces réservés numériques [[K#]] avant que quoi que ce soit n'atteigne le fournisseur, pour que la machine ne puisse pas casser le formatage du moteur. Certains jeux KirikiriZ livrent aussi leur scénario en binaire PSB .scn compilé (le format PSB\0) — RuneTranslate analyse et réempaquette aussi les scénarios PSB non chiffrés (versions de format 1 à 4), donc ces jeux se traduisent comme des scripts texte.

Étape 3 : Traduire et relire

Choisissez un fournisseur et lancez. Pour la voix des personnages et le langage stylisé, un LLM comme OpenAI ou Anthropic offre la meilleure lecture ; DeepL est rapide et net pour la narration ; Google Translate gratuit couvre les menus. Constituez d'abord le glossaire de votre distribution et de vos termes récurrents pour que chaque route affiche les noms à l'identique — voir Glossaire 101. Sur le palier gratuit, la traduction est modestement bridée — environ 2× plus lente sur les fournisseurs d'IA, moins sur les scrapers gratuits — avec une qualité de sortie identique ; les paliers payants s'exécutent à pleine vitesse et ajoutent la mémoire de traduction.

Chaque ligne atterrit dans l'éditeur à côté de sa source. Modifiez en ligne (enregistrement à la perte de focus ou par Ctrl+Entrée), utilisez rechercher & remplacer, ou lancez l'affineur IA facultatif pour une relecture de deuxième passe tenant compte du contexte — précieux sur les longues routes de roman visuel.

Étape 4 : Exporter un patch

Cliquez sur Exporter. RuneTranslate écrit le scénario traduit en fichiers libres plus un hook de démarrage et, là où ça aide, un patch.xp3 plat. Il utilise deux chemins de surcharge parce qu'aucun seul n'est universel :

• Fichiers libres + hook de démarrage — l'appel addAutoPath du hook fait remonter les fichiers libres au-dessus des archives du jeu. Comme différents builds exécutent un point d'entrée d'initialisation différent, RuneTranslate écrit le hook sous les trois noms qu'utilisent les jeux — AfterInit2.tjs, xAfterInit2.tjs, et xAfterInit.tjs — pour que celui que le jeu appelle le prenne en compte.
• patch.xp3 — Kirikiri monte automatiquement patch.xp3 / patch2.xp3 avec une priorité supérieure aux propres archives du jeu (« les chemins plus tardifs l'emportent »), donc il surcharge même quand un jeu désactive le hook de démarrage. Sur les builds chiffrés, ses entrées sont pré-chiffrées avec le propre schéma du jeu. Notez que les builds qui imposent des signatures d'archive rejettent un patch.xp3 supplémentaire, donc sur ceux-là le hook en fichiers libres est le chemin qui porte la traduction.

La sortie est votre traduction déposée à côté du jeu d'origine. Lancez le .exe et il se joue dans votre langue cible.

Limitations connues

• Un XP3 chiffré avec un schéma propre au jeu qui nécessite un état d'exécution, des tables de recherche, ou une clé détenue par le studio n'est pas pris en charge — environ deux douzaines de schémas GARbro plus un solveur XOR par force brute sont intégrés, ce qui couvre la plupart des jeux commerciaux mais pas toutes les exceptions.
• Les scénarios PSB .scn chiffrés / compressés en MDF sont ignorés ; seul le PSB non chiffré (versions 1–4) est pris en charge.
• Le bytecode KAG .ks compilé ou tokenisé (binaire / magie jk qui ne se débrouille pas en texte) est ignoré — seuls les scripts KAG lisibles et les scénarios PSB non chiffrés sont analysés.
• Le texte dans les images (logos, interface dessinée à la main, légendes de CG) n'est pas traduit — hors du périmètre de la traduction automatique.

Pourquoi c'est plus facile qu'avant

La route manuelle impliquait d'identifier le schéma de chiffrement, d'extraire le XP3 avec GARbro, de trouver à la main le texte lisible à l'intérieur des balises KAG, de le traduire sans casser le balisage, puis de réempaqueter ou de câbler correctement un chemin de surcharge. RuneTranslate replie toute la chaîne — déchiffrer, extraire, masquer les balises, traduire, construire à la fois le hook en fichiers libres et le patch.xp3 — en quelques clics, avec l'éditeur ouvert pour que vous contrôliez la formulation.

Voir la page moteur Kirikiri pour la liste complète des fonctionnalités, lisez le guide Ren'Py pour un autre moteur de roman visuel, ou téléchargez RuneTranslate et essayez-le sur un vrai jeu.