Godot - Lingo.dev CLI

Was ist Godot?

Godot ist eine Open-Source-Game-Engine zur Erstellung von 2D- und 3D-Spielen. Sie verfügt über integrierte Internationalisierungsunterstützung durch CSV- und PO-Dateiformate zur Verwaltung von Spielübersetzungen.

Was ist Lingo.dev CLI?

Lingo.dev ist eine KI-gestützte Übersetzungsplattform. Die Lingo.dev CLI liest Quelldateien, sendet übersetzbare Inhalte an große Sprachmodelle und schreibt übersetzte Dateien zurück in Ihr Projekt.

Über diesen Leitfaden

Dieser Leitfaden erklärt, wie Sie Lingo.dev CLI in einem Godot-Spielprojekt einrichten. Sie lernen, wie Sie Übersetzungsdateien konfigurieren, eine Übersetzungspipeline einrichten und die Übersetzungen in Ihr Spiel integrieren.

Schritt 1. Übersetzungsdateien einrichten

Erstellen Sie eine CSV-Datei für die übersetzbaren Strings Ihres Spiels (z. B. strings.csv):

keys,en
WELCOME,"Hello, world"

Godot generiert automatisch .translationDateien aus dieser CSV (z. B. strings.en.translation, strings.es.translation).

Hinweis: In Godot ist es üblich, dass Schlüssel in Großbuchstaben geschrieben werden, dies ist jedoch nicht zwingend erforderlich.

Schritt 2. CLI konfigurieren

Erstellen Sie im Stammverzeichnis Ihres Godot-Projekts eine i18n.jsonDatei:

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

Diese Datei definiert:

die CSV-Dateien, die Lingo.dev CLI übersetzen soll
die Sprachen, zwischen denen übersetzt werden soll

In diesem Fall übersetzt die Konfiguration CSV-Dateien von Englisch nach Spanisch.

Schritt 3. Inhalte übersetzen

Registrieren Sie sich für ein Lingo.dev-Konto.
Melden Sie sich über die CLI bei Lingo.dev an:
```
npx lingo.dev@latest login
```
Führen Sie die Übersetzungspipeline aus:
```
npx lingo.dev@latest run
```
Die CLI aktualisiert Ihre CSV-Datei mit dem übersetzten Inhalt und erstellt eine i18n.lockDatei, um nachzuverfolgen, was übersetzt wurde (um unnötige erneute Übersetzungen zu vermeiden).

Schritt 4. Sprachen in Godot konfigurieren

Navigieren Sie zu Projekt > Projekteinstellungen.
Wechseln Sie zum Tab Lokalisierung.
Klicken Sie auf Hinzufügen.
Wählen Sie die automatisch generierten .translationDateien aus.
Klicken Sie auf Öffnen.

Schritt 5. Übersetzungen verwenden

UI-Steuerelemente

Wählen Sie einen Node aus (z. B. einen Button oder ein Label).
Öffnen Sie den Inspektor-Bereich für den Node.
Setzen Sie das Attribut Text auf einen Schlüssel aus einer Übersetzungsdatei (z. B. "WELCOME").
Stellen Sie sicher, dass die Option Auto Translate aktiviert ist. (Sie ist standardmäßig aktiviert.)

GDScript

Verwenden Sie die Funktion tr, um auf Übersetzungen zuzugreifen:

tr("WELCOME")

C#

Verwenden Sie die Funktion Tr, um auf Übersetzungen zuzugreifen:

Tr("WELCOME")

Schritt 6. Übersetzungen testen

Navigieren Sie zu Projekt > Projekteinstellungen.
Aktivieren Sie Erweiterte Einstellungen.
Navigieren Sie zu Internationalisierung > Locale.
Geben Sie im Feld Test ein Locale ein (z. B. "es").
Starten Sie das Spiel.

Bekannte Einschränkungen

Die von Godot unterstützten Locale-Codes stimmen nicht zwangsläufig mit den von Lingo.dev unterstützten Locale-Codes überein. Informationen zu den verfügbaren Locale-Codes finden Sie in der offiziellen Dokumentation.

Nächste Schritte

Weitere Informationen zum Übersetzungssystem von Godot finden Sie unter: