Godot

AI-перевод для Godot с помощью Lingo.dev CLI

Что такое Godot?

Godot — это open-source игровой движок для создания 2D и 3D игр. В нём есть встроенная поддержка интернационализации через форматы файлов CSV и PO для управления переводами игр.

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

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

О данном гиде

В этом гайде рассказывается, как настроить Lingo.dev CLI в игровом проекте на Godot. Вы узнаете, как настроить файлы переводов, создать pipeline для перевода и интегрировать переводы в свою игру.

Шаг 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.10",
  "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. Запустите pipeline перевода:

    npx lingo.dev@latest run

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

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

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

Шаг 5. Используйте переводы

UI-элементы управления

  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, смотрите: