> 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="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FSPpwpMZbJ0DbvCNdC63E%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-07-24%20%D0%B2%2018.43.47.png?alt=media&amp;token=3baabb1a-e2f2-4adc-9daf-5037d03113ec" 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="/gem-rts-v1-ru/lokalizaciya/peremennye-stroki-v-lokalizacii.md">Переменные строки в локализации</a></td><td>Использование переменных строк в файлах локализации для горячих клавиш и кнопок управления в игре для обеспечения корректной локализации независимо от пользовательских настроек.</td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FrCk1dAvSKKe04Fp9WkP4%2Fsplash_editor_3.jpg?alt=media&amp;token=a89d5e03-56d3-401d-b04b-8da366458bd9">cover picture default</a></td></tr><tr><td><a href="/gem-rts-v1-ru/lokalizaciya/dobavlenie-novogo-yazyka.md">Добавление нового языка</a></td><td>Пошаговое руководство по добавлению локализационных текстов для нового языка в игру. Описание процесса добавления шрифтов, файлов конфигурации и локализационных файлов для обеспечения полной поддержки нового языка в игре.</td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FrCk1dAvSKKe04Fp9WkP4%2Fsplash_editor_3.jpg?alt=media&amp;token=a89d5e03-56d3-401d-b04b-8da366458bd9">cover picture default</a></td></tr></tbody></table>