Как работать с TankAir Studio

1. Новый модпак (или «Пример модпака», чтобы посмотреть на готовый проект).
2. Состав модпака — перетащите в окно .mtmod, старые .wotmod, .zip-архивы или папки с модами. Раскладка по mods/<версия>/ и res_mods/<версия>/ определяется сама, картинка и readme из архива становятся превью и описанием. Моды перетаскиваются мышью: меняйте порядок, вкладывайте в группы.
   • группа «Можно несколько» — в установщике галочки;
   • группа «Только один» — кружки, игрок выбирает один вариант (прицелы, маркеры, озвучка);
   • галочка слева от мода — включён ли он по умолчанию.
3. Оформление — цвет, фон баннера, картинка приветствия, иконка, тексты. Справа живой предпросмотр установщика, список в нём можно щёлкать.
4. Сведения — название, версия, автор, для какой версии игры, параметры сборки.
5. Сборка — проверка проекта и кнопка «Собрать установщик». Готовый .exe лежит в output/ проекта.

Раздел «Каталог модов»: готовые моды с превью и описанием добавляются в проект одним кликом (в выбранную группу). Если в каталоге вышла новая версия мода, в меню появляется счётчик, а у мода — кнопка «Обновить». Каждый файл проверяется по контрольной сумме SHA-256; моды только копируются в проект и никогда не запускаются.

Каталог — папка catalog-online/ в репозитории программы (index.json + mods/<id>/):

node scripts/catalog.js add мод.zip --id my_sight --name "Мой прицел" --category crosshair --version 1.0 --preview p.png
node scripts/catalog.js build

После коммита в ветку main моды сразу видны всем. Адрес каталога можно сменить в настройках программы (шестерёнка в заголовке) — например, на свой каталог. Добавляйте только моды, которые разрешено распространять, и не из списка запрещённых Lesta.

В разделе «Сборка»: кнопки «+0.1» / «+1.0» поднимают версию модпака, а в поле «Что нового» пишутся изменения. Игрок увидит их на отдельной странице установщика (последние три версии). Там же — история сборок: все собранные установщики с версией, датой и размером.

По умолчанию собирается собственный установщик (TankAir Installer) — его вид полностью настраивается в разделе «Оформление»: готовые темы, цвета, фон с затемнением и размытием, шрифты, скругления, карточки или список, вкладки или меню, размер окна и тексты. Справа показывается настоящий снимок окна. Установщик собирается встроенным в Windows компилятором C# (.NET Framework 4.8) — ничего ставить не нужно. У игрока он работает без установки дополнительных программ на Windows 10/11.

В «Сборке» можно включить обновления модпака: через GitHub Releases (кнопка «Опубликовать версию», нужен GitHub CLI) или через свой сайт (рядом с установщиком появляется update.json). Установщик и «Управление модпаком» в папке игры покажут игроку кнопку «Обновить».

Во вкладке «Холст» окно установщика собирается как в Figma: пять экранов (приветствие, выбор модов, установка, готово, управление), на каждом — текст, картинки, фигуры, кнопки (переходы, установка, ссылки, запуск игры…) и готовые блоки (список модов, описание, папка игры, прогресс, «Что нового»). Элементы двигаются мышью, меняют размер, выравниваются, у каждого свои цвета, шрифт, тень и условие показа. Кнопка «Проверить в настоящем окне» рисует экран так, как его увидит игрок.

Классический Inno Setup можно выбрать в «Сведениях».

Установщик Inno Setup с баннером модпака, деревом модов, превью, описанием, автором и размером каждого мода. Он сам находит игру и её версию (version.xml), предупреждает, если модпак собран для другой версии, предлагает убрать старые моды (они переносятся в modpack_backup), запоминает выбор при переустановке и удаляется через «Приложения» Windows.

Обычная папка: project.json (описание), mods/ (копии файлов модов), images/ (картинки), output/ (готовые установщики). Её можно копировать, архивировать и открывать на другом компьютере.

Готовый установщик можно выложить в галерею modpacks.tankair.ru: зарегистрируйтесь, нажмите «Добавить модпак», загрузите .exe, обложку и скриншоты. После проверки модератором модпак появится в галерее, а вам придёт уведомление. Отдельные моды выкладываются так же — на mods.tankair.ru.

У каждой версии на сайте свой файл, «Что нового» и контрольная сумма. Новую версию выпускают кнопкой «Новая версия» в личном кабинете.

Сайт сам раздаёт обновления установщику — свой хостинг не нужен:

1. Выложите модпак на modpacks.tankair.ru и дождитесь проверки.
2. Откройте страницу модпака: в панели автора есть адрес вида https://modpacks.tankair.ru/<модпак>/update.json.
3. В студии: «Сборка» → «Обновления» → «Свой сайт» → вставьте этот адрес и соберите установщик.
4. Когда выпустите новую версию на сайте, у игроков в установщике и «Управлении модпаком» появится кнопка «Обновить».

Установщик скачивает только .exe и проверяет его по контрольной сумме SHA-256.

Одобренные моды авторов сайта можно добавлять в модпак так же, как моды из встроенного каталога: «Настройки» (шестерёнка в заголовке) → «Адрес онлайн-каталога» → https://mods.tankair.ru/catalog.json. В нём есть и проверенные моды из каталога студии, и моды сообщества — с превью, описанием и контрольными суммами.