Wiki en construction. De nombreux concepts décrits ici viennent de l'alpha 0.2 et peuvent encore changer. Le wiki sera finalisé pour la version 1.0 — pour l'instant il sert à aider les testeurs fermés puis, plus tard, les joueurs de l'accès anticipé à s'y retrouver. Pour les informations les plus à jour et les plus fiables, rejoignez le Discord — c'est là que les changements sont annoncés en premier et que vous pouvez poser vos questions directement.

Rejoindre le Discord pour les dernières infos

Packs de langue

Traduire le jeu dans une nouvelle langue — le format du fichier, l'Éditeur de langues hors ligne, ce qui retombe en anglais, et les écritures gérées par les polices livrées.

Sur cette page

Le jeu est livré en six langues — anglais, français, espagnol, italien, allemand et portugais — et n’importe quelle autre langue peut être ajoutée sans écrire une seule ligne de code : une traduction, c’est un fichier texte déposé dans le lang/ de votre dossier mods (%APPDATA%\TheUndercut\mods\lang\ sous Windows — voir où vont les fichiers).

mods/
  lang/
    pl.txt      ← tout le pack de langue

Dès que le fichier est là, la langue apparaît dans Paramètres → Langue, avec son drapeau. Le changement est instantané, en carrière comme depuis le menu principal.


L’anglais est la clé

Il n’y a pas d’identifiants de chaînes. La phrase anglaise écrite dans le jeu est la clé de traduction, et un pack fait correspondre les lignes anglaises aux vôtres :

#name: Polski
#flag: pl

>New Career
=Nowa kariera

>Lap {} / {}
=Okrążenie {} / {}
  • > ouvre une clé (la chaîne anglaise), = donne la traduction, # est un commentaire.
  • #name: est le nom affiché dans le sélecteur, #flag: le code pays à deux lettres de son drapeau.
  • Les marqueurs {} et {named} doivent être conservés — le jeu y substitue ses valeurs dans l’ordre.
  • Une entrée tient sur une seule ligne physique. Un texte multiligne (le corps d’un courrier) écrit ses sauts de ligne sous la forme d’un \n littéral.
« New Career » la chaîne dans le jeu votre pack la clé est-elle traduite ? oui non « Nowa kariera » « New Career » retombe en anglais

Un pack à moitié terminé est parfaitement jouable. Tout ce que vous n’avez pas traduit s’affiche en anglais — pas d’état cassé, pas de marqueur de chaîne manquante, et vous pouvez publier un pack à 40 % et le finir plus tard.


L’Éditeur de langues

Menu principal → Outils de modding → Éditeur de langues (ou ouvrez lang-editor/index.html dans le dossier du jeu). Comme l’Éditeur de mods, il tourne hors ligne dans votre navigateur, depuis le fichier lui-même.

  1. Chaque chaîne traduisible est listée : l’anglais à gauche, votre traduction à droite. La traduction française est affichée comme seconde référence — masquez-la avec l’interrupteur si elle vous gêne.
  2. Remplissez l’en-tête : le nom de la langue affiché en jeu, le code du fichier (pl → pl.txt) et le code du drapeau.
  3. Traduisez. L’éditeur passe une ligne en rouge quand ses marqueurs ne correspondent plus à la clé anglaise — c’est la seule erreur qui vaille d’être attrapée, car un marqueur cassé se voit en jeu.
  4. Enregistrer le pack (Ctrl+S) dans mods/lang/. Chrome et Edge réécrivent directement le fichier ; Firefox le télécharge.
  5. Dans le jeu : Paramètres → Langue → votre drapeau.

Non traduits uniquement et le compteur de progression suivent ce qu’il reste à faire. Rouvrir un pack existant reprend là où vous vous étiez arrêté, et les chaînes provenant d’une autre version du jeu sont conservées en fin de fichier plutôt que supprimées.


Traduire sans l’éditeur

La liste de chaînes est un simple fichier texte, ce qui rend la traduction en masse — y compris par une IA — très simple. Travaillez par blocs de 200 à 300 entrées, avec une seule règle :

Remplissez les lignes =, ne touchez jamais aux lignes >.

La clé anglaise est comparée octet par octet à l’exécution. Une clé retapée — un espace en trop, un accent modifié — n’est pas une erreur : c’est une opération silencieusement sans effet, qui laisse cette chaîne en anglais pour toujours. Conservez chaque {marqueur} exactement tel qu’il apparaît.


Ce qu’un pack ne peut pas faire

  • Il ne peut pas masquer une langue intégrée. Les six langues embarquées l’emportent toujours ; un pack doit apporter un nouveau code.
  • Il ne traduit pas les noms propres. Pilotes, écuries, sponsors et circuits sont du contenu généré et restent tels quels.
  • La voix off du tutoriel reste en anglais. Seul son texte à l’écran est traduit.
  • Les courriers gardent la langue dans laquelle ils sont arrivés. Un courrier est traduit au moment où il est écrit puis stocké ainsi ; changer de langue en cours de carrière laisse donc les anciens courriers tels quels.

Écritures et polices

Les polices d’affichage du jeu couvrent le latin et, via un repli automatique, le latin étendu et le cyrillique : quand une langue chargée utilise des lettres absentes de la police choisie, le jeu remplace cette police par une qui les couvre, et remet l’originale lorsque vous en changez. Les packs polonais, tchèque, turc, russe ou ukrainien s’affichent donc correctement sans travail supplémentaire.

Le chinois, le japonais et le coréen ne sont pas encore pris en charge — ils exigent une police que le jeu ne livre pas. Un pack CJK se chargera, mais les glyphes ne se dessineront pas.


Partager

Envoyez le fichier .txt et il se dépose dans le mods/lang/ de quelqu’un d’autre. Pour le publier en objet à abonnement, voir le guide du Workshop : un pack de langue se place soit à la racine de l’objet (sous la forme <code>.txt), soit dans un dossier lang/ à l’intérieur. Votre propre fichier l’emporte toujours sur un abonnement portant le même code — c’est ainsi que vous testez une modification sans vous désabonner.