Comment traduire un jeu Ren'Py en anglais (guide complet)

Ren'Py est le moteur basé sur Python derrière la plupart des romans visuels occidentaux et japonais — des minuscules jams itch.io aux titres commerciaux DLsite. C'est l'un des moteurs les plus propres à traduire : RuneTranslate n'écrase jamais le script d'origine, il superpose la traduction par-dessus pour que le jeu reste intact. Ce guide parcourt la traduction d'un jeu Ren'Py en anglais (ou toute autre langue) de bout en bout avec RuneTranslate, y compris les trois formes sous lesquelles un jeu Ren'Py est livré — source .rpy libre, .rpyc compilé seulement, et .rpa archivé.

Ce qu'il vous faut

• RuneTranslate pour Windows — gratuit, chaque moteur et fournisseur débloqué.
• Un dossier de jeu Ren'Py. C'est le répertoire contenant le .exe du jeu plus un sous-dossier game/ (qui contient des fichiers .rpy, .rpyc, et/ou .rpa).
• Une langue cible — anglais, espagnol, français, allemand, portugais, russe, chinois, italien, turc, vietnamien, et plus de 20 autres.
• Un fournisseur de traduction. Google Translate gratuit fonctionne d'emblée ; DeepL a un palier gratuit ; OpenAI, Anthropic, un modèle local (Ollama / LM Studio) et toute API compatible OpenAI fonctionnent avec votre propre clé. Les romans visuels sont riches en dialogues et sensibles au ton, donc un LLM (OpenAI / Anthropic) ou DeepL offre généralement la meilleure lecture.

Étape 1 : Ouvrir le dossier du jeu

Lancez RuneTranslate, cliquez sur Nouveau projet, et pointez-le vers le répertoire du jeu Ren'Py (le dossier avec le .exe, ou le dossier interne game/). La détection du moteur s'exécute automatiquement et reconnaît le projet comme Ren'Py dès qu'elle voit une arborescence game/.

La manière dont le texte est lu dépend de ce que le développeur a livré :

• Jeux source — scripts .rpy libres sous game/. RuneTranslate les analyse directement. C'est le cas idéal.
• Jeux compilés seulement — uniquement du bytecode .rpyc. Un sidecar unrpyc embarqué les décompile d'abord en .rpy lisible, puis les analyse normalement.
• Jeux archivés — scripts empaquetés dans une archive .rpa. RuneTranslate la déballe avec un rpatool intégré et patché dans un espace de travail par projet sous %APPDATA%/RuneTranslate/renpy-workspace/<projectId>/, décompile, puis analyse. Notre fork de rpatool détecte automatiquement les clés d'archive RPA-x.y obfusquées et propres à un éditeur, donc il ouvre de nombreuses archives que les outils en amont refusent.

Votre dossier de jeu d'origine n'est jamais modifié.

Étape 2 : Comment le texte Ren'Py est extrait

RuneTranslate extrait les instructions say (dialogue), les choix menu, et le texte d'interface traduisible du script et les liste dans l'éditeur, regroupés par fichier. Le balisage de texte Ren'Py — {b}, {color=#fff}, les attentes {w}, les italiques {i}, et les interpolations de variable de style [player_name] — est masqué derrière des espaces réservés numériques [[R#]] avant que quoi que ce soit n'atteigne le fournisseur, puis restauré en sortie. La machine ne voit jamais les balises, donc elle ne peut pas les malmener, les supprimer ni les traduire.

Étape 3 : Traduire

Choisissez un fournisseur et lancez. Pour un roman visuel de longueur moyenne (~8 000–15 000 lignes) sur le palier Supporter :

• OpenAI / Anthropic — idéal pour la voix des personnages, les blagues et le langage stylisé ; environ quelques dollars de coût d'API pour un jeu complet. L'éditeur affiche une estimation en jetons + USD avant que vous ne vous engagiez.
• DeepL — rapide et net pour la narration ; le palier gratuit couvre 500 000 caractères/mois.
• Google Translate gratuit — 0 $, convient pour les menus et les courtes lignes, plus faible sur les dialogues.

