> For the complete documentation index, see [llms.txt](https://paradoxmodding-ru.gitbook.io/modding/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paradoxmodding-ru.gitbook.io/modding/osnova/descriptor.md).

# Дескриптор

**Дескриптор, он-же descriptor, имеет формат .mod служит для правильного запуска модификации. В нём содержатся множество параметров запуска.**

Сокращённый пример:

```
name="Hearts of Iron IV: Economic Crisis"
tags={
    "Gameplay"
    "Ideologies"
    "Technologies"
}
replace_path="common"
picture="thumbnail.png"
supported_version="1.10.2"
version="0.7.6 version"
path="mod/Economic_Crisis"
remote_file_id="2000532465"
```

## Правила:

* Модификации должны иметь идентичную файловую структуру что и в оригинальной игре.
* Загружаются все файлы что были найдены
* Все файлы .txt должны использовать UTF-8 без формата спецификации, файлы локализации должны использовать формат UTF-8 BOM.
* Чтобы добавить контент без изменения каких-либо обычных файлов, используйте другое имя файла
* Игра не будет проверять наличие изменений дальше, чем каталог файлов. Если кто-то пытается добавить строку в текстовый файл, необходимо скопировать весь текстовый файл и добавить строку в указанный текстовый файл.
* Изображение должно иметь формат .png и называться thumbnail.
* Дескриптор не может иметь комментарии или проблемы, за исключением аргументов в "".

Вы можеет сгенерировать абсолютно "чистый" вариант дескриптора используя лаунчер игры. Просто перейдите на вкладку `Модификации`, затем нажмите `Инструменты модификаций` и `Создать модификацию`. Обратите внимание, что имена папок и файлов чувствительны к регистру в Mac OS X и Linux.\
&#x20;Создав, вы получаете что-то вроде этого:<br>

```
name="New"
path="mod/New"
tags={
    "Alternative History"
}
picture="thumbnail.png"
supported_version="1.10.2"
```

Есть три основных классов модификаций, которые относятся к структуре файла .mod. Это классы *Минор(Minor)*, *Мажор(Major)*, и *сабмод(SubMod)*, и общая структура этих модов показана ниже. От Вас зависит, следует ли считать мод второстепенным, основным или подмодом.

Если Вы хотите чтобы Ваша модификация была сабмодом, добавьте строку `dependencies`, в таком случае эта модификация загрузится после материнского. Также, вы можете указать несколько модификаций для запуска, например:

```
dependencies={ 
    "Hearts of Iron IV: Economic Crisis"
    "Hearts of Iron: Old World Blues"
    "Hearts of Iron IV | New Ways"
    "Equestria at War"
}
```

И теперь Ваша модификация запустится после выше перечисленных модификаций что гарантирует слаженную работу.

## Аргументы:

| Тип                | Описание                                                                                                                                                                     | Требование              |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| name               | Название модификации                                                                                                                                                         | Обязательно             |
| tags               | Теги модификаций. [Список см. ниже](/modding/osnova/descriptor.md#kategorii-tegi)                                                                                            | Обязательно             |
| replace\_path      | Служит для того чтобы предотвратить загрузку директории из оригинальной игры. Не работает на вложенные директории.                                                           | Опционально             |
| picture            | Всегда должен иметь `thumbnail.png`                                                                                                                                          | Обязательно             |
| supported\_version | Служит для извещения поддерживаемой версии в лаунчере. На поддержку версий игры не влияет.                                                                                   | Обязательно             |
| version            | Кастомное информационное табло. Может содержать любую информацию.                                                                                                            | Опционально             |
| path               | Путь у директории модификации                                                                                                                                                | Обязательно (После 1.8) |
| archive            | Устаревший указатель на архив модификации                                                                                                                                    | Обязательно (До 1.7)    |
| remote\_file\_id   | Айдишник для страницы модификации в стиме.                                                                                                                                   | Опционально             |
| dependencies       | Требование материнской модификации для корректного запуска.                                                                                                                  | Опционально             |
| user\_dir          | Служит для отделения сохранений от основной директории сохранений для предотвращения запуска сохранений от других масштабных модификаций. Не работает но создает директорию. | Опционально             |

**Обратите особое внимание, аргумент** `replace_path` **служит для опытных скриптеров, его нужно использовать лишь с полным пониманием что Вы делаете и зачем. Побочный эффект этого инструмента в том, что вес модификаций резко повышатся связи с переносом файлов из оригинальной игры.**

## Категории/теги

**Указывать нужно лишь оригинальные названия**

| Оригинальные названия | Перевод                |
| --------------------- | ---------------------- |
| Alternative History   | Альтернативная история |
| Balance               | Баланс                 |
| Events                | События                |
| Fixes                 | Правки                 |
| Gameplay              | Геймплей               |
| Graphics              | Графика                |
| Historical            | История                |
| Ideologies            | Идеологии              |
| Map                   | Карта                  |
| Military              | Армия                  |
| National Focuses      | Национальные Фокусы    |
| Sound                 | Звук                   |
| Technologies          | Технологии             |
| Translation           | Перевод                |
| Utilities             | Утилиты                |