So installierst du Mods in Valheim (2026)

Eine Anleitung zum Herunterladen und Installieren von Mods in Valheim auf dem PC, die Mod-Manager und die manuelle Installation unter Windows, Linux und macOS abdeckt.

Valheim läuft auf Unity, und seine Mods sind BepInEx-Plugins. Die Community pflegt einen eigenen BepInEx-Build, statt den offiziellen zu verwenden, und das ist das Erste, was man richtig machen muss.

Unser Beispiel ist EpicLoot, ein seit langem bestehendes Overhaul für Loot und magische Gegenstände. Es eignet sich gut zur Demonstration, weil es echte Abhängigkeiten mitbringt und weil es sowohl auf dem Server als auch auf dem Client installiert werden muss.

Voraussetzungen

• Ein PC mit Windows 10 oder neuer, Linux oder macOS. Valheim hat native Builds für alle drei.
• Valheim, idealerweise die Steam-Version. Der nächste Abschnitt erklärt, warum.
• Ein paar hundert MB freier Speicherplatz. Große Overhauls wie EpicLoot sind größer.
• 7-Zip oder ein beliebiges Archivierungstool, falls du händisch installierst.
• Ein Backup deiner Welten und Charaktere, bevor du beginnst. Sie liegen unter %userprofile%\AppData\LocalLow\IronGate\Valheim auf Windows.

WARNUNG - Nimm dieses Backup ernst. Mods, die Items und Fortschritt hinzufügen, EpicLoot eingeschlossen, schreiben Daten in deinen Spielstand. Entfernst du so einen Mod später, kann dein Charakter Items behalten, die das Spiel nicht mehr erkennt.

Welche Version von Valheim du besitzt, spielt eine Rolle

Valheim wird auf Steam, im Microsoft Store und auf Xbox-Konsolen verkauft.

• Steam ist die Version, von der diese Anleitung ausgeht, und die Version, auf die sich die gesamte Modding-Szene bezieht.
• Microsoft Store und Game Pass-Installationen liegen unter C:\XboxGames\Valheim\Content und sind deutlich schwerer zu modden. BepInEx muss Dateien in den Spieleordner schreiben, und diese Installationen sind auf eine Weise geschützt, die dem meist im Weg steht. Dafür gibt es keinen unterstützten Weg, und du solltest nicht erwarten, dass Mod-Manager funktionieren.
• Xbox-Konsolen können überhaupt nicht gemoddet werden. Crossplay erlaubt es einem Xbox-Spieler, einem PC-Server beizutreten, aber der Xbox-Client bleibt Vanilla und kann nichts laden.

BepInExPack Valheim

BepInExPack Valheim ist der Loader, und es ist nicht das gewöhnliche BepInEx. Es ist ein Valheim-spezifischer Build, der von Azumatt, Vapok und Margmas gepflegt wird, mit einer vorkonfigurierten BepInEx.cfg, Startskripten für Linux und den dedizierten Server, Preloader-Änderungen, auf die mehrere Mods angewiesen sind, und Unterstützung für semantische Versionen, die das offizielle BepInEx 5 verwirft.

Installiere dieses Pack, nicht das generische BepInEx.

HINWEIS - Da es sich um einen Community-Fork handelt, kann dir der offizielle BepInEx-Discord bei Valheim-Problemen nicht helfen, und das wird man dir dort auch so sagen. Wende dich mit Valheim-Problemen stattdessen an die Valheim-Modding-Community.

Zusätzlich zu BepInEx hängt EpicLoot von zwei gemeinsam genutzten Bibliotheken ab:

• Jötunn, die Valheim-Modding-Bibliothek, auf der die meisten größeren Mods aufbauen.
• JsonDotNET, eine mitgelieferte Kopie von Newtonsoft.Json.

Mod-Manager installieren beides automatisch.

Installation mit einem Thunderstore-Mod-Manager

Das ist der meistgenutzte Weg und der, auf den Mod-Seiten verlinken.

Drei Manager funktionieren mit Valheim, und alle drei lesen dasselbe Profilformat:

Manager	Plattformen
Gale	Windows, Linux
Thunderstore Mod Manager	Windows
r2modman	Windows, Linux, macOS

Die Schritte sind bei allen gleich, egal welchen du wählst:

1. Installiere den Manager und wähle Valheim aus.
2. Erstelle ein Profil.
3. Durchsuche oder suche nach EpicLoot.
4. Klicke auf Install oder Download with dependencies. BepInExPack Valheim, Jötunn und JsonDotNET werden mitgeliefert.
5. Starte das Spiel über den Manager mit Start modded oder Launch game (modded).

