Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

Anleitungen

Schritt-für-Schritt-Anleitungen, um Ihren eigenen Server, Gameserver und Ihre Website einzurichten und zu betreiben – vom Team, das unsere Infrastruktur in Istanbul betreibt.

Valheim

BepInEx auf dem Valheim-Server installieren und Mods (.dll) hinzufügen

26 August 2026 13 Min. Lesezeit Aktualisiert:
Diesen Beitrag teilen

In dieser Anleitung installieren Sie die Mod-Grundlage BepInExPack_Valheim unter Windows und Linux auf Ihrem Valheim Dedicated Server, legen Mods mit der Endung .dll im Ordner BepInEx/plugins ab und bearbeiten deren Einstellungen. Außerdem sehen Sie, wie Sie die Installation anhand des Logs überprüfen, die Versionen mit den Spielern abgleichen und bei Updates Ordnung halten.

Bevor Sie beginnen

  • Ein laufender Valheim-Server: Der Server muss mit SteamCMD installiert und mindestens einmal ohne Mods gestartet worden sein; andernfalls folgen Sie zuerst der Anleitung zur Einrichtung eines Valheim-Servers von Grund auf. Die Beispiele verwenden den dortigen Aufbau: unter Windows C:\ValheimServer und start_north.bat; unter Linux den Benutzer steam, /home/steam/valheim, start_north.sh und den systemd-Dienst namens valheim.
  • Saubere Installation: Das Paket benötigt einen unveränderten Valheim-Ordner. Wenn Sie BepInEx schon einmal ausprobiert haben, verschieben Sie den alten Ordner BepInEx und die Datei winhttp.dll aus dem Serverordner heraus.
  • Backup: Legen Sie vor dem Hinzufügen von Mods eine Kopie Ihrer Weltdateien (.db und .fwl) außerhalb des Servers an. Bei VDS-Paketen sind automatische Backups nicht enthalten; die Vorgehensweise finden Sie in der Anleitung zum Sichern und Übertragen von Spielständen.
  • Ein einfacher Ordnerpfad: Laut BepInEx-Dokumentation verursachen manche Unity-Mono-Versionen Probleme bei sehr langen Pfaden oder bei Pfaden mit nicht-englischen Zeichen. Der Pfad zum Serverordner sollte keine Umlaute wie ä, ö, ü und kein ß enthalten.
  • Ressourcenreserve: Beobachten Sie beim Hinzufügen von Mods die CPU- und RAM-Auslastung in den Live-Nutzungsdiagrammen im Kundenbereich. Paketoptionen finden Sie auf der Seite Valheim-Server.

1. Festlegen, welcher Mod wo läuft

BepInEx ist ein Framework, das Plugins in mit Unity erstellte Spiele lädt; da Valheim keinen eigenen Mod-Ordner hat, werden .dll-Mods darüber geladen. Nicht jeder Mod wird sowohl auf dem Server als auch beim Spieler benötigt; teilen Sie Ihre Mods daher zuerst in drei Gruppen ein:

Mod-TypWo er installiert wirdTypisches Beispiel
Nur Server (Server-side)Nur auf dem Server; die Spieler müssen ihn nicht installierenSpielerlimit ändern, geplante Befehle oder Neustarts, Discord-Benachrichtigungen
Nur Client (Client-side)Nur auf dem Computer des SpielersPersönliche Anpassungen wie Oberfläche und Kamera
Server und ClientAuf beiden Seiten, in derselben VersionMods, die neue Gegenstände, Bauteile oder Kreaturen hinzufügen, Einstellungen vom Server synchronisieren oder Versionen prüfen

Auf Thunderstore sind Valheim-Mods mit den Kategorien Server-side und Client-side gekennzeichnet; verbindlich ist dennoch die Beschreibung des jeweiligen Mods. Xbox-Spieler können keine Mods installieren und haben möglicherweise Probleme, modifizierten Servern beizutreten.

2. BepInExPack_Valheim herunterladen

Verwenden Sie nicht die allgemeine BepInEx-Version von GitHub, sondern das Paket BepInExPack_Valheim auf Thunderstore. Dieses Paket enthält eine für Valheim vorkonfigurierte BepInEx.cfg (Konsole aktiviert, korrekter Einstiegspunkt) und Startskripte für Linux; die allgemeine Version ist dagegen nicht auf Valheim abgestimmt und kann den Server zum Absturz bringen. Zum Zeitpunkt der Erstellung dieser Anleitung ist die aktuelle Paketversion 5.4.2351 (basierend auf BepInEx 5.4.23.5).

