Alliance Francophone Sudden Strike

Modding Fusion · UNITS / AVIA / LAND/DOM / ANIMAT / EXPLOSIONS

English

Langues 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éContenuExemple
N_<fichier>nom complet d’une unitéN_m4
S_<fichier>nom court d’une unitéS_m4
H_<nom>nom d’un bâtimentH_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, dans lang2.aps. Il contient toutes les clés.
  • Autre langue : Run/APRM/i18n/<code>/desc.lng (par exemple i18n/en/), un dossier livré à tous les joueurs. Il ne contient que trois fichiers : desc.lng, game.lng (messages et menus en mission) et menures.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é

  1. Dans la fiche, écrivez name $N_<fichier> et shortname $S_<fichier>.
  2. Ajoutez les deux clés, en français, dans lang2/desc.lng.
  3. Ajoutez les deux clés, traduites, dans i18n/en/desc.lng.
  4. Lancez python3 tools/i18n_check.py à la racine de Fusion. Il doit finir sans erreur.

Limites du moteur

LimiteValeurCe qui se passe au-delà
Nom complet d’une unité63 octetsle texte est coupé
Nom court d’une unité12 octetsle moteur le coupe, parfois au milieu d’un caractère accentué (2 octets)
Nom d’un bâtiment31 octetsle texte est coupé
game.lng + desc.lng d’une langue200 Ko conseillésle tampon commun de 256 Ko n’est pas contrôlé
Clésidentifiées par leur CRC-32deux 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.