Mit BepInEx kannst du Valheim-Server um Mods erweitern, wenn Serverdateien, Client-Mods und Versionen sauber zusammenpassen. Entscheidend ist nicht nur das Kopieren einer DLL, sondern ein kontrollierter Ablauf: Framework installieren, Server einmal starten, Mods gezielt hinzufügen, Clients angleichen und Fehler über Logs oder schrittweises Deaktivieren eingrenzen.
Was BepInEx bei Valheim macht
BepInEx ist ein Mod-Framework für Unity-Spiele. Für Valheim wird häufig das BepInExPack Valheim verwendet, das auf Thunderstore bereitgestellt wird: Dokumentation bei thunderstore.io. Diese Projektseite ist die Primärquelle für das konkret genannte Valheim-BepInEx-Paket.
BepInEx stellt die Ordner bereit, in denen Valheim-Mods geladen und konfiguriert werden. Viele Mods bestehen aus einer oder mehreren DLL-Dateien, die in BepInEx/plugins/ liegen müssen. Nach dem ersten Serverstart werden üblicherweise zusätzliche Konfigurationsdateien in BepInEx/config/ erzeugt. Ändere diese Dateien erst, wenn der Server mindestens einmal mit installiertem Framework gestartet wurde.
Wenn du neben Mods auch Servergrundlagen, Konfiguration und Boss-Fortschritt sauber planen willst, passt ergänzend der interne Guide Valheim Server mieten: Mods, Konfiguration & Boss-Reihenfolge 2026. Für andere Unity- oder Mod-Framework-Setups ist außerdem der Vergleich zu V Rising Mods mit BepInEx Server Mods installieren hilfreich.
Voraussetzungen
Bevor du beginnst, brauchst du Zugriff auf das Valheim-Serververzeichnis, die Möglichkeit zum Neustart des Servers und eine klare Mod-Liste. Bei einem kostenpflichtigen Multi-Game-Hosting wie game-serverhosting ist besonders wichtig, dass du Änderungen nachvollziehbar einspielst: erst Backup, dann Framework, dann einzelne Mods, danach Prüfung. So bleiben technische Kontrolle, Supportfähigkeit und transparente Betriebsabläufe erhalten.
Lege außerdem fest, welche Mods rein serverseitig laufen und welche jeder Spieler lokal installieren muss. Viele Valheim-Mods benötigen passende Komponenten auf Server und Client; maßgeblich ist die Kennzeichnung auf der jeweiligen Mod-Seite. Prüfe daher für jede Mod die jeweilige Thunderstore-Beschreibung, bevor du sie in ein gemeinsames Modpack aufnimmst.
BepInEx auf dem Server installieren
- Lade BepInEx von Thunderstore herunter.
- Entpacke den Inhalt in das Valheim-Serververzeichnis.
- Starte den Server neu. BepInEx erstellt automatisch die Config-Ordner.
Die Zielstruktur sollte danach so aussehen:
/valheim/
├── BepInEx/
│ ├── config/ # Mod-Konfigurationen
│ ├── plugins/ # Mods hier ablegen
│ └── patchers/
├── valheim_server.x86_64
└── start_server.sh
Wichtig ist die Ebene: Der Ordner BepInEx/ gehört direkt in das Valheim-Serververzeichnis, nicht in einen zusätzlichen Unterordner aus dem ZIP-Archiv. Wenn nach dem Neustart keine config- oder plugins-Struktur entsteht, liegt häufig genau dort der Fehler.
Mods installieren
- Lade Mods von Thunderstore herunter.
- Entpacke die DLL-Datei in den Ordner
BepInEx/plugins/. - Starte den Server neu.
Installiere neue Mods nicht blind in großen Paketen. Sinnvoller ist ein kontrolliertes Vorgehen: eine Mod hinzufügen, Server starten, Log prüfen, Verbindung testen, dann erst die nächste Mod einspielen. Bei mehreren Spielern solltest du die Mod-Liste mit Versionsnummern dokumentieren, damit alle dieselbe Grundlage verwenden.
Wenn eine Mod zusätzliche Dateien oder eigene Ordner mitbringt, folge der jeweiligen Mod-Anleitung. Nicht jede Mod besteht nur aus einer einzelnen DLL. Verschiebe Konfigurationsdateien nicht willkürlich zwischen plugins und config; BepInEx und die Mod selbst erwarten bestimmte Pfade.
Client-Mods angleichen
Die meisten Valheim-Mods müssen sowohl auf dem Server als auch auf dem Client installiert sein. Nutze den Thunderstore Mod Manager für einfache Client-Installation.
Alternativ kannst du r2modman verwenden:
- Installiere r2modman.
- Wähle "Valheim" als Spiel.
- Durchsuche und installiere Mods mit einem Klick.
- Exportiere dein Modpack als Code → Teile mit Freunden.
Der praktische Vorteil eines Mod-Managers liegt im Abgleich: Alle Spieler können dasselbe Profil nutzen, statt DLLs manuell zusammenzusuchen. Trotzdem solltest du nach Updates vorsichtig bleiben. Eine aktualisierte Client-Mod kann zu einer älteren Server-Mod inkompatibel sein. Halte daher fest, wann du das Modpack geändert hast und welche Versionen aktiv sind.
Empfohlene Mods
Die folgende Tabelle zeigt verbreitete Beispiele; prüfe jede Mod vor der Installation auf Aktualität und Abhängigkeiten. Sie ist keine Leistungszusage und ersetzt nicht die Prüfung der jeweiligen Mod-Seite auf Kompatibilität, Aktualität und benötigte Abhängigkeiten.
| Mod | Beschreibung | Client nötig? |
|---|---|---|
| ValheimPlus | Umfangreiche Anpassungen | Ja |
| Better UI | Verbesserte Benutzeroberfläche | Ja |
| Plant Everything | Überall pflanzen | Ja |
| Epic Loot | Seltene Items mit Eigenschaften | Ja |
| Better Wards | Verbesserte Schutzsteine | Ja |
Ergebnis prüfen
Nach der Installation sollte der Server ohne Absturz starten. Prüfe zuerst, ob BepInEx im Log geladen wird und ob Fehlermeldungen zu fehlenden Abhängigkeiten, falschen Versionen oder nicht gefundenen DLLs auftauchen. Danach testest du mit einem Client, der dieselbe Mod-Auswahl nutzt.
Im Spiel solltest du gezielt eine Funktion jeder installierten Mod prüfen: UI-Änderung sichtbar, neue Konfigurationsoption wirksam, neues Item vorhanden oder erwartetes Verhalten aktiv. Wenn alles funktioniert, sichere die funktionierende Mod-Liste und die wichtigsten Config-Dateien. So kannst du spätere Änderungen nachvollziehen oder bei Problemen zurückrollen.
Troubleshooting
Mod funktioniert nicht
Prüfe zuerst BepInEx-Version, Mod-Version und Mod-Kompatibilität. Kontrolliere außerdem, ob die DLL wirklich in BepInEx/plugins/ liegt und nicht versehentlich in einem doppelt entpackten Unterordner. Lies die Mod-Seite auf Thunderstore, weil viele Mods zusätzliche Abhängigkeiten benötigen.
Server crashed
Entferne Mods einzeln, um den Verursacher zu finden. Beginne mit der zuletzt installierten oder zuletzt aktualisierten Mod. Starte den Server nach jeder Änderung neu und prüfe das Log. Wenn der Server ohne Mods startet, aber mit einer bestimmten Mod abstürzt, ist meist eine Abhängigkeit, Version oder Konfiguration die Ursache.
Desync oder Verbindungsprobleme
Stelle sicher, dass alle Spieler die gleichen Mods in passenden Versionen haben. Besonders bei clientpflichtigen Mods reicht es nicht, nur den Server zu ändern. Ein exportiertes r2modman- oder Thunderstore-Profil reduziert Abweichungen und macht Supportfälle leichter nachvollziehbar.
Config wird nicht erstellt
Starte den Server einmal mit installiertem BepInEx und der jeweiligen Mod. Viele Mods schreiben ihre Config erst beim ersten erfolgreichen Laden. Wenn danach keine Datei erscheint, wurde die Mod eventuell nicht geladen, liegt im falschen Ordner oder ist mit der aktuellen Umgebung nicht kompatibel.
Prüfung, Grenzen und sicherer Rückweg
Die Anleitung „Valheim Mods mit BepInEx installieren – Schritt für Schritt“ gilt für den im Artikel beschriebenen Servertyp und den zum Prüfzeitpunkt sichtbaren Versionsstand. Menünamen, verfügbare Versionen, Mod- oder Plugin-Kompatibilität und benötigte Ressourcen können nach Updates abweichen. Übertrage deshalb keine Werte ungeprüft auf eine andere Spiel-, Loader- oder Serverversion.
Erstelle vor Änderungen an Welt, Spielstand, Konfiguration oder Erweiterungen ein Backup der betroffenen Dateien. Ändere anschließend nur einen zusammengehörigen Schritt und prüfe ihn mit derselben Client- und Serverversion, mit der du später spielen möchtest.
| Prüfpunkt | Erwartetes Ergebnis | Abbruch und Rückweg |
|---|---|---|
| Serverstart | Der Server erreicht ohne neue Fehlermeldung den betriebsbereiten Zustand. | Bei Startfehlern Änderung zurücknehmen und das letzte Backup einspielen. |
| Verbindungstest | Ein Testkonto kann über die im Panel angezeigte Adresse verbinden. | Bei Versions- oder Verbindungsfehlern Version, Port und Freigaben erneut abgleichen. |
| Funktionstest | Die konkret geänderte Funktion arbeitet, ohne bestehende Welt- oder Spieldaten zu beschädigen. | Bei Nebenwirkungen Server stoppen und gesicherte Dateien wiederherstellen. |
Ein erfolgreicher Einzeltest ist keine Leistungs- oder Verfügbarkeitsgarantie. Weltgröße, Mods, Plugins, Spielerzahl, Netzwerkweg und gleichzeitige Last können das Ergebnis verändern. Dokumentiere Version, Änderung und Testergebnis, damit du spätere Abweichungen nachvollziehen kannst.
FAQ
Muss BepInEx auf Server und Client installiert sein?
Für viele Valheim-Mods ja. Wenn eine Mod clientpflichtig ist, brauchen Server und Spieler dieselbe oder kompatible Version. Prüfe das immer auf der jeweiligen Mod-Seite.
Kann ich Valheim Mods nur über Thunderstore installieren?
Nein, du kannst DLLs auch manuell in BepInEx/plugins/ ablegen. Thunderstore Mod Manager und r2modman erleichtern aber den Versionsabgleich und die Verteilung an Mitspieler.
Warum startet mein Server nach einer Mod nicht mehr?
Häufige Ursachen sind falsche BepInEx-Versionen, fehlende Abhängigkeiten, inkompatible Mod-Versionen oder Dateien im falschen Ordner. Entferne Mods schrittweise und prüfe nach jedem Neustart das Log.
Wo liegen die Konfigurationen der Mods?
Viele BepInEx-Mods erzeugen ihre Konfiguration in BepInEx/config/. Die Dateien erscheinen oft erst nach dem ersten erfolgreichen Serverstart mit installierter Mod.
Sollte ich alle Mods gleichzeitig installieren?
Besser nicht. Installiere Mods nacheinander oder in kleinen Gruppen, damit du Fehler eindeutig zuordnen kannst. Das spart Zeit, wenn der Server abstürzt oder Clients nicht verbinden können.