Denne veiledningen dekker avansert mod-feilsøking for Project Zomboid-servere hostet hos Legion Hosting. Hvis du ennå ikke har installert mods, start med den grunnleggende veiledningen for mod-installasjon først. Denne artikkelen tar for seg de vanligste mod-relaterte problemene som sees på tvers av Legion Hostings supportsaker, inkludert WorldDictionary-korrupsjon, mod-formatfeil, konflikter i innlastingsrekkefølge og versjonsavvik mellom server og klient.

Før du begynner

• Logg inn på GPanel og velg din Project Zomboid-server.
• Stopp serveren før du gjør noen konfigurasjons- eller filendringer.
• Sikkerhetskopier verdens-lagringsmappen din (/.cache/saves/multiplayer/) via SFTP eller GPanel før du forsøker noen løsning. Se SFTP-veiledningen hvis du er ukjent med filoverføringer.
• Ha filbanen til serverens .ini-fil klar: /.cache/server/<servername>.ini (f.eks. servertest.ini).

1. Mod-formatfeil (B42 vs B41)

Den vanligste årsaken til at mods ikke lastes inn, er et feil format i Mods=-linjen i serverens .ini-fil. Build 42 og Build 41 bruker ulik syntaks, og å blande dem sammen vil føre til at modsene dine ikke lastes inn uten feilmelding.

B42-format (gjeldende standard)

Build 42 krever et omvendt skråstrek-prefiks før hver Mod-ID i Mods=-linjen:

Mods=\ModID1;\ModID2;\ModID3;

DLMP-formatet kombinerer Workshop-ID-er og Mod-ID-er med en omvendt skråstrek som skilletegn:

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

WorkshopItems=-linjen bruker samme semikolon-separerte format på begge builds:

WorkshopItems=2392987841;1550458773;2786383654

B41-format (eldre)

Build 41 bruker enkle semikolon-separerte Mod-ID-er uten omvendt skråstrek:

Mods=ModID1;ModID2;ModID3

Slik fikser du det

1. Åpne /.cache/server/<servername>.ini i GPanel File Manager.
2. Finn Mods=-linjen og sjekk formatet mot eksemplene ovenfor.
3. Hvis formatet er feil for din build-versjon, korriger det. Bruk Legion Hosting Mod Organizer for å generere riktig formaterte linjer automatisk.
4. Lagre filen og start serveren.

2. WorldDictionary-korrupsjon

WorldDictionary er en fil (WorldDictionary.bin) som tilordner gjenstandsnavn til interne numeriske ID-er. Når mods legges til eller fjernes, kan ordboken bli korrupt, noe som får serveren til å krasje ved oppstart med en WorldDictionaryException.

Symptomer

• Konsollen eller debug.log viser WorldDictionaryException eller WorldDictionary-feil.
• Serveren krasjer umiddelbart under oppstart, spesifikt under innlasting av verden.
• Krasjet startet etter at mods ble lagt til, fjernet eller oppdatert.

Forstå risikoen

Gjenopprettingstrinn

1. Stopp serveren i GPanel.
2. Sikkerhetskopier hele lagringsmappen din via SFTP: last ned hele /.cache/saves/multiplayer/<YourWorldName>/-katalogen til din lokale maskin.
3. Prøv først ganske enkelt å reversere mod-endringen som forårsaket feilen. Hvis du nettopp la til en mod, fjern den fra både Mods= og WorkshopItems= i .ini-filen. Hvis du nettopp fjernet en mod, legg den tilbake. Start serveren og se om krasjet er løst.
4. Hvis reversering av mod-endringen ikke fungerer, koble til via SFTP og naviger til /.cache/saves/multiplayer/<YourWorldName>/.
5. Slett WorldDictionary.bin.
6. Start serveren. Project Zomboid vil regenerere ordboken ved oppstart.
7. Bli med på serveren og inspiser verden for korrupte gjenstander, manglende kjøretøy eller ødelagt inventar. Hvis verden er alvorlig skadet, gjenopprett fra sikkerhetskopien du opprettet i trinn 2.

3. Authentic Z mod-konflikter

Authentic Z er en av de mest populære mod-samlingene for Project Zomboid, men den er en hyppig kilde til supportsaker fordi den inneholder flere undermods som er i konflikt med hverandre.

Regelen

Vanlige feil

