Как устанавливать моды в Valheim (2026)

Руководство о том, как скачивать и устанавливать моды в Valheim на PC, охватывающее менеджеры модов и ручную установку на Windows, Linux и macOS.

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

Наш пример — EpicLoot, давно существующий мод, переделывающий систему лута и магических предметов. Это хороший демонстрационный случай, поскольку он подтягивает реальные зависимости и должен быть установлен как на сервере, так и на клиенте.

Требования

• PC с Windows 10 или новее, Linux или macOS. У Valheim есть нативные сборки для всех трёх систем.
• Valheim, желательно версия из Steam. Почему — см. следующий раздел.
• Несколько сотен МБ свободного места. Крупные overhaul-моды вроде EpicLoot занимают больше.
• 7-Zip или любой другой архиватор, если устанавливаете вручную.
• Резервная копия ваших миров и персонажей перед началом. На Windows они находятся в %userprofile%\AppData\LocalLow\IronGate\Valheim.

ВНИМАНИЕ — отнеситесь к резервной копии серьёзно. Моды, добавляющие предметы и прогрессию, включая EpicLoot, записывают данные в ваше сохранение. Удаление такого мода впоследствии может оставить у персонажа предметы, которые игра больше не распознаёт.

Важно, какая версия Valheim у вас установлена

Valheim продаётся в Steam, в Microsoft Store и на консолях Xbox.

• Steam — версия, на которую рассчитано всё в этом руководстве, и версия, на которую ориентируется всё модовое сообщество.
• Установки из Microsoft Store и Game Pass находятся в C:\XboxGames\Valheim\Content, и модифицировать их гораздо сложнее. BepInEx должен записывать файлы в папку игры, а такие установки защищены способами, которые обычно этому мешают. Здесь нет поддерживаемого пути, и не стоит рассчитывать, что менеджеры модов заработают.
• Консоли Xbox нельзя модифицировать вообще. Кроссплей позволяет игроку с Xbox подключиться к серверу на PC, но клиент Xbox остаётся ванильным и не может ничего загружать.

BepInExPack Valheim

BepInExPack Valheim — это загрузчик, и это не обычный BepInEx. Это специфическая для Valheim сборка, поддерживаемая Azumatt, Vapok и Margmas, с предварительно настроенным BepInEx.cfg, скриптами запуска для Linux и выделенного сервера, изменениями прелоадера, от которых зависят несколько модов, и поддержкой семантического версионирования, от которой отказался апстрим BepInEx 5.

Устанавливайте именно этот пакет, а не обычный BepInEx.

ПРИМЕЧАНИЕ — Поскольку это форк сообщества, официальный Discord BepInEx не сможет помочь с проблемами Valheim, и вам так и скажут. С вопросами по Valheim обращайтесь в сообщество моддинга Valheim.

Помимо BepInEx, EpicLoot зависит от двух общих библиотек:

• Jötunn — библиотека для моддинга Valheim, на которой строится большинство серьёзных модов.
• JsonDotNET — упакованная копия Newtonsoft.Json.

Менеджеры модов устанавливают обе автоматически.

Установка через менеджер модов Thunderstore

Это самый проторённый путь, и именно на него ссылаются страницы модов.

С Valheim работают три менеджера, и все три читают один и тот же формат профилей:

Менеджер	Платформы
Gale	Windows, Linux
Thunderstore Mod Manager	Windows
r2modman	Windows, Linux, macOS

Шаги одинаковы независимо от выбора:

1. Установите менеджер и выберите Valheim.
2. Создайте профиль.
3. Найдите EpicLoot через поиск или обзор.
4. Нажмите Install или Download with dependencies. BepInExPack Valheim, Jötunn и JsonDotNET установятся вместе с ним.
5. Запустите игру через менеджер, используя Start modded или Launch game (modded).

Запуск Valheim напрямую через Steam запускает игру в ванильном виде, поскольку менеджер подключает BepInEx во время запуска.

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

Vortex поддерживает Valheim и загружает моды с Nexus Mods, а не с Thunderstore. Каталог Valheim на Nexus значительно меньше, и большинство авторов сначала публикуют моды на Thunderstore, поэтому используйте этот вариант, если Vortex уже ваш основной инструмент и вы нашли там то, что искали.

1. Установите Vortex и войдите в аккаунт.
2. В разделе Games найдите Valheim, наведите курсор на плитку и нажмите Manage.
3. Установите BepInExPack Valheim самостоятельно, следуя ручным шагам ниже. Vortex не настроит загрузчик за вас.
4. Скачивайте моды с Nexus с помощью Mod Manager Download, затем нажмите Install и Enable.
5. Запускайте игру через Steam как обычно. Vortex записывает файлы в папку игры навсегда, поэтому специальный запуск не требуется, как только BepInEx установлен.

