Diese Anleitung behandelt die erweiterte Mod-Fehlerbehebung für Project Zomboid Server, die bei Legion Hosting gehostet werden. Wenn Sie noch keine Mods installiert haben, beginnen Sie zuerst mit der grundlegenden Mod-Installationsanleitung. Dieser Artikel behandelt die häufigsten modbezogenen Probleme, die in Legion Hosting Support-Tickets auftreten, einschließlich WorldDictionary-Korruption, Mod-Formatfehler, Laderreihenfolge-Konflikte und Versionsunterschiede zwischen Server und Client.

Bevor Sie beginnen

• Melden Sie sich bei GPanel an und wählen Sie Ihren Project Zomboid Server aus.
• Stoppen Sie Ihren Server, bevor Sie Konfigurations- oder Dateiänderungen vornehmen.
• Sichern Sie Ihren Weltspeicherordner (/.cache/saves/multiplayer/) per SFTP oder GPanel, bevor Sie eine Lösung versuchen. Siehe die SFTP-Anleitung, wenn Sie mit Dateiübertragungen nicht vertraut sind.
• Halten Sie den Pfad zur .ini-Datei Ihres Servers bereit: /.cache/server/<servername>.ini (z.B. servertest.ini).

1. Mod-Formatfehler (B42 vs B41)

Der häufigste Grund, warum Mods nicht geladen werden, ist ein falsches Format in der Mods=-Zeile der .ini-Datei Ihres Servers. Build 42 und Build 41 verwenden unterschiedliche Syntax, und eine Verwechslung führt dazu, dass Ihre Mods stillschweigend nicht geladen werden.

B42-Format (aktueller Standard)

Build 42 erfordert einen Backslash-Präfix vor jeder Mod-ID in der Mods=-Zeile:

Mods=\ModID1;\ModID2;\ModID3;

Das DLMP-Format kombiniert Workshop-IDs und Mod-IDs mit einem Backslash-Trennzeichen:

Mods=2392987841\ModID1;1550458773\ModID2;2786383654\ModID3;

Die WorkshopItems=-Zeile verwendet in beiden Builds das gleiche semikolongetrennte Format:

WorkshopItems=2392987841;1550458773;2786383654

B41-Format (Legacy)

Build 41 verwendet einfache semikolongetrennte Mod-IDs ohne Backslash:

Mods=ModID1;ModID2;ModID3

So beheben Sie das Problem

1. Öffnen Sie /.cache/server/<servername>.ini im GPanel File Manager.
2. Suchen Sie die Mods=-Zeile und überprüfen Sie das Format anhand der obigen Beispiele.
3. Wenn das Format für Ihre Build-Version falsch ist, korrigieren Sie es. Verwenden Sie den Legion Hosting Mod Organizer, um automatisch korrekt formatierte Zeilen zu generieren.
4. Speichern Sie die Datei und starten Sie den Server.

2. WorldDictionary-Korruption

Das WorldDictionary ist eine Datei (WorldDictionary.bin), die Itemnamen internen numerischen IDs zuordnet. Wenn Mods hinzugefügt oder entfernt werden, kann das Dictionary beschädigt werden, was dazu führt, dass der Server beim Start mit einer WorldDictionaryException abstürzt.

Symptome

• Konsole oder debug.log zeigt WorldDictionaryException oder WorldDictionary-Fehler.
• Server stürzt sofort beim Start ab, insbesondere während des Weltladens.
• Der Absturz begann nach dem Hinzufügen, Entfernen oder Aktualisieren von Mods.

Das Risiko verstehen

Wiederherstellungsschritte