Constituez le glossaire de votre distribution et de vos termes récurrents en amont pour que chaque scène 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 (concurrence plus faible, lots plus petits, une courte pause entre les lots) — avec une qualité de sortie identique. Les paliers payants s'exécutent à pleine vitesse et ajoutent la mémoire de traduction et le routage de fournisseurs.

Étape 4 : Relire dans l'éditeur

Chaque ligne atterrit dans le tableau à côté de sa source — japonais par défaut, ou la langue que vous avez définie pour le projet (chinois, coréen, anglais, et plus). Modifiez en ligne ce que la machine a mal rendu (enregistrement automatique à la perte de focus ou par Ctrl+Entrée), utilisez rechercher & remplacer pour un terme que vous avez renommé, ou lancez l'affineur IA facultatif pour une relecture de deuxième passe tenant compte du contexte. Comme le dialogue Ren'Py est long, c'est là que le peaufinage se fait.

Étape 5 : Exporter une version jouable

Cliquez sur Exporter. RuneTranslate ne compte pas sur le fait que Ren'Py préfère un .rpy libre dans tl/ — cela ne fonctionne que pour le texte indexé par id de dialogue, que les jeux compilés ne distribuent pas de façon fiable. À la place, il dépose quelques fichiers dans game/ et applique la traduction au moment de l'exécution :

• rt_translations.json — une carte texte source → traduction pour chaque ligne de dialogue et de menu.
• zzz_runetranslate_language.rpy — un petit hook d'exécution qui installe un config.say_menu_text_filter. Il met en correspondance chaque ligne que le jeu s'apprête à afficher avec la carte et y substitue votre traduction, et il force la langue active du jeu vers la langue traduite pour que le texte d'écran et d'interface suive.
• tl/translated/translation.rpy — contient uniquement les chaînes d'interface / d'écran _() (boutons, menus, infobulles), que Ren'Py résout de façon fiable par son propre mécanisme.
• Une police embarquée plus zzz_runetranslate_font.rpy quand la langue cible en a besoin — voir la note sur le non-latin ci-dessous.

Lancez le .exe du jeu et il se joue dans votre langue cible, avec les scripts et archives d'origine intacts. Pour revenir en arrière, supprimez les fichiers ajoutés par RuneTranslate — rt_translations.json, zzz_runetranslate_language.rpy, la police embarquée et son .rpy, et tl/translated/.

Langues non latines

La plupart des jeux Ren'Py livrent une police uniquement latine, si bien que le chinois, le coréen, le japonais, le thaï ou l'arabe s'afficheraient autrement en carrés vides. Quand vous ciblez l'un de ceux-là, RuneTranslate embarque une police adaptée (NanumGothic / Noto Sans) et route chaque police utilisée par le jeu à travers le config.font_replacement_map de Ren'Py, pour que le texte traduit s'affiche correctement sans modifier les propres actifs du jeu.

Limitations connues

• Les archives standard RPA-2 / RPA-3 / RPA-3.2 / RPA-4.0 et les archives couramment obfusquées par un éditeur s'ouvrent automatiquement ; un conteneur véritablement non standard ou une clé détenue à l'extérieur peuvent ne pas se déballer.
• Le texte incrusté dans les images (logos de titre, interface dessinée à la main, légendes de CG) est un travail de pixels et n'est pas traduit — hors du périmètre de la traduction automatique.
• Les écrans fortement scriptés qui construisent des chaînes à l'exécution à partir de variables peuvent nécessiter une rapide passe de correction manuelle dans l'éditeur.

Pourquoi c'est plus facile qu'avant

La route manuelle impliquait de décompiler les .rpyc à la main, d'exécuter rpatool sur l'archive, puis soit de traduire la source en place (et de la recasser à la prochaine mise à jour du jeu) soit d'écrire à la main des blocs tl/ ligne par ligne — tout en luttant encore contre les polices manquantes sur les langues non latines. RuneTranslate fait la chaîne décompiler + déballer + extraire + hook d'exécution en quelques clics, tout en gardant l'éditeur ouvert pour que vous contrôliez la formulation.

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