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

Моды Valheim удобнее устанавливать в отдельный профиль менеджера: так проще проверить зависимости, сохранить рабочий набор и вернуться к игре без дополнений. Для первого запуска на Windows со Steam подойдёт r2modman и подготовленный для Valheim пакет BepInExPack_Valheim. Сам загрузчик ещё не добавляет новые предметы или возможности — для этого нужны отдельные плагины.

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

Что потребуется перед установкой

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

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

Посмотрите, для какой версии Valheim предназначен выбранный мод. Надпись об обновлении после выхода 1.0 сама по себе не доказывает совместимость с каждым последующим патчем. В описании важны поддерживаемая версия, требуемые зависимости и известные ограничения. Отсутствие новой сборки тоже не доказывает поломку: автор мог подтвердить работу существующей версии без перевыпуска.

У Valheim нет официальной поддержки модов и Steam Workshop. Рассматриваемый ниже способ относится к версии Steam на персональном компьютере. Консольный игрок не может просто повторить установку клиентского плагина. Порядок запуска на Linux и macOS отличается от Windows; переносить туда установщик Windows и его действия нельзя.

Установка через r2modman

1. Установите r2modman из места распространения, указанного самим проектом: Thunderstore или репозитория разработчика на GitHub. Сайт с похожим названием не становится официальным из-за позиции в поиске.
2. Откройте менеджер, выберите Valheim и нужный магазин. Для этой инструкции используется Steam. Если программа просит расположение игры, укажите реальную папку установленной копии, а не папку загрузки архива.
3. Создайте новый профиль с понятным именем. Для первого опыта не импортируйте поверх него большой чужой набор: отдельный профиль поможет видеть, что именно было добавлено.
4. Найдите BepInExPack_Valheim от denikson и установите пакет. Это подготовленная для Valheim сборка с настройками загрузки. Не подменяйте её случайной универсальной сборкой BepInEx для другой разновидности Unity.
5. Запустите игру кнопкой Start modded в выбранном профиле. Дождитесь главного меню, затем выйдите из игры. Первый запуск нужен для проверки самого загрузчика до добавления игрового содержимого.
6. Установите один выбранный мод вместе с указанными зависимостями. Снова запустите тот же профиль и проверьте именно его функцию на тестовом сохранении.

В карточке подготовленного пакета при проверке была указана версия 5.4.2351. У базового BepInEx, на котором он собран, другое обозначение — 5.4.23.5. Эти номера не должны совпадать посимвольно. По той же причине номер обновления менеджера не говорит, какой набор плагинов находится внутри профиля.

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

BepInEx, Jötunn и Valheim Plus — разные компоненты

BepInEx загружает плагины при запуске игры. Jötunn — библиотека, на которую опираются некоторые модификации. Она нужна, когда указана в требованиях конкретного дополнения; устанавливать её вместо BepInEx бессмысленно. Наличие одной библиотеки также не закрывает автоматически все зависимости большого набора.

Valheim Plus — отдельный мод с многочисленными настройками, работающий поверх загрузчика. Его не следует считать другим названием BepInEx или обязательной частью любой установки. Важно различать старый проект и сопровождаемое продолжение: совпадение названия ещё не подтверждает, что выбрана актуальная сборка для вашей версии игры.

У зависимостей бывают разные правила совместимости. Одному плагину достаточно подходящей более новой версии библиотеки, другой требует определённого выпуска или одинакового набора у участников. Ориентируйтесь на условия автора, а для совместной игры сохраняйте проверенную комбинацию целиком. Правило «поставить всё самое новое независимо друг от друга» не заменяет такой проверки.

Документация для разработчиков может предлагать NuGet, сборку проекта или подготовку игровых библиотек. Это другой сценарий. Обычному игроку для использования готового мода не нужно создавать проект в среде разработки: нужен опубликованный пакет и его пользовательская инструкция.

Если устанавливаете вручную

Ручной способ имеет смысл, когда понятны состав пакета и способ его отключения. Для Windows найдите папку Valheim через Steam: «Управление → Просмотреть локальные файлы». Корневая папка содержит исполняемый файл игры. Она отличается от папки профиля r2modman.

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

Большинство обычных плагинов размещается в BepInEx/plugins, а настройки находятся в BepInEx/config. Однако пакет может содержать дополнительные ресурсы, переводы или специальный компонент для папки patchers. Сохраняйте структуру, указанную автором. Один файл .dll, вынутый из большого архива, не всегда составляет весь мод.

