unreal · guides · engine · localization

Comment traduire les jeux Unreal Engine

Les jeux Unreal livrent leur texte dans des tables .locres compilées, à l'intérieur de conteneurs .pak ou IoStore. Voici comment les lire, et pourquoi la sortie est un minuscule pak de surcharge plutôt qu'un jeu reconstruit.

9 min de lecture

Un jeu Unreal Engine ressemble à la chose la plus difficile à traduire sur votre disque. Pas de dossier data, pas de fichiers de script, aucun .json à ouvrir — juste un exécutable, un répertoire Content/Paks contenant un ou deux .pak énormes, et peut-être une paire de conteneurs .utoc/.ucas. La bonne nouvelle, c'est que le texte qui vous intéresse n'est en général pas caché dans ces fichiers par conception. Unreal dispose d'un système de localisation de premier plan, et la plupart des jeux publiés l'utilisent. Votre travail consiste à trouver la table, remplacer les chaînes, et remettre au moteur un petit fichier qui prend le pas sur l'original.

C'est cette dernière partie qui rend Unreal agréable une fois comprise. Vous ne reconstruisez pas un jeu de 60 Go. Vous produisez une archive de surcharge qui se mesure en kilo-octets et vous la déposez à côté des originaux.

Une chose avant les étapes : la prise en charge d'Unreal dans RuneTranslate a été confirmée jouable sur de vrais titres UE4 et UE5, mais la surface du format est énorme et chaque studio empaquette différemment. Vérifiez un build exporté en jeu avant de vous engager dans une longue passe de traduction.

Ce qu'un jeu Unreal livre réellement

Unreal garde le texte destiné au joueur dans des fichiers `.locres` — la forme compilée de FTextLocalizationResource. Il y en a un par culture, sur un chemin du type <Game>/Content/Localization/Game/ja/Game.locres, avec des voisins pour en, zh-Hans et ce que le studio a livré d'autre. Un jeu sans aucune traduction en a normalement quand même un, pour la culture dans laquelle il a été écrit.

