kirikiri · tutorial · engine

Comment traduire un roman visuel Kirikiri / KAG en français

Traduisez les romans visuels Kirikiri / KAG en français avec RuneTranslate — en lisant automatiquement les archives .xp3 empaquetées, en traduisant les scénarios KAG .ks et les scènes PSB, et en exportant un patch.xp3 que le jeu charge automatiquement.

6 min de lecture

Kirikiri (吉里吉里) et sa couche de scénario KAG animent une énorme part des romans visuels japonais. Le hic : Kirikiri empaquette ses scripts, son art et son audio dans des archives .xp3, et de nombreux studios utilisent par-dessus leur propre variante d'archive. 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, traduire les scénarios KAG .ks, et exporter un patch que le jeu charge automatiquement.

Ce qu'il vous faut

  • RuneTranslate pour Windows ou Linux — gratuit, chaque moteur et chaque fournisseur sauf RuneLingua 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.

Les archives empaquetées s'ouvrent automatiquement, y compris, pour les titres que RuneTranslate reconnaît, le format plus récent qu'utilisent certaines sorties récentes. Quelques formats rares ne sont pas encore reconnus.

É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 standard (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 fournisseurs 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. Le patch est écrit sous une forme que le jeu accepte. Certains builds refusent 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 format d'archive empaquetée rare que l'application ne reconnaît pas encore n'est pas pris en charge. La plupart des jeux commerciaux s'ouvrent, mais pas toutes les exceptions.
  • Les scénarios PSB .scn non standard / compressés en MDF sont ignorés ; seul le PSB standard (versions 1–4) est pris en charge.
  • Le bytecode KAG .ks compilé ou tokenisé (binaire / magie jk qui ne se décode pas en texte) est ignoré — seuls les scripts KAG lisibles et les scénarios PSB standard sont analysés.
  • Le texte dans les images (logos, interface dessinée à la main, légendes de CG) ne fait pas partie des scripts ; traduisez-le dans l'Image Studio, qui lit les images directement dans les archives XP3 (TLG compris) et livre l'art traduit de la même manière que les scripts.

Pourquoi c'est plus facile qu'avant

La route manuelle impliquait d'identifier le format d'archive, d'extraire le XP3 avec un outil de déballage séparé, 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éballer, 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.

Prêt à essayer RuneTranslate ?

L'offre gratuite débloque tous les moteurs et tous les fournisseurs de traduction sauf RuneLingua. Supporter (3,99 $/mois) débloque la vitesse maximale.

Télécharger pour Windows, Mac & Linux