Project-Zomboid-Workshop-Updates mit Weltbackup planen

Ein Workshop-Mod kann sich ändern, obwohl seine Workshop-Seite und der Eintrag im Serverprofil gleich bleiben. Plane deshalb Updates mit einem geprüften Backup und einer getrennten Testkopie. Am 7. Oktober 2026 ist Build 42.21 der Stable-Zweig; Build 41 steht separat über legacy41 bereit. Stelle zuerst fest, welchen Zweig dein Server und deine Spielenden verwenden. The Indie Stone bestätigt Build 42.21 Stable und nennt legacy41 für Build 41.

Was bei einem Workshop-Update passiert

Ein Steam-Workshop-Element bezeichnet den Inhalt, nicht zwingend einen dauerhaft eingefrorenen Stand. Die Steamworks-Dokumentation sagt, dass der Steam-Client Workshop-Inhalte aktuell hält. Diese Aussage betrifft den Client; sie belegt weder automatische oder zeitgleiche Updates auf deinem Server noch eine Updatezusage deiner Hostingverwaltung. Ein Mod-Autor kann beim Einreichen eines Updates eine kurze Änderungsnotiz mitgeben; sie ist optional. Lies darum die Workshop-Änderungen und Abhängigkeiten, statt eine fehlende Notiz als Beleg zu nehmen, dass sich nichts geändert hat. Valve zu Client-Updates · Valve zu optionalen Änderungsnotizen.

Für Project-Zomboid-Server dokumentierte The Indie Stone bereits in einem Entwicklerbeitrag zu Build 32.30, dass der Server die in WorkshopItems= aufgeführten Elemente beim Start herunterlädt, installiert und aktualisiert. Ein aktuellerer Supportfall zeigt eine vom Nutzer bereitgestellte Serverkonfiguration mit einer Workshop-Liste, die laut Kommentar mit Semikolons getrennt wird; ein TIS-Administrator weist darauf hin, dass ein leeres WorkshopItems=-Feld den Download verhindert. Die aktuelle offizielle TIS-API-Dokumentation zu Serveroptionen führt workshopItems als String-Option auf. Sie bestätigt den Schlüssel, aber weder den universellen Profilpfad noch den Downloadzeitpunkt jeder Servervariante. Prüfe deshalb das aktive Profil und die Startmeldungen deiner aktuellen Instanz, bevor du einen Ablauf voraussetzt. TIS-Entwicklerbeitrag zum Startverhalten · TIS-Supportfall mit aktuellem Konfigurationsbeispiel.

Die Datei heisst in Beispielen häufig servertest.ini; der Speicherort hängt aber vom Serverprofil und der Verwaltung ab. Ein TIS-Administrator nennt User/Zomboid/server als üblichen Beispielordner, nicht als universellen Pfad. Öffne die Datei oder den Bereich, den deine aktuelle Serververwaltung dem tatsächlich gestarteten Profil zuordnet. Die Anleitung zu Project-Zomboid-Serverprofilen erklärt, warum Profilnamen und zugehörige Dateien zusammengehören.

Vor dem Update Version und Folgen klären

1. Notiere Build-Zweig, Profilname, Workshop-Elemente, geladene Mod-IDs und bekannte Abhängigkeiten. Die Grundlagen zum Zuordnen der beiden Kennungen stehen im Artikel Workshop-ID und Mod-ID richtig eintragen; dieser Artikel konzentriert sich auf den Änderungsablauf.
2. Lies die Änderungsnotiz des Mod-Autors. Prüfe unterstützte Builds, neue Abhängigkeiten, entfernte Inhalte und bekannte Einschränkungen. Eine Workshop-ID allein fixiert keine Mod-Version. Bei Build 42 kann ein Workshop-Paket versionsbezogene Unterordner enthalten; Build 41 lädt laut The Indie Stone aus dem Paketstamm, während Build 42 eine passende Versions-Unterablage verwenden kann. Das funktioniert nur, wenn der Autor diese Version tatsächlich mitliefert. TIS erklärt die Build-41- und Build-42-Modstruktur.
3. Lege vor einer Änderung eine separate Sicherung des vollständigen Weltstands, der Serverdatenbank, der Konfiguration und der installierten Mod-Dateien an, sofern deine Verwaltung deren Sicherung oder Export ermöglicht. Notiere zusätzlich Build-Zweig, Profil und Mod-Kombination. Stoppe den Server sauber, bevor du Dateien kopierst oder Profilwerte änderst. Prüfe die Kopie und arbeite danach in einer getrennten Testumgebung; teste niemals mit demselben Weltordner, den der laufende Server verwendet.
4. Aktualisiere zuerst nur die Testkopie. Wenn dein Server die gelisteten Workshop-Elemente beim Start abgleicht, beobachte die Startmeldungen auf Downloadfehler, fehlende Abhängigkeiten und nicht geladene Mods. Ändere nicht gleichzeitig den Build-Zweig, die Mod-Liste und weitere Serveroptionen.
5. Verbinde einen Testclient mit demselben Build-Zweig. Prüfe, ob die Mod tatsächlich geladen wird und ob bestehende Figuren, Orte und modabhängige Inhalte im Teststand wie erwartet vorhanden sind. Ein erfolgreicher Serverstart allein beweist keine Save-Kompatibilität.