Например, автор Races of Valheim отдельно требует положить рядом с библиотекой папку переводов. Без неё вместо нормальных надписей появляются служебные ключи. Это пример зависимости от содержимого пакета, а не универсальное правило расположения ресурсов всех остальных модификаций.

Оставшийся ZIP в папке plugins сам по себе не становится загруженным плагином. Некоторые панели хостинга умеют принять архив и распаковать его автоматически, но это функция панели. При непосредственной работе с папкой загрузчика требуется правильное распакованное содержимое.

Не смешивайте ручное изменение корня игры и профиль менеджера без необходимости. Иначе запуск из Steam может подхватить вручную установленные компоненты, хотя вы ожидаете обычную игру. Кнопка запуска без модов в менеджере относится к его профилю и не является обещанием удалить все чужие изменения из папки Valheim.

Как передать набор друзьям

В настройках r2modman есть экспорт профиля в виде специального значения для импорта или файла .r2z. Другой участник выбирает импорт нового профиля, загружает полученное описание и запускает игру из этого профиля. Так удобнее согласовать версии и конфигурацию, чем пересылать список названий сообщениями.

Есть важное ограничение: вручную установленные и локально импортированные моды не восстанавливаются у получателя обычным импортом профиля. Проверьте такие дополнения отдельно. Передача описания профиля также не передаёт мир и персонажа и не заменяет их резервную копию.

Импорт нового профиля и обновление существующего — разные действия. При замене существующего профиля его вручную добавленные компоненты могут быть удалены. Если задача — сравнить два набора, импортируйте второй под отдельным именем. После успешного запуска сохраните сведения о версиях, с которыми группа действительно вошла в мир.

Какие моды нужны серверу и игрокам

Читайте требования каждого дополнения. Клиентское изменение интерфейса может работать только у игрока. Серверное изменение может не требовать установки у участников. Мод, добавляющий общее содержимое или собственную сетевую логику, способен потребовать компоненты с обеих сторон. Это определяется устройством мода, а не количеством его скачиваний.

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

У хостингов отличаются названия переключателей и поведение обновлений. На одной площадке перезапуск обновляет загрузчик, на другой обновление игры вообще не затрагивает BepInEx. Используйте инструкцию своей панели и заранее выясните, что сохраняется при переустановке. Универсальной команды «переустановите сервер» для любой ошибки модов нет.

Для группы с консолями нельзя обещать работу набора, требующего установки плагинов на каждом клиенте. Возможность отдельных серверных изменений проверяется отдельно вместе с условиями кроссплея и ограничениями хостинга. Само наличие BepInEx не доказывает ни полную совместимость с консолями, ни её отсутствие для всех возможных серверных дополнений.

Где искать причину ошибки

В подготовленном пакете BepInEx для Valheim основная точка проверки — журнал BepInEx/LogOutput.log. У профиля менеджера ищите его в папке выбранного профиля. У ручной установки и сервера местоположение связано с соответствующим корнем BepInEx. Журнал другого профиля не объяснит ошибку текущего запуска.

Сохраните журнал проблемного запуска до следующего перезапуска: новый старт может перезаписать файл. Найдите название или идентификатор плагина, сообщение о его загрузке и соседние ошибки. Простое появление окна консоли ещё не доказывает, что нужный мод успешно включён.

Проверяйте одно изменение за раз. Если после добавления нескольких модов перестал работать весь набор, вернитесь к сохранённому рабочему профилю и добавляйте компоненты последовательно. Не удаляйте сразу все конфигурации: в них находятся условия, с которыми набор уже мог работать. Сообщение о недостающей библиотеке полезнее случайной переустановки игры.

Как вернуться к обычной игре

Сначала прочитайте раздел удаления у автора модификации. Для интерфейсного дополнения и мода новых предметов последствия могут различаться. Перед отключением расширения инвентаря переместите вещи из добавленных слотов в обычные доступные места и сохраните отдельную копию персонажа. Иначе отсутствие самого расширения может сделать эти вещи недоступными или привести к их потере.

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

Модификации генерации заслуживают отдельной проверки: изменение набора может повлиять на то, что вы ожидаете увидеть в мире. Как связаны расположение островов, сид и исследованные области, разобрано в гайде по карте Valheim. Для обычного исследования не требуется менять генератор только ради поиска удобного маршрута.

Рабочий набор — это известная комбинация версии игры, загрузчика, зависимостей, плагинов и настроек. Сохраните её перед следующим обновлением. Тогда при сбое у вас останется точная исходная точка, с которой можно сравнить новый запуск.