Startest du Valheim direkt über Steam, läuft es im Vanilla-Modus, da der Manager BepInEx erst beim Start anhängt.

Installation mit Vortex

Vortex unterstützt Valheim und bezieht Mods von Nexus Mods statt von Thunderstore. Der Nexus-Valheim-Katalog ist deutlich kleiner, und die meisten Autoren veröffentlichen zuerst auf Thunderstore. Nutze diesen Weg also nur, wenn Vortex bereits dein bevorzugtes Tool ist und du dort gefunden hast, was du suchst.

1. Installiere Vortex und melde dich an.
2. Suche unter Games nach Valheim, fahre mit der Maus über die Kachel und klicke auf Manage.
3. Installiere BepInExPack Valheim selbst mit den manuellen Schritten weiter unten. Vortex richtet den Loader nicht für dich ein.
4. Lade Mods von Nexus mit Mod Manager Download herunter, dann Install und Enable.
5. Starte wie gewohnt über Steam. Vortex schreibt die Dateien dauerhaft in den Spielordner, daher ist kein spezieller Start nötig, sobald BepInEx eingerichtet ist.

WARNUNG - Betreibe Vortex und einen Thunderstore-Manager nicht an derselben Installation. Beide wollen BepInEx/plugins besitzen und machen sich gegenseitig die Arbeit zunichte.

Manuelle Installation

Suche zunächst deinen Spieleordner. Rechtsklicke auf Valheim in Steam, dann Verwalten und Lokale Dateien durchsuchen:

C:\Program Files (x86)\Steam\steamapps\common\Valheim

Lade BepInExPack Valheim mit Manual Download herunter, entpacke es an einem Ort, der nicht der Spielordner ist, und verschiebe dann den Inhalt des Ordners BepInExPack_Valheim in deinen Valheim-Ordner. Richtig gemacht, siehst du BepInEx, winhttp.dll und doorstop_config.ini direkt neben valheim.exe.

Lade dann EpicLoot, Jötunn und JsonDotNET herunter, entpacke jedes davon und kopiere ihre .dll-Dateien nach Valheim\BepInEx\plugins.

Was du als Nächstes tust, hängt von deiner Plattform ab.

Windows

Sonst ist nichts weiter zu tun. Starte das Spiel, und ein BepInEx-Konsolenfenster sollte daneben erscheinen.

Linux

1. Mache das Startskript ausführbar:

chmod u+x start_game_bepinex.sh

2. Öffne in Steam die Eigenschaften von Valheim und setze die Startoptionen auf:

./start_game_bepinex.sh %command%

3. Starte über Steam.

Du kannst dem Skript auch den vollständigen Pfad statt eines relativen angeben, wodurch du das Pack komplett außerhalb des Spielordners belassen kannst.

macOS

Valheim hat einen nativen macOS-Build, aber BepInEx 5 läuft nicht nativ auf Apple Silicon, da es auf MonoMod basiert und MonoMod noch keine arm64-Unterstützung bietet. Der Workaround besteht darin, das Spiel über Rosetta laufen zu lassen.

1. Mache das Skript ausführbar:

chmod u+x start_game_bepinex.sh

2. Setze die Steam-Startoptionen von Valheim auf:

/usr/bin/arch -x86_64 /bin/bash ./start_game_bepinex.sh %command%

3. Starte über Steam.

Lässt du den Teil arch -x86_64 auf einem M-Series-Mac weg, startet das Spiel trotzdem, allerdings ohne BepInEx und ohne dass irgendwelche Mods geladen werden. Intel-Macs benötigen das nicht.

Installation mit der TMC App

Valheim ist eines der Spiele, die die TMC App bereits unterstützt, sodass dies, anders als bei den meisten unserer Anleitungen, eine echte Option und kein bloßes Versprechen ist. Die App ist unser eigener Mod-Manager und Server-Browser und stellt Valheim-Mods wie alles andere hier in BepInEx/plugins bereit.

So installierst du sie:

• Linux: eine Zeile, kein Root und kein Paketmanager.

curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh

• Windows: die setup.exe oder setup.msi von der Releases-Seite. Es gibt auch einen portablen Build, der jedoch den Launcher-Eintrag und den tmc://-Link-Handler nicht registriert.
• macOS: die .dmg von derselben Releases-Seite.

Nach der Installation:

