# Дескриптор

**Дескриптор, он-же 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               | Теги модификаций. [Список см. ниже](#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             | Утилиты                |


---

# 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://paradoxmodding-ru.gitbook.io/modding/osnova/descriptor.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.