Дескриптор

Дескриптор, он-же 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. Создав, вы получаете что-то вроде этого:

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	Теги модификаций. Список см. ниже	Обязательно
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	Утилиты