Modding Fusion · UNITS / AVIA / LAND/DOM / ANIMAT / EXPLOSIONS
EnglishLangues et noms (desc.lng)
Depuis la version 4.5.6, Fusion se joue en français ou en anglais. Les noms des unités et des bâtiments ne sont plus écrits dans les fiches : chaque fiche donne une clé, et le jeu lit le texte de cette clé dans un fichier de langue. Les archives restent les mêmes pour tous les joueurs : une partie en réseau entre un joueur français et un joueur anglais ne se désynchronise pas.
Les cartes, les missions et les briefings (missiontexts.lng, mis_unitnames) ne sont pas concernés.
Les clés dans les fiches
Une valeur qui commence par $ est une clé. Le jeu la remplace par son texte, sur toutes les lignes de la fiche :
name $N_m4
shortname $S_m4
Name obj 12 $H_Atelier
Fusion nomme ses clés ainsi :
| Clé | Contenu | Exemple |
|---|---|---|
N_<fichier> | nom complet d’une unité | N_m4 |
S_<fichier> | nom court d’une unité | S_m4 |
H_<nom> | nom d’un bâtiment | H_Atelier |
<fichier> est le nom du fichier de la fiche, en minuscules (points, tirets et (t) compris). Un nom écrit en clair (name "Tigre personnalise") fonctionne toujours, mais il ne se traduit pas.
Les fichiers de langue
- Français, la langue de base :
lang2/desc.lng, danslang2.aps. Il contient toutes les clés. - Autre langue :
Run/APRM/i18n/<code>/desc.lng(par exemplei18n/en/), un dossier livré à tous les joueurs. Il ne contient que trois fichiers :desc.lng,game.lng(messages et menus en mission) etmenures.lng. - Le choix de la langue : le lanceur et le menu RUI écrivent deux lignes dans
sudtest.ini:
[Game]
Language=en
[data]
Common=i18n\en\
Le jeu monte le dossier Common avant ses archives : un fichier de i18n\en\ remplace celui de lang2.aps, fichier par fichier. Pour le français, Common= reste vide. Le jeu relit ces lignes à chaque chargement de mission.
Format de desc.lng
N_m4 Ravitailleuse M4 18t
S_m4 M4
H_Atelier Atelier
- Une ligne par clé : la clé, puis un espace ou une tabulation, puis le texte.
- Le fichier est en UTF-8, sans BOM, et les accents s’affichent.
- Une ligne qui commence par un espace ou une tabulation continue le texte de la ligne précédente : à éviter dans
desc.lng. - Si une clé apparaît deux fois, seule la première compte.
- Les guillemets et la ponctuation typographiques (
« » „ “ ’ – €) s’affichent?: utilisez la ponctuation ASCII. Les boutons à police texturée n’ont pas de minuscules.
Ajouter une unité
- Dans la fiche, écrivez
name $N_<fichier>etshortname $S_<fichier>. - Ajoutez les deux clés, en français, dans
lang2/desc.lng. - Ajoutez les deux clés, traduites, dans
i18n/en/desc.lng. - Lancez
python3 tools/i18n_check.pyà la racine de Fusion. Il doit finir sans erreur.
Limites du moteur
| Limite | Valeur | Ce qui se passe au-delà |
|---|---|---|
| Nom complet d’une unité | 63 octets | le texte est coupé |
| Nom court d’une unité | 12 octets | le moteur le coupe, parfois au milieu d’un caractère accentué (2 octets) |
| Nom d’un bâtiment | 31 octets | le texte est coupé |
game.lng + desc.lng d’une langue | 200 Ko conseillés | le tampon commun de 256 Ko n’est pas contrôlé |
| Clés | identifiées par leur CRC-32 | deux clés au même CRC : la seconde est perdue |
Une clé absente de desc.lng ne plante plus le jeu : l’unité affiche sa clé ($N_m4), ce qui indique au moddeur ce qu’il faut ajouter. Un bâtiment dont la clé manque n’a pas de nom.
Dans game.lng, gardez pour chaque clé les mêmes %d, %s, ~KEY_xx~, ~clr V1~ et \n que le français.