Mody na serwerze Valheim: BepInEx krok po kroku

W skrócie: mody do Valheim działają dzięki pakietowi BepInExPack_Valheim autorstwa denikson z Thunderstore, czyli wersji BepInEx 5 wstępnie skonfigurowanej pod Valheim. Aktualna wersja 5.4.2351 ukazała się 24 września 2026 roku, a więc po premierze Valheim 1.0. Na serwerze dedykowanym kopiuje się zawartość folderu BepInExPack_Valheim do katalogu z plikiem valheim_server.x86_64 i uruchamia serwer skryptem start_server_bepinex.sh albo ze zmiennymi Doorstop z tego skryptu. Pliki .dll modów trafiają do BepInEx/plugins. W grze wieloosobowej wszyscy gracze potrzebują tych samych modów, a serwer z modami działa bez crossplayu, czyli tylko dla graczy PC.

Własny serwer Valheim? W HostValues od €5,60 miesięcznie, online w kilka minut. Zobacz plany →

Serwer działa w HostValues? Jak włączyć mody na serwerze Valheim w HostValues opcją BepInEx mods w zakładce Startup, opisano niżej w części o HostValues.

Najpierw: Valheim 1.0 a mody

• Brak oficjalnego wsparcia modów. Według FAQ Iron Gate do wersji 1.0 gra nie ma oficjalnego wsparcia modów. Nie ma więc gwarancji, że mody będą działać, a po aktualizacjach gry ich dostosowanie zawsze trochę trwa. Nie ma Steam Workshop, a na konsolach mody nie są obsługiwane.
• Pakiet jest gotowy na 1.0. Wersja 5.4.2350 ukazała się 9 września 2026 roku, w dniu premiery Valheim 1.0, a wersja 5.4.2351 24 września 2026 roku. Thunderstore umieszcza pakiet w kategorii Deep North Update. Najnowszy patch Valheim to 1.0.20 z 15 października 2026 roku; do 16 października 2026 roku nie pojawił się nowszy. Przy każdym modzie warto też sprawdzić datę ostatniej wersji.
• Najpierw kopia zapasowa. Valheim 1.0 ma nowy system zapisu, który dzieli dane świata na wiele części (chunków). Przed każdą zmianą modów należy zabezpieczyć cały świat, najprościej kopią zapasową w panelu gry.

BepInEx Valheim: co zawiera BepInExPack_Valheim

Pakiet pobiera się przyciskiem pobierania na stronie Thunderstore i rozpakowuje na własnym komputerze, nie bezpośrednio w folderze gry lub serwera. W folderze BepInExPack_Valheim znajdują się:

• BepInEx/core z samym loaderem oraz BepInEx/config/BepInEx.cfg z podstawową konfiguracją,
• winhttp.dll i doorstop_config.ini, które ładują BepInEx w systemie Windows,
• doorstop_libs z bibliotekami dla Linuksa i macOS,
• start_server_bepinex.sh i start_game_bepinex.sh, czyli skrypty startowe dla Linuksa.

Folderu plugins w pobranym archiwum jeszcze nie ma. Według opisu pakiet zawiera gotowy plik BepInEx.cfg z właściwym punktem wejścia dla modów Valheim oraz skrypty dla Linuksa. Dlatego warto używać tego pakietu, a nie ogólnego wydania BepInEx z GitHuba.

Instalacja na własnym serwerze z Linuksem

1. Zatrzymać serwer i zrobić kopię zapasową.
2. Skopiować zawartość BepInExPack_Valheim (nie sam folder) do katalogu serwera, w którym leży valheim_server.x86_64. Ścieżki w skrypcie startowym są względne, więc BepInEx, doorstop_libs i skrypt muszą leżeć bezpośrednio obok.
3. Nadać skryptowi prawo do uruchamiania: chmod u+x start_server_bepinex.sh.
4. W ostatniej linii skryptu ustawić -name, -port, -world i -password, tak jak w zwykłym skrypcie startowym Valheim. Hasło musi mieć co najmniej pięć znaków i nie może występować w nazwie serwera.
5. Uruchomić serwer poleceniem ./start_server_bepinex.sh. Jeśli wszystko działa, w terminalu pojawiają się komunikaty startowe BepInEx, a BepInEx tworzy plik dziennika BepInEx/LogOutput.log.