1. Öffne die App und füge Valheim hinzu, wobei du sie auf deinen Steam-Installationsordner verweist.
2. Erstelle eine Sandbox. Sandboxes sind benannte Mod-Profile mit eigener Ladereihenfolge und Bereitstellungsmethode, und der Wechsel zwischen ihnen lädt nichts erneut herunter.
3. Installiere die gewünschten Mods in diese Sandbox.
4. Starte das Spiel.

WARNUNG - Bitte lies diesen Teil, bevor du dich darauf verlässt. Die App befindet sich in einer sehr frühen Entwicklungsphase, und wir sagen das lieber direkt, als dass du es mitten im Spiel herausfindest. Im eigenen README werden alle unterstützten Spiele, Valheim eingeschlossen, als ungetestet aufgeführt. Betrachte sie daher als etwas zum Ausprobieren neben Gale oder r2modman, nicht als Ersatz dafür. Behalte das in den Voraussetzungen erwähnte Backup.

Trotzdem ist genau dies die Phase, in der ein Test am nützlichsten ist. Wenn es funktioniert, würden wir das gerne wissen. Wenn es in den falschen Ordner installiert oder deine Ladereihenfolge zerstört, würden wir das wirklich gerne wissen – solches Feedback ist für das Projekt derzeit wertvoller als fast alles andere.

Die App ist Open Source unter GPL-3.0 auf github.com/modcommunity/tmc-app. Fehlermeldungen und Feature-Wünsche gehören in den Issue-Tracker, Pull Requests sind willkommen, und das Repository dokumentiert, wie spielspezifische Regeln funktionieren, falls du die Valheim-Seite selbst verbessern möchtest.

Server-seitige Mods und Multiplayer

Das ist der Teil, an dem Valheim-Spieler häufig scheitern, weil er anders funktioniert als bei den meisten Koop-Spielen.

Valheim-Mods lassen sich grob in drei Kategorien einteilen:

• Nur Client. UI-Anpassungen, Kameraänderungen, visuelle Mods. Auf deinem Rechner installieren, sonst interessiert es niemanden.
• Client und Server. Alles, was Items, Rezepte, Kreaturen oder Progression hinzufügt. EpicLoot fällt eindeutig in diese Kategorie und muss sowohl auf dem dedizierten Server als auch auf jedem Client der Spieler installiert werden.
• Nur Server. Admin-Tools, Backups, Weltverwaltung.

Macht man das falsch, äußert sich das meist darin, dass man beim Verbinden wegen eines Versions-Mismatches rausgeworfen wird, oder darin, dass Items verschwinden, weil der Server sie nicht kennt.

Für einen dedizierten Server liefert BepInExPack Valheim genau dafür ein start_server_bepinex.sh-Skript mit. Mache es mit chmod u+x start_server_bepinex.sh ausführbar, bearbeite dessen Startparameter genauso, wie du Valheims eigenes Server-Skript bearbeiten würdest, und führe es anstelle von start_server.sh aus.

Wenn du einen Server von Grund auf einrichtest, behandelt unser separater Valheim-Server-Guide diesen Teil.

TIPP - Mehrere Managed-Valheim-Hoster installieren BepInEx per Schalter für dich. Wenn du lieber keine Shell anfassen möchtest, ist das eine legitime Abkürzung.

Mods konfigurieren

Mods schreiben ihre Konfigurationsdateien beim ersten Start hierhin:

Valheim\BepInEx\config

Es handelt sich um reine Text-.cfg-Dateien. EpicLoot legt dort viel von seinem Feintuning ab, zusammen mit JSON-Dateien für Loot-Tabellen und magische Effekte, und es lohnt sich durchaus, einen Blick hineinzuwerfen, wenn du anpassen statt die Standardwerte übernehmen willst.

BepInEx Configuration Manager fügt ein Ingame-Einstellungsfenster hinzu, mit dem du dieselben Werte bearbeiten kannst, ohne Alt-Tab zu drücken. Gale und r2modman bringen ebenfalls Konfigurations-Editoren mit.

Überprüfen, ob alles geladen wurde

Unter Windows öffnet BepInEx ein Konsolenfenster neben dem Spiel. Es erscheint in der Taskleiste, und du kannst darin den Startvorgang beobachten.

Was du sehen willst, ist grauer und weißer Text – das ist informative Ausgabe. Farben bedeuten Ärger:

Farbe	Bedeutung
Rot	Schwerer Fehler
Dunkelrot	Fehler
Gelb	Warnung
Dunkelgrau	Debug-Ausgabe

Das Pack gibt außerdem seine eigene Thunderstore-Version in der Konsole aus, die getrennt von der darunterliegenden BepInEx-Version ist.

