> For the complete documentation index, see [llms.txt](https://docs.bestway.com.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bestway.com.ua/gem-rts-v1-ru/lokalizaciya.md).

# ЛОКАЛИЗАЦИЯ

## Введение в локализацию

Локализация — это процесс адаптации игры для разных регионов и языков, что включает перевод текстов, настройку интерфейса и прочие изменения для обеспечения комфортного восприятия пользователем. В движке Gem RTS локализация выполняется через файлы с расширением `.lng`, которые хранят тексты и настройки для разных языков.

{% hint style="info" %}
Файлы локализации являются SDL файлами.\
Для них справедливы [общие правила синтаксиса для SDL файлов](/gem-rts-v1-ru/bazovaya-informaciya-o-resursakh-v-gem-rts/obshaya-informaciya-o-konfiguracionnykh-failakh.md).
{% endhint %}

## Структура локализационных файлов

Локализационные материалы (тексты и файлы озвучивания текстов) находятся в корневой папке пакета `main` в папках с названиями вида `.<lang>`, где `<lang>` - код языка (например, папка с названием `.ru` содержит русскоязычные материалы локализации).

В папке `main\.ru\interface\text\` находятся следующие файлы и директории

<figure><img src="/files/dSKUIBSeTtNcw2MgQkYH" alt=""><figcaption><p>Содержимое папки локализационных материалов</p></figcaption></figure>

<table><thead><tr><th width="243">Название</th><th>Назначение</th></tr></thead><tbody><tr><td><strong>desc</strong> (папка)</td><td>Содержит файлы с описаниями различных игровых элементов</td></tr><tr><td><strong>info_short</strong> (папка)</td><td>Включает короткие информационные сообщения</td></tr><tr><td><strong>mission</strong> (папка)</td><td>Содержит тексты миссий</td></tr><tr><td><strong>#damage_report.lng</strong></td><td>Файл локализации для отчета о повреждениях</td></tr><tr><td><strong>#hud2+.lng</strong></td><td>Локализация для элементов интерфейса HUD</td></tr><tr><td><strong>#ingame+.lng</strong></td><td>Включает текстовые элементы, отображаемые во время игры</td></tr><tr><td><strong>commander.lng</strong></td><td>Локализация для командиров</td></tr><tr><td><strong>desc.lng</strong></td><td>Описания для различных элементов игры</td></tr><tr><td><strong>difficulty.lng</strong></td><td>Тексты, связанные с уровнями сложности</td></tr><tr><td><strong>info.lng</strong></td><td>Общая информационная локализация</td></tr><tr><td><strong>interactive_hints.lng</strong></td><td>Интерактивные подсказки</td></tr><tr><td><strong>loading_tips.lng</strong></td><td>Советы, отображаемые во время загрузки игры</td></tr><tr><td><strong>mp+.lng</strong></td><td>Локализация для многопользовательских режимов</td></tr><tr><td><strong>options+.lng</strong></td><td>Настройки и опции игры</td></tr><tr><td><strong>side.lng</strong></td><td>Локализация для сторон конфликта</td></tr><tr><td><strong>unit.lng</strong></td><td>Тексты, связанные с юнитами</td></tr></tbody></table>

{% hint style="info" %}
Файлы, в названии которых есть знак `+`, дописываются в порядке очередности подключения пакетов к содержимому одноименных файлов из папки локализации основных ресурсов. Чтобы найти нужные файлы, используйте поиск по названию без знака `+`.
{% endhint %}

{% hint style="warning" %}
Важно соблюдать [структуру папок и файлов](/gem-rts-v1-ru/bazovaya-informaciya-o-resursakh-v-gem-rts/arkhitektura-resursov-igry/struktura-failov-v-paketakh.md), чтобы обеспечить правильную работу локализации в игре. Все локализационные файлы должны быть размещены в соответствующих директориях.
{% endhint %}

***

#### Больше информации

<table data-card-size="large" data-view="cards"><thead><tr><th data-type="content-ref"></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><a href="/pages/AY3k2VmXFqFKCsUQEDXe">/pages/AY3k2VmXFqFKCsUQEDXe</a></td><td>Использование переменных строк в файлах локализации для горячих клавиш и кнопок управления в игре для обеспечения корректной локализации независимо от пользовательских настроек.</td><td><a href="/files/7PiLyqlIStMHdiy0XHd4">/files/7PiLyqlIStMHdiy0XHd4</a></td></tr><tr><td><a href="/pages/uuMsm47an2VyS9QwvmBP">/pages/uuMsm47an2VyS9QwvmBP</a></td><td>Пошаговое руководство по добавлению локализационных текстов для нового языка в игру. Описание процесса добавления шрифтов, файлов конфигурации и локализационных файлов для обеспечения полной поддержки нового языка в игре.</td><td><a href="/files/7PiLyqlIStMHdiy0XHd4">/files/7PiLyqlIStMHdiy0XHd4</a></td></tr></tbody></table>