1. Stoppen Sie Ihren Server in GPanel.
2. Sichern Sie Ihren gesamten Speicherordner per SFTP: Laden Sie das vollständige Verzeichnis /.cache/saves/multiplayer/<YourWorldName>/ auf Ihren lokalen Computer herunter.
3. Versuchen Sie zunächst, die Mod-Änderung rückgängig zu machen, die den Fehler verursacht hat. Wenn Sie gerade einen Mod hinzugefügt haben, entfernen Sie ihn aus beiden Zeilen Mods= und WorkshopItems= in der .ini-Datei. Wenn Sie gerade einen Mod entfernt haben, fügen Sie ihn wieder hinzu. Starten Sie den Server und prüfen Sie, ob der Absturz behoben ist.
4. Wenn das Rückgängigmachen der Mod-Änderung nicht funktioniert, verbinden Sie sich per SFTP und navigieren Sie zu /.cache/saves/multiplayer/<YourWorldName>/.
5. Löschen Sie WorldDictionary.bin.
6. Starten Sie den Server. Project Zomboid wird das Dictionary beim Start neu generieren.
7. Treten Sie dem Server bei und untersuchen Sie die Welt auf beschädigte Items, fehlende Fahrzeuge oder defekte Inventare. Wenn die Welt schwer beschädigt ist, stellen Sie das Backup aus Schritt 2 wieder her.

3. Authentic Z Mod-Konflikte

Authentic Z ist eine der beliebtesten Project Zomboid Mod-Sammlungen, aber sie ist eine häufige Ursache für Support-Tickets, da sie mehrere Sub-Mods enthält, die miteinander in Konflikt stehen.

Die Regel

Häufige Fehler

• Gleichzeitiges Hinzufügen von Authentic Z - Current und Authentic Z - Litemode.
• Hinzufügen von Authentic Z Sub-Mods, die für den Einzelspieler konzipiert sind, zusammen mit der Multiplayer-Version.
• Nicht bemerken, dass verschiedene Authentic Z Sub-Mods die gleiche Workshop-ID aber unterschiedliche Mod-IDs teilen, sodass der Workshop-Download erfolgreich ist, aber der Server widersprüchliche Mod-Dateien lädt.

So beheben Sie das Problem

1. Öffnen Sie /.cache/server/<servername>.ini im GPanel File Manager.
2. Durchsuchen Sie die Mods=-Zeile nach jedem Eintrag, der Authentic oder AuthenticZ enthält.
3. Behalten Sie nur einen Authentic Z Sub-Mod (empfohlen: Authentic Z - Current). Entfernen Sie alle anderen Authentic Z-Einträge aus beiden Zeilen Mods= und WorkshopItems=.
4. Speichern Sie die Datei und starten Sie den Server neu.

4. Linux-Groß-/Kleinschreibung

Legion Hosting Server laufen auf Linux, wo Datei- und Ordnernamen zwischen Groß- und Kleinschreibung unterscheiden. Eine Datei namens MyMod.lua und mymod.lua werden als zwei völlig verschiedene Dateien behandelt. Dies verursacht Probleme, wenn Mod-Autoren unter Windows (nicht zwischen Groß-/Kleinschreibung unterscheidend) entwickeln und ihre Mods nicht übereinstimmende Dateiverweise enthalten.

Symptome

• Ein Mod funktioniert perfekt im Einzelspieler auf Ihrem Windows-PC, aber schlägt auf dem Server fehl.
• Konsole oder debug.log zeigt FileNotFoundException oder can't find file-Fehler, die auf ein Lua-Skript oder eine Textur innerhalb eines Mods verweisen.
• Der Fehler zeigt auf eine Datei, die im Mod-Ordner existiert, aber mit anderer Groß-/Kleinschreibung (z.B. referenziert der Code Items.txt, aber die tatsächliche Datei heißt items.txt).

So diagnostizieren Sie das Problem

1. Überprüfen Sie die Konsole oder die Logdateien unter /.cache/Logs/ auf den genauen Dateipfad, der in der Fehlermeldung erwähnt wird.
2. Verbinden Sie sich per SFTP und navigieren Sie zum Mod-Ordner unter /steamapps/workshop/content/108600/<WorkshopID>/.
3. Vergleichen Sie die Dateinamen auf der Festplatte mit dem in der Fehlermeldung referenzierten Dateinamen. Achten Sie auf Unterschiede in der Groß-/Kleinschreibung.