• Å legge til både Authentic Z - Current og Authentic Z - Litemode samtidig.
• Å legge til Authentic Z-undermods som er laget for enkeltspiller sammen med flerspillerversjonen.
• Å ikke innse at ulike Authentic Z-undermods deler samme Workshop-ID, men har ulike Mod-ID-er, slik at Workshop-nedlastingen lykkes, men serveren laster inn motstridende mod-filer.

Slik fikser du det

1. Åpne /.cache/server/<servername>.ini i GPanel File Manager.
2. Søk i Mods=-linjen etter hver oppføring som inneholder Authentic eller AuthenticZ.
3. Behold kun én Authentic Z-undermod (anbefalt: Authentic Z - Current). Fjern alle andre Authentic Z-oppføringer fra både Mods=- og WorkshopItems=-linjene.
4. Lagre filen og start serveren på nytt.

4. Problemer med store/små bokstaver i Linux

Legion Hosting-servere kjører på Linux, der fil- og mappenavn skiller mellom store og små bokstaver. En fil med navnet MyMod.lua og mymod.lua behandles som to helt forskjellige filer. Dette forårsaker problemer når mod-forfattere utvikler på Windows (uten skille mellom store/små bokstaver) og modsene deres inneholder filreferanser som ikke samsvarer.

Symptomer

• En mod fungerer perfekt i enkeltspiller på Windows-PC-en din, men feiler på serveren.
• Konsollen eller debug.log viser FileNotFoundException eller can't find file-feil som refererer til et Lua-skript eller en tekstur inne i en mod.
• Feilen peker til en fil som finnes i mod-mappen, men med en annen bruk av store/små bokstaver (f.eks. koden refererer til Items.txt, men selve filen heter items.txt).

Slik diagnostiserer du det

1. Sjekk konsollen eller loggfilene i /.cache/Logs/ for den nøyaktige filbanen som nevnes i feilen.
2. Koble til via SFTP og naviger til moddens mappe på /steamapps/workshop/content/108600/<WorkshopID>/.
3. Sammenlign filnavnene på disken med filnavnet det refereres til i feilmeldingen. Se etter forskjeller i store/små bokstaver.

Slik fikser du det

• Hvis du kan gi filen nytt navn: Koble til via SFTP og gi filen et nytt navn som samsvarer med bruken av store/små bokstaver som moddens kode forventer. Merk at denne løsningen vil bli overskrevet hvis modden oppdateres på Steam Workshop.
• Hvis problemet ligger i selve modden: Rapporter feilen til mod-forfatteren på Steam Workshop-siden. Nevn at filreferansen har et avvik i store/små bokstaver og at den feiler på Linux-servere. Mange mod-forfattere er ikke klar over Linux' skille mellom store og små bokstaver.
• Som en midlertidig løsning: Sjekk kommentarene på moddens Workshop-side — andre Linux-serveroperatører kan ha lagt ut en løsning eller en kompatibel fork av modden.

5. Problemer med mod-innlastingsrekkefølge

Project Zomboid laster inn mods i den rekkefølgen de vises i Mods=-linjen. Noen mods er avhengige av at andre mods lastes inn først. Hvis en avhengighet lastes inn etter modden som krever den, kan den avhengige modden feile uten feilmelding eller forårsake feil.

Symptomer

• Mod-funksjoner fungerer delvis — noen gjenstander eller systemer fra en mod er til stede, men andre mangler.
• Konsollen viser NullPointerException eller attempt to index a nil value-feil som refererer til en modds Lua-skript.
• Feil vises kun når en bestemt kombinasjon av mods er installert, men hver mod fungerer fint individuelt.

Slik fikser du det