Weltstand schützen und Fehler eingrenzen

Für den konkreten Test von Build 42.21 Unstable mit Spielständen aus Build 42.20.4 empfiehlt The Indie Stone eine manuelle Sicherung. Die Entwickler dokumentierten ausserdem, dass bestimmte Spielstände aus Build 42.19 Unstable wegen zusätzlicher Karteninhalte nicht mit Build 42.20 kompatibel waren. Das sind versionsgebundene Beispiele, kein Beleg, dass jedes Mod-Update einen Weltstand beschädigt. Die Kompatibilität hängt vom konkreten Build und Inhalt ab. Teste daher die Kombination aus Build, Mod-Version und Abhängigkeiten auf einer Kopie. TIS zur Sicherung beim Test von 42.21 Unstable · TIS zur Save-Grenze zwischen 42.19 und 42.20.

Workshop-Inhalt wird nicht geladen: Kontrolliere das aktive Serverprofil und dessen Workshop-Liste. Ein Eintrag in der Mod-Auswahl allein beweist nicht, dass das gestartete Profil dieselbe Liste nutzt. Mod erscheint trotz Download nicht im Spiel: Vergleiche geladene Mod-IDs und Abhängigkeiten mit der Beschreibung für den gewählten Build. Testkopie startet, aber Inhalte fehlen: Stoppe sie und sichere Logs sowie den Teststand; ändere nicht die Originalwelt, um den Fehler zu überdecken.

Wenn der Test fehlschlägt, stelle die ursprüngliche Kombination nur in einer getrennten Testumgebung wieder her. Das setzt voraus, dass du sowohl den alten Weltstand als auch die vor dem Update installierten Mod-Dateien noch hast oder erneut beziehen kannst. Eine Workshop-ID oder ein Welt- und Konfigurationsbackup stellt die alte Mod-Version nicht wieder her; ohne diese Dateien ist eine vollständige Rückkehr nicht gesichert. Ein altes Weltbackup mit einer anderen Mod-Version kann selbst inkompatibel sein, darum lade es nicht probeweise mit der neuen Kombination. Die Anleitung Gameserver-Backup mit Testwiederherstellung beschreibt die Prüfung einer separaten Sicherung.

Quellen

• The Indie Stone: 42.21 Stable Released – aktueller Stable-Zweig zum Recherchezeitpunkt.
• The Indie Stone: Build 42.20 Released – nennt legacy41 und beschreibt eine konkrete Save-Inkompatibilität zwischen 42.19 Unstable und 42.20.
• The Indie Stone: Tidy Up Time – beschreibt den Unterschied zwischen B41-Mods im Paketstamm und versionsbezogenen B42-Unterordnern.
• The Indie Stone: RELEASED Build 32.30 – älterer Entwicklerbeitrag zum Herunterladen, Installieren und Aktualisieren gelisteter Workshop-Elemente beim Serverstart.
• The Indie Stone Support: Self host with mods issues – aktueller Supportfall mit Serverkonfigurationsbeispiel und Hinweis, dass ein leerer Workshop-Eintrag keinen Download auslöst.
• The Indie Stone: ServerOptions API – aktuelle generierte Dokumentation führt workshopItems als String-Serveroption; sie belegt weder Pfad noch Updatezeitpunkt.
• The Indie Stone Support: Dedicated-Server-Profil – nennt servertest.ini und einen üblichen Profilordner als Beispiel.
• Valve: Steam Workshop – beschreibt automatische Updates über den Steam-Client.
• Valve: ISteamUGC – dokumentiert die optionale Änderungsnotiz beim Einreichen eines Workshop-Updates.
• The Indie Stone: Build 42.21 Unstable – empfiehlt eine manuelle Sicherung vor dem Test von Build 42.21 Unstable mit einem bestehenden Build-42.20.4-Spielstand.