Установка сервера Valheim с модами (BepInEx) в панели Pterodactyl

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

Инструкция, как установить и запустить сервер Valheim с модами (BepInEx) в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 21 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 с сервером Valheim 1.0.21 и BepInEx 5.4.23.

BepInEx — загрузчик модов, на котором работают почти все моды Valheim. Шаблон «Valheim BepINex» ставит обычный сервер Valheim через SteamCMD и сразу добавляет к нему BepInEx из каталога модов Thunderstore; учётная запись Steam не нужна. Моды после этого достаточно положить в одну папку. Сервер без модов описан в статье Установка сервера Valheim в панели Pterodactyl.

Что понадобится

  • VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
  • Память: сервер с новым миром занимает около 1,5 ГБ; моды добавляют к этому. Серверу в панели отведите 4 ГБ; если панель стоит на том же VDS, берите VDS от 8 ГБ.
  • Диск: файлы игры с BepInEx занимают около 2,5 ГБ, образ Docker — около 1 ГБ. Серверу в панели отведите 10 ГБ.

Подобрать сервер можно на странице тарифов VDS.

1. Добавьте шаблон игры

Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблона Valheim с модами (BepInEx) в панели изначально нет — его берут из общего хранилища шаблонов, которое ведёт сообщество.

1. Скачайте файл шаблона на свой компьютер: откройте ссылку egg-pterodactyl-valheim-bep-i-nex.json и сохраните страницу (Ctrl+S) под именем egg-pterodactyl-valheim-bep-i-nex.json. Нужен именно файл со словом pterodactyl в имени: соседний файл без него предназначен для другой панели и в Pterodactyl не загрузится.

2. В панели перейдите в раздел администратора (значок с шестерёнками справа вверху) и откройте Nests. Гнездо (nest) — это папка для шаблонов. Если гнезда для дополнительных игр у вас ещё нет, нажмите Create New, введите имя — например, Games — и нажмите Save.

3. Вернитесь в Nests и нажмите Import Egg. В поле «Egg File» выберите скачанный файл, в поле «Associated Nest» — гнездо Games и нажмите Import:

Панель откроет страницу шаблона с сообщением «Successfully imported this Egg and its associated variables».

2. Выделите порты

Адрес и порты сервер получает из списка «выделений» (allocations) узла. Серверу Valheim с модами (BepInEx) нужны порты:

Порт Протокол Зачем
2456 UDP Игра
2457 UDP Запросы списка серверов Steam — всегда порт игры плюс один

1. Откройте Nodes, щёлкните по своему узлу и перейдите на вкладку Allocation.

2. В блоке «Assign New Allocations» в поле «IP Address» выберите IP-адрес VDS, а в поле «Ports» введите 2456 и 2457 — после каждого номера нажимайте Enter. Нажмите Submit:

IP-адрес на снимках заменён примером.

3. Создайте сервер

1. Откройте Servers и нажмите Create New.

2. Заполните верхнюю часть формы:

  • Server Name — название сервера в панели; игроки его не видят;
  • Server Owner — начните вводить почту своей учётной записи и выберите её из списка;
  • Node — ваш узел, Default Allocation — порт 2456, в поле Additional Allocation(s) — 2457;
  • Memory — 4096 (в мегабайтах), Disk Space — 10000, Swap — 0, CPU Limit — 0, то есть без ограничения.

3. В блоке «Nest Configuration» выберите гнездо Games и шаблон Valheim BepINex. Образ Docker и команда запуска подставятся сами, менять их не нужно:

4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:

Поле Что вписать
Server Name Название сервера в списке игры
Server Password Пароль для входа — не короче 5 символов. Secret123 на снимке — пример, придумайте свой
World Name Имя мира. Если мира с таким именем ещё нет, сервер создаст новый
Public Server 1 — показывать сервер в общем списке, 0 — вход только по адресу
Enable Crossplay 1 — на сервер смогут зайти и игроки с Xbox и из Microsoft Store. Моды у таких игроков не работают, поэтому для сервера с модами оставьте 0
ModPack Набор модов из каталога Thunderstore, который шаблон поставит сам при установке. Можно оставить пустым и положить моды вручную — см. раздел «Настройки после установки»
Backup Count, Backup Interval, Backup Shorttime, Backup Longtime Как часто сервер сохраняет мир и сколько его резервных копий хранит. Можно не менять: сохранение каждые 30 минут, четыре копии
Auto Update, Beta Branch, Beta Password Оставьте как есть: сервер проверяет обновления при каждом запуске

Остальные поля можно оставить как есть.

5. Нажмите Create Server внизу страницы.

4. Дождитесь установки

Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. При проверке установка заняла меньше минуты: SteamCMD скачивает файлы игры — около 2,4 ГБ, — а шаблон добавляет к ним BepInEx.

Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью. Пока идёт установка, вверху страницы стоит надпись «This server is currently running its installation process and most actions are unavailable».

