Denne guide dækker avanceret mod-fejlfinding for Project Zomboid servere hostet med Legion Hosting. Hvis du endnu ikke har installeret mods, så start med den grundlæggende mod-installationsguide først. Denne artikel adresserer de mest almindelige mod-relaterede problemer set på tværs af Legion Hosting supporttickets, herunder WorldDictionary-korruption, mod-formatfejl, indlæsningsrækkefølge-konflikter og versionsuoverensstemmelser mellem server og klient.

Inden du begynder

• Log ind på GPanel og vælg din Project Zomboid server.
• Stop din server inden du foretager ændringer i konfiguration eller filer.
• Tag backup af din verden-gemmemappe (/.cache/saves/multiplayer/) via SFTP eller GPanel inden du forsøger nogen rettelse. Se SFTP-guiden hvis du ikke er bekendt med filoverførsler.
• Hav din servers .ini filsti klar: /.cache/server/<servername>.ini (f.eks. servertest.ini).

1. Mod-formatfejl (B42 vs B41)

Den mest almindelige årsag til, at mods ikke indlæses, er et forkert format i Mods= linjen i din servers .ini fil. Build 42 og Build 41 bruger forskellig syntaks, og blander man dem, vil mods stille og roligt ikke blive indlæst.

B42 Format (nuværende standard)

Build 42 kræver et backslash-præfiks før hvert Mod ID i Mods= linjen:

Mods=\ModID1;\ModID2;\ModID3;

DLMP-formatet kombinerer Workshop IDs og Mod IDs med en backslash-separator:

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

WorkshopItems= linjen bruger det samme semikolon-separerede format på begge builds:

WorkshopItems=2392987841;1550458773;2786383654

B41 Format (ældre version)

Build 41 bruger rene semikolon-separerede Mod IDs uden backslash:

Mods=ModID1;ModID2;ModID3

Sådan løser du det

1. Åbn /.cache/server/<servername>.ini i GPanel File Manager.
2. Find Mods= linjen og tjek formatet mod eksemplerne ovenfor.
3. Hvis formatet er forkert for din build-version, ret det. Brug Legion Hosting Mod Organizer til at generere korrekt formaterede linjer automatisk.
4. Gem filen og start serveren.

2. WorldDictionary-korruption

WorldDictionary er en fil (WorldDictionary.bin), der mapper genstandsnavne til interne numeriske IDs. Når mods tilføjes eller fjernes, kan ordbogen blive korrupt, hvilket får serveren til at crashe ved opstart med en WorldDictionaryException.

Symptomer

• Konsollen eller debug.log viser WorldDictionaryException eller WorldDictionary fejl.
• Serveren crasher øjeblikkeligt under opstart, specifikt under verdensindlæsning.
• Crashet startede efter tilføjelse, fjernelse eller opdatering af mods.

Forståelse af risikoen

Genoprettelsestrin

1. Stop din server i GPanel.
2. Tag backup af hele din gemmemappe via SFTP: download hele /.cache/saves/multiplayer/<YourWorldName>/ mappen til din lokale maskine.
3. Prøv først blot at tilbagerulle den mod-ændring, der forårsagede fejlen. Hvis du lige har tilføjet en mod, fjern den fra både Mods= og WorkshopItems= i .ini filen. Hvis du lige har fjernet en mod, tilføj den igen. Start serveren og se om crashet er løst.
4. Hvis tilbagerulning af mod-ændringen ikke virker, opret forbindelse via SFTP og naviger til /.cache/saves/multiplayer/<YourWorldName>/.
5. Slet WorldDictionary.bin.
6. Start serveren. Project Zomboid vil regenerere ordbogen ved opstart.
7. Tilslut dig serveren og inspicer verdenen for korrupte genstande, manglende køretøjer eller ødelagte inventarer. Hvis verdenen er alvorligt beskadiget, gendan fra den backup du oprettede i trin 2.

3. Authentic Z Mod-konflikter

Authentic Z er en af de mest populære Project Zomboid mod-samlinger, men den er en hyppig kilde til supporttickets, fordi den indeholder flere sub-mods der konflikter med hinanden.

Reglen

Almindelige fejl