Un .locres n'est ni un fichier texte ni une simple liste clé/valeur. C'est une table binaire organisée en namespaces, chacun contenant des clés, chaque clé pointant vers une chaîne. Dans les versions modernes, le namespace et la clé sont stockés sous forme de hachages (CRC32 en version 2, CityHash64 sur de l'UTF-16 en version 3) plutôt que sous forme de noms lisibles, et les chaînes elles-mêmes vivent dans une table de recherche partagée et dédupliquée, avec des compteurs de références. Le moteur ne cherche jamais une chaîne par son texte anglais — il la cherche par cette paire namespace/clé, compilée dans les Blueprints et le C++ du jeu au moment du build.

Cette structure dicte la seule façon sûre d'en modifier un. RuneTranslate préserve chaque hachage de namespace, de clé et de chaîne source octet pour octet et ne change que la valeur, puis reconstruit la table de chaînes dédupliquée et ses compteurs de références. Rien ne recalcule un hachage, donc rien ne peut produire une clé que le jeu ne retrouve pas. Les traductions sont libres d'être plus longues ou plus courtes que l'original.

Ces fichiers .locres sont ensuite empaquetés dans des archives .pak — identifiées par la valeur magique 0x5A6F12E1 dans un pied de fichier tout à la fin — ou, sur les titres UE5 modernes, dans des conteneurs IoStore .utoc/.ucas.

Vérifiez le périmètre avant d'y passer une heure

Le .locres couvre l'interface, les menus, les messages système, les textes de tutoriel, les noms d'objets et de compétences, et les sous-titres — disons à peu près 90 % du texte visible d'un jeu type. C'est la partie que RuneTranslate lit en premier.

Ce que le .locres ne couvre pas : le texte compilé dans des DataTables ou incrusté dans des paquets `.uasset` cuits. Certains studios, en particulier sur des projets plus petits ou fortement pilotés par Blueprint, y gardent leurs dialogues au lieu de passer par le système de localisation. RuneTranslate lit cela aussi. Quand un jeu n'a pas de .locres à lui, il déballe les fichiers du jeu et analyse les paquets cuits à la recherche de texte, ce qui prend des minutes plutôt que des secondes sur un gros jeu, et sur les jeux avec des archives .pak en vrac il ajoute aussi les dialogues en ligne que le .locres avait manqués. Le seul trou : un jeu UE5 IoStore qui livre son propre .locres n'obtient que le texte du .locres.

Bon à savoir tôt : le moyen le plus rapide de vérifier est de lancer l'étape de création du projet et de regarder ce qui en sort. Quelques centaines de chaînes courtes qui ressemblent toutes à Continue, Options, Are you sure? veulent dire que l'interface est localisée mais pas le script. Plusieurs milliers de chaînes comprenant des phrases entières veulent dire que vous êtes en bonne posture.

L'IoStore d'UE5 est différent, et l'extraction est ciblée

Les titres UE5 livrent de plus en plus des conteneurs IoStore au lieu de paks simples : un répertoire .utoc associé à un blob de données .ucas, avec la compression Oodle. L'approche naïve ici consiste à tout déballer, ce qui sur un jeu de 105 Go n'est pas une approche du tout.

RuneTranslate embarque retoc (sous licence MIT) et lui demande de convertir les conteneurs en pak legacy filtré aux seuls fichiers de localisation — l'équivalent de to-legacy -f locres --no-shaders --no-script-objects. Un titre IoStore de 105 Go se réduit à quelques kilo-octets de .locres, en quelques secondes plutôt qu'en quelques heures. retoc gère aussi la compression Oodle propre au conteneur, et c'est pourquoi les jeux IoStore contournent le problème Oodle que les paks en vrac peuvent rencontrer.

La moitié importante de tout cela, c'est que l'IoStore ne complique que la lecture. L'écriture est universelle, et c'est la section suivante.

La sortie est un pak de surcharge, pas un jeu reconstruit

C'est la partie qu'aucun guide concurrent n'explique correctement, et c'est la raison pour laquelle traduire de l'Unreal coûte peu dès que cela fonctionne.

Unreal monte les fichiers pak dans un ordre défini, et toute archive dont le nom se termine par `_P` est montée en dernier. Les montages tardifs l'emportent. Une petite archive ne contenant rien d'autre que votre .locres modifié, au même chemin virtuel que celui utilisé par le jeu de base, masque donc tout simplement l'original — le gestionnaire de localisation charge le vôtre et ne voit jamais celui qui a été livré.

  • Aucune re-signature. La surcharge laisse intactes les archives propres au jeu, il n'y a donc rien à re-signer.
  • Un fichier simple et non compressé. La surcharge est écrite sous forme de pak ordinaire non compressé que le moteur lit directement.
  • Aucun ré-empaquetage du jeu. Les archives de base ne sont pas touchées. Une installation de 60 Go reste à 60 Go ; votre traduction est un fichier qui se mesure en kilo-octets.
  • Cela marche aussi pour les jeux IoStore. Le .locres est lu via le système de fichiers pak plutôt que par le chargeur de paquets Zen, si bien qu'un simple _P.pak en vrac est pris en compte même par un jeu UE5 dont tous les assets vivent dans des .utoc/.ucas.

Vous l'installez en copiant le _P.pak produit dans <Game>/Content/Paks/ — le dossier même où se trouvent les originaux. Certains jeux montent aussi un sous-dossier ~mods/, qui fonctionne tout aussi bien. Retirer la traduction revient à supprimer ce seul fichier, ce qui rend le retour en arrière trivial et permet de tester tôt sans risque.

Les étapes

  1. Installez RuneTranslate depuis la page de téléchargement et connectez-vous. Une connexion gratuite (Patreon, Google ou e-mail) est requise au premier lancement ; le palier gratuit débloque chaque moteur et chaque fournisseur sauf RuneLingua — il bride le débit et ne garde qu'un projet à la fois.
  2. Créez un projet et pointez-le vers le dossier racine du jeu — celui qui contient l'exécutable et le répertoire <Game>. La détection cherche Content/Paks et la valeur magique du pied de pak, ou des .utoc/.ucas.
  3. Laissez RuneTranslate ouvrir les archives. La plupart des jeux ne demandent rien de votre part à cette étape.
  4. Laissez l'extraction se terminer. Vous obtenez les entrées .locres de la culture source, regroupées par cible de localisation, prêtes à relire.
  5. Choisissez un fournisseur et traduisez. Les courtes chaînes d'interface et les longs dialogues peuvent être routés vers des fournisseurs différents si vous voulez ne dépenser que là où cela compte.
  6. Relisez ce qui est revenu. Les chaînes de menu sont là où la traduction automatique est la plus faible — un Save ou un Load isolé n'a aucun contexte, et un bouton de deux mots qui revient sous forme de phrase débordera de son widget.
  7. Exportez. RuneTranslate écrit un _P.pak contenant votre texte traduit, au bon chemin relatif au moteur, plus un README. Pour les rares jeux dont le moteur ne charge jamais les paks de patch, il écrit aussi le texte sous forme de .locres en fichier libre, et le README indique où le placer.
  8. Copiez ce fichier dans <Game>/Content/Paks/ et lancez le jeu.

Faites le test de l'étape 8 avec une poignée de chaînes traduites, avant de faire passer tout le jeu chez un fournisseur. Si la surcharge doit être ignorée — mauvais dossier, mauvaise culture, montage inhabituel — vous voulez le découvrir en cinq minutes, pas après avoir payé pour 9 000 chaînes.

Espaces réservés et texte enrichi

Le formatage FText d'Unreal utilise {0}, {1} pour les arguments positionnels et {PlayerName}, {Count} pour les arguments nommés, plus le balisage <RichText> avec ses fermetures </> pour la mise en forme en ligne. Si un fournisseur de traduction en supprime ou en abîme un, le jeu n'affiche pas une phrase légèrement fausse — il affiche une chaîne de format cassée, ou l'argument disparaît silencieusement de la ligne.

RuneTranslate masque chacun d'eux derrière un espace réservé neutre avant que le fournisseur ne voie la chaîne, et les restaure ensuite. Le fournisseur traduit autour des marqueurs plutôt qu'à travers, si bien qu'un argument ne peut pas être supprimé par un modèle qui a décidé que les accolades ressemblaient à une faute de frappe. Si vous voulez aller plus loin et retenir certaines chaînes entièrement hors de la traduction, les filtres d'exclusion regex fonctionnent sur tous les moteurs, et un glossaire garde les noms propres stables dans tout le jeu.

Le piège des accents, qui est un bug d'encodage et non une police

Celui-ci mérite d'être documenté à part, parce que le symptôme pointe exactement dans la mauvaise direction. Unreal sérialise une chaîne avec un préfixe de longueur : une longueur positive signifie un octet par caractère, une longueur négative signifie de l'UTF-16. Le moteur ne choisit la forme étroite que lorsque chaque caractère est de l'ASCII 7 bits — son test rejette tout ce qui dépasse 0x7F. Son chargeur est construit de la même manière, donc si on lui remet une chaîne étroite contenant un octet haut, il substitue un ? littéral à chacun.

La conséquence pratique : une traduction contenant poción mágica écrite sous la forme étroite arrive chez le joueur en poci?n m?gica. Et la plage concernée est U+0080–U+00FF, c'est-à-dire précisément les lettres accentuées de l'espagnol, du français, de l'allemand, du portugais, de l'italien et des langues nordiques. Le polonais, le turc, le tchèque, le grec, le cyrillique, le japonais et le chinois sont tous au-dessus de U+00FF, prennent automatiquement la branche large, et ne sont jamais touchés.

L'empreinte est donc : les accents cassent en espagnol mais le russe va bien. Si vous voyez cela, c'est un bug d'encodage dans ce qui a écrit le fichier, pas un glyphe manquant dans la police du jeu — un glyphe manquant s'affiche en carré ou en rien du tout, jamais en point d'interrogation. RuneTranslate a eu exactement ce bug et l'a corrigé en 0.49.4 ; l'encodeur vit désormais à un seul endroit et écrit la forme large pour tout ce qui sort de l'ASCII. Cela vaut la peine d'être connu, parce que d'autres outils du domaine se trompent encore là-dessus.

Choisir un fournisseur

Cinq des douze fournisseurs ne demandent aucune clé d'API (Google, DeepL gratuit, les modèles Classic / Next-gen de DeepL, Yandex Translate et Gemini Nano, qui tourne sur votre propre PC via Chrome), et le palier gratuit vous les donne tous. Pour un jeu essentiellement fait d'interface, un fournisseur gratuit convient parfaitement. Pour les titres riches en dialogues, un fournisseur LLM gère bien mieux le contexte ; OpenAI, Anthropic, DeepSeek, tout point d'accès compatible OpenAI, et un modèle local via Ollama ou LM Studio sont tous disponibles, et les offres payantes incluent aussi RuneLingua, notre propre traducteur, sans rien à configurer. La comparaison des fournisseurs passe en revue ce que chacun fait bien ou mal, avec de vrais chiffres de coût.

Dépannage

Le jeu se lance mais rien n'est traduit

Presque toujours l'une de trois choses. Le fichier n'est pas dans <Game>/Content/Paks/ — le poser à côté de l'exécutable ne fait rien. Le nom de fichier a perdu son suffixe _P, auquel cas il se monte dans l'ordre alphabétique ordinaire et le pak de base peut l'emporter. Ou le jeu tourne dans une culture que vous n'avez pas traduite : il charge le .locres de la culture qu'il a résolue au démarrage, si bien qu'un jeu forçant en ignorera une surcharge écrite uniquement pour ja. Vérifiez d'abord le réglage de langue du jeu.

L'extraction échoue sur un pak en vrac compressé en Oodle

Un .pak en vrac compressé en Oodle demande un décompresseur qui ne peut pas être embarqué. Si le jeu livre aussi des conteneurs IoStore, la route retoc gère l'Oodle et tout va bien. S'il n'y a que des paks en vrac, c'est un arrêt net pour l'instant, signalé explicitement plutôt que sous forme de résultat vide silencieux.

Le jeu n'a aucun .locres nulle part

Alors son texte est compilé dans des assets cuits, et RuneTranslate le lit à cet endroit : il déballe les fichiers du jeu et analyse les paquets cuits à la recherche de texte, ce qui peut prendre quelques minutes sur un gros jeu. Si cela ne trouve rien non plus, RuneTranslate le dit explicitement au lieu de vous remettre un projet vide.

La détection ne se déclenche pas du tout

Pointez vers le dossier contenant l'exécutable, pas vers Content/Paks lui-même ni vers un dossier parent plein d'autres jeux. Si la détection ne se fait toujours pas, l'empaquetage est inhabituel et vaut la peine d'être signalé — le format pak a des dispositions de pied spécifiques à chaque version, et un dialecte que personne n'a encore vu est exactement le genre de chose qui finit par être ajouté.

Limites honnêtes

La prise en charge d'Unreal a été confirmée jouable en jeu sur des titres UE4 et UE5, via le .locres dans les archives .pak et dans l'IoStore d'UE5, et via le texte lu dans les assets cuits. Un jeu UE5 IoStore qui livre son propre .locres n'obtient que ce texte, pas les dialogues des assets cuits qui l'accompagnent. Les paks en vrac compressés en Oodle sans contrepartie IoStore ne sont pas pris en charge. Les paks à signature imposée ne peuvent pas être surchargés, même s'ils sont rares en pratique. Et comme le format varie énormément d'une version de moteur et d'un studio à l'autre, traitez le premier export comme un test plutôt que comme le livrable.

Ce que vous obtenez au bout est un build traduit jouable que vous gardez sur votre propre machine : le jeu d'origine intact, plus un petit fichier que vous pouvez supprimer pour tout annuler. Si vous comparez les moteurs ou vérifiez si votre jeu est couvert, la page moteur Unreal donne le détail technique et tous les moteurs liste les dix-huit formats pris en charge, dont Unity et RPG Maker. Si vous découvrez tout le processus, commencez par le guide général et revenez ici pour les parties propres à Unreal.

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