Hoe installeer ik mods op mijn Valheim-server?

Opgepast

Om op een gemodificeerde server te spelen, moeten alle spelers dezelfde mods op hun client installeren. Het paneel installeert alleen bestanden op de dedicated server.

Valheim-mods gebruiken BepInEx. Bij AleForge zet je de server met Game Swap op Valheim BepInEx en installeer je daarna pakketten van Thunderstore in de Mod Manager.

Overschakelen naar Valheim BepInEx met Game Swap

Vanilla Valheim kan geen BepInEx-plugins laden. Draai je al op een Valheim BepInEx-instance, sla dit gedeelte over.

1. Ga naar het AleForge Panel
2. Stop de server
3. Open Backups en maak een back-up
4. Open Game Swap
5. Klik op een lege slot op New Game
6. Zoek Valheim en selecteer het Valheim-template
7. Kies onder Server Version / Type voor Valheim BepInEx
8. Laat Backup Active Server aan staan zodat de huidige instance in die slot wordt opgeslagen
9. Klik Confirm Action en wacht tot de installatie klaar is

Opgepast

De nieuwe BepInEx-instance start een nieuwe wereld. Backup Active Server bewaart je vorige instance in een Game Swap-slot. Die wereld wordt niet naar BepInEx gekopieerd. Dezelfde map houden: herstel na de wissel en zet World Name op Startup. Zie Hoe upload ik mijn Valheim-wereld?.

Als de wissel klaar is, installeer je mods en start je daarna de server.

Mods installeren met de Mod Manager

De Mod Manager staat in de serverzijbalk. Hij doorzoekt de Thunderstore-catalogus voor Valheim.

1. Open je Valheim BepInEx-server in het AleForge Panel
2. Klik in de zijbalk op Mod Manager
3. Blijf op Mods of ga naar Modpacks
4. Zoek en sorteer op Most Popular, Last Updated of Newest
5. Laat Hide client-side aan staan, tenzij je bewust een client-only pakket nodig hebt
6. Klik bij een mod op Install, of bij een modpack op Install pack en daarna Confirm install
7. Wacht tot de voortgangsbalk klaar is
8. Herstart de server zodat de plugins laden

Mods laden niet hot. Herstart na elke installatie, de-installatie of update.

Afhankelijkheden worden automatisch meegenomen. Al geïnstalleerde pakketten tonen Installed. BepInEx zelf kun je op deze pagina niet verwijderen.

Modpacks

Het tabblad Modpacks is een aparte Thunderstore-lijst. Een pack installeren vraagt om bevestiging. Optioneel: Replace existing plugins leegt /BepInEx/plugins vóór het pack (BepInEx zelf blijft).

Geïnstalleerd en verwijderen

Installed toont pakketten die de Mod Manager op de server heeft gezet. Klik op Uninstall en daarna op Confirm. ZIP-bestanden die je via Files in BepInEx/plugins hebt gezet, verschijnen hier niet.

Updates

Open Updates, klik op Check for Updates en daarna op Install all updates als er iets achterloopt. Herstart (of Start server als de server offline is) wanneer het paneel dat vraagt.

Client-mods

Spelers hebben dezelfde Thunderstore-pakketten op hun pc nodig. Installeer lokaal BepInExPack Valheim en daarna dezelfde mods als op de server. Een Thunderstore-client zoals r2modman of Gale is de gebruikelijke manier.

Handmatig uploaden (optioneel)

Gebruik dit alleen als een pakket niet op Thunderstore staat of je al een zip hebt.

Opgepast

Als de zip groter is dan 1 GB, upload via SFTP.

1. Stop de server
2. Open Files
3. Ga naar BepInEx/plugins
4. Upload de zip en kies Unarchive
5. Start de server

Handmatige uploads verschijnen niet onder Installed of Updates in de Mod Manager.

Als de installatie mislukt

Als de Mod Manager meldt dat BepInEx-Doorstop-bestanden ontbreken, installeer met Game Swap een nieuwe Valheim-instance en zet Server Version / Type op Valheim BepInEx. Wijzig het startup-commando niet handmatig om BepInEx te forceren.

Voor wereldbestanden na een wissel gebruik je een Valheim-wereld uploaden en back-up en herstel.