Sie können das Paket direkt auf den Server herunterladen; ersetzen Sie die Versionsnummer am Ende der Adresse durch die aktuelle Version von der Paketseite. Unter Windows in einer PowerShell mit Administratorrechten:

Invoke-WebRequest -UseBasicParsing -Uri https://thunderstore.io/package/download/denikson/BepInExPack_Valheim/5.4.2351/ -OutFile C:\bepinex.zip
Expand-Archive -Path C:\bepinex.zip -DestinationPath C:\BepInExPaket -Force

Meldet der Befehl einen Verbindungsfehler, laden Sie die Zip-Datei über die Schaltfläche Manual Download auf der Paketseite im Browser herunter. Entpacken Sie das Archiv gemäß dem Hinweis der Maintainer nicht in den Serverordner, sondern in einen separaten Ordner.

Installieren Sie unter Linux zuerst mit Ihrem Administratorbenutzer das Werkzeug unzip, wechseln Sie dann zum Benutzer steam und laden Sie das Paket herunter:

sudo apt install unzip
sudo -iu steam
wget -O /home/steam/bepinex.zip https://thunderstore.io/package/download/denikson/BepInExPack_Valheim/5.4.2351/
unzip -o /home/steam/bepinex.zip -d /home/steam/bepinex-paket
exit

Das Archiv enthält einen Ordner namens BepInExPack_Valheim; die zu installierenden Dateien sind dessen Inhalt.

3. Windows: Paket in den Serverordner kopieren

Läuft der Server, stoppen Sie ihn im Konsolenfenster mit Strg+C. Kopieren Sie dann den gesamten Inhalt des Ordners BepInExPack_Valheim (nicht nur den Ordner BepInEx) in den Ordner, in dem sich die Datei valheim_server.exe befindet:

Copy-Item -Path C:\BepInExPaket\BepInExPack_Valheim\* -Destination C:\ValheimServer -Recurse -Force

Nach dem Kopieren sollten in C:\ValheimServer der Ordner BepInEx, winhttp.dll und doorstop_config.ini zu sehen sein. Diese beiden Dateien bilden die Komponente Unity Doorstop, die BepInEx beim Start des Servers lädt; deshalb müssen Sie Ihr Startskript nicht ändern. Starten Sie den Server wie gewohnt mit start_north.bat.

4. Linux: Server mit start_server_bepinex.sh starten

Unter Linux wird BepInEx nicht automatisch geladen; das mitgelieferte Skript start_server_bepinex.sh setzt die nötigen Umgebungsvariablen und startet den Server. Stoppen Sie den Server mit Ihrem Administratorbenutzer, wechseln Sie dann zum Benutzer steam, kopieren Sie das Paket in den Serverordner und legen Sie eine Kopie des Skripts an:

sudo systemctl stop valheim
sudo -iu steam
cp -a /home/steam/bepinex-paket/BepInExPack_Valheim/. /home/steam/valheim/
cd /home/steam/valheim
cp start_server_bepinex.sh start_north_bepinex.sh
chmod u+x start_north_bepinex.sh
nano start_north_bepinex.sh

Die Kopie schützt Ihre Einstellungen davor, bei einem Paketupdate mit dem Originalskript überschrieben zu werden. Die Zeilen DOORSTOP_, LD_LIBRARY_PATH und LD_PRELOAD im oberen Teil des Skripts laden BepInEx; ändern Sie sie nicht. Passen Sie nur die Parameter der untersten Zeile exec ./valheim_server.x86_64 an die Ihres bisherigen Skripts start_north.sh an:

exec ./valheim_server.x86_64 -name "North Clan" -port 2456 -world "Midgard" -password "Odin2456x"

Das Skript gibt Dateipfade mit ./ an, also relativ zu dem Ordner, in dem es liegt; deshalb muss es aus dem Serverordner heraus ausgeführt werden. Dafür sorgt die Zeile WorkingDirectory=/home/steam/valheim in der Dienstdatei aus der Installationsanleitung. Verlassen Sie mit exit den Benutzer steam, öffnen Sie die Dienstdatei mit sudo nano /etc/systemd/system/valheim.service und ändern Sie nur die Zeile ExecStart:

ExecStart=/bin/sh /home/steam/valheim/start_north_bepinex.sh

Laden Sie den Dienst neu, starten Sie ihn und verfolgen Sie das Log:

sudo systemctl daemon-reload
sudo systemctl start valheim
journalctl -u valheim -f

Ist die Installation korrekt, erscheinen im Log die Startmeldungen (Bootstrap) von BepInEx.

