Wie installiere ich Mods auf meinem Valheim-Server?

Achtung

Um einem modifizierten Server beizutreten, müssen alle Spieler dieselben Mods auf ihrem Client installieren. Das Panel installiert Dateien nur auf dem Dedicated Server.

Valheim-Mods nutzen BepInEx. Bei AleForge wechselst du den Server mit Game Swap auf Valheim BepInEx und installierst danach Pakete von Thunderstore im Mod Manager.

Mit Game Swap zu Valheim BepInEx wechseln

Vanilla-Valheim kann keine BepInEx-Plugins laden. Wenn du schon auf einer Valheim-BepInEx-Instanz bist, überspringe diesen Abschnitt.

1. Öffne das AleForge Panel
2. Stoppe den Server
3. Öffne Backups und erstelle ein Backup
4. Öffne Game Swap
5. Klicke auf einem leeren Slot auf New Game
6. Suche Valheim und wähle das Valheim-Template
7. Unter Server Version / Type wähle Valheim BepInEx
8. Lass Backup Active Server an, damit die aktuelle Instanz in diesem Slot gespeichert wird
9. Klicke Confirm Action und warte, bis die Installation fertig ist

Achtung

Die neue BepInEx-Instanz startet eine neue Welt. Backup Active Server legt deine bisherige Instanz in einem Game-Swap-Slot ab. Die Welt wird nicht auf BepInEx kopiert. Dieselbe Karte behalten: nach dem Wechsel wiederherstellen und World Name unter Startup anpassen. Siehe Wie lade ich meine Valheim-Welt hoch?.

Wenn der Wechsel fertig ist, installiere Mods und starte den Server danach.

Mods mit dem Mod Manager installieren

Der Mod Manager liegt in der Server-Seitenleiste. Er durchsucht den Thunderstore-Katalog für Valheim.

1. Öffne deinen Valheim-BepInEx-Server im AleForge Panel
2. Klicke in der Seitenleiste auf Mod Manager
3. Bleibe bei Mods oder wechsle zu Modpacks
4. Suche und sortiere nach Most Popular, Last Updated oder Newest
5. Lass Hide client-side aktiv, außer du brauchst bewusst ein reines Client-Paket
6. Klicke bei einem Mod auf Install, bei einem Modpack auf Install pack und danach auf Confirm install
7. Warte, bis der Fortschrittsbalken fertig ist
8. Starte den Server neu, damit die Plugins geladen werden

Mods werden nicht im laufenden Betrieb geladen. Starte nach jeder Installation, Deinstallation oder jedem Update neu.

Abhängigkeiten werden automatisch mitinstalliert. Bereits installierte Pakete zeigen Installed. BepInEx selbst kann auf dieser Seite nicht deinstalliert werden.

Modpacks

Der Tab Modpacks ist eine eigene Thunderstore-Liste. Die Installation eines Packs verlangt eine Bestätigung. Optional: Replace existing plugins leert /BepInEx/plugins vor dem Pack (BepInEx selbst bleibt).

Installiert und deinstallieren

Installed listet Pakete, die der Mod Manager auf den Server gelegt hat. Klicke auf Uninstall, dann auf Confirm. ZIP-Dateien, die du über Files nach BepInEx/plugins gelegt hast, erscheinen hier nicht.

Updates

Öffne Updates, klicke auf Check for Updates und danach auf Install all updates, wenn etwas hinterherhinkt. Starte neu (oder Start server, wenn der Server offline ist), wenn das Panel danach fragt.

Client-Mods

Spieler brauchen dieselben Thunderstore-Pakete auf ihrem PC. Installiere lokal BepInExPack Valheim und danach dieselben Mods wie auf dem Server. Ein Thunderstore-Client wie r2modman oder Gale ist der übliche Weg.

Manueller Upload (optional)

Nur nutzen, wenn ein Paket nicht auf Thunderstore liegt oder du bereits ein ZIP hast.

Achtung

Wenn die ZIP größer als 1 GB ist, per SFTP hochladen.

1. Stoppe den Server
2. Öffne Files
3. Gehe zu BepInEx/plugins
4. Lade die ZIP hoch und wähle Unarchive
5. Starte den Server

Manuelle Uploads erscheinen nicht unter Installed oder Updates im Mod Manager.

Wenn die Installation fehlschlägt

Wenn der Mod Manager fehlende BepInEx-Doorstop-Dateien meldet, installiere mit Game Swap eine neue Valheim-Instanz und setze Server Version / Type auf Valheim BepInEx. Ändere den Startbefehl nicht von Hand, um BepInEx zu erzwingen.

Für Weltdateien nach einem Wechsel nutze Valheim-Welt hochladen und Backup und Wiederherstellung.