# Mod Development

## Introduction

Creating game modifications is an exciting and multifaceted process that offers developers extensive opportunities for creativity and innovation. Gem RTS provides all the necessary tools and resources to bring the boldest ideas to life, allowing you to add unique elements to the game through mods. In this section, we will cover all aspects of mod development, from the first steps to advanced techniques.

To get started creating mods, you need to find and set up the Editor's working folder and learn how to connect mods to the game.

{% hint style="info" %}
Mods (either Raw or Workshop Item packages) must be placed in  “Working Packages” folder.  Set it in the Game Options.
{% endhint %}

{% hint style="info" %}
The content of the [game folder](https://bestway-1.gitbook.io/documentation/foundational-knowledge/game-local-files-and-player-profile-locations) updates only through the launcher.\
Do not add any files directly to the game folder
{% endhint %}

## Working Packages

"Working Packages" is the editor's working folder that mods, raw packages and the “[Editor local changes](#user-content-fn-1)[^1]” package are stored . \
By default, the editor's working folder is the /packages folder in the game profile.

<table><thead><tr><th width="380">Platform</th><th>Working folder location in the game profile</th></tr></thead><tbody><tr><td>Windows</td><td>Users\[UserName]\AppData\Local\Men of War II\packages\</td></tr><tr><td>Ubuntu</td><td>~/Men of War II/packages/</td></tr></tbody></table>

You can change the location of the editor's working folder if necessary.

### How to change editor's working folder

1. Open the game options
2. Select the "Game" tab
3. Switch "My profile"  to "Selected Folder" inside the "Working Packages" field
4. Enter the path in the "Folder Location" field to the desired folder
5. Click the "Apply" button

<figure><img src="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FX3Z4IzY7ikA8k4b9YNWa%2FGame%20Tab.jpg?alt=media&#x26;token=aecacf17-af60-43ae-b83e-a907583835d5" alt=""><figcaption><p>Game tab in the Options</p></figcaption></figure>

### Package Activation

The content of a package becomes available in the game and in the editor after its activation.&#x20;

The list of all available packages is in the "Packages" tab. \
Activated packages are marked in checkboxes.

<figure><img src="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FB1f2O3RihXgwPMzAbI9Y%2FPackages%20window.jpg?alt=media&#x26;token=a46dc7e7-95e0-4530-ba59-7bbd30bf0ff6" alt=""><figcaption><p>Packages tab in the Options</p></figcaption></figure>

{% hint style="info" %}
The content of the [game folder](https://bestway-1.gitbook.io/documentation/foundational-knowledge/game-local-files-and-player-profile-locations) updates only through the launcher.\
Changing files in the main game folder can lead to conflicts and errors when launching the game.
{% endhint %}

{% hint style="info" %}
The contents of encrypted packets are not available in the editor
{% endhint %}

***

Before starting with mod development, it is essential to study sections:

* &#x20;[Game Resource Architecture](https://bestway-1.gitbook.io/documentation/foundational-knowledge/game-resource-architecture)
* &#x20;[Basic Knowledge about Configuration Files](https://bestway-1.gitbook.io/documentation/foundational-knowledge/basic-knowledge-about-configuration-files)

These sections provide the foundational knowledge required to effectively create mods for the game.

### Learn more about

<table data-card-size="large" data-column-title-hidden data-view="cards"><thead><tr><th data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden align="center"></th><th data-hidden align="center"></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><a href="mod-development/creating-mod">creating-mod</a></td><td></td><td align="center">Добавление новых карт и миссий в игру</td><td align="center"></td><td></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&#x26;token=ecb5bb0d-d794-4925-a780-f7d98f315d42">default_cover.jpg</a></td></tr><tr><td><a href="mod-development/advanced-package-configuration">advanced-package-configuration</a></td><td><a href="mod-development/advanced-package-configuration">advanced-package-configuration</a></td><td align="center">Создание балансного мода</td><td align="center"></td><td></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&#x26;token=ecb5bb0d-d794-4925-a780-f7d98f315d42">default_cover.jpg</a></td></tr></tbody></table>

[^1]: This folder will be automatically created as soon as the editor is launched. All changes in the editor are saved here.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bestway-1.gitbook.io/documentation/mod-development.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
