BepInEx не загружает моды: как найти этап сбоя
Если Valheim запускается без модов, сначала выясните, дошёл ли запуск до загрузчика. Ошибка одного плагина и отсутствие самого BepInEx — разные ситуации. Начните с консоли, конфигурации и preloader-журнала, а не с массовой замены всех модов.
Проверьте, какой пакет установлен
Для Valheim используется BepInExPack Valheim с подготовленной конфигурацией и точкой входа. В пакет уже входит BepInEx.cfg с включённой консолью. Если этого файла нет, сперва проверьте полноту распаковки и правильную папку: отсутствие файла не доказывает, что проблема в конкретном плагине.
Не сравнивайте только последнее число версии: номер пакета Thunderstore может отличаться от версии BepInEx внутри. Авторы пакета отдельно выводят его номер в консоль. Для отчёта о сбое запишите обе версии, если они видны, и способ запуска игры или сервера.
Включите журнал без изменения точки входа
Если BepInEx/config/BepInEx.cfg существует, найдите секцию [Logging.Console] и проверьте Enabled = true. Перед правкой сохраните копию настроек. Valheim-пакет обычно уже включает консоль; этот шаг нужен для проверки своей конфигурации, а не для обязательного создания нового файла вручную.
| Что наблюдается | Что проверять дальше |
|---|---|
| Нет конфигурации пакета и признаков загрузки | Полноту установки, каталог запуска и выбранный пакет |
| Консоль не открывается, есть preloader-журнал | Первую ошибку ранней загрузки; в upstream-документации это этап Doorstop/preloader |
| Preloader проходит без ошибок, плагины не начинают загружаться | Этап chainloader и совместимость конфигурации именно Valheim-сборки |
| Плагин загружается без ошибок, но функция не действует | Требования самого плагина и его совместимость; это уже не доказанное отсутствие загрузчика |
Проверьте ОС и архитектуру целевого приложения
BepInEx имеет разные сборки для x86, x64 и разных ОС. Важна платформа самого запускаемого приложения: Windows-версия под Wine остаётся Windows-приложением, даже если компьютер работает на Linux. Не подменяйте пакет произвольным архивом только по названию ОС хоста.
Для нативного Linux-сервера пакет предусматривает start_server_bepinex.sh, а для игры — start_game_bepinex.sh. В серверном терминале ожидаются bootstrap-сообщения BepInEx. Сам факт работающего игрового процесса ещё не подтверждает, что загрузчик подключён.
Какие журналы нужны
- Проверьте корень игры или сервера на наличие preloader-журналов, если ранняя загрузка не проходит.
- Сохраните начало журнала запуска и первую ошибку, а не только последние повторяющиеся сообщения.
- Добавьте версию игры, BepInExPack, видимую версию BepInEx, ОС и архитектуру целевого приложения.
- Опишите способ запуска и укажите, появились ли bootstrap, chainloader и сообщения нужного плагина.
Не переносите советы для других Unity-игр вслепую
Upstream-руководство предлагает для отдельных игр менять [Preloader.Entrypoint] и HarmonyBackend. Это не универсальная рекомендация для Valheim: пакет уже подготовлен под игру. Не начинайте диагностику со случайного изменения точки входа, удаления Managed или переименования системных DLL.
Если обычные проверки не объясняют сбой, передайте собранные сведения поддержке Valheim-сборки или соответствующего плагина. Страница пакета прямо направляет такие обращения к его сопровождающим, поскольку customized-сборка отличается от upstream BepInEx.
Гайд был полезен?