5. Запустите сервер

Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start. Первый запуск дольше обычного: сервер создаёт мир — при проверке на это ушло две с половиной минуты, следующие запуски занимают полторы. В начале журнала идут строки загрузчика: «BepInEx 5.4.23.6 - valheim_server», затем «Chainloader startup complete» с числом загруженных модов. Сервер готов, когда в консоли появилась строка «Game server connected». На снимке — сервер с одним модом:

Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.

6. Откройте порты в файрволе

Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:

sudo ufw allow 2456/udp
sudo ufw allow 2457/udp

Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.

При проверке сервер, созданный в панели, ответил на запрос снаружи, с другого компьютера: название «ARK-HOSTER Valheim», 10 мест. На запросы он начинает отвечать примерно через полминуты после строки «Game server connected».

7. Зайдите на сервер

В игре откройте список серверов, выберите добавление сервера по адресу и введите IP_СЕРВЕРА:2456, затем пароль. Пошагово со снимками — в статье Как зайти на сервер Valheim.

Игрокам тоже нужны моды. Большинство модов меняют игру и на сервере, и у игрока — тогда каждый игрок ставит себе BepInEx и те же моды тех же версий. Удобнее всего это делать программой управления модами: она ставит моды из каталога Thunderstore в отдельный профиль, а профилем можно поделиться с друзьями. Есть и чисто серверные моды — их игрокам ставить не нужно; это сказано в описании мода.

Настройки после установки

Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.

Моды — файлы .dll в папке BepInEx/plugins. Чтобы поставить мод:

1. Скачайте архив мода на свой компьютер со страницы мода в каталоге thunderstore.io/c/valheim и распакуйте его. Посмотрите на странице, от каких модов он зависит, — их тоже нужно поставить.

2. Остановите сервер. На вкладке Files зайдите в папку BepInEx/plugins и загрузите файлы .dll из архива кнопкой Upload. Если мод лежит в архиве папкой, загрузите папку целиком.

3. Запустите сервер. В начале журнала BepInEx сообщит, сколько модов нашёл и загрузил: «1 plugin to load», «Chainloader startup complete (1 loaded, 0 skipped, 0 failed)».

При проверке так был поставлен мод Server Devcommands: сервер загрузил его и создал файлы его настроек.

Настройки модов появляются в папке BepInEx/config после первого запуска с модом — по файлу .cfg на мод. Меняйте их при остановленном сервере. Там же лежит BepInEx.cfg — настройки самого загрузчика. Подробный журнал загрузки модов — файл BepInEx/LogOutput.log: в нём видно, какой мод не загрузился и почему.

Набор модов одной строкой. В поле «ModPack» на вкладке Startup можно вписать название набора из каталога Thunderstore — в том виде, как оно показано на странице набора в строке «Dependency string». После этого нажмите Reinstall Server на вкладке Settings: шаблон скачает все моды набора в папку BepInEx/plugins, а прежние моды из неё удалит.

Мир лежит в папке .config/unity3d/IronGate/Valheim/worlds_local — её видно на вкладке Files. Чтобы перенести мир, остановите сервер и скачайте из неё файлы с именем вашего мира (.db и .fwl). Перед установкой и обновлением модов делайте копию мира на вкладке Backups: мир, в котором побывали моды с новыми предметами, без этих модов может открыться с потерями.

Кнопка Stop останавливает сервер с сохранением: при проверке на это ушло 20 секунд, файлы мира обновились.

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

При включённом «Auto Update» сервер проверяет обновления игры при каждом запуске. После крупного обновления Valheim моды часто перестают работать, пока их авторы не выпустят новые версии: в журнале BepInEx у таких модов появляются ошибки, а игроки не могут зайти. Обновите моды — замените файлы в BepInEx/plugins новыми версиями. Сам BepInEx обновляет кнопка Reinstall Server.

Если что-то пошло не так

Что видите Причина и решение
В журнале «0 plugins to load» BepInEx работает, но модов не нашёл. Файлы .dll должны лежать в папке BepInEx/plugins или в её подпапках.
В журнале у мода строки «Error» или «skipped» Не поставлен мод, от которого он зависит, либо версия мода не подходит к версии игры. Подробности — в файле BepInEx/LogOutput.log.
Игрока выбрасывает при входе У игрока нет модов сервера или их версии другие. Сверьте наборы модов.
Сервер долго в состоянии «Starting» При первом запуске он создаёт мир. Следите за консолью: когда появится «Game server connected», сервер готов.
Сервер не отвечает на запросы сразу после запуска Он начинает отвечать примерно через полминуты после строки «Game server connected».
При импорте шаблона панель сообщает об ошибке формата Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
В форме создания сервера нет нужного порта Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла.
Установка не заканчивается: надпись об установке висит часами Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/parkervcp/games:valheim, затем на странице сервера откройте Settings и нажмите Reinstall Server.
Сервер запущен, но зайти не удаётся Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт.

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: