Pterohost docs

V Rising: установка модов на сервер (BepInEx)

Как установить BepInEx и моды на сервер V Rising: пошаговая настройка, популярные серверные моды, синхронизация с клиентом, обновление и бэкап.

Кратко: Для модов на сервере V Rising нужен BepInEx 6.x (IL2CPP-ветка). Устанавливается один раз: распаковать архив в корень сервера, скопировать нужные DLL в BepInEx/plugins/ и запустить сервер. Серверные моды работают без изменений у игроков.

V Rising: установка модов на сервер (BepInEx)

Система модов V Rising построена на фреймворке BepInEx и библиотеке VampireCommandFramework. К 2026 году экосистема модов для V Rising насчитывает несколько сотен плагинов на Thunderstore: от расширенных команд администратора и телепортации до кастомных ивентов и балансировочных твиков. Установить BepInEx на сервер несложно - вся операция занимает 10-15 минут. Важно понять разницу между серверными модами (server-side only) и клиент-серверными, иначе игроки не смогут подключиться после модификации.

Pterohost - игровой хостинг с NVMe SSD, DDoS-защитой и поддержкой 24/7. Сервер V Rising разворачивается автоматически, BepInEx можно поставить через файловый менеджер панели. Промокод 4START даёт -20% на первый заказ. Заказать сервер V Rising

Как устроены моды в V Rising

V Rising использует движок Unity с IL2CPP-компиляцией. Это означает, что стандартный BepInEx 5.x для Mono не подходит - нужна специальная IL2CPP-ветка BepInEx 6.x (также называемая “Bleeding Edge” или BE-билд).

Цепочка загрузки выглядит так:

  1. VRisingServer.exe запускается и загружает winhttp.dll (прокси BepInEx).
  2. BepInEx инициализирует IL2CPP-хуки и загружает ядро фреймворка.
  3. Из папки BepInEx/plugins/ загружаются все найденные DLL-файлы плагинов.
  4. Плагины регистрируют хуки в игровых системах и активируются.

Типы модов по области действия:

ТипТребование у игрокаПримеры
Server-side onlyНичего дополнительноAdminCommands, CustomBans, ServerStats
Client+ServerBepInEx + тот же модКосметика, UI-изменения, новые предметы
Client-onlyТолько у игрокаHUD-моды, клиентские твики

Большинство популярных серверных модов относятся к категории server-side - игроки подключаются как обычно, без каких-либо изменений у себя.

Подготовка: что нужно перед установкой

Перед установкой BepInEx убедитесь, что:

  • Сервер V Rising установлен и хотя бы один раз запускался (app ID 1829350 через SteamCMD).
  • У вас есть доступ к файловой системе сервера - через SSH, файловый менеджер панели или RDP.
  • Сервер в данный момент остановлен.
  • Сделан бэкап папки Saves (критично, делайте до любых модификаций).

Папка сервера по умолчанию после SteamCMD-установки:

C:\vrising-server\           (Windows)
/home/vrising/server/        (Linux)

Далее все пути указаны относительно корневой папки сервера.

Установка BepInEx 6.x

Загрузка правильной версии

Идём на официальный GitHub BepInEx: github.com/BepInEx/BepInEx/releases. Нужен архив для IL2CPP и вашей платформы:

  • Для Windows: BepInEx_win_x64_6.0.0-be.XXX.zip (или актуальная BE-версия).
  • Для Linux: BepInEx_linux_x64_6.0.0-be.XXX.zip.

Обратите внимание: имя файла обязательно должно содержать x64, а не x86. V Rising - 64-битное приложение.

Дополнительно потребуется пакет BepInEx.Unity.IL2CPP - он может идти в комплекте с BE-архивом или скачиваться отдельно как NuGet-пакет. Проверьте README на странице релиза.

Распаковка в папку сервера

Содержимое архива распаковывается прямо в корень сервера поверх существующих файлов:

vrising-server/
  BepInEx/
    core/           <- ядро фреймворка
    plugins/        <- сюда кладём моды
    config/         <- конфиги модов
    patchers/       <- патчеры (редко нужны вручную)
  doorstop_config.ini
  winhttp.dll       <- именно этот файл запускает BepInEx
  VRisingServer.exe
  VRisingServer_Data/

Файл winhttp.dll - прокси-библиотека, которая перехватывает загрузку движка и инициализирует BepInEx. Без него фреймворк не запустится.

Проверка установки

Запустите сервер и подождите 30-60 секунд. Если BepInEx установлен правильно, появится файл BepInEx/LogOutput.log. Откройте его и найдите строки вида:

[Message:   BepInEx] BepInEx 6.0.0.XXX - V Rising (...)
[Message:   BepInEx] Running under Unity IL2CPP
[Info   :   BepInEx] 0 plugins loaded.