WARNING - Не запускайте Vortex и менеджер Thunderstore для одной и той же установки. Оба хотят владеть папкой BepInEx/plugins и будут перезаписывать работу друг друга.

Установка вручную

Сначала найдите папку игры. Кликните правой кнопкой по Valheim в Steam, затем Управлять и Просмотреть локальные файлы:

C:\Program Files (x86)\Steam\steamapps\common\Valheim

Скачайте BepInExPack Valheim через Manual Download, распакуйте его куда-нибудь не в папку с игрой, затем переместите содержимое папки BepInExPack_Valheim в папку Valheim. Если всё сделано правильно, вы увидите BepInEx, winhttp.dll и doorstop_config.ini рядом с valheim.exe.

Затем скачайте EpicLoot, Jötunn и JsonDotNET, распакуйте каждый архив и скопируйте их файлы .dll в Valheim\BepInEx\plugins.

Дальнейшие шаги зависят от вашей платформы.

Windows

Больше ничего делать не нужно. Запустите игру, и рядом с ней должно появиться окно консоли BepInEx.

Linux

1. Сделайте скрипт запуска исполняемым:

chmod u+x start_game_bepinex.sh

2. В Steam откройте Свойства Valheim и укажите параметры запуска:

./start_game_bepinex.sh %command%

3. Запустите через Steam.

Вы также можете указать полный путь к скрипту вместо относительного, что позволяет держать пакет полностью вне папки игры.

macOS

У Valheim есть нативная сборка для macOS, но BepInEx 5 не запускается нативно на Apple Silicon, так как зависит от MonoMod, а у MonoMod пока нет поддержки arm64. Обходной путь — запустить игру через Rosetta.

1. Сделайте скрипт исполняемым:

chmod u+x start_game_bepinex.sh

2. Укажите параметры запуска Valheim в Steam:

/usr/bin/arch -x86_64 /bin/bash ./start_game_bepinex.sh %command%

3. Запустите через Steam.

Если не указать часть arch -x86_64 на Mac с чипом M-серии, игра всё равно запустится, но без BepInEx и без загрузки ваших модов. На Intel Mac это не требуется.

Установка через приложение TMC

Valheim — одна из игр, которые уже поддерживает приложение TMC, поэтому, в отличие от большинства наших руководств, это реальный вариант, а не просто обещание. Приложение — это наш собственный менеджер модов и браузер серверов, и оно устанавливает моды Valheim в BepInEx/plugins, как и всё остальное здесь.

Установка:

• Linux: одна строка, без root и без пакетного менеджера.

curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh

• Windows: setup.exe или setup.msi со страницы релизов. Также есть портативная сборка, хотя она не регистрирует запись в лаунчере и обработчик ссылок tmc://.
• macOS: .dmg с той же страницы релизов.

После установки:

1. Откройте приложение и добавьте Valheim, указав папку установки Steam.
2. Создайте песочницу (sandbox). Песочницы — это именованные профили модов со своим порядком загрузки и методом развёртывания, и переключение между ними не требует повторного скачивания.
3. Установите нужные моды в эту песочницу.
4. Запустите игру.

ПРЕДУПРЕЖДЕНИЕ — Пожалуйста, прочитайте эту часть, прежде чем полагаться на приложение. Приложение находится на очень ранней стадии разработки, и мы предпочитаем сказать об этом прямо, чем чтобы вы обнаружили это посреди прохождения. Собственный README приложения помечает все поддерживаемые игры как непротестированные, включая Valheim, так что относитесь к нему как к тому, что стоит попробовать наряду с Gale или r2modman, а не как к их замене. Сохраните резервную копию, о которой мы упоминали в требованиях.

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

Приложение с открытым исходным кодом под лицензией GPL-3.0, доступно на github.com/modcommunity/tmc-app. Сообщения об ошибках и предложения по функциям отправляются в трекер задач, pull request'ы приветствуются, а в репозитории описано, как работают правила для конкретных игр, если вы хотите улучшить поддержку Valheim самостоятельно.

Серверные моды и мультиплеер

Это та часть, на которой чаще всего спотыкаются игроки Valheim, потому что здесь всё работает иначе, чем в большинстве кооперативных игр.

Моды для Valheim делятся примерно на три типа:

• Только клиент. Изменения интерфейса, камеры, визуальные моды. Устанавливаются только у вас, и больше никому нет дела.
• Клиент и сервер. Всё, что добавляет предметы, рецепты, существ или прогрессию. EpicLoot относится именно сюда, и его нужно устанавливать как на выделенный сервер, так и на клиент каждого игрока.
• Только сервер. Инструменты администрирования, резервное копирование, управление миром.

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