5. Prüfen, ob BepInEx geladen wird

Beim ersten Start legt BepInEx den Ordner BepInEx/config und die Logdatei BepInEx/LogOutput.log an; das Log wird bei jedem erfolgreichen Start neu geschrieben. Unter Windows liegt die Datei unter C:\ValheimServer\BepInEx\LogOutput.log, unter Linux unter /home/steam/valheim/BepInEx/LogOutput.log. Am Anfang sollte eine Zeile wie die folgende stehen, die die Paketversion meldet:

[Message:   BepInEx] User is running BepInExPack Valheim version 5.4.2351 from Thunderstore

Wenn Sie unsicher sind, stoppen Sie den Server, löschen Sie die Datei LogOutput.log und starten Sie ihn neu; entsteht kein neues Log, wird BepInEx nicht geladen (siehe „Häufige Fehler“).

Legen Sie den Ordner BepInEx/plugins, in den die Mods kommen, an, falls er nicht existiert. Unter Windows:

New-Item -ItemType Directory -Force -Path C:\ValheimServer\BepInEx\plugins

Unter Linux so, dass der Benutzer steam Eigentümer ist:

sudo -u steam mkdir -p /home/steam/valheim/BepInEx/plugins

6. Mod (.dll) in den Ordner plugins legen

Beziehen Sie Mods aus dem Valheim-Bereich von Thunderstore. Auf der Seite jedes Pakets finden Sie einen Dependency String und eine Liste der Abhängigkeiten. Der String hat die Form Team-Paketname-Version; die einzige Abhängigkeit des ValheimPlus-Forks wird zum Beispiel als denikson-BepInExPack_Valheim-5.4.2351 angegeben. Installieren Sie bei der manuellen Installation zuerst die Bibliotheken aus der Liste (ein häufiges Beispiel: Jotunn) und danach den Mod selbst.

manifest.json, README.md und icon.png im Stammverzeichnis von Thunderstore-Paketen sind Informationsdateien; der Server benötigt die .dll-Datei des Mods und die in der README genannten Zusatzdateien. Unter Linux können Sie den Mod direkt auf den Server herunterladen; ersetzen Sie Team, Paketname und Version in der Adresse durch die Werte von der Seite des Mods:

sudo -iu steam
wget -O /home/steam/ModName.zip https://thunderstore.io/package/download/TEAM/PAKETNAME/VERSION/
unzip -o /home/steam/ModName.zip -d /home/steam/mod-paket/ModName
find /home/steam/mod-paket/ModName -name "*.dll"
cp /home/steam/mod-paket/ModName/ModName.dll /home/steam/valheim/BepInEx/plugins/

Den Pfad, den der Befehl find anzeigt, verwenden Sie in der cp-Zeile; bei manchen Paketen liegt die .dll in einem Unterordner. Laden Sie unter Windows die Zip-Datei über die Schaltfläche Manual Download auf der Paketseite herunter, entpacken Sie sie und kopieren Sie die .dll-Datei in den Ordner C:\ValheimServer\BepInEx\plugins.

Starten Sie den Server neu und suchen Sie im Log nach der Zeile, die das Laden des Mods anzeigt. Unter Windows in PowerShell:

Select-String -Path C:\ValheimServer\BepInEx\LogOutput.log -SimpleMatch -Pattern "Loading ["

Unter Linux verlassen Sie mit exit den Benutzer steam und führen mit Ihrem Administratorbenutzer aus:

sudo systemctl restart valheim
sudo grep -F "Loading [" /home/steam/valheim/BepInEx/LogOutput.log

Für jeden geladenen Mod sollten Sie eine Zeile der Form [Info : BepInEx] Loading [ModName 1.2.3] sehen. Legen Sie nicht zwei Kopien desselben Mods ab: BepInEx erkennt Plugins an ihrer eindeutigen Kennung (GUID) und lädt von mehreren Kopien nur die neueste Version.

7. Mod-Einstellungen bearbeiten

Mods, die das Konfigurationssystem von BepInEx nutzen, legen beim ersten Start im Ordner BepInEx/config eine Datei namens <GUID>.cfg an. Starten und stoppen Sie den Server nach dem Hinzufügen des Mods einmal, bearbeiten Sie die Datei dann mit einem Texteditor und starten Sie den Server neu. Bei Mods, die Einstellungen vom Server an die Spieler synchronisieren, übernehmen die Spieler die Werte des Servers; nehmen Sie Änderungen bei diesen Mods in der Datei auf dem Server vor.

