Godot - Lingo.dev CLI

¿Qué es Godot?

Godot es un motor de juegos de código abierto para crear juegos 2D y 3D. Tiene soporte de internacionalización integrado a través de formatos de archivo CSV y PO para gestionar las traducciones del juego.

¿Qué es Lingo.dev CLI?

Lingo.dev es una plataforma de traducción impulsada por IA. La CLI de Lingo.dev lee archivos fuente, envía contenido traducible a modelos de lenguaje grandes y escribe los archivos traducidos de vuelta a tu proyecto.

Acerca de esta guía

Esta guía explica cómo configurar Lingo.dev CLI en un proyecto de juego de Godot. Aprenderás cómo configurar archivos de traducción, establecer un pipeline de traducción e integrar las traducciones en tu juego.

Paso 1. Configurar archivos de traducción

Crea un archivo CSV para las cadenas traducibles de tu juego (por ejemplo, strings.csv):

keys,en
WELCOME,"Hello, world"

Godot generará automáticamente archivos .translation a partir de este CSV (por ejemplo, strings.en.translation, strings.es.translation).

Nota: En Godot, es convención que las claves estén en mayúsculas, pero esto no es estrictamente obligatorio.

Paso 2. Configurar la CLI

En la raíz de tu proyecto de Godot, crea un archivo i18n.json:

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

Este archivo define:

los archivos CSV que Lingo.dev CLI debe traducir
los idiomas entre los que traducir

En este caso, la configuración traduce archivos CSV del inglés al español.

Paso 3. Traducir el contenido

Regístrate para obtener una cuenta de Lingo.dev.
Inicia sesión en Lingo.dev a través de la CLI:
```
npx lingo.dev@latest login
```
Ejecuta el pipeline de traducción:
```
npx lingo.dev@latest run
```
La CLI actualizará tu archivo CSV con el contenido traducido y creará un archivo i18n.lock para realizar un seguimiento de lo que se ha traducido (para evitar retraducciones innecesarias).

Paso 4. Configurar idiomas en Godot

Navega a Proyecto > Configuración del proyecto.
Cambia a la pestaña Localización.
Haz clic en Añadir.
Selecciona los archivos .translation generados automáticamente.
Haz clic en Abrir.

Paso 5. Usar las traducciones

Controles de UI

Selecciona un nodo (por ejemplo, un Button o un Label).
Abre el panel Inspector para el nodo.
Establece el atributo Text a una clave del archivo de traducción (por ejemplo, "WELCOME").
Asegúrate de que la opción Auto Translate esté habilitada. (Lo está por defecto.)

GDScript

Usa la función tr para acceder a las traducciones:

tr("WELCOME")

C#

Usa la función Tr para acceder a las traducciones:

Tr("WELCOME")

Paso 6. Probar las traducciones

Navega a Proyecto > Configuración del proyecto.
Habilita Configuración avanzada.
Navega a Internacionalización > Configuración regional.
En el campo Test, introduce una configuración regional (por ejemplo, "es").
Ejecuta el juego.

Limitaciones conocidas

Los códigos de configuración regional que soporta Godot no están garantizados para coincidir con los códigos de configuración regional que soporta Lingo.dev. Para conocer qué códigos de configuración regional están disponibles, consulta la documentación oficial.

Próximos pasos

Para obtener más información sobre el sistema de traducción de Godot, consulta: