Met BepInEx kun je Valheim-servers uitbreiden met mods, als serverbestanden, clientmods en versies netjes op elkaar aansluiten. Doorslaggevend is niet alleen het kopiëren van een DLL, maar een gecontroleerde aanpak: framework installeren, server één keer starten, mods gericht toevoegen, clients gelijktrekken en fouten via logs of stapsgewijs uitschakelen beperken.
Wat BepInEx bij Valheim doet
BepInEx is een mod-framework voor Unity-games. Voor Valheim wordt vaak BepInExPack Valheim gebruikt, dat via Thunderstore wordt aangeboden: documentatie op thunderstore.io. Deze projectpagina is de primaire bron voor het concreet genoemde Valheim-BepInEx-pakket.
BepInEx maakt de mappen aan waarin Valheim-mods worden geladen en geconfigureerd. Veel mods bestaan uit een of meerdere DLL-bestanden die in BepInEx/plugins/ moeten staan. Na de eerste serverstart worden meestal extra configuratiebestanden in BepInEx/config/ aangemaakt. Pas deze bestanden pas aan nadat de server minstens één keer met geïnstalleerd framework is gestart.
Als je naast mods ook serverbasis, configuratie en boss-voortgang netjes wilt plannen, past aanvullend de interne gids Een Valheim-server huren: mods, configuratie & boss-volgorde 2026. Voor andere Unity- of mod-framework-setups is daarnaast de vergelijking met V Rising-mods met BepInEx Server Mods installeren nuttig.
Vereisten
Voordat je begint, heb je toegang nodig tot de Valheim-servermap, de mogelijkheid om de server opnieuw te starten en een duidelijke modlijst. Bij betaalde multi-game-hosting zoals game-serverhosting is het vooral belangrijk dat je wijzigingen traceerbaar doorvoert: eerst back-up, dan framework, dan losse mods, daarna controle. Zo blijven technische controle, supportbaarheid en transparante beheerprocessen behouden.
Leg daarnaast vast welke mods puur server-side draaien en welke elke speler lokaal moet installeren. Veel Valheim-mods hebben passende componenten op server en client nodig; bepalend is de aanduiding op de betreffende modpagina. Controleer daarom voor elke mod de bijbehorende Thunderstore-beschrijving voordat je die in een gezamenlijk modpack opneemt.
BepInEx op de server installeren
- Download BepInEx van Thunderstore.
- Pak de inhoud uit in de Valheim-servermap.
- Start de server opnieuw. BepInEx maakt automatisch de config-mappen aan.
De doelstructuur zou er daarna zo uit moeten zien:
/valheim/
├── BepInEx/
│ ├── config/ # Mod-configuraties
│ ├── plugins/ # Mods hier plaatsen
│ └── patchers/
├── valheim_server.x86_64
└── start_server.sh
Belangrijk is het niveau: de map BepInEx/ hoort direct in de Valheim-servermap, niet in een extra submap uit het ZIP-archief. Als er na de herstart geen config- of plugins-structuur ontstaat, zit de fout vaak precies daar.
Mods installeren
- Download mods van Thunderstore.
- Pak het DLL-bestand uit naar de map
BepInEx/plugins/. - Start de server opnieuw.
Installeer nieuwe mods niet blind in grote pakketten. Zinvoller is een gecontroleerde aanpak: één mod toevoegen, server starten, log controleren, verbinding testen en pas daarna de volgende mod installeren. Bij meerdere spelers moet je de modlijst met versienummers documenteren, zodat iedereen dezelfde basis gebruikt.
Als een mod extra bestanden of eigen mappen meelevert, volg dan de instructies van die mod. Niet elke mod bestaat alleen uit één losse DLL. Verplaats configuratiebestanden niet willekeurig tussen plugins en config; BepInEx en de mod zelf verwachten specifieke paden.
Clientmods gelijktrekken
De meeste Valheim-mods moeten zowel op de server als op de client geïnstalleerd zijn. Gebruik de Thunderstore Mod Manager voor eenvoudige clientinstallatie.
Als alternatief kun je r2modman gebruiken:
- Installeer r2modman.
- Kies "Valheim" als game.
- Zoek en installeer mods met één klik.
- Exporteer je modpack als code → deel met vrienden.
Het praktische voordeel van een modmanager zit in de afstemming: alle spelers kunnen hetzelfde profiel gebruiken in plaats van DLLs handmatig bij elkaar te zoeken. Toch moet je na updates voorzichtig blijven. Een bijgewerkte clientmod kan incompatibel zijn met een oudere servermod. Leg daarom vast wanneer je het modpack hebt gewijzigd en welke versies actief zijn.
Aanbevolen mods
De volgende tabel toont veelgebruikte voorbeelden; controleer elke mod vóór installatie op actualiteit en afhankelijkheden. Dit is geen prestatiebelofte en vervangt niet de controle van de betreffende modpagina op compatibiliteit, actualiteit en benodigde afhankelijkheden.
| Mod | Beschrijving | Client nodig? |
|---|---|---|
| ValheimPlus | Uitgebreide aanpassingen | Ja |
| Better UI | Verbeterde gebruikersinterface | Ja |
| Plant Everything | Overal planten | Ja |
| Epic Loot | Zeldzame items met eigenschappen | Ja |
| Better Wards | Verbeterde beschermstenen | Ja |
Resultaat controleren
Na de installatie zou de server zonder crash moeten starten. Controleer eerst of BepInEx in het log wordt geladen en of er foutmeldingen over ontbrekende afhankelijkheden, verkeerde versies of niet gevonden DLLs verschijnen. Daarna test je met een client die dezelfde modselectie gebruikt.
In de game moet je gericht één functie van elke geïnstalleerde mod controleren: UI-wijziging zichtbaar, nieuwe configuratieoptie actief, nieuw item aanwezig of verwacht gedrag actief. Als alles werkt, sla dan de werkende modlijst en de belangrijkste config-bestanden op. Zo kun je latere wijzigingen volgen of bij problemen terugrollen.
Troubleshooting
Mod werkt niet
Controleer eerst BepInEx-versie, modversie en modcompatibiliteit. Controleer ook of de DLL echt in BepInEx/plugins/ staat en niet per ongeluk in een dubbel uitgepakte submap. Lees de modpagina op Thunderstore, omdat veel mods extra afhankelijkheden nodig hebben.
Server crashed
Verwijder mods één voor één om de veroorzaker te vinden. Begin met de laatst geïnstalleerde of laatst bijgewerkte mod. Start de server na elke wijziging opnieuw en controleer het log. Als de server zonder mods start, maar met een bepaalde mod crasht, is meestal een afhankelijkheid, versie of configuratie de oorzaak.
Desync of verbindingsproblemen
Zorg ervoor dat alle spelers dezelfde mods in passende versies hebben. Vooral bij mods die op de client vereist zijn, is het niet genoeg om alleen de server aan te passen. Een geëxporteerd r2modman- of Thunderstore-profiel vermindert afwijkingen en maakt supportgevallen makkelijker te herleiden.
Config wordt niet aangemaakt
Start de server één keer met geïnstalleerde BepInEx en de betreffende mod. Veel mods schrijven hun config pas bij de eerste succesvolle laadactie. Als er daarna geen bestand verschijnt, is de mod mogelijk niet geladen, staat hij in de verkeerde map of is hij niet compatibel met de huidige omgeving.
Controle, grenzen en veilige terugweg
De handleiding „Valheim-mods met BepInEx installeren – stap voor stap“ geldt voor het in het artikel beschreven servertype en de versiestand die op het moment van controle zichtbaar was. Menunamen, beschikbare versies, mod- of plugincompatibiliteit en benodigde resources kunnen na updates afwijken. Neem waarden daarom niet ongecontroleerd over naar een andere game-, loader- of serverversie.
Maak vóór wijzigingen aan wereld, savegame, configuratie of uitbreidingen een back-up van de betreffende bestanden. Wijzig daarna slechts één samenhangende stap en controleer die met dezelfde client- en serverversie waarmee je later wilt spelen.
| Controlepunt | Verwacht resultaat | Afbreken en terugweg |
|---|---|---|
| Serverstart | De server bereikt zonder nieuwe foutmelding de bedrijfsklare status. | Bij startfouten wijziging terugdraaien en de laatste back-up terugzetten. |
| Verbindingstest | Een testaccount kan verbinden via het adres dat in het panel wordt getoond. | Bij versie- of verbindingsfouten versie, poort en vrijgaven opnieuw afstemmen. |
| Functietest | De concreet gewijzigde functie werkt zonder bestaande wereld- of gamegegevens te beschadigen. | Bij neveneffecten server stoppen en opgeslagen bestanden herstellen. |
Een succesvolle losse test is geen garantie voor prestaties of beschikbaarheid. Wereldgrootte, mods, plugins, spelersaantal, netwerkroute en gelijktijdige belasting kunnen het resultaat veranderen. Documenteer versie, wijziging en testresultaat, zodat je latere afwijkingen kunt herleiden.
FAQ
Moet BepInEx op server en client geïnstalleerd zijn?
Voor veel Valheim-mods wel. Als een mod verplicht is op de client, hebben server en spelers dezelfde of een compatibele versie nodig. Controleer dat altijd op de betreffende modpagina.
Kan ik Valheim-mods alleen via Thunderstore installeren?
Nee, je kunt DLLs ook handmatig in BepInEx/plugins/ plaatsen. Thunderstore Mod Manager en r2modman maken versieafstemming en distributie naar medespelers wel makkelijker.
Waarom start mijn server na een mod niet meer?
Veelvoorkomende oorzaken zijn verkeerde BepInEx-versies, ontbrekende afhankelijkheden, incompatibele modversies of bestanden in de verkeerde map. Verwijder mods stap voor stap en controleer na elke herstart het log.
Waar staan de configuraties van de mods?
Veel BepInEx-mods maken hun configuratie aan in BepInEx/config/. De bestanden verschijnen vaak pas na de eerste succesvolle serverstart met geïnstalleerde mod.
Moet ik alle mods tegelijk installeren?
Beter van niet. Installeer mods één voor één of in kleine groepen, zodat je fouten duidelijk kunt toewijzen. Dat bespaart tijd als de server crasht of clients niet kunnen verbinden.