Ein gutes Beispiel dafür ist das in älteren Anleitungen häufig erwähnte ValheimPlus. Die letzte Version des ursprünglichen Projekts ist 0.9.9.11, und es wird seit Langem nicht mehr aktualisiert. Für aktuelle Valheim-Versionen wird der Community-Fork verwendet, der auf Thunderstore unter dem Namen ValheimPlus_Grantapher_Temporary veröffentlicht ist. In dieser Version heißt die Konfigurationsdatei nicht valheim_plus.cfg, sondern org.bepinex.plugins.valheim_plus.cfg; wird eine Datei mit dem alten Namen gefunden, wird sie einmalig importiert. Der Mod muss sowohl auf dem Server als auch bei den Spielern installiert sein. Die Einstellungen im Serverabschnitt finden Sie in der Tabelle zur Beispielkonfiguration weiter unten.

8. Dafür sorgen, dass die Spieler dieselben Mods installieren

Geben Sie den Spielern für die Mods, die auch auf dem Client benötigt werden, die vollständige Liste mit Versionsnummern. Am einfachsten ist für die Spieler ein Mod-Manager wie Gale, Thunderstore Mod Manager oder r2modman; er installiert BepInExPack und die Abhängigkeiten selbst. In r2modman können Sie durch Exportieren (Export) des Profils die Mod-Liste und die Einstellungen mit anderen teilen. Ein Spieler, der manuell installieren möchte, kopiert den Paketinhalt in den Ordner steamapps\common\Valheim und legt die Mods im dortigen Ordner BepInEx\plugins ab.

Wenn Sie den Aufbau zuerst auf Ihrem eigenen Computer mit r2modman getestet haben, können Sie in den Profileinstellungen mit Browse profile folder den Profilordner öffnen und den Inhalt von BepInEx\plugins und BepInEx\config in dieselben Ordner auf dem Server kopieren; übertragen Sie dabei keine reinen Client-Mods.

Stimmen die Versionen nicht überein, weist der Server den Spieler ab. Bei Mods, die Jotunn verwenden, prüft der Server; der Spieler sieht ein Fehlerfenster, das anzeigt, welches Plugin (GUID) in welcher Version nicht übereinstimmt.

9. Bei Updates Ordnung halten

Nach Valheim-Updates funktionieren Mods unter Umständen nicht mehr; wie lange die Anpassung der Mods an die neue Version dauert, hängt von deren Autoren ab. Wenn der Client der Spieler aktualisiert wurde, aktualisieren Sie auch den Server in dieser Reihenfolge:

  1. Prüfen Sie auf den Thunderstore-Seiten Ihrer Mods die Hinweise zur neuen Spielversion und die Kennzeichnung Deprecated (nicht mehr gepflegt).
  2. Stoppen Sie den Server; sichern Sie die Weltdateien sowie die Ordner BepInEx/plugins und BepInEx/config. Da der Cloud-Backup-Speicher Zugriff per SFTP und WebDAV bietet, ist er ein geeignetes Ziel für eine Kopie außerhalb des Servers.
  3. Aktualisieren Sie den Server mit SteamCMD. Laut Valve prüft validate nur die Dateien der Standardinstallation; nachträglich hinzugefügte BepInEx-Dateien bleiben unberührt.
  4. Gibt es eine neue Paketversion, laden Sie BepInExPack wie in Schritt 2 herunter und kopieren Sie es wie in Schritt 3 oder 4 erneut. Die Konfigurationsdateien der Mods bleiben erhalten. Vergleichen Sie unter Linux Ihre eigene Skriptkopie mit der neuen start_server_bepinex.sh.
  5. Aktualisieren Sie die Mods auf ihre aktuellen Versionen und teilen Sie den Spielern die neue Versionsliste mit.

Beispielkonfiguration: Dateistruktur und Servereinstellungen von ValheimPlus

Nach Abschluss der Installation befinden sich im Serverordner folgende Elemente (Pfade relativ zum Serverordner):

ElementPlattformAufgabe
BepInEx/pluginsWindows und LinuxDie .dll-Dateien der Mods
BepInEx/configWindows und LinuxBepInEx.cfg und die Konfigurationsdateien <GUID>.cfg der Mods
BepInEx/LogOutput.logWindows und LinuxBepInEx-Log; wird bei jedem Start neu geschrieben
winhttp.dll, doorstop_config.iniWindowsLaden BepInEx beim Start; enabled = true muss gesetzt sein
doorstop_libs, start_server_bepinex.shLinuxBibliothek und Startskript, die BepInEx laden
start_north.bat / start_north_bepinex.shWindows / LinuxIhr eigenes Startskript; von Updates nicht betroffen

