Godot - Lingo.dev CLI

Qu'est-ce que Godot ?

Godot est un moteur de jeu open source pour créer des jeux 2D et 3D. Il dispose d'un support d'internationalisation intégré via les formats de fichiers CSV et PO pour gérer les traductions de jeux.

Qu'est-ce que Lingo.dev CLI ?

Lingo.dev est une plateforme de traduction alimentée par l'IA. Le CLI Lingo.dev lit les fichiers sources, envoie le contenu traduisible aux grands modèles de langage et réécrit les fichiers traduits dans votre projet.

À propos de ce guide

Ce guide explique comment configurer Lingo.dev CLI dans un projet de jeu Godot. Vous apprendrez à configurer les fichiers de traduction, à mettre en place un pipeline de traduction et à intégrer les traductions dans votre jeu.

Étape 1. Configurer les fichiers de traduction

Créez un fichier CSV pour les chaînes traduisibles de votre jeu (par exemple, strings.csv) :

keys,en
WELCOME,"Hello, world"

Godot générera automatiquement des fichiers .translation à partir de ce CSV (par exemple, strings.en.translation, strings.es.translation).

Remarque : dans Godot, la convention veut que les clés soient en majuscules, mais ce n'est pas strictement obligatoire.

Étape 2. Configurer le CLI

À la racine de votre projet Godot, créez un fichier i18n.json :

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "csv": {
      "include": ["strings.csv"]
    }
  }
}

Ce fichier définit :

les fichiers CSV que Lingo.dev CLI doit traduire
les langues entre lesquelles traduire

Dans ce cas, la configuration traduit les fichiers CSV de l'anglais vers l'espagnol.

Étape 3. Traduire le contenu

Créez un compte Lingo.dev.
Connectez-vous à Lingo.dev via le CLI :
```
npx lingo.dev@latest login
```
Exécutez le pipeline de traduction :
```
npx lingo.dev@latest run
```
La CLI mettra à jour votre fichier CSV avec le contenu traduit et créera un fichier i18n.lock pour suivre ce qui a été traduit (afin d'éviter les retraductions inutiles).

Étape 4. Configurer les langues dans Godot

Accédez à Projet > Paramètres du projet.
Basculez vers l'onglet Localisation.
Cliquez sur Ajouter.
Sélectionnez les fichiers .translation générés automatiquement.
Cliquez sur Ouvrir.

Étape 5. Utiliser les traductions

Contrôles d'interface utilisateur

Sélectionnez un nœud (par exemple, un Button ou un Label).
Ouvrez le panneau Inspecteur pour le nœud.
Définissez l'attribut Text sur une clé d'un fichier de traduction (par exemple, "WELCOME").
Assurez-vous que l'option Auto Translate est activée. (Elle l'est par défaut.)

GDScript

Utilisez la fonction tr pour accéder aux traductions :

tr("WELCOME")

C#

Utilisez la fonction Tr pour accéder aux traductions :

Tr("WELCOME")

Étape 6. Tester les traductions

Accédez à Projet > Paramètres du projet.
Activez Paramètres avancés.
Accédez à Internationalisation > Locale.
Dans le champ Test, saisissez un code de langue (par exemple, "es").
Lancez le jeu.

Limitations connues

Les codes de langue pris en charge par Godot ne correspondent pas nécessairement aux codes de langue pris en charge par Lingo.dev. Pour connaître les codes de langue disponibles, consultez la documentation officielle.

Prochaines étapes

Pour en savoir plus sur le système de traduction de Godot, consultez :