# Создание мода

{% hint style="info" %}
Перед началом работы над модом рекомендуем ознакомиться с [основными принципами создания модов](/documentation/gem-rts-v1-ru/sozdanie-modov-k-igre.md#osnovnye-principy) и [архитектурой ресурсов](/documentation/gem-rts-v1-ru/bazovaya-informaciya-o-gem-rts/arkhitektura-resursov-igry.md) в Men of War II
{% endhint %}

Созданные и модифицированные в редакторе ресурсы игры при сохранении автоматически попадают в папку “Editor local changes”, которая находится в папке редактора "[Рабочие пакеты](#user-content-fn-1)[^1]"

**Порядок действий для подключения новых и модифицированных ресурсов в игру**

1. Создать пакет для мода и подключить его к игре
2. Перенести новые и модифицированные ресурсы из “Editor local changes” в пакет мода
3. Настроить пакет
4. Протестировать мод 
5. Опубликовать в Мастерской

## Создание пакета для мода 

1. В игре открыть НАСТРОЙКИ и перейти на вкладку ПАКЕТЫ

<figure><img src="/files/5SHS1GHVqbfYHcUyRpzV" alt=""><figcaption><p>Внешний вид вкладки Пакеты в "Настройках игры"</p></figcaption></figure>

2. Нажать кнопку “Создать” (кнопка находится под списком пакетов)\
   В открывшемся окне задать имя пакета и нажать кнопку Ок - имя пакета появится в общем списке

<figure><img src="/files/J1gFIIiu37RpbcrkixSP" alt=""><figcaption><p>Создание пакета для мода</p></figcaption></figure>

3. Подключить пакет мода к игре и редактору.  \
   Для этого выставить флаг в чекбоксе напротив имени созданного пакета и нажать кнопку “Применить”

<figure><img src="/files/6QcsH1oiI96oRHeIP2Wd" alt=""><figcaption><p>Иллюстрация  подключения пакета в игру</p></figcaption></figure>

{% hint style="info" %}
Наведение курсора на пакет выводит всплывающее окно с основной информацией о пакете:

* тип пакета
* id
* путь к папке пакета
* дата создания и автор
  {% endhint %}

<figure><img src="/files/D7bfG12VVeHno5LqBIH2" alt=""><figcaption><p>Всплывающее окно со свойствами пакета</p></figcaption></figure>

На этом шаге пакет для мода создан и подключен. \
Ресурсы пакета доступны для загрузки в игре и в редакторе.

## Перенос новых и модифицированных ресурсов в пакет мода&#x20;

1. Открыть в проводнике папку "Рабочие пакеты" и найти в ней папку созданного сырого пакета
2. Перенести ресурсы из папки "Editor local changes" в папку созданного пакета, сохраняя структуру размещения файлов

{% hint style="info" %}
После перемещения ресурсов мода в пакет, редактор будет автоматически сохранять изменения ресурсов мода в его пакете.&#x20;
{% endhint %}

{% hint style="info" %}
В папке "Editor local changes" сохраняются только новые ресурсы и измененные редактором оригинальные ресурсы игры. \
При необходимости переносите ресурсы из пакета "Editor local changes" в пакет мода, сохраняя структуру размещения файлов.
{% endhint %}

На этом этапе новые и модифицированные ресурсы находятся в пакете мода. \
Следующим шагом необходимо настроить пакет.

## Настройка пакета мода

### Изображение превью мода

В корне папки разместить изображение обложки мода - файл с именем preview, сохраненный в формате jpg и размером 512х512

<figure><img src="/files/2hOpVe5rHsvyEM1isdXr" alt=""><figcaption><p>Пример расположения папки пакета для мода и содержимого его корневой папки</p></figcaption></figure>

### Настройка свойств пакета&#x20;

В корне папки мода находится файл .info, в котором необходимо настроить параметры пакета с модом.

<table><thead><tr><th width="214">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><strong>id</strong></td><td>Уникальный идентификатор пакета, который генерится автоматически при нажатии на кнопку “Создать” на вкладке "Пакеты" в "Настройках игры"</td></tr><tr><td><strong>legacy_id</strong></td><td>После публикации сырого пакета в Мастерской Steam параметр id заменяется на параметр legacy_id, при этом Пакет меняет свой вид с Сырого на Workshop Item</td></tr><tr><td><strong>name</strong></td><td>Имя пакета</td></tr><tr><td><strong>author</strong></td><td>Автор пакета</td></tr><tr><td><strong>order</strong></td><td>Порядок в списке пакетов. <br>По умолчанию равен 0 и отображается самым верхним в списке пакетов</td></tr><tr><td><strong>default_disabled</strong></td><td>Пакет по умолчанию будет отключен, пока игрок не применит его в "Настройках игры".<br>Для всех модов рекомендовано ставить этот параметр.</td></tr><tr><td><strong>dependency</strong></td><td>Задает зависимость от уже существующих пакетов. <br>Чтобы мод использовал в качестве исходных ресурсы и параметры оригинальной игры, необходимо прописать зависимость от пакета оригинальной игры, указав его id в блоке dependency.<br>Блок можно использовать многократно для <a href="/pages/SFMeLvLnf4jlmFDAbVWd#nastroika-zavisimostei-ot-drugikh-paketov">задания очередности подключения пакетов</a> для корректной работы мода. </td></tr></tbody></table>

<details>

<summary>Пример содержимого файла .info</summary>

```
{id "cc507d63-2143-4598-99de-237a5ea5e621"}
{name "Пример Пакета"}
{order 1}
{dependency "02f8e8f9-91d9-45e0-8ee6-dc56adae4763"}; main package
{default_disabled}
{author "Created by username, at Mon Apr 15 16:39:49 2024"}
```

</details>

## Тестирование мода&#x20;

1. Запустить игру
2. Открыть в настройках игры вкладку ПАКЕТЫ и убедиться, что пакет мода подключен
3. Выйти из настроек игры в "Главное меню"
4. Создать сессию на карте из мода и протестировать карту и миссию
5. Устранить найденные ошибки

Закончив процесс настройки и тестирования мода можно переходить к его публикации в Мастерской Steam

## Мастерская Steam

### Публикация мода&#x20;

1. Запустить игру и перейти на вкладку Пакеты в "Настройках игры"&#x20;
2. Выбрать название своего пакета в списке и нажать “Опубликовать” - мод будет добавлен в WorkShop в режиме “невидимый”. &#x20;

{% hint style="info" %}
Ссылку на страницу мода можно найти в окне описания мода, которое появляется под курсором при наведении на поле с названием мода в списке пакетов.
{% endhint %}

3. Перейти на страницу мода, для этого выбрать в списке пакетов его название и нажать кнопку “Мастерская”

<figure><img src="/files/709lvjkwMn8nrXMK4tws" alt=""><figcaption><p>Иллюстрация перехода на страницу мода в Мастерской Steam</p></figcaption></figure>

4. Настроить внешний вид страницы мода с помощью инструментов Мастерской

### Обновление мода&#x20;

По окончании работы над обновлением мода, необходимо опубликовать обновление в Мастерской

1. Запустить игру и перейти на вкладку Пакеты в "Настройки игры"
2. Выбрать в списке название пакета, для которого нужно опубликовать обновления, и нажать кнопку “Обновить” - обновления пакета будут опубликованы в Мастерской

{% hint style="info" %}
Дополнить мод новыми файлами можно в любой момент времени, работая с папкой мода, расположенной в папке "[Рабочие пакеты](/documentation/gem-rts-v1-ru/sozdanie-modov-k-igre.md#pakety-dlya-modifikacii)"
{% endhint %}

[^1]: "Рабочие пакеты" - рабочая папка редактора, в которой хранятся моды, сырые пакеты и пакет "Editor local changes" для временного размещения ресурсов, созданных в редакторе игры. По умолчанию это папка packages в папке с профилем игры\
    [Подробнее](/documentation/gem-rts-v1-ru/sozdanie-modov-k-igre.md#rabochie-pakety)


---

# 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/gem-rts-v1-ru/sozdanie-modov-k-igre/dobavlenie-novykh-kart-i-missii-v-igru.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.