BepInEx auf dem Valheim-Server installieren und Mods (.dll) hinzufügen
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:\ValheimServerundstart_north.bat; unter Linux den Benutzersteam,/home/steam/valheim,start_north.shund den systemd-Dienst namensvalheim. - Saubere Installation: Das Paket benötigt einen unveränderten Valheim-Ordner. Wenn Sie BepInEx schon einmal ausprobiert haben, verschieben Sie den alten Ordner
BepInExund die Dateiwinhttp.dllaus dem Serverordner heraus. - Backup: Legen Sie vor dem Hinzufügen von Mods eine Kopie Ihrer Weltdateien (
.dbund.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-Typ | Wo er installiert wird | Typisches Beispiel |
|---|---|---|
| Nur Server (Server-side) | Nur auf dem Server; die Spieler müssen ihn nicht installieren | Spielerlimit ändern, geplante Befehle oder Neustarts, Discord-Benachrichtigungen |
| Nur Client (Client-side) | Nur auf dem Computer des Spielers | Persönliche Anpassungen wie Oberfläche und Kamera |
| Server und Client | Auf beiden Seiten, in derselben Version | Mods, 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:
- Prüfen Sie auf den Thunderstore-Seiten Ihrer Mods die Hinweise zur neuen Spielversion und die Kennzeichnung Deprecated (nicht mehr gepflegt).
- Stoppen Sie den Server; sichern Sie die Weltdateien sowie die Ordner
BepInEx/pluginsundBepInEx/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. - Aktualisieren Sie den Server mit SteamCMD. Laut Valve prüft
validatenur die Dateien der Standardinstallation; nachträglich hinzugefügte BepInEx-Dateien bleiben unberührt. - 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. - 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):
| Element | Plattform | Aufgabe |
|---|---|---|
BepInEx/plugins | Windows und Linux | Die .dll-Dateien der Mods |
BepInEx/config | Windows und Linux | BepInEx.cfg und die Konfigurationsdateien <GUID>.cfg der Mods |
BepInEx/LogOutput.log | Windows und Linux | BepInEx-Log; wird bei jedem Start neu geschrieben |
winhttp.dll, doorstop_config.ini | Windows | Laden BepInEx beim Start; enabled = true muss gesetzt sein |
doorstop_libs, start_server_bepinex.sh | Linux | Bibliothek und Startskript, die BepInEx laden |
start_north.bat / start_north_bepinex.sh | Windows / Linux | Ihr eigenes Startskript; von Updates nicht betroffen |
In der Datei org.bepinex.plugins.valheim_plus.cfg des ValheimPlus-Forks der Abschnitt [Server]:
| Einstellung | Beispielwert | Funktion |
|---|---|---|
enabled | true | Aktiviert den Abschnitt |
maxPlayers | 10 | Maximale Anzahl Spieler auf dem Server |
enforceMod | true | Nur Spieler mit derselben ValheimPlus-Version können beitreten |
serverSyncsConfig | true | Sendet 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
BepInExkopiert; auchwinhttp.dllunddoorstop_config.inimüssen im selben Ordner wievalheim_server.exeliegen, und indoorstop_config.inimussenabled = truestehen. Unter Linux startet der Server möglicherweise noch mit dem altenstart_north.sh; prüfen Sie die ZeileExecStartin 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,MissingFieldExceptionoder „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
- Valheim-Server einrichten: SteamCMD auf einem Windows- und Linux-VDS
- Valheim-Spielstand (Save) sichern und umziehen
- Valheim-Crossplay-Server (Steam & Xbox) einrichten
- Valheim-Server: Ports 2456-2458 UDP öffnen und „Disconnected“ beheben
- Valheim: Server-Performance verbessern und Desync (Verzögerung) beheben
Weitere Artikel finden Sie auf der Seite Valheim-Anleitungen.
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.