Pterohost docs

Моды на Valheim сервер: установка BepInEx и Thunderstore

Установка модов на сервер Valheim: BepInEx как лоадер, Thunderstore Mod Manager, синхронизация клиент-сервер, ValheimPlus, Epic Loot, Jotunn и топ-10 модов 2026.

Чистый Valheim после 500 часов начинает повторяться: те же боссы, те же рецепты, тот же лут. Моды решают это - от мелких QoL-правок (увеличенный инвентарь, быстрое перемещение через порталы любых ресурсов) до глобальных оверхолов вроде Epic Loot и Valheim Enhanced. В этой статье разбираем, как правильно поставить BepInEx на сервер, синхронизировать моды с клиентами и какие 10 модов реально стоят установки в 2026 году.

Архитектура модов в Valheim

Valheim не имеет официальной поддержки модов. Всё ставится через сторонний лоадер BepInEx, который патчит игровые DLL-файлы при запуске через утилиту doorstop. Структура:

  • BepInEx - сам лоадер, подгружает плагины (DLL) перед стартом игры.
  • Plugins - папка BepInEx/plugins/ куда кладутся моды (DLL и иногда подпапки с ассетами).
  • Config - папка BepInEx/config/ куда моды пишут свои настройки в формате .cfg.
  • doorstop - механизм инъекции, файлы winhttp.dll (Windows) или run_bepinex.sh (Linux).

Для модов используется BepInEx 5.4.x - именно её все авторы Valheim-модов поддерживают. BepInEx 6.x пока несовместим с большинством плагинов.

Jotunn как библиотека

Многие сложные моды (Epic Loot, Valheim Enhanced, Therzie’s mods) используют библиотеку Jotunn - это слой абстракции над Unity и BepInEx, упрощающий создание контента, локализаций, RPC. Jotunn кладётся как обычный мод в plugins/, и без него зависящие моды просто не загрузятся - в логе будет ошибка MissingMethodException или TypeLoadException.

Установка BepInEx на сервер Valheim

Сервер Valheim под Linux ставится через SteamCMD (app id 896660), под Windows - через valheim_dedicated_server. Дальнейшие шаги одинаковы.

Шаг 1. Скачать BepInEx

Берём пакет с Thunderstore: denikson-BepInExPack_Valheim. Это сборка специально под Valheim, уже включает doorstop под Linux и Windows, конфиг и нужные DLL.

