Godot - Lingo.dev CLI

Qu'est-ce que Godot ?

Godot est un moteur de jeu open-source pour créer des jeux en 2D et 3D. Il dispose d'un support intégré pour l'internationalisation 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 source, envoie le contenu traduisible aux modèles de langage avancés, et écrit les fichiers traduits dans votre projet.

À propos de ce guide

Ce guide explique comment configurer le CLI Lingo.dev dans un projet de jeu Godot. Vous apprendrez comment 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.8,
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "csv": {
      "include": ["strings.csv"]
    }
  }
}

Ce fichier définit :

les fichiers CSV que le CLI Lingo.dev 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
```
Le 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 des retraductions inutiles).

Étape 4. Configurer les langues dans Godot

Naviguez vers Projet > Paramètres du projet.
Passez à 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 UI

Sélectionnez un nœud (par exemple, un Bouton ou un Label).
Ouvrez le panneau Inspecteur pour le nœud.
Définissez l'attribut Texte avec une clé du fichier de traduction (par exemple, "WELCOME").
Assurez-vous que l'option Traduction automatique 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

Naviguez vers Projet > Paramètres du projet.
Activez Paramètres avancés.
Naviguez vers Internationalisation > Locale.
Dans le champ Test, entrez une locale (par exemple, "fr").
Exécutez le jeu.

Limitations connues

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

Prochaines étapes

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