> 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/sozdanie-modov-k-igre/dobavlenie-novykh-kart-i-missii-v-igru.md).

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

{% hint style="info" %}
Перед началом работы над модом рекомендуем ознакомиться с [основными принципами создания модов](/gem-rts-v1-ru/sozdanie-modov-k-igre.md#osnovnye-principy) и [архитектурой ресурсов](/gem-rts-v1-ru/bazovaya-informaciya-o-resursakh-v-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="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FGVGVSy4SLIUJgQiMLCLp%2F%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D1%82%D1%8C%20%D0%BF%D0%B0%D0%BA%D0%B5%D1%82.png?alt=media&amp;token=101f3bb9-ff0f-418e-94af-a5ed8cc4c733" alt=""><figcaption><p>Внешний вид вкладки Пакеты в "Настройках игры"</p></figcaption></figure>

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

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FcXyN9InD5tNdQoA0Q0lx%2F%D0%98%D0%BC%D1%8F%20%D0%BF%D0%B0%D0%BA%D0%B5%D1%82%D0%B0.png?alt=media&amp;token=ed88098b-c5dd-4431-9b6f-4cd58c2e52c4" alt=""><figcaption><p>Создание пакета для мода</p></figcaption></figure>

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

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FgDxVaksUUD8vm1NbMilp%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-04-15%20%D0%B2%2016.53.53.png?alt=media&amp;token=94659068-194d-4aa1-a585-eff35e9f7b0c" alt=""><figcaption><p>Иллюстрация подключения пакета в игру</p></figcaption></figure>

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

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

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FPfkhbsmlTzNvVeIQeIvj%2F%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5%20%D0%BF%D0%B0%D0%BA%D0%B5%D1%82%D0%B0.png?alt=media&amp;token=716d7b0a-6cc4-4e19-a335-d23c0952f859" alt=""><figcaption><p>Всплывающее окно со свойствами пакета</p></figcaption></figure>

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

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

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

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

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

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

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

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

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

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FxfQdGogI4QIVNYgVLNno%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-04-15%20%D0%B2%2017.19.42.png?alt=media&amp;token=9e0372b7-0d4a-4a0e-8657-34ff5f293f20" alt=""><figcaption><p>Пример расположения папки пакета для мода и содержимого его корневой папки</p></figcaption></figure>

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

В корне папки мода находится файл .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="/gem-rts-v1-ru/sozdanie-modov-k-igre/sozdanie-balansnogo-moda.md#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>

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

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

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

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

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

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

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

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

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FD262SAYu2UcgXGDGoFJR%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-04-15%20%D0%B2%2017.49.02.png?alt=media&amp;token=90dc98d5-f746-4dad-8ecb-781659a881e5" alt=""><figcaption><p>Иллюстрация перехода на страницу мода в Мастерской Steam</p></figcaption></figure>

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

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

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

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

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

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