Een gids over het downloaden en installeren van mods in Valheim op PC, met daarin mod managers en handmatige installatie op Windows, Linux en macOS.
Valheim draait op Unity en de mods zijn BepInEx-plugins. De community onderhoudt een eigen BepInEx-build in plaats van de upstream-versie te gebruiken, en dat is het eerste dat je goed moet hebben.
Ons voorbeeld is EpicLoot, een langlopende loot- en magische-itemoverhaul. Het is een goed demonstratiegeval omdat het echte afhankelijkheden meebrengt en omdat het zowel op de server als op de client geïnstalleerd moet worden.
Vereisten
- Een PC met Windows 10 of nieuwer, Linux, of macOS. Valheim heeft native builds voor alle drie.
- Valheim, idealiter de Steam-versie. Zie de volgende sectie waarom.
- Een paar honderd MB vrije ruimte. Grote overhauls zoals EpicLoot zijn groter.
- 7-Zip of een ander archiefprogramma als je handmatig installeert.
- Een backup van je werelden en characters voordat je begint. Deze staan op
%userprofile%\AppData\LocalLow\IronGate\Valheimop Windows.
WAARSCHUWING - Neem die back-up serieus. Mods die items en progressie toevoegen, EpicLoot inbegrepen, schrijven data in je save. Als je zo'n mod later verwijdert, kan dat je achterlaten met een personage dat items bij zich draagt die het spel niet meer herkent.
Welke Versie Van Valheim Je Bezit Maakt Uit
Valheim wordt verkocht op Steam, op de Microsoft Store, en op Xbox-consoles.
- Steam is de versie waar deze hele gids van uitgaat, en de versie waar de hele modscene zich op richt.
- Microsoft Store- en Game Pass-installaties bevinden zich onder
C:\XboxGames\Valheim\Contenten zijn veel lastiger te modden. BepInEx moet bestanden wegschrijven in de gamemap, en deze installaties zijn op manieren beveiligd die daarbij doorgaans in de weg zitten. Hier bestaat geen ondersteund pad en je moet niet verwachten dat mod managers werken. - Xbox-consoles kunnen helemaal niet gemod worden. Crossplay laat een Xbox-speler wel meedoen op een pc-server, maar de Xbox-client blijft vanilla en kan niets laden.
BepInExPack Valheim
BepInExPack Valheim is de loader, en het is niet gewone BepInEx. Het is een Valheim-specifieke build die wordt onderhouden door Azumatt, Vapok en Margmas, met een voorgeconfigureerde BepInEx.cfg, launch scripts voor Linux en de dedicated server, preloader-aanpassingen waar meerdere mods van afhankelijk zijn, en semantic version support die de upstream BepInEx 5 overboord gooit.
Installeer dat pack, niet de generieke BepInEx.
NOTITIE - Omdat het een community fork is, kan de officiële BepInEx Discord je niet helpen met Valheim-problemen, en dat zullen ze je ook vertellen. Breng Valheim-problemen liever naar de Valheim modding community.
Bovenop BepInEx is EpicLoot afhankelijk van twee gedeelde libraries:
- Jötunn, de Valheim modding library waar de meeste substantiële mods op bouwen.
- JsonDotNET, een verpakte kopie van Newtonsoft.Json.
Mod managers installeren beide automatisch.
Installeren Met Een Thunderstore Mod Manager
Dit is het meest bewandelde pad en degene waarnaar mod-pagina's linken.
Drie managers werken met Valheim en alle drie lezen hetzelfde profielformaat:
| Manager | Platforms |
|---|---|
| Gale | Windows, Linux |
| Thunderstore Mod Manager | Windows |
| r2modman | Windows, Linux, macOS |
De stappen zijn hetzelfde, welke je ook kiest:
- Installeer de manager en selecteer Valheim.
- Maak een profiel aan.
- Blader of zoek naar EpicLoot.
- Klik op Install of Download with dependencies. BepInExPack Valheim, Jötunn en JsonDotNET komen erbij.
- Start het spel via de manager met Start modded of Launch game (modded).
Valheim direct via Steam starten draait het vanilla, omdat de manager BepInEx pas bij het opstarten koppelt.
Installeren Met Vortex
Vortex ondersteunt Valheim en haalt mods op van Nexus Mods in plaats van Thunderstore. De Nexus Valheim-catalogus is veel kleiner en de meeste auteurs publiceren eerst naar Thunderstore, dus gebruik dit alleen als Vortex al jouw tool van keuze is en je daar hebt gevonden wat je zocht.
- Installeer Vortex en log in.
- Zoek onder Games naar Valheim, hover over de tegel en klik op Manage.
- Installeer BepInExPack Valheim zelf via de handmatige stappen hieronder. Vortex zet de loader niet voor je klaar.
- Download mods van Nexus met Mod Manager Download, en klik dan op Install en Enable.
- Start het spel gewoon via Steam. Vortex schrijft bestanden permanent naar de spelmap, dus is er geen speciale manier van starten nodig zodra BepInEx aanwezig is.
WAARSCHUWING - Gebruik Vortex en een Thunderstore-manager niet tegelijk op dezelfde installatie. Ze willen beide de eigenaar zijn van BepInEx/plugins en maken elkaars werk ongedaan.
Handmatig Installeren
Zoek eerst je game-folder op. Klik met de rechtermuisknop op Valheim in Steam, dan Manage en Browse local files:
C:\Program Files (x86)\Steam\steamapps\common\Valheim
Download BepInExPack Valheim met Manual Download, pak het uit op een plek die niet de spelmap is, en verplaats dan de inhoud van de map BepInExPack_Valheim naar je Valheim-map. Als het goed is gegaan, zie je BepInEx, winhttp.dll en doorstop_config.ini naast valheim.exe staan.
Download vervolgens EpicLoot, Jötunn en JsonDotNET, pak elk uit, en kopieer hun .dll-bestanden naar Valheim\BepInEx\plugins.
Wat je vervolgens doet, hangt af van je platform.
Windows
Verder niets te doen. Start de game en er zou een BepInEx-consolevenster naast moeten verschijnen.
Linux
- Maak het launch script executable:
chmod u+x start_game_bepinex.sh
- Open in Steam de Properties van Valheim en zet de launch options op:
./start_game_bepinex.sh %command%
- Start via Steam.
Je kunt ook het volledige pad naar het script opgeven in plaats van een relatief pad, waardoor je het pack volledig buiten de spelmap kunt houden.
macOS
Valheim heeft een native macOS-build, maar BepInEx 5 draait niet native op Apple Silicon, omdat het afhankelijk is van MonoMod en MonoMod nog geen arm64-ondersteuning heeft. De workaround is om de game via Rosetta te forceren.
- Maak het script uitvoerbaar:
chmod u+x start_game_bepinex.sh
- Zet Valheim's Steam launch options op:
/usr/bin/arch -x86_64 /bin/bash ./start_game_bepinex.sh %command%
- Start via Steam.
Laat je het arch -x86_64-gedeelte weg op een Mac met een M-serie chip, dan start het spel nog steeds, maar zonder BepInEx en dus zonder je mods te laden. Intel Macs hebben dit niet nodig.
Installeren Met De TMC App
Valheim is een van de games die de TMC App al ondersteunt, dus in tegenstelling tot de meeste van onze gidsen is dit een echte optie in plaats van een belofte. De app is onze eigen mod manager en server browser, en zet Valheim-mods net als alles hier neer in BepInEx/plugins.
Installeren:
- Linux: één regel, geen root en geen package manager.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: de
setup.exeofsetup.msivan de releases page. Er is ook een portable build, hoewel deze de launcher entry of detmc://link handler niet registreert. - macOS: de
.dmgvan dezelfde releases page.
Eenmaal geïnstalleerd:
- Open de app en voeg Valheim toe, waarbij je naar je Steam-installatiemap wijst.
- Maak een sandbox aan. Sandboxes zijn benoemde modprofielen met hun eigen laadvolgorde en implementatiemethode, en wisselen ertussen download niets opnieuw.
- Installeer de mods die je wilt in die sandbox.
- Start het spel.
WAARSCHUWING - Lees dit deel voordat je er op vertrouwt. De app is in een zeer vroeg ontwikkelingsstadium en we zeggen dat liever nu dan dat je er middenin een playthrough achter komt. De eigen README vermeldt elke ondersteunde game als untested, Valheim inbegrepen, dus beschouw het als iets om mee te experimenteren naast Gale of r2modman in plaats van als vervanging ervoor. Behoud de backup die we bij de vereisten noemden.
Dat gezegd hebbende, dit is precies het stadium waarin het uitproberen het meest nuttig is. Als het werkt, horen we dat graag. Als het naar de verkeerde folder deployt of je load order verknoeit, horen we dat echt heel graag, en dat soort feedback is momenteel meer waard voor het project dan bijna alles anders.
De app is open source onder GPL-3.0 op github.com/modcommunity/tmc-app. Bugrapporten en feature requests horen in de issue tracker, pull requests zijn welkom, en de repository documenteert hoe per-game rules werken als je zelf de Valheim-kant wilt verbeteren.
Server-Side Mods En Multiplayer
Dit is het deel waar Valheim-speler vaak tegenaan lopen, omdat het anders werkt dan bij de meeste co-op games.
Valheim-mods vallen grofweg in drie categorieën uiteen:
- Alleen client. UI-aanpassingen, camera-veranderingen, visuele mods. Installeer ze op je eigen machine en verder maakt het niets uit.
- Client en server. Alles wat items, recepten, wezens of progressie toevoegt. EpicLoot valt hier duidelijk onder, en moet zowel op de dedicated server als op elke client van iedere speler geïnstalleerd worden.
- Alleen server. Adminhulpmiddelen, back-ups, wereldbeheer.
Als dit misgaat, uit zich dat meestal doordat je bij het verbinden wordt gekickt vanwege een versieverschil, of doordat items verdwijnen omdat de server ze niet herkent.
Voor een dedicated server levert BepInExPack Valheim hiervoor een start_server_bepinex.sh-script mee. Maak het uitvoerbaar met chmod u+x start_server_bepinex.sh, pas de startparameters aan zoals je dat ook bij het eigen serverscript van Valheim zou doen, en gebruik het in plaats van start_server.sh.
Als je een server helemaal opnieuw opzet, behandelt onze aparte Valheim server-gids dat onderdeel.
TIP - Verschillende beheerde Valheim-hostingdiensten installeren BepInEx voor je met één schakelaar. Als je liever geen shell aanraakt, is dat een legitieme kortere weg.
Mods Configureren
Mods schrijven hun configbestanden hier bij de eerste keer opstarten:
Valheim\BepInEx\config
Het zijn platte tekst .cfg-bestanden. EpicLoot zet daar veel van zijn instellingen in, samen met JSON-bestanden voor loot-tabellen en magische effecten, en het is zeker de moeite waard om erin te kijken als je iets wilt aanpassen in plaats van de standaardwaarden te accepteren.
BepInEx Configuration Manager voegt een in-game instellingenvenster toe waarmee je dezelfde waarden kunt aanpassen zonder te hoeven alt-tabben. Gale en r2modman bevatten ook allebei config-editors.
Controleren Of Alles Geladen Is
Op Windows opent BepInEx een consolevenster naast de game. Het verschijnt in de taakbalk en je kunt de bootsequence erin volgen.
Wat je wilt zien is grijze en witte tekst, dat is informatieve uitvoer. Kleuren betekenen problemen:
| Kleur | Betekenis |
|---|---|
| Rood | Fatale fout |
| Donkerrood | Fout |
| Geel | Waarschuwing |
| Donkergrijs | Debug-output |
Het pack toont ook zijn eigen Thunderstore-versie in de console, wat iets anders is dan de onderliggende BepInEx-versie.
Laad specifiek voor EpicLoot een wereld en controleer je inventaris op de tabbladen voor magische items en de recepten van het augmenting station.
Updaten En Verwijderen
Mod managers markeren verouderde mods en updaten ze met één klik. Doe je updates tussen speelsessies door in plaats van midden in een playthrough, omdat een mod die naar je save schrijft zich vervelend kan gedragen wanneer versies onder hem veranderen.
Om een mod te verwijderen, deïnstalleer je hem in je manager of verwijder je zijn .dll uit BepInEx/plugins. Om terug te keren naar vanilla, verwijder je BepInEx, winhttp.dll, doorstop_config.ini en de startscripts uit de spelmap. Steams bestandsverificatie zal ze niet verwijderen, omdat Steam ze niet heeft geïnstalleerd.
WAARSCHUWING - Denk voordat je een mod verwijdert die items aan je wereld heeft toegevoegd goed na of je dat personage en die wereld daarna nog wilt gebruiken. Daar is de back-up voor bedoeld.
Problemen Oplossen
Geen BepInEx-console en geen mods. Controleer op Windows of winhttp.dll direct naast valheim.exe staat. Controleer op Linux of je launch options ./start_game_bepinex.sh %command% bevatten. Controleer op macOS of de arch -x86_64-prefix aanwezig is.
Gekickt van een server vanwege een versieverschil. Je mods en de mods van de server komen niet overeen. Installeer dezelfde versies die de server draait, of vraag de host om zijn lijst te exporteren.
Mods werken niet meer na een Valheim-update. Te verwachten. Iron Gate-patches breken BepInEx-mods en auteurs hebben tijd nodig. Kijk op de Thunderstore-pagina's van je mods voor bijgewerkte releases.
Spel crasht bij het opstarten. Verplaats alles uit BepInEx/plugins, controleer of het spel schoon opstart, en voeg vervolgens mods in helften terug toe om de boosdoener te vinden.
Mods werken in singleplayer maar niet op mijn eigen server. Server-side mods moeten ook op de server geïnstalleerd worden, niet alleen in de client die hem host. Gebruik start_server_bepinex.sh.
Microsoft Store-versie wil niet modden. Dat klopt grotendeels, en er is geen ondersteunde manier om dit te omzeilen. De Steam-versie is degene die je moet gebruiken.
Er laadt niets op een Mac met M-serie chip. Je mist de Rosetta-prefix in je startopties.
Conclusie
De korte versie voor de meeste mensen: installeer Gale of r2modman, kies Valheim, installeer EpicLoot met dependencies, en start modded. BepInExPack Valheim komt automatisch mee en je hoeft er nooit meer over na te denken.
De twee Valheim-specifieke dingen die het onthouden waard zijn, zijn dat het BepInEx-pakket een community fork is met zijn eigen eigenaardigheden en eigen supportkanalen, en dat alles wat items of progressie raakt zowel op de server als op de client geïnstalleerd moet worden.
Valheim is een van de weinige games die onze eigen TMC App al ondersteunt. Het is open source en zit nog in een zeer vroeg ontwikkelingsstadium, dus het is de moeite waard om het te proberen, maar niet om er volledig op te vertrouwen, en feedback erover zou echt op prijs worden gesteld.
Zie Ook
- Valheim op Thunderstore
- Valheim op Nexus Mods
- Valheim Modding Discord
- Valheim Modding Wiki
- Officiële Valheim Modding FAQ - Iron Gate's eigen notities over het asset bundle-systeem waarmee mods moeten werken.
- Jötunn documentatie
- TMC App
We houden deze gids zo actueel mogelijk, maar Valheim, BepInEx en de modbibliotheken worden allemaal apart geüpdatet. Als een instructie hier niet meer overeenkomt met wat je ziet, meld dit dan graag of open een pull request op de GitHub-repository van deze gids.
Join onze Discord server als je vragen hebt of hulp wilt bij iets modding-gerelateerd!