So beheben Sie das Problem

• Wenn Sie die Datei umbenennen können: Verbinden Sie sich per SFTP und benennen Sie die Datei um, damit sie der vom Mod-Code erwarteten Groß-/Kleinschreibung entspricht. Beachten Sie, dass diese Korrektur bei einem Mod-Update im Steam Workshop überschrieben wird.
• Wenn das Problem im Mod selbst liegt: Melden Sie den Fehler dem Mod-Autor auf der Steam Workshop-Seite. Erwähnen Sie, dass der Dateiverweis eine Groß-/Kleinschreibung-Abweichung aufweist und auf Linux-Servern fehlschlägt. Viele Mod-Autoren sind sich der Linux-Groß-/Kleinschreibung nicht bewusst.
• Als Workaround: Prüfen Sie die Kommentare auf der Workshop-Seite des Mods – andere Linux-Serverbetreiber haben möglicherweise eine Lösung oder einen kompatiblen Fork des Mods gepostet.

5. Probleme mit der Mod-Ladereihenfolge

Project Zomboid lädt Mods in der Reihenfolge, in der sie in der Mods=-Zeile erscheinen. Einige Mods erfordern, dass andere Mods zuerst geladen werden. Wenn eine Abhängigkeit nach dem Mod geladen wird, der sie benötigt, kann der abhängige Mod stillschweigend fehlschlagen oder Fehler verursachen.

Symptome

• Mod-Funktionen funktionieren nur teilweise – einige Items oder Systeme eines Mods sind vorhanden, aber andere fehlen.
• Konsole zeigt NullPointerException oder attempt to index a nil value-Fehler, die auf Lua-Skripte eines Mods verweisen.
• Fehler treten nur auf, wenn eine bestimmte Kombination von Mods installiert ist, aber jeder Mod funktioniert einzeln einwandfrei.

So beheben Sie das Problem