cd /home/valheim
wget https://valheim.thunderstore.io/package/download/denikson/BepInExPack_Valheim/5.4.2202/ -O bepinex.zip
unzip bepinex.zip -d bepinex-temp
cp -r bepinex-temp/BepInExPack_Valheim/* ./server/

После распаковки в папке сервера должны появиться:

  • BepInEx/ (с подпапками core, plugins, config)
  • doorstop_libs/
  • unstripped_corlib/
  • start_server_bepinex.sh (Linux) или start_game_bepinex.bat (Windows)
  • run_bepinex.sh

Шаг 2. Изменить команду запуска

Vanilla сервер стартует через ./valheim_server.x86_64. С BepInEx нужно либо использовать готовый start_server_bepinex.sh, либо запускать с переменными doorstop:

#!/bin/bash
export LD_LIBRARY_PATH=./linux64:$LD_LIBRARY_PATH
export DOORSTOP_ENABLE=TRUE
export DOORSTOP_INVOKE_DLL_PATH=./BepInEx/core/BepInEx.Preloader.dll
export DOORSTOP_CORLIB_OVERRIDE_PATH=./unstripped_corlib
export LD_PRELOAD=libdoorstop_x64.so:$LD_PRELOAD
./valheim_server.x86_64 -name "Modded Server" -port 2456 -world Dedicated -password "secret123" -public 0

Если запустить без doorstop-переменных, моды просто не подгрузятся.

Шаг 3. Положить моды в plugins

Каждый мод с Thunderstore - это zip с DLL внутри. Распаковать и скопировать содержимое (обычно одна-две DLL и папка с ассетами) в BepInEx/plugins/. Например, для ValheimPlus:

BepInEx/plugins/ValheimPlus/
├── ValheimPlus.dll
└── valheim_plus.cfg

Шаг 4. Запустить и проверить логи

После старта смотрим BepInEx/LogOutput.log:

[Info   :   BepInEx] BepInEx 5.4.22.0 - valheim_server (...)
[Info   :   BepInEx] Loading [ValheimPlus 0.9.10.x]
[Info   :   BepInEx] Loading [Jotunn 2.20.0]
[Info   :   BepInEx] Loading [EpicLoot 0.10.5]
[Info   : Unity Log] Server is ready

Если видите Failed to load plugin или MissingMethodException - значит, мод требует более новой/старой версии Jotunn или BepInEx, либо есть конфликт.

Thunderstore Mod Manager для клиента

Клиенты ставят те же моды через r2modman или Thunderstore Mod Manager - это GUI-приложение, которое сам качает BepInEx, моды и держит профили под разные серверы.

  1. Скачать с overwolf.com/app/Thunderstore-Thunderstore_Mod_Manager или github.com/ebkr/r2modmanPlus.
  2. Запустить, выбрать игру Valheim.
  3. Создать профиль (например, “Friends Server”).
  4. Через вкладку Online поставить нужные моды.
  5. Запускать игру кнопкой “Start modded” из менеджера.

Менеджер автоматически разруливает зависимости (Jotunn подтянется как dependency для Epic Loot), хранит несколько профилей и умеет экспортировать список модов в код для шеринга.

Экспорт профиля для друзей

В r2modman: Settings -> Profile -> Export profile as code. Получите строку вида 1234abcd-.... Друг импортирует её и получает идентичный набор модов с теми же версиями.

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

Главная боль модового Valheim - совпадение версий. Если сервер запущен с ValheimPlus 0.9.10, а клиент попытается зайти с 0.9.9 - игрока выкинет с ошибкой Mod version mismatch.

Правила синхронизации

  • Версии должны совпадать побайтово. Не просто “та же мажорная” - именно тот же релиз.
  • Все клиентозависимые моды должны быть и у сервера, и у клиента. Это касается всего, что меняет геймплей: ValheimPlus, Epic Loot, Therzie’s Monstrum.
  • Чисто серверные моды клиенту не нужны. ServerCharacters, AutoBackup, World Edit Commands ставятся только на сервер.

ServerSync и DiscordConnector

Современные моды используют библиотеку ServerSync - она автоматически шлёт конфиг с сервера на клиент при подключении. Это значит, что вам не нужно править .cfg файлы у каждого игрока - все настройки баланса в valheim_plus.cfg применяются с сервера.

Топ-10 серверных модов на 2026 год

Отбор по двум критериям: активная поддержка автора (релизы в 2025-2026) и стабильность на серверах от 5 игроков.

1. ValheimPlus

Классический оверхол. Стек предметов 50/100/999, ускоренное строительство, увеличенный радиус мастерской, портал-сэндбокс для любых ресурсов, отключение деградации брони. Конфигурируется через valheim_plus.cfg - сотни параметров.

2. Jotunn

Библиотека-зависимость. Сам по себе ничего не делает, но без него не запустятся 70% модов из списка ниже.

3. Epic Loot

Добавляет diablo-подобную систему легендарок с магическими свойствами, рунные слова, аукционный дом. Полностью меняет луп игры. Требует Jotunn.

4. ServerCharacters

Серверный мод (клиент не нужен). Хранит персонажей на стороне сервера - игроки не могут унести прогресс на ванильный сервер и тащить читовый шмот. Критичен для PvP и публичных серверов.

5. AutoBackup

Автоматические бэкапы мира каждые N минут. Сам ротирует архивы, поддерживает сжатие.

6. Therzie’s Monstrum / Armory / Warfare

Трилогия модов от Therzie: новые мобы в каждом биоме, дополнительные сеты брони и оружие, балансные доработки боссов. Один из самых полированных контент-паков.

7. PlantEverything

Расширяет систему садоводства - можно сажать всё от грибов до железной руды (в кастомных конфигах). QoL must-have.

8. EquipmentAndQuickSlots

Добавляет отдельные слоты под броню, амулеты и 3 быстрых слота под расходники. Геймпад-френдли.

9. Better Archery

Полная переработка стрельбы из лука: настоящая траектория, ветер, разные типы наконечников. Не дружит с Epic Loot из коробки - нужен патч-мод.

10. ValheimRAFT

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

Pterohost - хостинг игровых серверов с DDoS-защитой и NVMe SSD. Промокод 4START даёт -20% на первый заказ. Арендовать сервер Valheim

Где лежат логи и как их читать

Основной лог BepInEx: BepInEx/LogOutput.log в папке сервера. Он перезаписывается при каждом старте, поэтому если сервер уже падал - смотрите свежий лог сразу после рестарта.

Типичные паттерны проблем:

[Error  :   BepInEx] Could not load [SomeMod]: System.IO.FileNotFoundException:
Could not load file or assembly 'Jotunn, Version=2.20.0'

Перевод: мод требует Jotunn 2.20.0, а у вас стоит другая версия или его нет вовсе.

[Warning: Unity Log] ZNetScene 142 incompatible with 138

Несовпадение протокола: игрок зашёл с другой версией мода, который меняет ZNetScene (сетевой объект).

[Error  :   BepInEx] MissingMethodException: Method not found:
'void ItemManager.AddItem(ItemConfig)'

Старая версия Jotunn, в которой ещё не было нужного API. Обновите.

Частые ошибки и как их решать

Клиент вылетает при заходе на сервер

Не совпадает версия BepInEx или критичных модов. Сравните в r2modman список модов профиля с тем, что стоит на сервере. Точнее всего - попросите админа выложить экспорт профиля и импортируйте его себе.

Сервер падает при старте после установки нового мода

Удалите последний поставленный мод и проверьте логи. Часто проблема в конфликте двух модов, патчащих одни и те же методы (например, два мода на изменение урона).

Мир сломался после обновления мода

Откатите DLL мода до предыдущей версии и восстановите мир из последнего бэкапа. Поэтому критически важна установка AutoBackup или внешнего бэкап-скрипта до экспериментов с модами. Подробнее про резервное копирование в гайде по серверу Valheim.

Моды не подгружаются вообще

Проверьте, что вы запускаете сервер через start_server_bepinex.sh, а не через valheim_server.x86_64 напрямую. Без переменных doorstop игра грузится в ванильном режиме, и BepInEx не инициализируется.

Обновление модов на сервере

Workflow обновления, чтобы ничего не сломать:

  1. Остановите сервер.
  2. Сделайте бэкап папок BepInEx/plugins/, BepInEx/config/ и мира.
  3. Удалите старую DLL мода, положите новую.
  4. Запустите сервер, проверьте LogOutput.log на ошибки.
  5. Сообщите игрокам новую версию мода - они обновляются через r2modman.
  6. Подключитесь сами и убедитесь, что мир грузится, чанки не пустые, предметы не потерялись.

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

Что нельзя ставить

  • Моды без обновлений с 2023 года - почти наверняка несовместимы с актуальной версией Valheim и Jotunn.
  • Пиратские “сборки модов” из VK и Telegram - часто содержат изменённые DLL с майнерами или бэкдорами.
  • Два мода, патчащих один и тот же кусок (например, два конкурирующих оверхола боёвки) - выберите один.
  • BepInEx 6.x - пока не работает с Valheim-модами, нужен именно 5.4.x пакет от denikson.

Pterohost - готовые шаблоны Valheim с BepInEx и снапшоты мира раз в сутки. Заказать сервер Valheim

Часто задаваемые вопросы

Нужен ли BepInEx на клиенте, если стоит на сервере?

Зависит от мода. Серверные моды баланса (ValheimPlus, Epic Loot) обязательно нужны и на клиенте, причём той же версии. Чисто серверные моды (ServerCharacters, AutoBackup) клиент не требуют.

Почему игроки не могут зайти на модовый сервер?

Чаще всего - несовпадение версий модов между клиентом и сервером или отсутствие BepInEx у клиента. Проверьте LogOutput.log на сервере - там видно, какие моды требует клиент.

Где взять моды для Valheim?

Официальная площадка - Thunderstore (valheim.thunderstore.io). Через Thunderstore Mod Manager или r2modman моды ставятся в один клик. NexusMods используется реже.

Можно ли играть на ванильном клиенте на модовом сервере?

Только если сервер использует моды, не меняющие сетевой протокол. Любой мод, добавляющий предметы или меняющий баланс, требует совпадения версий клиент-сервер.

Как откатить мод, если он сломал мир?

Остановите сервер, удалите DLL мода из BepInEx/plugins, восстановите мир из бэкапа, перезапустите. Перед установкой любого мода всегда делайте копию папки worlds_local.