Comment traduire des scripts FiveM en toute sécurité (Manuel + IA)

Traduisez les valeurs de locale existantes de la ressource tout en préservant les clés, les espaces réservés, les codes de contrôle et la syntaxe des fichiers. L'édition manuelle offre un contrôle maximal ; l'IA peut accélérer un lot révisé. Aucune de ces méthodes ne permet de traduire en toute sécurité toutes les chaînes entre guillemets du code source.

Trouvez le système de locales pris en charge

Lisez la documentation de la ressource et fxmanifest.lua. Recherchez les répertoires de locales, les dictionnaires JSON/Lua, les fichiers de traduction NUI et un paramètre de langue. Utilisez le système fourni par le créateur. N'ajoutez pas lua54 comme correctif de traduction ; cette option de manifeste est obsolète et sans rapport avec la localisation.

Sauvegardez et inventoriez les chaînes visibles

1. Copiez la ressource ou créez une branche de contrôle de version.
2. Enregistrez la version exacte et la langue configurée.
3. Listez les étiquettes visibles par le joueur, les notifications, le texte des menus et les messages d'aide.
4. Excluez les clés, les noms d'événements, les commandes, les colonnes de base de données, les chemins de fichiers et les identifiants, sauf si la documentation les marque explicitement comme traduisibles.
5. Créez un glossaire pour les termes du framework, les métiers, les objets et la terminologie du serveur.

Méthode manuelle : modifier uniquement les valeurs

Dans un éditeur sensible à la syntaxe tel que Notepad++, modifiez la valeur lisible par l'homme sur le côté droit tout en gardant la clé et la structure intactes.

{
  "garage_open": "Open garage",
  "price_label": "Price: %s"
}

Pour une autre langue, traduisez Open garage et Price, mais préservez garage_open, price_label et %s. Conservez les séquences d'échappement, les guillemets, les virgules, les accolades, les codes couleur tels que ~r~, et les jetons de format tels que %s, %d ou {name} à l'identique.

Méthode IA : envoyez un lot restreint contenant uniquement des valeurs

Fournissez uniquement les entrées de locale nécessaires à la traduction, et non l'intégralité de la ressource privée, la configuration du serveur, la clé de licence, le webhook, les données du joueur ou l'exportation de la base de données. Indiquez la langue source et cible, le glossaire et les jetons invariants. Exigez le même format structuré et demandez au modèle de laisser les clés et tous les espaces réservés inchangés.

La sortie de l'IA est un brouillon. Les modèles peuvent renommer une clé, modifier la ponctuation, traduire une commande, supprimer un espace réservé ou renvoyer du JSON/Lua invalide tout en paraissant sûrs d'eux. Examinez le diff entrée par entrée.

Validez avant de démarrer la ressource

• Analysez le JSON avec un analyseur JSON et le Lua avec le flux de travail de lint/test pris en charge par le projet.
• Comparez l'ensemble complet des clés avec la locale source.
• Vérifiez la parité exacte des espaces réservés et des codes de contrôle pour chaque entrée.
• Recherchez les modifications accidentelles apportées aux commandes, aux noms d'événements et aux URL.
• Inspectez le diff à la recherche de commentaires ajoutés ou de délimiteurs de code Markdown.

Testez dans l'interface utilisateur

Démarrez les paramètres régionaux traduits sur la préproduction et parcourez chaque flux visible : menu, notification, erreur, confirmation, validation de saisie et texte d'aide. Vérifiez la troncature du texte, les sauts de ligne, les caractères accentués, les erreurs de pluriel/contexte et le comportement de droite à gauche le cas échéant. Examinez les journaux du navigateur/NUI, de la console F8 et du serveur.

Créez une mémoire de traduction réutilisable

Stockez les paires source/valeur approuvées, les décisions du glossaire et les notes du réviseur en dehors du package du fournisseur. Lorsque la ressource est mise à jour, comparez les nouveaux paramètres régionaux source avec la version précédente et ne traduisez que les clés ajoutées ou modifiées. N'écrasez jamais aveuglément les nouveaux paramètres régionaux du fournisseur par un ancien fichier complet.

Revenir en arrière en toute sécurité

Gardez les paramètres régionaux et la configuration d'origine à disposition. Si l'analyse, l'interface ou le comportement d'exécution régresse, restaurez les fichiers connus comme fonctionnels, redémarrez la ressource et vérifiez que la langue par défaut fonctionne. Corrigez la traduction dans une nouvelle version plutôt que de modifier la production sans diff.