• Tilføjelse af både Authentic Z - Current og Authentic Z - Litemode på samme tid.
• Tilføjelse af Authentic Z sub-mods designet til singleplayer sammen med multiplayer-versionen.
• Ikke at være klar over, at forskellige Authentic Z sub-mods deler det samme Workshop ID men har forskellige Mod IDs, så Workshop-downloaden lykkes, men serveren indlæser konfliktende mod-filer.

Sådan løser du det

1. Åbn /.cache/server/<servername>.ini i GPanel File Manager.
2. Søg i Mods= linjen efter hver post, der indeholder Authentic eller AuthenticZ.
3. Behold kun én Authentic Z sub-mod (anbefalet: Authentic Z - Current). Fjern alle andre Authentic Z poster fra både Mods= og WorkshopItems= linjerne.
4. Gem filen og genstart serveren.

4. Linux-forskel på store og små bogstaver

Legion Hosting servere kører på Linux, hvor fil- og mappenavne er følsomme over for store og små bogstaver. En fil med navnet MyMod.lua og mymod.lua behandles som to helt forskellige filer. Dette skaber problemer, når mod-udviklere udvikler på Windows (ikke følsom over for store/små bogstaver) og deres mods indeholder uoverensstemmende filreferencer.

Symptomer

• En mod fungerer perfekt i singleplayer på din Windows-PC, men fejler på serveren.
• Konsollen eller debug.log viser FileNotFoundException eller can't find file fejl, der refererer til et Lua-script eller en tekstur inde i en mod.
• Fejlen peger på en fil, der eksisterer i mod-mappen, men med anden brug af store/små bogstaver (f.eks. koden refererer til Items.txt, men den faktiske fil hedder items.txt).

Sådan diagnosticerer du

1. Tjek konsollen eller /.cache/Logs/ logfilerne for den nøjagtige filsti nævnt i fejlen.
2. Opret forbindelse via SFTP og naviger til moddets mappe på /steamapps/workshop/content/108600/<WorkshopID>/.
3. Sammenlign filnavnene på disken med filnavnet refereret i fejlmeddelelsen. Se efter forskelle i store/små bogstaver.

Sådan løser du det

• Hvis du kan omdøbe filen: Opret forbindelse via SFTP og omdøb filen, så den matcher den brug af store/små bogstaver, som moddets kode forventer. Bemærk at denne rettelse vil blive overskrevet, hvis moddet opdateres på Steam Workshop.
• Hvis problemet er i selve moddet: Rapporter fejlen til mod-udvikleren på Steam Workshop-siden. Nævn at filreferencen har en uoverensstemmelse i store/små bogstaver, og at det fejler på Linux-servere. Mange mod-udviklere er ikke bevidste om Linux's forskel på store og små bogstaver.
• Som en midlertidig løsning: Tjek moddets Workshop-side kommentarer — andre Linux-serveroperatører kan have postet en rettelse eller en kompatibel fork af moddet.

5. Problemer med mod-indlæsningsrækkefølge

Project Zomboid indlæser mods i den rækkefølge, de fremgår i Mods= linjen. Nogle mods afhænger af, at andre mods indlæses først. Hvis en afhængighed indlæses efter det mod, der kræver det, kan det afhængige mod fejle stille eller forårsage fejl.

Symptomer

• Mod-funktioner virker delvist — nogle genstande eller systemer fra et mod er til stede, men andre mangler.
• Konsollen viser NullPointerException eller attempt to index a nil value fejl, der refererer til et mods Lua-scripts.
• Fejl opstår kun når en bestemt kombination af mods er installeret, men hvert mod fungerer fint individuelt.

Sådan løser du det

