Langues

Onze langues sont fournies complètes — chaque écran, et pas seulement les boutons — en reprenant les termes utilisés par l’iPhone dans chaque langue respective. Tout texte manquant dans une langue retombe sur l’anglais chaîne par chaîne, de sorte qu’une traduction incomplète affiche ce dont elle dispose au lieu de planter.

Code	Langue	Code	Langue
`en`	English	`pt`	Português (Brasil)
`es`	Español	`pl`	Polski
`fr`	Français	`ru`	Русский
`de`	Deutsch	`tr`	Türkçe
`it`	Italiano	`ar`	العربية — de droite à gauche
		`ja`	日本語

Choisir une langue

-- shared/config.lua
Config.Locale = 'en'

C’est la langue par défaut de la ville. Chaque joueur peut la modifier pour lui-même dans Paramètres → Général → Langue, et son choix est mémorisé avec le reste de ses préférences.

Qui lit quelle langue

Chaque joueur lit la langue qu’il a choisie, sur le téléphone comme en dehors. Le téléphone suit le choix configuré dans les Paramètres, tout comme les messages affichés hors du téléphone — « Pas de signal ici. », « Vos deux mains sont occupées. », ou l’arrivée d’une nouvelle candidature.

Config.Locale définit la langue d’un joueur qui n’en a jamais sélectionné, ainsi que tout message qui ne s’adresse à personne en particulier.

Pour vos propres ressources : LFor(source, text, ...) répond dans la langue de ce joueur, et L(text, ...) dans celle de la ville.

Ce qui s’adapte à la langue au-delà des mots

Les dates et l’horloge. “Samstag, 19. September”, “9月19日土曜日”, le format 24 heures lorsque la langue l’utilise. L’argent reste en $, conformément au système économique de la ville.
L’arabe se lit de droite à gauche. Tout l’écran est inversé en miroir à la manière d’un iPhone configuré en arabe : les listes débutent à droite, la flèche retour pointe vers la droite. Deux éléments restent inchangés dans toutes les langues, comme sur un iPhone — le pavé de numérotation et la calculatrice. Les montants, dates et nombres au sein d’une phrase en arabe conservent leur ordre. Chiffres occidentaux et calendrier grégorien, tels qu’utilisés à Los Santos.
Les pluriels et décomptes. Le polonais, le russe et l’arabe possèdent des déclinaisons de pluriel plus riches que le simple singulier/pluriel ; leurs compteurs s’affichent donc sous la forme “Notatki: 4” — correct quel que soit le nombre.

Où se trouvent les textes

Un dossier, un fichier par langue. Tout y est réuni : les 2 400 chaînes affichées à l’écran et les deux douzaines visibles hors du téléphone — notification de la ville, explication de l’impossibilité d’ouvrir le téléphone en plein saut.

locales/en.lua
locales/es.lua
locales/fr.lua
…

Il s’agit d’un fichier Lua, le serveur et le client le chargent donc directement comme le script qu’il est, sans parsing lourd ni conversion. Le téléphone lit ce même fichier et le découpe, d’où un formatage strict : un seul ["key"] = "value", par ligne, et un commentaire reste un commentaire. Respectez cette structure et les deux environnements accéderont à vos textes.

Une chaîne sert de propre clé :

Locales['es'] = {
    ["Verified account"] = "Cuenta verificada",
    ["The last {n} hours."] = "Las últimas {n} horas.",
}

La clé étant le texte en anglais, une traduction manquante affiche la version anglaise plutôt qu’un blanc ou un code d’erreur. Les accolades entourent des valeurs dynamiques injectées par le téléphone — conservez-les et placez-les là où la syntaxe de votre phrase l’exige plutôt que là où l’anglais les plaçait. Une valeur laissée à "" signifie « afficher la version anglaise » : c’est ainsi que sont renseignés les noms propres qui ne se traduisent jamais (Instapic, Bean Machine, Los Santos).

Le téléphone ne lit que la langue choisie par un joueur lorsqu’il la choisit — onze dictionnaires complets ne sont pas chargés à chaque démarrage pour un appareil qui n’en affiche qu’un.

Modifier un terme

Ouvrez le fichier de la langue, trouvez la ligne, et modifiez la valeur :

["Wallet"] = "Portefeuille",   -- la partie de droite est ce que lit le joueur

Redémarrez la ressource. Rien d’autre ne fait référence à cette chaîne.

Ajouter une langue

Copiez locales/en.lua vers locales/<code>.lua — par exemple nl.lua — et remplacez Locales['en'] par Locales['nl'].
Traduisez les valeurs. Les clés ne changent jamais.
Si le code ne figure pas parmi les onze existants, ajoutez-le à la liste proposée par le sélecteur dans html/core/onboarding.js : const languages=[['en','English','Hello'], … ,['nl','Nederlands','Hallo']]; — le code, le nom dans sa propre langue et la salutation d’accueil.
Config.Locale = 'nl', s’il doit devenir la langue par défaut de la ville.

Le manifest FiveM intègre déjà l’ensemble des fichiers présents dans locales/, il n’y a donc rien à enregistrer en plus. Le sélecteur signale une langue n’ayant pas encore de contenu sous la mention Shown in English for now plutôt que de la masquer.