Для выделенного сервера BepInExPack Valheim поставляется со скриптом start_server_bepinex.sh именно для этой цели. Сделайте его исполняемым с помощью chmod u+x start_server_bepinex.sh, отредактируйте его параметры запуска так же, как вы бы редактировали собственный серверный скрипт Valheim, и запускайте его вместо start_server.sh.

Если вы настраиваете сервер с нуля, наш отдельный гайд по серверу Valheim охватывает эту часть.

TIP - Многие управляемые хостинги для Valheim устанавливают BepInEx одним переключателем. Если вам не хочется возиться с оболочкой, это вполне законный способ.

Настройка модов

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

Valheim\BepInEx\config

Это обычные текстовые файлы .cfg. EpicLoot хранит там много настроек, а также JSON-файлы для таблиц добычи и магических эффектов, и стоит в них заглянуть, если хотите что-то настроить, а не просто принять значения по умолчанию.

BepInEx Configuration Manager добавляет игровое окно настроек, которое редактирует те же значения без необходимости переключаться между окнами. Gale и r2modman тоже включают редакторы конфигурации.

Проверка, что всё загрузилось

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

То, что вы хотите увидеть - это серый и белый текст, который является информационным выводом. Цвета означают проблемы:

Цвет	Значение
Красный	Критическая ошибка
Тёмно-красный	Ошибка
Жёлтый	Предупреждение
Тёмно-серый	Отладочный вывод

Пакет также выводит в консоль собственную версию Thunderstore, которая отличается от версии BepInEx под ней.

Конкретно для EpicLoot загрузите мир и проверьте инвентарь на наличие вкладок магических предметов и рецептов станции улучшения.

Обновление и удаление

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

Чтобы удалить мод, удалите его через менеджер или удалите его .dll из BepInEx/plugins. Чтобы вернуться к ванильной версии, удалите BepInEx, winhttp.dll, doorstop_config.ini и скрипты запуска из папки игры. Проверка файлов Steam их не удалит, потому что Steam их не устанавливал.

WARNING - Прежде чем удалять мод, добавивший предметы в ваш мир, подумайте, нужны ли вам после этого этот персонаж и мир. Именно для этого нужна резервная копия.

Устранение неполадок

Нет консоли BepInEx и моды не работают. На Windows проверьте, что winhttp.dll находится прямо рядом с valheim.exe. На Linux проверьте, что параметры запуска включают ./start_game_bepinex.sh %command%. На macOS проверьте наличие префикса arch -x86_64.

Вылет с сервера из-за несовпадения версий. Ваши моды и моды сервера не совпадают. Установите те же версии, что использует сервер, или попросите хостера экспортировать список.

Моды перестали работать после обновления Valheim. Это ожидаемо. Патчи Iron Gate ломают моды BepInEx, и авторам нужно время. Проверьте страницы ваших модов на Thunderstore на наличие обновлённых версий.

Игра вылетает при запуске. Уберите всё из BepInEx/plugins, убедитесь, что запуск проходит без ошибок, а затем добавляйте моды обратно частями, чтобы найти виновника.

Моды работают в одиночной игре, но не на моём собственном сервере. Серверные моды нужно устанавливать и на сервер, а не только на клиент, который его хостит. Используйте start_server_bepinex.sh.

Версия из Microsoft Store не модифицируется. По большей части — да, и поддерживаемого способа обойти это нет. Используйте версию из Steam.

На Mac с чипом M-серии ничего не загружается. У вас отсутствует префикс Rosetta в параметрах запуска.

Заключение

Короткая версия для большинства: установите Gale или r2modman, выберите Valheim, установите EpicLoot со всеми зависимостями и запустите игру в моддинг-режиме. BepInExPack Valheim подтянется автоматически, и вам не придётся об этом думать.

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

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

Смотрите также

• Valheim на Thunderstore
• Valheim на Nexus Mods
• Discord по моддингу Valheim
• Wiki по моддингу Valheim
• Официальный FAQ по моддингу Valheim - собственные заметки Iron Gate о системе asset bundle, с которой приходится работать модам.
• Документация Jötunn
• TMC App

Мы стараемся поддерживать это руководство в актуальном состоянии, но Valheim, BepInEx и библиотеки модов обновляются независимо друг от друга. Если какая-то инструкция здесь больше не соответствует тому, что вы видите, пожалуйста, сообщите об этом или откройте pull request в GitHub-репозитории этого руководства.

Присоединяйтесь к нашему Discord-серверу, если у вас есть вопросы или нужна помощь с чем-либо, связанным с моддингом!