So installierst du Mods auf einem Project Zomboid Server (Build 42)
Steam Workshop-Mods zu einem Project Zomboid-Dedicated-Server hinzuzufügen erfordert drei Informationen pro Mod und zwei Zeilen in deiner Server-Konfiguration. Diese Anleitung führt Schritt für Schritt durch den Prozess für einen Build 42 Multiplayer-Server, der auf einem Pterodactyl-basierten Panel gehostet wird (einschließlich DoomHosting).
Build 42 Hinweis: Multiplayer befindet sich derzeit im Unstable-Branch. Viele Build 41-Mods funktionieren nicht auf Build 42 — prüfe immer die Workshop-Seite auf eine ausdrückliche "B42 supported"-Markierung, bevor du sie hinzufügst.
Schnellreferenz
| Feld | Wo findest du es |
|---|---|
| Workshop ID | Numerische ID in der Workshop-URL (z. B. ?id=2392709985) |
| Mod ID | In der Workshop-Beschreibung als Mod ID: ExampleMod |
| Map-Ordnername | Nur bei Map-Mods, z. B. Map Folder: Bedford Falls |
Schritt 1 — Server vor dem Bearbeiten stoppen
Project Zomboid überschreibt sowohl servertest.ini als auch servertest_SandboxVars.lua beim Herunterfahren. Wenn du bei laufendem Server bearbeitest, werden deine Änderungen überschrieben. Stoppe den Server zuerst über dein Panel.
Schritt 2 — servertest.ini im Dateimanager öffnen
Navigiere zu:
/home/container/Zomboid/Server/servertest.ini
Wenn du den Server umbenannt hast, verwendet die Datei deinen Namen (z. B. MyServer.ini). Öffne sie im Panel-Editor oder per SFTP.
Schritt 3 — WorkshopItems- und Mods-Zeilen hinzufügen
Suche diese beiden Zeilen (sie existieren standardmäßig, sind aber meist leer):
WorkshopItems=
Mods=
Füge deine IDs durch Semikolons getrennt hinzu. Beispiel mit drei Mods (Common Sense, Brita's Weapon Pack, ModOptions):
WorkshopItems=2685168362;2900665603;2169435993
Mods=Common Sense;Brita;ModOptions
WorkshopItems sagt SteamCMD, welche Mods herunterzuladen sind. Mods sagt dem Spiel, welche Mods tatsächlich geladen werden sollen. Beide müssen ausgefüllt sein — und die Reihenfolge in Mods= steuert die Ladereihenfolge.
Schritt 4 — Map-Mods hinzufügen
Map-Mods benötigen eine zusätzliche Zeile. Map= steuert, aus welcher Map die Welt generiert wird. Standard (Knox County) ist Muldraugh, KY. Um Bedford Falls zu verwenden:
WorkshopItems=2392709985
Mods=BedfordFalls
Map=BedfordFalls;Muldraugh, KY
Beende die Map=-Kette immer mit Muldraugh, KY, damit Vanilla-Map-Referenzen weiterhin funktionieren.
Schritt 5 — Empfohlene Mod-Ladereihenfolge
Mod-Konflikte sind häufig. Verwende diese Ladereihenfolge in deiner Mods=-Zeile:
- Map-Mods
- Tile Packs (z. B.
Tile Pack v1) - Frameworks (Common Sense, ModOptions, etc.)
- Fahrzeug-Mods
- Waffen- und Item-Mods
- UI- und QoL-Mods zuletzt
Schritt 6 — Speichern, neu starten und Konsole beobachten
Speichere die Datei und starte den Server. SteamCMD lädt jede Workshop-ID aus der Liste herunter. Erstdownloads können bei einer großen Modliste 5–15 Minuten dauern. Achte auf Konsolenzeilen wie:
LOG : General , 1234567890, Mod "BedfordFalls" loaded.
Wenn Mod "X" not found erscheint, prüfe, ob die Mod ID exakt mit der Workshop-Beschreibung übereinstimmt — sie ist case-sensitiv.
Wo Mods heruntergeladen werden
SteamCMD speichert gecachte Mods in:
/home/container/Zomboid/Workshop/
/home/container/Zomboid/steamapps/workshop/content/108600/
Wenn eine Mod nicht aktualisiert wird, erzwingt das Löschen dieser Ordner einen frischen Re-Download beim nächsten Start.
Spieler benötigen dieselben Mods
Sowohl der Server als auch jeder verbindende Spieler müssen dieselben Mods aktiviert haben. Spieler, die beitreten, werden automatisch aufgefordert, fehlende Mods zu abonnieren — sie müssen das Spiel nach dem Abonnieren nur neu starten.
Häufige Fehler und Lösungen
"Mod not found in PZModFileSystem" — falsche Mod ID. Öffne die Workshop-Seite und kopiere die ID aus der Beschreibung (nicht aus dem Titel).
Server crasht beim Start nach dem Hinzufügen einer Mod — falsche Ladereihenfolge oder zwei Mods im Konflikt. Entferne die Mod und prüfe die Workshop-Kommentare auf Kompatibilitätsprobleme.
Workshop-Downloads bleiben bei 0% hängen — SteamCMD-Authentifizierung fehlgeschlagen. Starte den Server neu; meist erholt er sich beim zweiten Versuch.
Mod funktioniert in Singleplayer, aber nicht in Multiplayer — viele Mods benötigen servertest_spawnregions.lua-Updates oder haben "SP only"-Hinweise im Workshop.
FAQ
Muss ich den Server jedes Mal neu starten, wenn ich eine Mod hinzufüge?
Ja. Mod-Laden geschieht nur beim Start. Eine Mod live über /changeoption hinzuzufügen funktioniert für Mod-Felder nicht.
Kann ich Mods außerhalb des Steam Workshop installieren?
Ja — lege den Mod-Ordner in /home/container/Zomboid/mods/ und füge nur die Mod ID (nicht die Workshop ID) zu deiner Mods=-Zeile hinzu.
Wie viele Mods sind zu viele? Die meisten B42-Server laufen problemlos mit 20–60 Mods. Über 80 Mods solltest du mit doppelt so langen Boot-Zeiten und höherem RAM-Verbrauch rechnen. Verwende unseren RAM-Rechner, um zu planen.
Beeinflussen Mods die Server-Performance? Ja. Schwere Gameplay-Mods (Brita's, Fahrzeug-Erweiterungen) fügen 1–3 GB RAM hinzu und können das Chunk-Laden verlangsamen. Leichte QoL-Mods sind praktisch kostenlos.