Начать

Карты и моды

Аддоны — карты, моды, плагины и фреймворки, которые ставятся на сервер в один клик. Вы собираете каталог в разделе Карты и моды, клиенты ставят из него на вкладке Карты и моды своего сервера. Панель сама подтягивает зависимости, прописывает аддон в конфиги игры, а при удалении убирает его начисто.

Что нужно заранее

  1. Движок у игры. Откройте игру в разделе Игры и в блоке Карты и моды выберите движок (GoldSrc, Source, Source 2, Minecraft Java, Rust/Oxide, BepInEx и другие) и каталог игры. У игр стартового набора всё уже настроено. Подробности — в Каталоге игр. Сами движки (какие типы контента есть и куда раскладываются файлы) правятся в разделе Движки контента, см. Движки контента. Обычно трогать их не нужно.
  2. Хранилище S3. Файлы аддонов хранятся в хранилище по умолчанию (Модули → Бэкапы и хранилища S3). Без него загрузка в каталог недоступна. Если хотите держать аддоны отдельно от бэкапов, отметьте нужное хранилище как Хранить здесь аддоны. Подробнее — в статье Хранилища S3.

Каталог

На странице Карты и моды выберите игру. Список показывает аддоны, их тип, последнюю версию и зависимости. Добавить аддоны можно несколькими способами.

Свой аддон

Новый аддон:

  • Slug — уникальный в игре идентификатор, например de_dust2 или amxmodx. По нему указывают зависимости.
  • Название, Теги (через запятую: aim, classic), Описание.
  • Требует — slug других аддонов. Они поставятся автоматически.
  • Несовместим с — slug аддонов, которые нельзя ставить вместе с этим.
  • Свои правки конфигов — дополнительные действия после установки, если правил типа не хватает. Нужны редко.

Затем загрузите файл версии (Загрузить версию). Формат зависит от типа: один файл (например, .jar или .smx), архив zip или tar.gz с одной папкой или архив с путями относительно папки игры (maps/de_x.bsp). До 1 ГиБ. Для Minecraft можно указать Версии игры (1.21.1, >=1.20.1 <1.21) и Загрузчики (fabric, paper). Если их не указать, для .jar они читаются из файла.

Из внешних каталогов

Кнопки над списком зависят от движка игры:

  • Найти на Modrinth — моды и плагины Minecraft;
  • Найти на Thunderstore — моды BepInEx (Valheim, V Rising и др.) вместе с зависимостями;
  • Найти на uMod — плагины Oxide для Rust вместе с зависимостями;
  • Найти на Factorio Mod Portal — нужен аккаунт factorio.com, логин и токен вводятся там же; токен хранится зашифрованным;
  • Найти на GameBanana — карты и моды. Автор, лицензия и ссылка сохраняются в описании аддона. Проверьте, что лицензия разрешает ставить файл на серверы ваших клиентов.

Файл скачивается, проверяется и сохраняется в хранилище панели. Если аддон уже есть в каталоге, повторный поиск предложит обновить его до новой версии.

Steam Workshop

Добавить из Workshop — ссылки или ID по одному в строке. Ссылка на коллекцию добавит все её предметы. Файлы при этом не хранятся: панель прописывает ID в конфиг, а скачивает предметы сам игровой сервер (Project Zomboid, CS2, GMod и др.) или установщик на ноде (Arma 3, DayZ — см. ниже).

Импорт пачкой

Импорт пачкой — архив zip или tar.gz до 4 ГиБ с картами, wad-файлами, звуками и спрайтами, разложенными как в папке игры (можно целиком папку cstrike). Каждая карта становится отдельным аддоном с нужными ей ресурсами, а карты, которые уже есть в каталоге, пропускаются. Для карт GoldSrc панель генерирует .res, чтобы игроки скачали ресурсы с сервера.

Наборы

Наборы → Новый набор — несколько аддонов, которые клиент ставит одной кнопкой, например «Классика CS 1.6: AMX Mod X и 20 популярных карт». Зависимости добавлять не нужно. Набор можно выбрать и при создании сервера, в поле Стартовый набор. Удаление набора не трогает то, что уже установлено на серверах.

Вкладка сервера

Вкладка Карты и моды на странице сервера доступна владельцу и тем, кому он дал право Карты и моды:

  • Каталог — поиск по названию, slug или тегу. Установить ставит аддон со всеми зависимостями. Если аддон не подходит серверу (другая версия игры, загрузчик или конфликт), панель предупредит. Поставить его всё равно можно, но сервер может не запуститься.
  • Установлено — что стоит на сервере, версия и статус. Большие пакеты ставятся в фоне, прогресс виден в этом же списке. Отметка Нужен перезапуск означает, что аддон подхватится после перезапуска сервера.
  • Обновить и Обновить все — до последней версии из каталога. Закрепить не даёт «Обновить все» трогать аддон. Файлы, которые вы правили после установки (например, конфиги), при обновлении и удалении остаются на месте.
  • Сверить с сервером — сравнить установленное с тем, что реально лежит на диске, например после правок по SFTP.
  • Наборы — установить набор целиком.
  • Загрузить своё — своя карта или мод. Файл становится приватным аддоном владельца с пометкой моё: его видят и ставят на любые свои серверы только владелец и администраторы. Объём своих загрузок ограничен (по умолчанию 1024 МБ на владельца и 200 МБ на файл, тариф может это изменить). Там же можно добавить предметы Steam Workshop по ссылкам, если тариф разрешает этот источник.

Лимиты — сколько аддонов можно поставить, из каких внешних источников, разрешены ли свои загрузки — задаются в тарифе сервера, см. Тарифы.

Установщики

Некоторые моды нельзя загрузить в каталог заранее: мод Arma весит гигабайты и скачивается из Steam только аккаунтом, у которого есть игра. Для таких модов нода запускает одноразовый контейнер-установщик, и он скачивает файлы прямо на сервер. Установщики перечислены в разделе Установщики.

Встроенный установщик steamcmd-workshop скачивает предметы Steam Workshop через steamcmd. Для модов Arma 3 и DayZ ему нужен аккаунт Steam с купленной игрой:

  1. Заведите отдельный аккаунт Steam (не личный — его пароль будет храниться в панели) и купите на нём Arma 3 и/или DayZ. Одного аккаунта хватает на всю панель: через него качают моды все ноды и все серверы.
  2. Отключите на нём Steam Guard.
  3. Установщики → steamcmd-workshop → Изменить → добавьте переменные STEAM_USER и STEAM_PASSWORD. Пароль хранится зашифрованным и больше не показывается.

Сам сервер Arma 3 или DayZ скачивается без аккаунта, аккаунт нужен только для модов. Подробная инструкция по настройке игры есть на странице Установщики.

Ограничения установщика: один аддон — до 4 ГБ и не больше свободной квоты диска сервера, время работы — до 60 минут (можно поднять до 180), память — 1 ГБ (у steamcmd-workshop — 2 ГБ). Свой установщик можно добавить кнопкой Новый установщик. Контейнер получает доступ в интернет, поэтому указывайте только образы, которым доверяете.

Если аддон не встал

Ошибка видна в списке установленного на вкладке Карты и моды и во вкладке Задачи сервера. Частые причины:

  • у игры не выбран движок — вкладка сервера сообщит «Карты и моды для этой игры не настроены»;
  • аддон не подходит версии игры или загрузчику сервера;
  • закончилась квота диска сервера или лимит тарифа.

Если файлы оказались не в тех папках, у образа игры своя раскладка — поправьте Каталог игры в настройках игры.