Jeśli panel lub własny skrypt uruchamia valheim_server.x86_64 bezpośrednio, BepInEx się nie załaduje. Przed startem muszą być wtedy ustawione te zmienne środowiskowe ze skryptu start_server_bepinex.sh:

• export DOORSTOP_ENABLED=1
• export DOORSTOP_TARGET_ASSEMBLY=./BepInEx/core/BepInEx.Preloader.dll
• export LD_LIBRARY_PATH="./doorstop_libs:$LD_LIBRARY_PATH"
• export LD_PRELOAD="libdoorstop_x64.so:$LD_PRELOAD"

Skrypt z pakietu uruchamia serwer bez argumentu -crossplay. Według Iron Gate serwer bez tego argumentu korzysta z backendu Steam i tylko użytkownicy Steam go widzą i mogą do niego dołączyć.

Instalacja w HostValues

Na serwerze Valheim w HostValues postępuje się tak, jak opisano na stronie produktu:

1. Zatrzymać serwer w panelu gry i utworzyć kopię zapasową.
2. Wgrać zawartość BepInExPack_Valheim przez SFTP lub menedżer plików do katalogu, w którym leży valheim_server.x86_64, a mody do BepInEx/plugins.
3. Otworzyć w panelu gry zakładkę Startup i ustawić opcję BepInEx mods na 1.
4. Opcję Crossplay zostawić na 0. Domyślnie jest wyłączona, a przy włączonym crossplayu mody BepInEx nie są obsługiwane.
5. Zrestartować serwer i sprawdzić, czy powstał plik BepInEx/LogOutput.log.

Warto pamiętać, że serwer przy każdym restarcie instaluje najnowszą wersję Valheim. Po patchu gry należy więc najpierw sprawdzić, czy BepInExPack_Valheim i mody zostały już zaktualizowane.

Instalacja modów: plugins, zależności i konfiguracja

• Mody: plik .dll moda trafia do folderu BepInEx/plugins; tak opisuje to również dokumentacja BepInEx. Jeśli folderu nie ma, trzeba go utworzyć. Gdy mod zawiera własny folder z dodatkowymi plikami, wgrywa się cały folder do plugins.
• Zależności: na stronie moda w Thunderstore w sekcji Required widać, jakich innych pakietów potrzebuje, na przykład biblioteki Jötunn (the Valheim Library). Te pakiety również trzeba zainstalować. Sam BepInExPack_Valheim jest już wtedy na serwerze.
• Konfiguracja: po pierwszym starcie z danym modem jego plik konfiguracyjny pojawia się w BepInEx/config. Według dokumentacji BepInEx nazwa pliku odpowiada GUID pluginu. Plik edytuje się przy zatrzymanym serwerze, a potem uruchamia serwer ponownie.

Mody najlepiej dodawać pojedynczo i po każdym restartować serwer. Wtedy od razu widać, który mod sprawia problemy.

Serwer, klient czy obie strony?

Nie każdy mod musi być zainstalowany wszędzie. Thunderstore ma dla Valheim kategorie Server-side i Client-side, ale rozstrzyga zawsze opis moda.

W razie wątpliwości obowiązuje prosta zasada ze strony produktu: wszyscy gracze muszą mieć te same mody co serwer.

Gracze: menedżer modów

Instrukcja pakietu zaleca do gry menedżer modów: Gale, Thunderstore Mod Manager lub r2modman. Na stronie pakietu w Thunderstore klika się przycisk instalacji (Install with App), a Valheim uruchamia się potem zawsze przez menedżer. r2modman pracuje na profilach i potrafi wyeksportować profil, także w postaci kodu, więc pozostali gracze dostają te same mody i konfiguracje.