Speziell für EpicLoot: Lade eine Welt und überprüfe dein Inventar auf die magischen Item-Tabs und die Rezepte der Aufwertungsstation.

Aktualisieren und Deinstallieren

Mod-Manager markieren veraltete Mods und aktualisieren sie mit einem Klick. Führe Updates zwischen den Spielsitzungen durch und nicht mitten im Spiel, da ein Mod, der in deinen Spielstand schreibt, sich schlecht verhalten kann, wenn sich die Versionen unter ihm ändern.

Um einen Mod zu entfernen, deinstalliere ihn in deinem Manager oder lösche seine .dll aus BepInEx/plugins. Um zu Vanilla zurückzukehren, lösche BepInEx, winhttp.dll, doorstop_config.ini und die Start-Skripte aus dem Spielordner. Steams Dateiüberprüfung entfernt sie nicht, da Steam sie nicht installiert hat.

WARNUNG - Bevor du einen Mod entfernst, der deiner Welt Items hinzugefügt hat, überlege dir, ob du diesen Charakter und diese Welt danach überhaupt noch behalten willst. Genau dafür ist das Backup da.

Problembehandlung

Keine BepInEx-Konsole und keine Mods. Prüfe unter Windows, ob winhttp.dll direkt neben valheim.exe liegt. Prüfe unter Linux, ob deine Startoptionen ./start_game_bepinex.sh %command% enthalten. Prüfe unter macOS, ob das arch -x86_64-Präfix vorhanden ist.

Vom Server wegen Versions-Mismatch rausgeworfen. Deine Mods und die Mods des Servers stimmen nicht überein. Installiere dieselben Versionen, die der Server nutzt, oder bitte den Host, seine Liste zu exportieren.

Mods funktionieren nach einem Valheim-Update nicht mehr. Zu erwarten. Iron-Gate-Patches brechen BepInEx-Mods, und die Autoren brauchen Zeit. Prüfe die Thunderstore-Seiten deiner Mods auf aktualisierte Releases.

Spiel stürzt beim Start ab. Räume alles aus BepInEx/plugins, bestätige einen sauberen Start und füge die Mods dann in Hälften wieder hinzu, um den Übeltäter zu finden.

Mods funktionieren im Singleplayer, aber nicht auf meinem eigenen Server. Server-seitige Mods müssen auch auf dem Server installiert werden, nicht nur im Client, der ihn hostet. Verwende start_server_bepinex.sh.

Microsoft-Store-Version lässt sich nicht modden. Größtenteils stimmt das, und es gibt keinen unterstützten Weg drumherum. Die Steam-Version ist diejenige, die man verwenden sollte.

Auf einem M-Series-Mac lädt nichts. Dir fehlt das Rosetta-Präfix in deinen Startoptionen.

Fazit

Die Kurzfassung für die meisten: Gale oder r2modman installieren, Valheim auswählen, EpicLoot mit Abhängigkeiten installieren und modded starten. BepInExPack Valheim wird dabei mitgeliefert, und man muss sich nie darum kümmern.

Die beiden Valheim-spezifischen Dinge, die man sich merken sollte, sind, dass das BepInEx-Paket ein Community-Fork mit eigenen Eigenheiten und eigenen Support-Kanälen ist, und dass alles, was Items oder Fortschritt betrifft, sowohl auf dem Server als auch auf dem Client installiert werden muss.

Valheim ist eines der wenigen Spiele, die unsere eigene TMC App bereits unterstützt. Sie ist Open Source und steckt noch in einer sehr frühen Entwicklungsphase, daher lohnt sich ein Versuch, aber man sollte sich noch nicht darauf verlassen – Feedback dazu wäre wirklich willkommen.

Siehe auch

• Valheim auf Thunderstore
• Valheim auf Nexus Mods
• Valheim Modding Discord
• Valheim Modding Wiki
• Offizielles Valheim Modding FAQ - Iron Gates eigene Hinweise zum Asset-Bundle-System, mit dem Mods arbeiten müssen.
• Jötunn-Dokumentation
• TMC App

Wir halten diesen Guide so aktuell wie möglich, aber Valheim, BepInEx und die Mod-Bibliotheken werden alle unabhängig voneinander aktualisiert. Falls eine Anleitung hier nicht mehr mit dem übereinstimmt, was du siehst, melde es bitte oder eröffne einen Pull Request im GitHub-Repository dieses Guides.

Tritt unserem Discord-Server bei, wenn du Fragen hast oder Hilfe bei irgendetwas rund ums Modding brauchst!