Barotrauma: топ модов для сервера

MAATRIX GAMES

Ванильный набор подлодок и предметов в Barotrauma рано или поздно надоедает постоянному экипажу — карта одна и та же, стартовые субмарины изучены наизусть, а разнообразия монстров хватает на первые десятки часов. Steam Workshop закрывает это с запасом: тысячи модов, от новых субмарин до полноценных фреймворков на Lua. Проблема в другом — Barotrauma сверяет контент-пакеты между сервером и клиентом почти буквально, и один неудачно выбранный мод способен превратить стабильный сервер в бесконечные "content package mismatch" у половины экипажа. Разберём категории модов, на что смотреть при выборе и как всё это не уронить синхронизацию.

Как Barotrauma вообще работает с модами

Каждый мод из Workshop — это контент-пакет: папка с файлом filelist.xml внутри, который описывает, что пакет содержит (предметы, подлодки, существ, локализацию) и его уникальный идентификатор. Сервер хранит список активных пакетов в contentpackages.xml рядом с serversettings.xml — том же файле, который упоминается в базовой инструкции по установке сервера Barotrauma. При подключении клиент отправляет серверу свой список контент-пакетов, и если версии (точнее, хэши файлов пакета) не совпадают хотя бы по одному активному моду — игрока просто не пустят с ошибкой рассинхрона, даже если по названию мод у обоих один и тот же.

Скачать мод на сервер, где нет графического клиента Steam, можно через SteamCMD, указав ID предмета Workshop (он виден в URL страницы мода):

./steamcmd.sh +login anonymous +workshop_download_item 602960 <WORKSHOP_ID> +quit

Файлы лягут в steamapps/workshop/content/602960/<WORKSHOP_ID>/. Дальше путь к пакету нужно прописать в contentpackages.xml — проще всего запустить сервер один раз после добавления мода и дать ему самому пересчитать хэш пакета, чем вписывать значение руками. Если что-то в этой цепочке пойдёт не так — путь неверный, хэш не совпал, пакет ссылается на отсутствующие файлы — сервер обычно либо не стартует, либо падает при попытке применить список пакетов; разбор именно такого поведения есть в статье про диагностику "Barotrauma не запускается".

Новые подлодки — самая массовая категория

Подлодки — то, с чего обычно начинают моддинг Barotrauma, и Workshop завален ими: от компактных стартовых субмарин до огромных многоэтажных монстров с десятком отсеков и собственной экономикой апгрейдов. Технически это .sub-файл, собранный в редакторе подлодок (Submarine Editor), встроенном в саму игру — при желании можно и свою сборку выложить в Workshop, не только скачивать чужие.

Практический нюанс, который часто упускают: чем крупнее и детальнее подлодка, тем тяжелее серверу разворачивать её состояние при загрузке — особенно в кампании, где подлодка обрастает апгрейдами, ремонтами и историей повреждений за недели игры. Если уже сталкивались с крашем именно на загрузке сохранённой кампании, вероятная причина разобрана отдельно в статье про краш Barotrauma при загрузке кампании — и тяжёлая модовая подлодка там в списке подозреваемых наравне с нехваткой RAM. Второй момент — совместимость с режимом игры: не все подлодки из Workshop одинаково хорошо ведут себя в Campaign (где важна стартовая планировка под квесты найма экипажа и торговлю), некоторые делались в первую очередь под Sandbox.

Новые предметы, оружие и снаряжение

Паки предметов добавляют новое оружие, инструменты, декоративные объекты или целые производственные цепочки на станках. Здесь есть техническая ловушка, о которой редко пишут в описании мода: предметы в Barotrauma различаются по строковому идентификатору (identifier в XML), и два независимых мода теоретически могут случайно использовать одинаковый идентификатор для разных вещей — тогда один пакет молча переопределяет объект другого при загрузке, и итог зависит от порядка пакетов в contentpackages.xml. Если после установки нескольких паков предметов что-то ведёт себя странно — не той текстурой, не тем уроном — в первую очередь стоит проверить именно конфликт идентификаторов, а не списывать на баг конкретного мода.

