Добавление модов

Это руководство описывает установку модов на выделенный сервер Valheim: установку BepInEx, загрузку модов с Thunderstore и Nexus Mods, размещение файлов в BepInEx/plugins/ и базовую проверку совместимости.

Большинство модов Valheim работают через BepInEx. Без него обычные .dll-моды не будут загружаться сервером.

Где скачивать моды

Основные источники модов для Valheim:

Thunderstore Valheim — основной каталог модов и модпаков Valheim;
Nexus Mods Valheim — крупная база модов для Valheim;
BepInExPack Valheim — пакет BepInEx для Valheim;
Valheim Plus — популярный пакет изменений игрового процесса;
Jotunn — библиотека, которая требуется многим Valheim-модам.

Перед установкой всегда проверяйте страницу мода: версию Valheim, зависимости, место установки и необходимость установки на клиент игрока.

BepInEx

BepInEx — это загрузчик модов для Valheim. Он устанавливается в корневую папку сервера, где находится файл valheim_server.x86_64.

После установки BepInEx сервер получает структуру:

BepInEx/
  config/
  plugins/
  patchers/
doorstop_libs/
start_server_bepinex.sh
run_bepinex.sh

Основная папка для модов:

BepInEx/plugins/

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

Скачайте BepInExPack Valheim.
Распакуйте архив на компьютере.
Откройте папку, внутри которой находятся BepInEx, doorstop_libs и файлы запуска BepInEx.
Загрузите содержимое этой папки в корень сервера через SFTP.
Перезапустите сервер.

Корень сервера — это папка, где находится файл:

valheim_server.x86_64

После первого запуска BepInEx создаст нужные папки и файлы конфигурации.

Проверка BepInEx

После запуска проверьте консоль сервера. В логах должны появиться строки BepInEx, например:

[Message:   BepInEx] BepInEx 5.x.x.x
[Info   :   BepInEx] Loading plugins

Если таких строк нет, значит сервер запущен без BepInEx или файлы были загружены не в корневую папку сервера.

Установка обычных модов

Большинство модов Valheim устанавливаются в папку:

BepInEx/plugins/

Обычно внутри архива мода находится один или несколько файлов .dll. Иногда вместе с ними идут папки с ресурсами или дополнительные зависимости.

Пример структуры:

BepInEx/
  plugins/
    ExampleMod.dll
    Jotunn/
      Jotunn.dll
    AnotherMod/
      AnotherMod.dll
      assets/

Если автор мода указывает конкретную структуру папок, используйте её. Не все моды достаточно просто бросить одним .dll в общий каталог.

Конфигурация модов

После первого запуска моды часто создают свои конфигурационные файлы в папке:

BepInEx/config/

Файлы конфигурации обычно имеют расширение .cfg.

BepInEx/config/
  mod.author.examplemod.cfg
  valheim_plus.cfg

После изменения конфигурации мода сервер нужно перезапустить.

Серверные и клиентские моды

Перед установкой важно понять, где должен стоять мод.

Только сервер — мод работает на сервере и не требует установки у игроков;
Сервер + клиент — мод должен быть установлен на сервере и у всех игроков;
Только клиент — мод влияет только на интерфейс или локальное удобство игрока и обычно не нужен серверу.

Моды, которые добавляют новые предметы, механики, интерфейсы, рецепты, навыки или изменяют игровой процесс, часто требуют одинаковой версии на сервере и у игроков.

Зависимости модов

Некоторые моды требуют дополнительные библиотеки. Самый частый пример — Jotunn.

Если на странице мода указаны зависимости, установите их перед запуском сервера. Без нужной зависимости мод может не загрузиться или вызвать ошибку при старте.

Пример:

BepInEx/plugins/
  Jotunn/
    Jotunn.dll
  SomeMod/
    SomeMod.dll

Valheim Plus

Valheim Plus — крупный пакет настроек, который меняет разные игровые механики: строительство, переносимый вес, костры, телепорты, выносливость, производство и другие параметры.

Если вы используете Valheim Plus, скачивайте сборку, подходящую для вашей версии Valheim и сервера.

После установки и первого запуска конфигурация обычно появляется здесь:

BepInEx/config/valheim_plus.cfg

Внутри файла параметры разделены на секции. Обычно у каждой секции есть переключатель enabled. Если секция выключена, её настройки не применяются.

[Player]
enabled = true

[Building]
enabled = true

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

Модпаки

Модпаки удобны, если сервер должен использовать сразу несколько модов с уже подобранными зависимостями.

При использовании модпака важно, чтобы игроки установили тот же набор модов и те же версии. Для этого обычно используют Thunderstore Mod Manager, r2modman или профиль модпака, который можно передать игрокам.

На сервер вручную переносятся файлы BepInEx, плагины и конфигурации из профиля модпака, если автор модпака не указал другой способ установки.

Пример итоговой структуры

/
  valheim_server.x86_64
  BepInEx/
    config/
      valheim_plus.cfg
      mod.author.examplemod.cfg
    plugins/
      Jotunn/
        Jotunn.dll
      ValheimPlus.dll
      ExampleServerMod.dll
    patchers/
  doorstop_libs/
  start_server_bepinex.sh
  run_bepinex.sh

Что проверить перед запуском

BepInEx установлен в корень сервера, рядом с valheim_server.x86_64;
моды лежат в BepInEx/plugins/;
все зависимости модов установлены;
версии модов подходят под текущую версию Valheim;
если мод требует клиентскую установку, игроки используют такую же версию;
после изменения конфигов сервер был перезапущен.

Если моды не загружаются

проверьте консоль сервера на строки BepInEx;
убедитесь, что BepInEx установлен не во вложенную папку, а в корень сервера;
проверьте, что файл мода имеет расширение .dll и лежит в BepInEx/plugins/;
проверьте зависимости на странице мода;
проверьте совместимость мода с текущей версией Valheim;
если сервер перестал запускаться после установки нескольких модов, проверяйте их по одному.

После обновлений Valheim моды могут временно перестать работать до выхода обновлений от авторов. Перед обновлением сильно модифицированного сервера лучше заранее сохранить резервную копию мира и текущей папки BepInEx.

Статьи категории