1. Sjekk hver modds Steam Workshop-side for en seksjon kalt «Required Mods» eller «Load Order». Mange mod-forfattere angir hvilke mods som må lastes inn før deres.
2. Åpne /.cache/server/<servername>.ini og finn Mods=-linjen.
3. Endre rekkefølgen på oppføringene slik at avhengighetsmods vises før modsene som krever dem. For eksempel, hvis Mod B krever Mod A, skal linjen lese Mods=\ModA;\ModB; (B42-format).
4. Rammeverk- og biblioteksmods (som ModFramework, TsarLib eller Shark's Mod Utils) bør alltid stå først i Mods=-linjen.
5. Lagre filen og start serveren på nytt.

6. Serveren krasjer etter å ha lagt til mods

Hvis serveren din kjørte fint og krasjer etter at du la til en eller flere mods, er den nye modden sannsynligvis årsaken. Denne delen tar deg gjennom å isolere problem-modden.

Trinnvis isolering

1. Stopp serveren i GPanel.
2. Åpne /.cache/server/<servername>.ini i File Manager.
3. Noter alle modsene du nettopp la til. Fjern alle sammen fra både Mods=- og WorkshopItems=-linjene.
4. Start serveren. Hvis den starter vellykket, ligger problemet i en av modsene du fjernet.
5. Legg modsene tilbake én om gangen, og start serveren på nytt etter hver tillegging. Når krasjet kommer tilbake, er den siste modden du la til årsaken.
6. Når den er identifisert, sjekk moddens Workshop-side for:
   • En merknad om B42-kompatibilitet — mange B41-mods har ikke blitt oppdatert for B42.
   • Kjente konflikter med andre mods du kjører.
   • Nødvendige avhengighetsmods som du kanskje ikke har installert.

Lese krasjloggen

Før du utfører isoleringsprosessen, sjekk krasjloggen — den peker ofte direkte til problem-modden:

1. I GPanel, åpne Console-fanen og bla til slutten av utdataen.
2. Se etter STACK TRACE-, Exception- eller ERROR-linjer.
3. Linjene rett over stacksporet refererer vanligvis til et mod-filnavn eller en Mod-ID — dette forteller deg hvilken mod som utløste krasjet.
4. For mer detaljer, åpne hele loggfilen via SFTP på /.cache/Logs/ og sjekk den nyeste DebugLog-server.txt- eller debug.log-filen.

7. Mod-versjonsavvik (server vs klient)

Project Zomboid krever at serveren og alle tilkoblede klienter har samme versjon av hver mod. Hvis en mod oppdateres på Steam Workshop og serveren laster ned den nye versjonen, men en spiller fortsatt har den gamle versjonen i hurtigbufferen (eller omvendt), vil tilkoblingsfeil eller krasj oppstå.

Symptomer

• Spillere får en «Mod mismatch»- eller «Version mismatch»-feil når de prøver å koble til.
• Noen spillere kan koble til, men andre kan ikke — de som ikke kan koble til, har en annen mod-versjon i den lokale hurtigbufferen.
• Serveren fungerte fint, så ble en mod oppdatert på Steam Workshop, og plutselig kan ikke noen spillere bli med.
• Spillere ser manglende teksturer, gjenstander eller ødelagte UI-elementer fra mods som nylig ble oppdatert.

Løsning for serveroperatører

1. Stopp serveren i GPanel.
2. Start serveren igjen. Ved oppstart laster serveren ned de nyeste versjonene av alle Workshop-mods på nytt. Dette sikrer at serveren kjører den nyeste versjonen.
3. Hvis serveren fortsatt har en gammel versjon i hurtigbufferen, koble til via SFTP og slett den spesifikke moddens Workshop-hurtigbuffermappe på /steamapps/workshop/content/108600/<WorkshopID>/. Start serveren på nytt for å tvinge frem en ren nedlasting.

Løsning for spillere

Spillere som ikke kan koble til på grunn av mod-versjonsavvik bør:

1. Åpne Steam og naviger til Library → Project Zomboid.
2. Høyreklikk Project Zomboid, velg Properties → Local Files → Verify Integrity of Game Files.
3. Naviger også til Steam Workshop-mappen for Project Zomboid på sin lokale maskin og slett bufrede mod-filer for å tvinge frem en ny nedlasting.
4. Start spillet og koble til serveren igjen.

8. Tømme Steam Workshop-hurtigbufferen

Hvis flere mod-problemer vedvarer og du mistenker at Workshop-nedlastingshurtigbufferen er korrupt, kan du tvinge frem en fullstendig ny nedlasting av alle Workshop-mods.

1. Stopp serveren i GPanel.
2. Koble til via SFTP og naviger til /steamapps/workshop/.
3. Slett hele workshop/-mappen (eller innholdet i den).
4. Start serveren. Steam vil laste ned alle Workshop-gjenstander på nytt fra bunnen av.
5. Følg med på GPanel-konsollen for å bekrefte at alle mods er ferdig nedlastet før serveren begynner å laste inn verden.

Hurtig diagnostisk referanse

Har du fortsatt mod-problemer?