Dzięki BepInEx możesz rozszerzyć serwer Valheim o mody, jeśli pliki serwera, mody klienta i wersje są ze sobą dobrze dopasowane. Kluczowe nie jest samo skopiowanie DLL, lecz kontrolowany przebieg: zainstalować framework, uruchomić serwer raz, dodać konkretne mody, dopasować klientów i zawęzić błędy przez logi albo stopniowe wyłączanie.
Co BepInEx robi w Valheim
BepInEx to framework modów dla gier Unity. W przypadku Valheim często używa się BepInExPack Valheim, udostępnianego na Thunderstore: dokumentacja na thunderstore.io. Ta strona projektu jest głównym źródłem dla konkretnie wymienionego pakietu Valheim-BepInEx.
BepInEx tworzy foldery, w których ładowane i konfigurowane są mody Valheim. Wiele modów składa się z jednego lub kilku plików DLL, które muszą znajdować się w BepInEx/plugins/. Po pierwszym uruchomieniu serwera zwykle powstają dodatkowe pliki konfiguracyjne w BepInEx/config/. Zmieniaj te pliki dopiero wtedy, gdy serwer został uruchomiony przynajmniej raz z zainstalowanym frameworkiem.
Jeśli oprócz modów chcesz też dobrze zaplanować podstawy serwera, konfigurację i postęp bossów, pasuje do tego wewnętrzny poradnik Wynajem serwera Valheim: mody, konfiguracja i kolejność bossów 2026. Przy innych konfiguracjach Unity albo frameworków modów przydatne jest też porównanie z Instalacja modów V Rising z BepInEx Server Mods.
Wymagania
Zanim zaczniesz, potrzebujesz dostępu do katalogu serwera Valheim, możliwości restartu serwera i jasnej listy modów. Przy płatnym hostingu multi-game, takim jak game-serverhosting, szczególnie ważne jest, żeby wprowadzać zmiany w sposób możliwy do prześledzenia: najpierw backup, potem framework, potem pojedyncze mody, a następnie kontrola. Dzięki temu zachowujesz kontrolę techniczną, możliwość wsparcia i przejrzysty przebieg działania.
Ustal też, które mody działają wyłącznie po stronie serwera, a które każdy gracz musi zainstalować lokalnie. Wiele modów Valheim wymaga pasujących komponentów na serwerze i kliencie; decydujące jest oznaczenie na stronie danego moda. Dlatego sprawdź opis każdego moda na Thunderstore, zanim dodasz go do wspólnego modpacka.
Instalacja BepInEx na serwerze
- Pobierz BepInEx z Thunderstore.
- Rozpakuj zawartość do katalogu serwera Valheim.
- Uruchom serwer ponownie. BepInEx automatycznie utworzy foldery konfiguracyjne.
Docelowa struktura powinna potem wyglądać tak:
/valheim/
├── BepInEx/
│ ├── config/ # Konfiguracje modów
│ ├── plugins/ # Tutaj umieszczaj mody
│ └── patchers/
├── valheim_server.x86_64
└── start_server.sh
Ważny jest poziom folderów: folder BepInEx/ należy bezpośrednio do katalogu serwera Valheim, a nie do dodatkowego podfolderu z archiwum ZIP. Jeśli po restarcie nie powstaje struktura config ani plugins, błąd często leży właśnie tam.
Instalacja modów
- Pobierz mody z Thunderstore.
- Rozpakuj plik DLL do folderu
BepInEx/plugins/. - Uruchom serwer ponownie.
Nie instaluj nowych modów na ślepo w dużych paczkach. Rozsądniejsze jest kontrolowane podejście: dodać jeden mod, uruchomić serwer, sprawdzić log, przetestować połączenie i dopiero potem wgrać kolejny mod. Przy kilku graczach warto dokumentować listę modów wraz z numerami wersji, żeby wszyscy używali tej samej podstawy.
Jeśli mod zawiera dodatkowe pliki albo własne foldery, postępuj zgodnie z instrukcją danego moda. Nie każdy mod składa się tylko z pojedynczego DLL. Nie przenoś plików konfiguracyjnych dowolnie między plugins i config; BepInEx oraz sam mod oczekują określonych ścieżek.
Dopasowanie modów klienta
Większość modów Valheim musi być zainstalowana zarówno na serwerze, jak i na kliencie. Użyj Thunderstore Mod Manager, żeby łatwo zainstalować je po stronie klienta.
Alternatywnie możesz użyć r2modman:
- Zainstaluj r2modman.
- Wybierz "Valheim" jako grę.
- Przeglądaj i instaluj mody jednym kliknięciem.
- Wyeksportuj swój modpack jako kod → udostępnij znajomym.
Praktyczna zaleta menedżera modów leży w dopasowaniu: wszyscy gracze mogą używać tego samego profilu, zamiast ręcznie szukać DLL. Mimo to po aktualizacjach zachowaj ostrożność. Zaktualizowany mod klienta może być niekompatybilny ze starszym modem serwera. Zapisuj więc, kiedy zmieniłeś modpack i które wersje są aktywne.
Polecane mody
Poniższa tabela pokazuje popularne przykłady; przed instalacją sprawdź każdy mod pod kątem aktualności i zależności. To nie jest obietnica wydajności i nie zastępuje sprawdzenia strony danego moda pod kątem kompatybilności, aktualności i wymaganych zależności.
| Mod | Opis | Wymagany klient? |
|---|---|---|
| ValheimPlus | Rozbudowane ustawienia | Tak |
| Better UI | Ulepszony interfejs użytkownika | Tak |
| Plant Everything | Sadzenie wszędzie | Tak |
| Epic Loot | Rzadkie przedmioty z właściwościami | Tak |
| Better Wards | Ulepszone kamienie ochronne | Tak |
Sprawdzenie wyniku
Po instalacji serwer powinien uruchomić się bez awarii. Najpierw sprawdź, czy BepInEx ładuje się w logu i czy pojawiają się komunikaty o brakujących zależnościach, błędnych wersjach albo nieznalezionych plikach DLL. Następnie testujesz klientem, który używa tego samego zestawu modów.
W grze celowo sprawdź jedną funkcję każdego zainstalowanego moda: widoczną zmianę UI, działającą nową opcję konfiguracji, obecność nowego przedmiotu albo aktywne oczekiwane zachowanie. Jeśli wszystko działa, zapisz działającą listę modów i najważniejsze pliki config. Dzięki temu możesz późniejsze zmiany odtworzyć albo cofnąć w razie problemów.
Troubleshooting
Mod nie działa
Najpierw sprawdź wersję BepInEx, wersję moda i kompatybilność moda. Skontroluj też, czy DLL naprawdę leży w BepInEx/plugins/, a nie przypadkiem w podwójnie rozpakowanym podfolderze. Przeczytaj stronę moda na Thunderstore, ponieważ wiele modów wymaga dodatkowych zależności.
Serwer się crashuje
Usuwaj mody pojedynczo, żeby znaleźć przyczynę. Zacznij od ostatnio zainstalowanego albo ostatnio zaktualizowanego moda. Po każdej zmianie uruchom serwer ponownie i sprawdź log. Jeśli serwer startuje bez modów, ale crashuje z konkretnym modem, przyczyną najczęściej jest zależność, wersja albo konfiguracja.
Desync albo problemy z połączeniem
Upewnij się, że wszyscy gracze mają te same mody w pasujących wersjach. Zwłaszcza przy modach wymaganych po stronie klienta nie wystarczy zmienić tylko serwera. Wyeksportowany profil r2modman albo Thunderstore ogranicza różnice i ułatwia analizę zgłoszeń supportowych.
Config nie jest tworzony
Uruchom serwer raz z zainstalowanym BepInEx i danym modem. Wiele modów zapisuje swój config dopiero przy pierwszym udanym załadowaniu. Jeśli potem plik się nie pojawia, mod mógł nie zostać załadowany, leży w złym folderze albo nie jest kompatybilny z aktualnym środowiskiem.
Kontrola, ograniczenia i bezpieczny powrót
Instrukcja „Instalacja modów Valheim z BepInEx – krok po kroku” dotyczy typu serwera opisanego w artykule oraz wersji widocznej w momencie sprawdzania. Nazwy menu, dostępne wersje, kompatybilność modów lub pluginów i wymagane zasoby mogą się różnić po aktualizacjach. Dlatego nie przenoś żadnych wartości bez sprawdzenia na inną wersję gry, loadera albo serwera.
Przed zmianami w świecie, zapisie gry, konfiguracji albo rozszerzeniach utwórz backup odpowiednich plików. Następnie zmieniaj tylko jeden powiązany krok naraz i sprawdź go z tą samą wersją klienta i serwera, z którą później chcesz grać.
| Punkt kontroli | Oczekiwany wynik | Przerwanie i powrót |
|---|---|---|
| Start serwera | Serwer osiąga stan gotowości bez nowego komunikatu o błędzie. | Przy błędach startu cofnij zmianę i wgraj ostatni backup. |
| Test połączenia | Konto testowe może połączyć się przez adres pokazany w panelu. | Przy błędach wersji albo połączenia ponownie porównaj wersję, port i reguły dostępu. |
| Test funkcji | Konkretnie zmieniona funkcja działa bez uszkadzania istniejącego świata albo danych gry. | Przy skutkach ubocznych zatrzymaj serwer i przywróć zabezpieczone pliki. |
Udany pojedynczy test nie jest gwarancją wydajności ani dostępności. Rozmiar świata, mody, pluginy, liczba graczy, trasa sieciowa i jednoczesne obciążenie mogą zmienić wynik. Dokumentuj wersję, zmianę i wynik testu, żeby później rozumieć odchylenia.
FAQ
Czy BepInEx musi być zainstalowany na serwerze i kliencie?
Dla wielu modów Valheim tak. Jeśli mod jest wymagany po stronie klienta, serwer i gracze potrzebują tej samej albo kompatybilnej wersji. Zawsze sprawdzaj to na stronie danego moda.
Czy mogę instalować mody Valheim tylko przez Thunderstore?
Nie, możesz też ręcznie umieszczać DLL w BepInEx/plugins/. Thunderstore Mod Manager i r2modman ułatwiają jednak dopasowanie wersji oraz dystrybucję wśród współgraczy.
Dlaczego mój serwer nie startuje po dodaniu moda?
Częste przyczyny to błędne wersje BepInEx, brakujące zależności, niekompatybilne wersje modów albo pliki w złym folderze. Usuwaj mody krok po kroku i po każdym restarcie sprawdzaj log.
Gdzie znajdują się konfiguracje modów?
Wiele modów BepInEx tworzy swoją konfigurację w BepInEx/config/. Pliki często pojawiają się dopiero po pierwszym udanym starcie serwera z zainstalowanym modem.
Czy powinienem instalować wszystkie mody jednocześnie?
Lepiej nie. Instaluj mody po kolei albo w małych grupach, żeby móc jednoznacznie przypisać błędy. To oszczędza czas, gdy serwer crashuje albo klienci nie mogą się połączyć.