Часть более сложных предметов — с активным поведением, а не просто статикой XML — требует LuaCsForBarotrauma, community-фреймворк для серверных и клиентских Lua-скриптов. Если такой мод у вас уже есть в списке (например, из статьи про краш при загрузке кампании, где LuaCsForBarotrauma упоминается как источник версионных рассинхронов) — версия загрузчика на сервере и у всех игроков обязана совпадать, иначе получите рассинхрон не на подключении, а прямо в разгар сессии.

Новые монстры и существа

Кастомные монстры — самая требовательная к производительности категория. AI существа в Barotrauma считается сервером даже вне зоны видимости игроков: пути патрулирования, реакция на шум двигателя подлодки, атаки — всё это активная симуляция, а не декорация. Новый монстр с богатым набором поведений (несколько фаз атаки, стайное поведение, реакция на конкретные типы урона) нагружает сервер заметнее, чем косметический предмет или даже новая подлодка.

Практический совет — не ставить сразу пачку модов с монстрами "на пробу". Добавляйте по одному, давайте экипажу пройти с ним несколько рейсов и следите за откликом сервера в характерных точках: массовый бой у станции, встреча в открытой воде на глубине. Если после установки очередного монстра сервер стал заметнее подтормаживать под нагрузкой — это тот самый случай, когда разница между modded- и vanilla-сервером ощущается физически; общий разбор, откуда берётся эта разница и как считать запас железа заранее, есть в статье про производительность modded против vanilla сервера.

QoL-моды: удобство без переворота геймплея

Самая безопасная точка входа в моддинг — плагины на удобство: улучшенная сортировка инвентаря, более понятные подсказки при ремонте и проводке электрики, расширенный чат-лог, быстрые команды для координации экипажа. Здесь важно различать два принципиально разных типа таких модов.

• Чисто клиентские QoL-моды — например, изменение интерфейса или подсказок только на экране игрока — не требуют совпадения с сервером вообще, потому что не добавляют игровых объектов и не входят в список контент-пакетов, которые сверяет сервер. Игрок может поставить их себе один, без остальной команды.
• QoL-моды, которые добавляют предметы или меняют логику (автоматический сортировщик как физический объект на подлодке, новые команды экипажу через Lua) — это уже полноценный контент-пакет, который должен совпадать у всех, иначе снова "content package mismatch".

Перед тем как рекомендовать мод экипажу, стоит явно понимать, к какой из этих двух групп он относится — страница мода в Workshop обычно указывает зависимости в описании, но не всегда прямо пишет "клиентский" или "серверный".

На что смотреть перед установкой и как не сломать сервер

Короткий чек-лист, прежде чем тащить очередной мод на боевой сервер:

• Дата последнего обновления и версия игры. Barotrauma регулярно выходит с патчами, которые меняют внутреннюю структуру XML — заброшенный год назад мод рискует не пережить обновление сервера.
• Зависимости. Если мод требует LuaCsForBarotrauma — убедитесь, что фреймворк стоит и у сервера, и у всех клиентов той же версии.
• Конфликты идентификаторов. При установке нескольких паков предметов или монстров одного жанра проверьте, не переопределяют ли они друг друга — особенно если оба претендуют на один и тот же слот вооружения или тип брони.
• Бэкап сохранения перед изменением списка модов в разгар кампании. Даже безобидный на вид мод способен что-то сломать при десериализации накопленного прогресса — практика восстановления и профилактика подробно разобраны в статье про краш при загрузке кампании.
• Единый источник дистрибуции модов для экипажа. Проще всего собрать Workshop-коллекцию с нужным набором и разослать ссылку игрокам, чем объяснять каждому, что и в каком порядке подписывать — расхождение в наборе пакетов у игроков внутри одного экипажа частая причина жалоб "у меня не грузится, а у друга всё ок".
• Автообновление модов — с осторожностью. Workshop-подписки у игроков могут обновиться сами при следующем запуске Steam, а сервер — нет, и наоборот. Если держите внешние моды дольше пары недель, стоит понимать, что обновляется автоматически, а что только руками; общий разбор этой темы — в статье про автообновление модов на сервере.

Ориентир без точных цифр FPS или тикрейта, которые сильно зависят от конкретной сборки модов и версии игры: если экипаж стал жаловаться на рывки именно после добавления нового монстра или тяжёлой подлодки, а не постепенно со временем — это сигнал разбирать конкретный мод, а не искать проблему в железе.

Частые вопросы