Przy instalacji ręcznej zawartość BepInExPack_Valheim kopiuje się do folderu gry steamapps\common\Valheim. W Windows według instrukcji pakietu nic więcej nie trzeba. W Linuksie należy nadać plikowi start_game_bepinex.sh prawo do uruchamiania i wpisać w Steam opcję uruchamiania ./start_game_bepinex.sh %command%.

Crossplay a mody

Mody i crossplay się wykluczają. Iron Gate nie obsługuje modów na konsolach, a przy włączonym crossplayu mody BepInEx nie są obsługiwane. Na serwerze z modami Crossplay zostaje więc na 0 i dołączać mogą tylko gracze PC przez Steam. Łączą się oni adresem IP i portem z panelu oraz hasłem serwera.

Rozwiązywanie problemów

• Brak LogOutput.log: BepInEx się nie uruchamia, najczęściej dlatego, że Doorstop nie jest aktywny. Należy sprawdzić, czy BepInEx, doorstop_libs i pozostałe pliki leżą bezpośrednio obok valheim_server.x86_64 oraz czy serwer startuje przez skrypt, ze zmiennymi Doorstop albo w HostValues z opcją BepInEx mods ustawioną na 1.
• Mod się nie ładuje: w BepInEx/LogOutput.log każdy załadowany mod ma linię w rodzaju Loading [Nazwa 1.0.0] z GUID. Od wersji pakietu 5.4.2351 linia Chainloader startup complete kończy się liczbą modów załadowanych, pominiętych i nieudanych.
• Awaria po aktualizacji: najpierw zaktualizować BepInExPack_Valheim, potem biblioteki takie jak Jötunn, a na końcu pozostałe mody. Mody bez aktualizacji do 1.0 usuwa się po kolei, aż serwer znowu wystartuje.
• Gracze nie mogą się połączyć: zwykle brakuje jakiegoś moda albo różnią się wersje. Warto porównać listę modów gracza z listą na serwerze.

Serwer nie jest jeszcze skonfigurowany? Pomoże artykuł Serwer dedykowany Valheim: konfiguracja krok po kroku. Zmiany w wersji 1.0 opisuje tekst Serwer Valheim 1.0, a komendy administratora zebrano w artykule Komendy Valheim.

Najczęściej zadawane pytania

Jaki BepInEx jest potrzebny do Valheim 1.0?

BepInExPack_Valheim autorstwa denikson z Thunderstore, obecnie w wersji 5.4.2351 z 24 września 2026 roku, oparty na BepInEx 5.4.23.5. Ogólne wydanie BepInEx nie jest wstępnie skonfigurowane pod Valheim.

Gdzie umieścić mody na serwerze Valheim?

Pliki modów trafiają do BepInEx/plugins w katalogu serwera. Pliki konfiguracyjne powstają po pierwszym starcie w BepInEx/config.

Czy wszyscy gracze muszą zainstalować BepInEx?

Tak, jeśli którykolwiek mod musi działać także po stronie klienta. Wtedy wszyscy gracze potrzebują BepInEx i tych samych wersji modów co serwer. Najprościej zrobić to menedżerem modów ze wspólnym profilem.

Czy gracze na konsolach mogą dołączyć do serwera z modami?

Nie. Iron Gate nie obsługuje modów na konsolach, a bez crossplayu dołączać mogą tylko gracze PC przez Steam.

Czy Valheim Plus nadal działa?

Oryginalny pakiet ValheimPlus jest na Thunderstore oznaczony jako przestarzały (deprecated). Jego ostatnia wersja 9.9.11 pochodzi z 7 grudnia 2022 roku, czyli z czasów długo przed Valheim 1.0, a Thunderstore zaleca poszukanie alternatywy.

Źródła: Thunderstore (BepInExPack_Valheim, changelog, wersje, Jötunn, r2modman, ValheimPlus); dokumentacja BepInEx (instalacja, konfiguracja, rozwiązywanie problemów, folder plugins); Iron Gate (Valheim 1.0 FAQ, A Guide to Dedicated Servers); notatki do patchy na Steam (Valheim 1.0, patch 1.0.20). Stan na 16 października 2026 roku.