1. Überprüfen Sie die Steam Workshop-Seite jedes Mods auf einen Abschnitt "Required Mods" oder "Load Order". Viele Mod-Autoren geben an, welche Mods vor ihrem geladen werden müssen.
2. Öffnen Sie /.cache/server/<servername>.ini und suchen Sie die Mods=-Zeile.
3. Ordnen Sie die Einträge so um, dass Abhängigkeits-Mods vor den Mods erscheinen, die sie benötigen. Wenn beispielsweise Mod B Mod A benötigt, sollte die Zeile Mods=\ModA;\ModB; lauten (B42-Format).
4. Framework- und Bibliotheks-Mods (wie ModFramework, TsarLib oder Shark's Mod Utils) sollten immer zuerst in der Mods=-Zeile aufgeführt werden.
5. Speichern Sie die Datei und starten Sie den Server neu.

6. Serverabstürze nach dem Hinzufügen von Mods

Wenn Ihr Server einwandfrei lief und nach dem Hinzufügen eines oder mehrerer Mods abstürzt, ist wahrscheinlich der neue Mod die Ursache. Dieser Abschnitt führt Sie durch die Isolierung des problematischen Mods.

Schrittweise Isolierung

1. Stoppen Sie den Server in GPanel.
2. Öffnen Sie /.cache/server/<servername>.ini im File Manager.
3. Notieren Sie alle Mods, die Sie gerade hinzugefügt haben. Entfernen Sie alle davon aus beiden Zeilen Mods= und WorkshopItems=.
4. Starten Sie den Server. Wenn er erfolgreich startet, liegt das Problem bei einem der entfernten Mods.
5. Fügen Sie die Mods einzeln wieder hinzu und starten Sie den Server nach jeder Hinzufügung neu. Wenn der Absturz zurückkehrt, ist der zuletzt hinzugefügte Mod die Ursache.
6. Überprüfen Sie nach der Identifizierung die Workshop-Seite des Mods auf:
   • Einen Hinweis zur B42-Kompatibilität – viele B41-Mods wurden nicht für B42 aktualisiert.
   • Bekannte Konflikte mit anderen Mods, die Sie verwenden.
   • Erforderliche Abhängigkeits-Mods, die Sie möglicherweise nicht installiert haben.

Das Absturzprotokoll lesen

Bevor Sie den Isolierungsprozess durchführen, überprüfen Sie das Absturzprotokoll – es weist oft direkt auf den problematischen Mod hin:

1. Öffnen Sie in GPanel den Tab Console und scrollen Sie zum Ende der Ausgabe.
2. Suchen Sie nach STACK TRACE-, Exception- oder ERROR-Zeilen.
3. Die Zeilen unmittelbar über dem Stack Trace verweisen typischerweise auf einen Mod-Dateinamen oder eine Mod-ID – dies zeigt Ihnen, welcher Mod den Absturz ausgelöst hat.
4. Für mehr Details öffnen Sie die vollständige Logdatei per SFTP unter /.cache/Logs/ und prüfen Sie die neueste DebugLog-server.txt oder debug.log-Datei.

7. Mod-Versionsunterschiede (Server vs Client)

Project Zomboid erfordert, dass Server und alle verbundenen Clients die gleiche Version jedes Mods haben. Wenn ein Mod im Steam Workshop aktualisiert wird und der Server die neue Version herunterlädt, aber ein Spieler noch die alte Version im Cache hat (oder umgekehrt), treten Verbindungsfehler oder Abstürze auf.

Symptome

• Spieler erhalten einen "Mod mismatch" oder "Version mismatch"-Fehler beim Verbindungsversuch.
• Einige Spieler können sich verbinden, andere nicht – diejenigen, die sich nicht verbinden können, haben eine andere Mod-Version lokal im Cache.
• Der Server lief einwandfrei, dann wurde ein Mod im Steam Workshop aktualisiert und plötzlich können einige Spieler nicht mehr beitreten.
• Spieler sehen fehlende Texturen, Items oder defekte UI-Elemente von kürzlich aktualisierten Mods.

Lösung für Serverbetreiber

1. Stoppen Sie den Server in GPanel.
2. Starten Sie den Server erneut. Beim Start lädt der Server die neuesten Versionen aller Workshop-Mods erneut herunter. Dies stellt sicher, dass der Server die neueste Version ausführt.
3. Wenn der Server immer noch eine alte Version im Cache hat, verbinden Sie sich per SFTP und löschen Sie den spezifischen Workshop-Cache-Ordner des Mods unter /steamapps/workshop/content/108600/<WorkshopID>/. Starten Sie den Server neu, um einen sauberen Download zu erzwingen.

Lösung für Spieler

Spieler, die sich aufgrund von Mod-Versionsunterschieden nicht verbinden können, sollten:

1. Steam öffnen und zu Library → Project Zomboid navigieren.
2. Rechtsklick auf Project Zomboid, Properties → Local Files → Verify Integrity of Game Files auswählen.
3. Außerdem zum Steam Workshop-Ordner für Project Zomboid auf ihrem lokalen Computer navigieren und zwischengespeicherte Mod-Dateien löschen, um einen erneuten Download zu erzwingen.
4. Das Spiel starten und sich erneut mit dem Server verbinden.

8. Steam Workshop-Cache leeren

Wenn mehrere Mod-Probleme bestehen bleiben und Sie vermuten, dass der Workshop-Download-Cache beschädigt ist, können Sie einen vollständigen Neudownload aller Workshop-Mods erzwingen.

1. Stoppen Sie den Server in GPanel.
2. Verbinden Sie sich per SFTP und navigieren Sie zu /steamapps/workshop/.
3. Löschen Sie den gesamten workshop/-Ordner (oder dessen Inhalt).
4. Starten Sie den Server. Steam wird alle Workshop-Items von Grund auf neu herunterladen.
5. Beobachten Sie die GPanel-Konsole, um zu bestätigen, dass alle Mods vollständig heruntergeladen werden, bevor der Server mit dem Laden der Welt beginnt.

Kurzreferenz zur Diagnose

Immer noch Mod-Probleme?