Godot - Lingo.dev CLI

¿Qué es Godot?

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

¿Qué es Lingo.dev CLI?

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

Acerca de esta guía

Esta guía explica cómo configurar el CLI de Lingo.dev en un proyecto de juego de Godot. Aprenderás a 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 necesario.

Paso 2. Configurar el CLI

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

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

Este archivo define:

los archivos CSV que el CLI de Lingo.dev 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 del CLI:
```
npx lingo.dev@latest login
```
Ejecuta el pipeline de traducción:
```
npx lingo.dev@latest run
```
El CLI actualizará tu archivo CSV con el contenido traducido y creará un archivo i18n.lock para llevar un registro de lo que se ha traducido (para evitar retraducciones innecesarias).

Paso 4. Configurar idiomas en Godot

Navega a Proyecto > Ajustes 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 Botón o una Etiqueta).
Abre el panel Inspector para el nodo.
Establece el atributo Texto con una clave del archivo de traducción (por ejemplo, "WELCOME").
Asegúrate de que la opción Auto Traducir 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 > Ajustes del proyecto.
Habilita Ajustes avanzados.
Navega a Internacionalización > Localización.
En el campo Prueba, introduce una localización (por ejemplo, "es").
Ejecuta el juego.

Limitaciones conocidas

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

Próximos pasos

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