Гайд по локализации в нашем репозитории

[ThereDrD0]

Здесь будет краткая инструкция, как правильно работать с локализацией в рамках нашего билда.

Схема локализации

Билд поддерживает русские и английские языки
Мы используем автоматический скрипт и Google Gemini 2.5 Flash для автоматического перевода и локализации игры на русский и английский.

Как это работает:

1. Скрипт проходится по всем прототипам и вытаскивает названия и описания из прототипа.
   1.1 Если у прототипа нет названия или описания, скрипт берет это из его parent`а и автоматически вставляет в локализации.
2. Скрипт сам создает файлы русской и английской локализации, вставляя данные из прототипов.
3. Расположение файлов совпадает с расположением прототипа относительно папки Prototypes.
   3.1 Если локализация уже существует, но лежит в другом месте, скрипт перетаскивает ее в правильное место, удаляя из прошлого.
4. Скрипт проходится автоформатированием по всей локализации, расставляет или удаляет в нужных местах пробелы, табуляцию и прочее.

После работы скрипта в дело вступает ИИ(этот код есть локально только у меня)

1. ИИ проходится по всем измененным локалям и переводит все с одного языка, на другой.
   1.1 Языки настраиваются отдельно через конфиг, если это русская локализация -> с английского на русский. В английском наоборот.

В итоге весь перевод практически автоматизирован. Человеку нужно лишь правильно предоставлять исходные данные, чтобы все работало адекватно.

И так, вы создали прототип...

Теперь вы должны

1. Написать name и description для вашего прототипа на английском языке. Оно должно совпадать с тем, что вы хотите видеть на русском(можно использовать переводчик или ИИ)
   1.1 Если вы хотите, чтобы название или описание совпадало с парентом - не пишите ничего.

Теперь вы можете

1. Самостоятельно написать локализацию в русской локализации. Желательно сразу по правильному пути(смотреть путь до прототипа).

Что делать нельзя?

1. Писать английскую локализацию самостоятельно. Оставьте это дело скрипту. Используйте прототип для английской локализации.
2. Писать русскими буквами в прототипе
3. Не писать в прототипе имя, описание или суффикс, но написать в файлах локализации.