Цифра 0 plugins loaded - нормально, моды ещё не добавлены. Главное - строка Running under Unity IL2CPP. Если её нет, значит загрузился не тот BepInEx (Mono-версия) или winhttp.dll лежит не в корне сервера.

Linux-специфика

На Linux-хостинге V Rising запускается через Wine или специальный контейнер. BepInEx для Wine требует дополнительной настройки:

В файле doorstop_config.ini убедитесь, что:

[UnityDoorstop]
enabled=true
targetAssembly=BepInEx/core/BepInEx.Unity.IL2CPP.dll

При запуске через Wine переменные среды нужно передать явно:

WINEDLLOVERRIDES="winhttp=n,b" wine VRisingServer.exe \
  -persistentDataPath /home/vrising/data \
  -serverName "My Server" \
  -saveName world1

Без WINEDLLOVERRIDES Wine проигнорирует winhttp.dll и BepInEx не запустится.

Установка VampireCommandFramework

Большинство серверных модов для V Rising зависят от библиотеки VampireCommandFramework (VCF) - она предоставляет API для команд в чате и обработки событий сервера. Это не опциональная зависимость - без неё моды просто не загрузятся.

Загружаем VCF с Thunderstore (thunderstore.io/c/v-rising/p/deca/VampireCommandFramework/) и копируем DLL в BepInEx/plugins/:

BepInEx/plugins/
  VampireCommandFramework.dll

Также нередко требуется библиотека Bloodstone - фреймворк для патчинга игровых систем. Проверяйте dependencies на странице каждого мода перед установкой.

Популярные серверные моды V Rising

Ниже - актуальные на 2026 год моды, которые устанавливаются исключительно на стороне сервера:

AdminCommands

Расширенные команды для администраторов сервера. Добавляет:

  • !kit <name> - выдать набор предметов игроку.
  • !teleport <player> - телепортировать игрока.
  • !ban / !unban / !kick - управление игроками через чат.
  • !announce <message> - объявление для всех.
  • !time set <hour> - изменить время суток.

Скачать: thunderstore.io/c/v-rising/p/Odjit/KindredCommands/

KindredCommands

Пакет утилит для управления кланами, постройками и игровыми событиями. Особенно полезен для RP-серверов:

  • Настройка зон запрета PvP.
  • Кастомные ограничения на постройки.
  • Управление репутацией кланов.

VampireJournals

Логирование активности сервера: кто убил кого, кто вошёл или вышел, кто захватил замок. Логи пишутся в текстовый файл рядом с плагином. Полезно для разрешения споров на PvP-серверах.

ServerStatsViewer

Показывает статистику сервера в реальном времени через веб-интерфейс на отдельном порту. Uptime, онлайн игроков, тиклейт, потребление памяти. Не требует изменений у клиентов.

BloodyMerchant

Добавляет кастомных торговцев с настраиваемым инвентарём. Конфигурируется через JSON-файл в BepInEx/config/. Популярен на PvE-серверах с нестандартной экономикой.

Пример конфига BepInEx/config/BloodyMerchant.cfg:

[Merchant.1]
Name = Shadow Trader
SpawnLocation = 3200, 50, -600
RefreshIntervalHours = 24

[Item.1]
PrefabGUID = 1234567890
Price = 100
Currency = BloodEssence
Stock = 5

AutoAnnounce

Периодически рассылает сообщения в чат сервера: правила, напоминания о вайпе, расписание осад. Настраивается через INI:

[AutoAnnounce]
Interval = 1800
Message1 = Осада замков: пятница-воскресенье 19:00-23:00 МСК
Message2 = Вайп каждые 4 недели. Следующий: 15.07

Синхронизация с клиентом

Чисто серверные моды (server-side)

Большинство вышеперечисленных модов не требуют ничего от игроков. Игрок запускает обычный V Rising без BepInEx и подключается к серверу - всё работает. Проверить, является ли мод серверным, можно в описании на Thunderstore: там должна быть метка Server-side или явное указание в README.

Клиент-серверные моды

Если мод помечен как Client-side или Both, каждый игрок должен:

  1. Установить BepInEx 6.x у себя (аналогичным образом, но в папку клиентской игры).
  2. Скопировать ту же версию DLL мода в свой BepInEx/plugins/.
  3. Проверить, что версии совпадают - несовпадение версий может вызвать ошибку подключения.

Для управления клиентскими модами рекомендуется Thunderstore Mod Manager - он автоматически скачивает зависимости и упрощает обновление.

Проверка совместимости

Перед установкой мода сверьте:

ПроверкаГде смотреть
Версия BepInExREADME мода, поле “Dependencies”
Версия V RisingОписание мода, строка “Game version”
Зависимые библиотеки”Dependencies” на странице Thunderstore
Конфликты с другими модамиРаздел “Known issues” или Issues на GitHub

Обновление модов

