BepInEx en mods installeren op je Valheim server

BepInEx is het modframework voor Valheim. Zonder BepInEx kun je geen mods laden op je server. In deze handleiding leer je hoe je BepInEx installeert, mods toevoegt en het verschil tussen server-side en client-side mods.

Stap 1: BepInEx downloaden

1. Ga naar de BepInEx-pagina op Thunderstore of GitHub.
2. Download de BepInExPack Valheim (let op: gebruik de Valheim-specifieke versie, niet de generieke BepInEx).
3. Pak het archief uit op je computer.

Stap 2: BepInEx installeren op de server

1. Verbind via SFTP met je Valheim-server.
2. Upload de inhoud van het BepInEx-archief naar de hoofdmap van je server (waar valheim_server.x86_64 staat).
3. Controleer dat de mappenstructuur correct is: BepInEx/ moet in de hoofdmap staan, met daarin submappen als plugins, config en patchers.
4. Start de server opnieuw op. BepInEx wordt automatisch geladen.

Stap 3: Mods installeren

1. Download mods van Thunderstore (thunderstore.io). Zorg dat de mod compatibel is met je Valheim-versie.
2. Upload de mod .dll-bestanden naar de map BepInEx/plugins/ op je server.
3. Herstart de server. De mods worden automatisch geladen en configuratiebestanden verschijnen in BepInEx/config/.

Server-side vs client-side mods

Dit onderscheid is belangrijk:

• Server-side mods: deze hoeven alleen op de server geinstalleerd te worden. Voorbeelden: spawn-aanpassingen, loot-tabellen, servertools. Spelers hoeven niets extra te installeren.
• Client-side mods: deze moeten zowel op de server als bij elke speler geinstalleerd zijn. Voorbeelden: UI-aanpassingen, nieuwe items of crafting-recepten, kaartmods.
• Alleen-client mods: sommige mods werken alleen aan de kant van de speler en hoeven niet op de server. Voorbeelden: HUD-verbeteringen, minimap-mods.

Controleer altijd de modbeschrijving om te weten of een mod server-side, client-side of beide is.

Configuratie aanpassen

Na de eerste keer laden maakt elke mod een configuratiebestand aan in BepInEx/config/. Open dit bestand om instellingen aan te passen, zoals spawn-rates, moeilijkheidsgraad of craftingkosten. Herstart de server na wijzigingen.

Tips

• Gebruik een modmanager zoals r2modman voor het beheren van mods op je eigen computer (client-side).
• Voeg mods een voor een toe en test na elke toevoeging om problemen snel te identificeren.
• Maak een back-up van je wereld voordat je mods toevoegt of bijwerkt.
• Raadpleeg de Valheim server opzetten handleiding als je nog geen server hebt draaien.

Tip: bij HostValues kun je een Valheim server huren die geschikt is voor mods en BepInEx.