Valheim-mods installeren met BepInEx, ook op je server

Valheim-mods installeer je met BepInEx, het modframework waar bijna alle Valheim-mods op draaien. Op je pc gaat dat het makkelijkst met een modmanager zoals r2modman; met de hand zet je de BepInExPack in je Valheim-map en je mods in de map BepInEx/plugins. Op een server werkt het op dezelfde manier. Eén ding vooraf: op een console kun je geen mods installeren. Speel je met vrienden op Xbox, PlayStation 5 of Switch 2, dan speel je dus vrijwel altijd zonder mods.

Hieronder lees je hoe je mods op je pc en op je server zet, welke mods waar moeten staan en wat je doet als Valheim na een update niet meer start. Heb je nog geen server, dan kun je bij ons een Valheim-server huren met een schakelaar voor BepInEx.

Wat is BepInEx?

BepInEx is een gratis framework dat mods laadt in games die met Unity zijn gemaakt, zoals Valheim. Voor Valheim gebruik je de BepInExPack Valheim van Thunderstore: een pakket dat al is ingesteld voor deze game, en dat sinds 9 september 2026 ook voor Valheim 1.0 is bijgewerkt. Bijna elke Valheim-mod op Thunderstore en Nexus Mods heeft het nodig.

Iron Gate, de maker van Valheim, ondersteunt mods niet officieel: je gebruikt ze op eigen risico, en na een update van de game werken ze niet altijd meteen. Een back-up van je wereld is dus altijd verstandig.

Mods installeren op je pc

Met een modmanager

1. Installeer een modmanager zoals r2modman of de Thunderstore Mod Manager, en kies Valheim als game.
2. Maak een profiel, bijvoorbeeld met de naam van je groep of server.
3. Installeer je mods. Zoek ze op in de lijst en klik op installeren. De modmanager zet de BepInExPack en andere mods die nodig zijn er vanzelf bij.
4. Start Valheim met Start modded. Met Start vanilla speel je zonder mods.

In r2modman exporteer je een profiel als code of als bestand, met je mods en hun instellingen. Zo heeft iedereen in je groep in één keer precies dezelfde mods en versies.

Met de hand

1. Download de BepInExPack Valheim van Thunderstore en pak hem uit buiten je Valheim-map.
2. Kopieer de inhoud van de map BepInExPack_Valheim naar je Valheim-map. In Steam vind je die via een rechtsklik op Valheim, Beheren en Lokale bestanden bekijken. Daar staan dan onder meer de map BepInEx en het bestand winhttp.dll.
3. Start Valheim één keer en sluit het weer af. BepInEx maakt dan zijn mappen aan.
4. Zet je mods in BepInEx/plugins: meestal een .dll-bestand per mod, soms een eigen map. Na de volgende start staan de instellingen van elke mod in BepInEx/config.

Mods op je Valheim-server

Een server laadt BepInEx op dezelfde manier: de BepInExPack in de servermap, de mods in BepInEx/plugins en de instellingen in BepInEx/config. Bij ons gaat dat zo:

1. Maak een back-up van je wereld. Hoe dat gaat, lees je in Een back-up maken en terugzetten.
2. Zet BepInEx aan in het tabblad Startup van het gamepanel, met de schakelaar BepInEx mods. Crossplay gaat dan uit: op onze servers kies je een van de twee.
3. Upload de BepInExPack: de inhoud van de map BepInExPack_Valheim naar de hoofdmap van je server, via het bestandsbeheer of SFTP. Hoe SFTP werkt, lees je in Bestanden beheren met SFTP.
4. Zet je mods in BepInEx/plugins op de server en herstart hem. In de console zie je welke mods BepInEx laadt.
5. Pas instellingen aan in BepInEx/config. Stop de server eerst en start hem daarna weer.

Met mods heeft je server meer werkgeheugen nodig dan zonder. Voor een vriendengroep zonder mods is 4 GB genoeg; met een flinke lijst mods kies je 6 of 8 GB.

Welke mods moeten waar staan?

• Op de server en bij elke speler: mods die nieuwe voorwerpen, gebouwen, recepten of vijanden toevoegen, zoals Epic Loot of Valheim Plus. Die horen meestal aan beide kanten, en het liefst in dezelfde versie. Veel van zulke mods weigeren spelers die de mod niet hebben of een andere versie gebruiken.
• Alleen bij de speler: mods die alleen je eigen scherm veranderen, zoals een andere weergave van je inventaris of de kaart. Die hoeven niet op de server.
• Alleen op de server: een kleiner aantal mods die de server zelf regelen. Spelers hoeven daarvoor niets te installeren.

Twijfel je, lees dan de beschrijving van de mod: daar staat meestal of hij op de server, bij de spelers of op allebei moet. Het veiligst is één gedeeld profiel voor de hele groep, met dezelfde mods op de server.

Mods of crossplay?

Sinds Valheim 1.0, op 9 september 2026, spelen pc, Mac, Linux, Xbox, PlayStation 5 en Nintendo Switch 2 samen. Volgens Iron Gate zijn er op consoles geen mods. Met consolevrienden kan dus hooguit een server met mods die alleen op de server draaien, en ook dan werken veel mods niet met crossplay. Modmakers raden daarom aan om crossplay uit te laten als je met mods speelt.

Op onze servers kies je in het tabblad Startup: crossplay met je consolevrienden, of BepInEx voor een groep die op pc speelt. Allebei tegelijk kan niet. Hoe crossplay werkt, lees je in Valheim-crossplay: pc, Xbox, PlayStation en Switch 2 samen.

Valheim start niet meer na een update

Na een grote update, zoals 1.0, werken veel mods een tijd niet. Het spel start dan niet, of het crasht bij het laden van je wereld. Iron Gate raadde bij eerdere grote updates aan om mods vooraf uit te zetten, een paar dagen te wachten op nieuwe versies en eerst back-ups te maken. Zo vind je de oorzaak:

• Start zonder mods: in r2modman met Start vanilla, of haal bij een installatie met de hand het bestand winhttp.dll tijdelijk uit je Valheim-map. Werkt het dan wel, dan ligt het aan een mod.
• Werk alles bij: eerst de BepInExPack, dan je mods, zodra de makers een versie voor de nieuwe update uitbrengen.
• Zoek de boosdoener: haal mods een voor een weg tot het weer werkt. De foutmelding staat vaak in BepInEx/LogOutput.log.
• Op je server: haal de mods tijdelijk uit BepInEx/plugins of zet BepInEx uit in het tabblad Startup. Je wereld blijft gewoon staan.
• Zet een back-up terug als een mod je wereld heeft veranderd. Sinds 1.0 staat elke wereld in een eigen map in worlds_local; kopieer altijd die hele map.