Обновление мода - это замена DLL-файла более новой версией. Процедура:

  1. Остановите сервер.
  2. Сделайте бэкап текущего BepInEx/plugins/ (опционально, но рекомендуется).
  3. Скачайте новую версию DLL с Thunderstore или GitHub.
  4. Замените старый файл новым.
  5. Запустите сервер и проверьте BepInEx/LogOutput.log на ошибки.

Если мод имеет конфигурационный файл в BepInEx/config/, обновление обычно не затрагивает его. Но при мажорных обновлениях могут появиться новые параметры конфига - проверяйте changelog мода.

Обновление BepInEx делается аналогично: распаковать новый архив поверх, сохранив папку plugins/ и config/.

Бэкап перед модификацией

Это обязательный шаг. Неудачно установленный мод может вызвать краш при загрузке мира или повредить данные замков. Минимальный бэкап перед установкой нового мода:

# На Linux
tar -czf /backups/vrising-pre-mod-$(date +%Y%m%d).tar.gz \
  /home/vrising/data/Saves \
  /home/vrising/server/BepInEx/plugins \
  /home/vrising/server/BepInEx/config

# На Windows (PowerShell)
$date = Get-Date -Format "yyyyMMdd"
Compress-Archive -Path "C:\vrising-server\save-data\Saves","C:\vrising-server\BepInEx\plugins" `
  -DestinationPath "C:\backups\vrising-pre-mod-$date.zip"

Храните последние 3-5 таких архивов. Если что-то пошло не так после обновления мода, можно быстро откатиться.

Диагностика проблем

Сервер не запускается после установки BepInEx

Проверьте BepInEx/LogOutput.log. Типичные причины:

  • Неверная версия BepInEx (Mono вместо IL2CPP) - строка Running under Mono вместо IL2CPP. Скачайте правильный архив.
  • winhttp.dll в неверном месте - он должен лежать рядом с VRisingServer.exe, не в подпапке.
  • doorstop_config.ini поврежден или отсутствует - распакуйте BepInEx заново.

Мод загружается, но не работает

[Error :   BepInEx] Could not load plugin...

Причины:

  • Не установлены зависимости (VampireCommandFramework и/или Bloodstone).
  • Версия мода несовместима с текущей версией игры.
  • DLL скомпилирован под другую архитектуру (x86 вместо x64).

Конфликты между модами

Если два мода патчат одну и ту же игровую систему, один из них может выбросить исключение. В логе ищите строки [Error] или [Warning] с упоминанием Harmony или Patch. Решение - временно отключить моды по одному, чтобы найти конфликт:

# Переименовать мод временно (сервер его не загрузит)
mv BepInEx/plugins/SuspectedMod.dll BepInEx/plugins/SuspectedMod.dll.disabled

Игроки не могут подключиться после установки мода

Если мод должен быть у игроков тоже (client+server), они получат ошибку версии или несовпадения данных. Убедитесь:

  • Игроки поставили тот же мод той же версии.
  • На сервере не стоит мод, который ожидает отсутствия у клиентов (такое редко, но бывает).

Риски использования модов

Несколько важных моментов, о которых стоит знать:

Совместимость после патчей игры. Stunlock Studios выпускает обновления V Rising, после которых часть модов ломается. Особенно затронуты моды, которые патчат низкоуровневые системы. После крупного обновления сервер стоит запустить без модов, убедиться в работоспособности, и затем возвращать моды по одному, дожидаясь их обновления авторами.

Производительность. Каждый мод добавляет хуки в игровые системы. 2-5 легких модов практически не влияют на производительность. Тяжелые моды с логированием каждого события или сложными алгоритмами могут заметно снизить тиклейт на серверах с высоким онлайном.

Безопасность. Скачивайте моды только с Thunderstore или официальных GitHub-репозиториев. DLL-файл из ненадежного источника - потенциальный вектор атаки на сервер.

Связанные материалы

Если вы только начинаете разворачивать сервер V Rising, читайте базовое руководство настройка сервера V Rising - там подробно описана установка через SteamCMD, конфигурация ServerHostSettings.json и открытие портов. Для сравнения подходов к хостингу других выживалок смотрите настройку сервера 7 Days to Die и Palworld dedicated server.

Заключение

BepInEx 6.x устанавливается на сервер V Rising один раз и после этого все плагины подключаются простым копированием DLL в BepInEx/plugins/. Серверные моды не требуют ничего от игроков - это их главное преимущество. Перед каждым изменением делайте бэкап папки Saves, сверяйте версии зависимостей и проверяйте логи после запуска. Экосистема модов V Rising активно развивается: Thunderstore пополняется новыми плагинами регулярно, и большинство популярных решений для администрирования сервера уже там.

Pterohost - хостинг серверов V Rising с автоматическим деплоем, NVMe SSD и DDoS-защитой. Устанавливайте моды через файловый менеджер панели без настройки Wine и systemd вручную. Промокод 4START даёт -20% на первый заказ. Заказать сервер V Rising