1. Tjek hvert mods Steam Workshop-side for en "Required Mods" eller "Load Order" sektion. Mange mod-udviklere specificerer hvilke mods der skal indlæses før deres.
2. Åbn /.cache/server/<servername>.ini og find Mods= linjen.
3. Omarranger posterne, så afhængighedsmods fremgår før de mods, der kræver dem. For eksempel, hvis Mod B kræver Mod A, skal linjen læse Mods=\ModA;\ModB; (B42 format).
4. Framework- og biblioteksmods (såsom ModFramework, TsarLib eller Shark's Mod Utils) bør altid listes først i Mods= linjen.
5. Gem filen og genstart serveren.

6. Servercrash efter tilføjelse af mods

Hvis din server kørte fint og crasher efter tilføjelse af en eller flere mods, er det nye mod sandsynligvis årsagen. Denne sektion gennemgår, hvordan du isolerer det problematiske mod.

Trin-for-trin isolering

1. Stop serveren i GPanel.
2. Åbn /.cache/server/<servername>.ini i File Manager.
3. Notér alle de mods, du lige har tilføjet. Fjern dem alle fra både Mods= og WorkshopItems= linjerne.
4. Start serveren. Hvis den starter succesfuldt, er problemet i et af de mods, du fjernede.
5. Tilføj modsene tilbage ét ad gangen, og genstart serveren efter hver tilføjelse. Når crashet vender tilbage, er det sidste mod du tilføjede årsagen.
6. Når det er identificeret, tjek moddets Workshop-side for:
   • En note om B42-kompatibilitet — mange B41-mods er ikke blevet opdateret til B42.
   • Kendte konflikter med andre mods, du kører.
   • Påkrævede afhængighedsmods, som du måske ikke har installeret.

Læsning af crashloggen

Inden du udfører isoleringsprocessen, tjek crashloggen — den peger ofte direkte på det problematiske mod:

1. I GPanel, åbn fanen Console og rul til slutningen af outputtet.
2. Kig efter STACK TRACE, Exception eller ERROR linjer.
3. Linjerne umiddelbart over stack tracen refererer typisk til et mod-filnavn eller Mod ID — dette fortæller dig, hvilket mod der udløste crashet.
4. For flere detaljer, åbn den fulde logfil via SFTP på /.cache/Logs/ og tjek den seneste DebugLog-server.txt eller debug.log fil.

7. Mod-versionsuoverensstemmelser (server vs. klient)

Project Zomboid kræver, at serveren og alle tilsluttede klienter har den samme version af hvert mod. Hvis et mod opdateres på Steam Workshop, og serveren downloader den nye version, men en spiller stadig har den gamle version i cache (eller omvendt), vil forbindelsesfejl eller crash opstå.

Symptomer

• Spillere får en "Mod mismatch" eller "Version mismatch" fejl, når de forsøger at oprette forbindelse.
• Nogle spillere kan oprette forbindelse, men andre kan ikke — dem der ikke kan oprette forbindelse, har en anden mod-version i deres lokale cache.
• Serveren fungerede fint, derefter opdaterede et mod på Steam Workshop, og pludselig kan nogle spillere ikke tilslutte sig.
• Spillere ser manglende teksturer, genstande eller ødelagte UI-elementer fra mods, der for nylig blev opdateret.

Løsning for serveroperatører

1. Stop serveren i GPanel.
2. Start serveren igen. Ved opstart gendownloader serveren de seneste versioner af alle Workshop-mods. Dette sikrer, at serveren kører den nyeste version.
3. Hvis serveren stadig har en gammel version i cache, opret forbindelse via SFTP og slet det specifikke mods Workshop-cachemappe på /steamapps/workshop/content/108600/<WorkshopID>/. Genstart serveren for at tvinge en ren download.

Løsning for spillere

Spillere, der ikke kan oprette forbindelse på grund af mod-versionsuoverensstemmelser, bør:

1. Åbne Steam og navigere til Library → Project Zomboid.
2. Højreklikke på Project Zomboid, vælge Properties → Local Files → Verify Integrity of Game Files.
3. Også navigere til Steam Workshop-mappen for Project Zomboid på deres lokale maskine og slette cachede mod-filer for at tvinge en gendownload.
4. Starte spillet og oprette forbindelse til serveren igen.

8. Rydning af Steam Workshop-cachen

Hvis flere mod-problemer fortsætter, og du har mistanke om at Workshop-downloadcachen er korrupt, kan du tvinge en komplet gendownload af alle Workshop-mods.

1. Stop serveren i GPanel.
2. Opret forbindelse via SFTP og naviger til /steamapps/workshop/.
3. Slet hele workshop/ mappen (eller dens indhold).
4. Start serveren. Steam vil gendownloade alle Workshop-emner fra bunden.
5. Overvåg GPanel-konsollen for at bekræfte, at alle mods er færdige med at downloade, inden serveren begynder at indlæse verdenen.

Hurtig diagnostisk reference

Har du stadig mod-problemer?