In der Datei org.bepinex.plugins.valheim_plus.cfg des ValheimPlus-Forks der Abschnitt [Server]:

EinstellungBeispielwertFunktion
enabledtrueAktiviert den Abschnitt
maxPlayers10Maximale Anzahl Spieler auf dem Server
enforceModtrueNur Spieler mit derselben ValheimPlus-Version können beitreten
serverSyncsConfigtrueSendet beitretenden Spielern die Einstellungen des Servers; die eigene Datei des Spielers bleibt unverändert

Die Mod-Entwickler empfehlen, enforceMod und serverSyncsConfig nicht abzuschalten.

Häufige Fehler

  • LogOutput.log wird nicht angelegt, Mods werden nicht geladen: Unter Windows wurde aus dem Paket möglicherweise nur der Ordner BepInEx kopiert; auch winhttp.dll und doorstop_config.ini müssen im selben Ordner wie valheim_server.exe liegen, und in doorstop_config.ini muss enabled = true stehen. Unter Linux startet der Server möglicherweise noch mit dem alten start_north.sh; prüfen Sie die Zeile ExecStart in der Dienstdatei. Eine ausführliche Checkliste finden Sie in der Fehlerbehebungsdokumentation von BepInEx.
  • „Permission denied“ unter Linux: Wenn Sie die Dateien als root kopiert haben, korrigieren Sie die Eigentümerschaft mit sudo chown -R steam:steam /home/steam/valheim.
  • Fenster mit Versionskonflikt (Version Mismatch) beim Verbinden: Vergleichen Sie GUIDs und Versionen im Fenster mit den Loading [-Zeilen auf dem Server und gleichen Sie die Mods des Spielers an. Ist die Mod-Liste des Servers (remote) im Fenster leer, liegt das Problem nicht beim Spieler, sondern daran, dass BepInEx auf dem Server nicht geladen wird.
  • Schwarzer Bildschirm nach dem Verbinden: Laut der Seite zur Server-Fehlerbehebung der Valheim-Modding-Community wird dies meist durch einen Mod verursacht, der eine veraltete ServerSync-Version verwendet. Entfernen Sie die zuletzt hinzugefügten Mods einzeln, um den problematischen zu finden.
  • MissingMethodException, MissingFieldException oder „Could not find method“ im Log: Der Mod ist mit der aktuellen Spielversion nicht kompatibel. Der Mod-Name im Stack Trace der Fehlerzeile verweist auf den problematischen Mod; aktualisieren oder entfernen Sie ihn.
  • Absturz beim Start nach einem Spielupdate: Meist passt die BepInExPack-Version nicht zur Spielversion; aktualisieren Sie das Paket auf die aktuelle Version auf Thunderstore.

Häufig gestellte Fragen

Müssen die Spieler auch BepInEx installieren?

Wenn Sie nur Mods verwenden, die auf der Serverseite laufen, nein; die Spieler können sich mit einem Valheim ohne Mods verbinden. Gibt es auch nur einen Mod, der auf Server und Client gemeinsam laufen muss, muss jeder Spieler BepInExPack und dieselbe Version dieses Mods installieren.

Kann ich Mods vorübergehend deaktivieren?

Ja. Ändern Sie unter Windows in der Datei doorstop_config.ini den Wert enabled = true auf false und starten Sie den Server neu. Stellen Sie unter Linux die Zeile ExecStart in der Dienstdatei auf Ihr altes Skript start_north.sh zurück. Um einen einzelnen Mod zu deaktivieren, genügt es, die betreffende .dll-Datei aus dem Ordner plugins zu verschieben. Sichern Sie vor dem Deaktivieren Ihre Welt.

Kann ich auf einem Server mit Mods Crossplay nutzen?

Das wird nicht empfohlen. Xbox-Spieler können keine Mods installieren, und die Modding-Community rät, auf Servern mit Mods auf Crossplay zu verzichten, da viele Mods es nicht unterstützen. Ist Crossplay unverzichtbar, verwenden Sie nur serverseitige Mods. Einzelheiten finden Sie in der Crossplay-Anleitung.

Verwandte Anleitungen

Weitere Artikel finden Sie auf der Seite Valheim-Anleitungen.

Kommentare0

Noch keine Kommentare

Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.

Diskutieren Sie mit

Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.

Keinen Beitrag verpassen

Erhalten Sie unsere neuesten Tutorials, Anleitungen und Produktneuigkeiten direkt in Ihr Postfach.

Sie haben unseren Newsletter abonniert.