Godot

AI-перевод для Godot с использованием Lingo.dev CLI

Что такое Godot?

Godot — это игровой движок с открытым исходным кодом для создания 2D и 3D игр. Он поддерживает встроенную интернационализацию через форматы файлов CSV и PO для управления переводами игр.

Что такое Lingo.dev CLI?

Lingo.dev — это платформа перевода на основе ИИ. Lingo.dev CLI считывает исходные файлы, отправляет переводимый контент в крупные языковые модели и записывает переведённые файлы обратно в ваш проект.

О данном руководстве

Это руководство объясняет, как настроить Lingo.dev CLI в проекте игры на Godot. Вы узнаете, как настроить файлы перевода, создать конвейер перевода и интегрировать переводы в вашу игру.

Шаг 1. Настройка файлов перевода

Создайте CSV-файл для строк вашего проекта, подлежащих переводу (например, strings.csv):

keys,en
WELCOME,"Hello, world"

Godot автоматически сгенерирует файлы .translation из этого CSV (например, strings.en.translation, strings.es.translation).

Примечание: В Godot принято использовать ключи в верхнем регистре, но это не является строгим требованием.

Шаг 2. Настройка CLI

В корневой папке вашего проекта Godot создайте файл i18n.json:

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

Этот файл определяет:

  • CSV-файлы, которые Lingo.dev CLI должен перевести
  • языки для перевода

В данном случае конфигурация переводит CSV-файлы с английского на испанский.

Шаг 3. Перевод контента

  1. Зарегистрируйтесь в Lingo.dev.

  2. Войдите в Lingo.dev через CLI:

    npx lingo.dev@latest login

  3. Запустите конвейер перевода:

    npx lingo.dev@latest run

    CLI обновит ваш CSV-файл с переведённым контентом и создаст файл i18n.lock для отслеживания переведённого контента (чтобы избежать ненужных повторных переводов).

Шаг 4. Настройка языков в Godot

  1. Перейдите в Project > Project Settings.
  2. Переключитесь на вкладку Localization.
  3. Нажмите Add.
  4. Выберите автоматически сгенерированные файлы .translation.
  5. Нажмите Open.

Шаг 5. Использование переводов

Элементы интерфейса

  1. Выберите узел (например, Button или Label).
  2. Откройте панель Inspector для узла.
  3. Установите атрибут Text в значение ключа из файла перевода (например, "WELCOME").
  4. Убедитесь, что опция Auto Translate включена (по умолчанию она включена).

GDScript

Используйте функцию tr для доступа к переводам:

tr("WELCOME")

C#

Используйте функцию Tr для доступа к переводам:

Tr("WELCOME")

Шаг 6. Тестирование переводов

  1. Перейдите в Project > Project Settings.
  2. Включите Advanced Settings.
  3. Перейдите в Internationalization > Locale.
  4. В поле Test введите локаль (например, "es").
  5. Запустите игру.

Известные ограничения

  • Код локали, поддерживаемый Godot, не гарантированно совпадает с кодами локалей, поддерживаемыми Lingo.dev. Чтобы узнать, какие коды локалей доступны, см. официальную документацию.

Следующие шаги

Чтобы узнать больше о системе перевода в Godot, см.: