> 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/localization.md).

# Localization

### Introduction to Localization

Localization is the process of adapting a game for different regions and languages, including text translation, interface adjustments, and other changes to ensure a comfortable user experience. In the Gem RTS engine, localization is performed through `.lng` files, which store texts and settings for different languages.

{% hint style="info" %}
Localization files are SDL files, and all [syntax rules for SDL files](/foundational-knowledge/basic-knowledge-about-configuration-files.md) apply to them.
{% endhint %}

## Structure of Localization Files

Localization materials (texts and voice-over files) are located in the root directory of the `main` package in folders named `.<lang>`, where `<lang>` is the language code (for example, the folder named `.en` contains English localization materials).

In the `main\.en\interface\text\` folder, the following files and directories are located

<table><thead><tr><th width="240">File Name</th><th>Purpose</th></tr></thead><tbody><tr><td><strong>desc</strong> (folder)</td><td>Contains files with descriptions of various game elements</td></tr><tr><td><strong>info_short</strong> (folder)</td><td>Includes short informational messages</td></tr><tr><td><strong>mission</strong> (folder)</td><td>Contains mission texts</td></tr><tr><td><strong>#damage_report.lng</strong></td><td>Localization file for damage reports</td></tr><tr><td><strong>#hud2+.lng</strong></td><td>Localization for HUD interface elements</td></tr><tr><td><strong>#ingame+.lng</strong></td><td>Includes text elements displayed during the game</td></tr><tr><td><strong>commander.lng</strong></td><td>Localization for commanders</td></tr><tr><td><strong>desc.lng</strong></td><td>Descriptions for various game elements</td></tr><tr><td><strong>difficulty.lng</strong></td><td>Texts related to difficulty levels</td></tr><tr><td><strong>info.lng</strong></td><td>General informational localization</td></tr><tr><td><strong>interactive_hints.lng</strong></td><td>Interactive hints</td></tr><tr><td><strong>loading_tips.lng</strong></td><td>Tips displayed during game loading</td></tr><tr><td><strong>mp+.lng</strong></td><td>Localization for multiplayer modes</td></tr><tr><td><strong>options+.lng</strong></td><td>Game settings and options</td></tr><tr><td><strong>side.lng</strong></td><td>Localization for factions</td></tr><tr><td><strong>unit.lng</strong></td><td>Texts related to units</td></tr></tbody></table>

{% hint style="info" %}
Files with a `+` in their name are appended in the order of package connection to the contents of similarly named files from the main resource localization folder. To find the required files, search for the name without the `+`
{% endhint %}

{% hint style="warning" %}
It is important to maintain [the structure of folders and file](/foundational-knowledge/game-resource-architecture/package-file-structure.md)s to ensure the proper functioning of localization in the game.\
All localization files must be placed in the appropriate directories and contain correct texts for display in the game.
{% endhint %}

***

#### More about localization

<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="/localization/variable-strings-in-localization.md">Variable strings in localization</a></td><td>Using variable strings in localization files for hotkeys and control buttons in the game to ensure proper localization regardless of user settings</td><td><a href="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FXqe0ZKqSICsAK0XgCyMC%2Fsplash_editor_3.jpg?alt=media&amp;token=ecb5bb0d-d794-4925-a780-f7d98f315d42">default_cover.jpg</a></td></tr><tr><td><a href="/localization/adding-a-new-localization-language.md">Adding a new localization language</a></td><td>Step-by-step guide to adding localization texts for a new language in the game. Describes the process of adding fonts, configuration files, and localization files to ensure full support for the new language in the game.</td><td><a href="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FXqe0ZKqSICsAK0XgCyMC%2Fsplash_editor_3.jpg?alt=media&amp;token=ecb5bb0d-d794-4925-a780-f7d98f315d42">default_cover.jpg</a></td></tr></tbody></table>