Den här guiden täcker avancerad felsökning av moddar för Project Zomboid-servrar som hostas hos Legion Hosting. Om du ännu inte har installerat moddar, börja med den grundläggande guiden för moddinstallation först. Den här artikeln tar upp de vanligaste moddrelaterade problemen som ses i Legion Hostings supportärenden, inklusive korruption av WorldDictionary, moddformatfel, konflikter i laddningsordning och versionsavvikelser mellan server och klient.

Innan du börjar

• Logga in på GPanel och välj din Project Zomboid-server.
• Stoppa din server innan du gör några konfigurations- eller filändringar.
• Säkerhetskopiera din världssparmapp (/.cache/saves/multiplayer/) via SFTP eller GPanel innan du försöker med någon lösning. Se SFTP-guiden om du inte är van vid filöverföringar.
• Ha din servers .ini-filsökväg redo: /.cache/server/<servername>.ini (t.ex. servertest.ini).

1. Moddformatfel (B42 vs B41)

Den vanligaste orsaken till att moddar inte laddas är ett felaktigt format på raden Mods= i din servers .ini-fil. Build 42 och Build 41 använder olika syntax, och att blanda ihop dem gör att dina moddar misslyckas med att laddas utan felmeddelande.

B42-format (nuvarande standard)

Build 42 kräver ett bakåtstreck-prefix före varje Mod-ID på raden Mods=:

Mods=\ModID1;\ModID2;\ModID3;

DLMP-formatet kombinerar Workshop-ID:n och Mod-ID:n med ett bakåtstreck som avgränsare:

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

Raden WorkshopItems= använder samma semikolonseparerade format på båda builds:

WorkshopItems=2392987841;1550458773;2786383654

B41-format (äldre)

Build 41 använder vanliga semikolonseparerade Mod-ID:n utan bakåtstreck:

Mods=ModID1;ModID2;ModID3

Så åtgärdar du

1. Öppna /.cache/server/<servername>.ini i GPanels filhanterare.
2. Hitta raden Mods= och kontrollera formatet mot exemplen ovan.
3. Om formatet är fel för din build-version, korrigera det. Använd Legion Hosting Mod Organizer för att automatiskt generera korrekt formaterade rader.
4. Spara filen och starta servern.

2. Korruption av WorldDictionary

WorldDictionary är en fil (WorldDictionary.bin) som mappar föremålsnamn till interna numeriska ID:n. När moddar läggs till eller tas bort kan ordboken bli korrupt, vilket gör att servern kraschar vid start med ett WorldDictionaryException.

Symtom

• Konsolen eller debug.log visar WorldDictionaryException eller WorldDictionary-fel.
• Servern kraschar omedelbart under uppstart, specifikt under världsladdningen.
• Kraschen började efter att moddar lades till, togs bort eller uppdaterades.

Förstå risken

Återställningssteg

1. Stoppa din server i GPanel.
2. Säkerhetskopiera hela din sparmapp via SFTP: ladda ner hela katalogen /.cache/saves/multiplayer/<YourWorldName>/ till din lokala dator.
3. Försök först att helt enkelt ångra den moddändring som orsakade felet. Om du precis lade till en modd, ta bort den från både Mods= och WorkshopItems= i .ini-filen. Om du precis tog bort en modd, lägg tillbaka den. Starta servern och se om kraschen är löst.
4. Om det inte hjälper att ångra moddändringen, anslut via SFTP och navigera till /.cache/saves/multiplayer/<YourWorldName>/.
5. Ta bort WorldDictionary.bin.
6. Starta servern. Project Zomboid regenererar ordboken vid start.
7. Gå med på servern och inspektera världen efter korrupta föremål, saknade fordon eller trasiga inventarier. Om världen är allvarligt skadad, återställ från säkerhetskopian du skapade i steg 2.

3. Konflikter med Authentic Z-moddar

Authentic Z är en av de mest populära moddsamlingarna för Project Zomboid, men den är en frekvent källa till supportärenden eftersom den innehåller flera undermoddar som krockar med varandra.

Regeln

Vanliga misstag

• Att lägga till både Authentic Z - Current och Authentic Z - Litemode samtidigt.
• Att lägga till Authentic Z-undermoddar som är designade för singleplayer tillsammans med multiplayer-versionen.
• Att inte inse att olika Authentic Z-undermoddar delar samma Workshop-ID men har olika Mod-ID:n, så att Workshop-nedladdningen lyckas men servern laddar moddfiler som krockar.

Så åtgärdar du

1. Öppna /.cache/server/<servername>.ini i GPanels filhanterare.
2. Sök på raden Mods= efter varje post som innehåller Authentic eller AuthenticZ.
3. Behåll endast en Authentic Z-undermodd (rekommenderat: Authentic Z - Current). Ta bort alla andra Authentic Z-poster från både raderna Mods= och WorkshopItems=.
4. Spara filen och starta om servern.

4. Problem med skiftlägeskänslighet i Linux

Legion Hostings servrar körs på Linux, där fil- och mappnamn är skiftlägeskänsliga. En fil med namnet MyMod.lua och mymod.lua behandlas som två helt olika filer. Detta orsakar problem när moddutvecklare utvecklar på Windows (skiftlägesokänsligt) och deras moddar innehåller filreferenser som inte stämmer överens.

Symtom

• En modd fungerar perfekt i singleplayer på din Windows-dator men misslyckas på servern.
• Konsolen eller debug.log visar FileNotFoundException eller can't find file-fel som refererar till ett Lua-skript eller en textur inuti en modd.
• Felet pekar på en fil som faktiskt finns i moddmappen, men med annan stor/liten bokstav (t.ex. koden refererar till Items.txt men den faktiska filen heter items.txt).

Så diagnostiserar du

1. Kontrollera konsolen eller loggfilerna i /.cache/Logs/ efter den exakta filsökväg som nämns i felet.
2. Anslut via SFTP och navigera till moddens mapp på /steamapps/workshop/content/108600/<WorkshopID>/.
3. Jämför filnamnen på disken med det filnamn som refereras i felmeddelandet. Leta efter skillnader i stora/små bokstäver.

Så åtgärdar du

• Om du kan byta namn på filen: Anslut via SFTP och byt namn på filen så att den matchar de stora/små bokstäver som moddens kod förväntar sig. Observera att denna lösning kommer att skrivas över om modden uppdateras på Steam Workshop.
• Om problemet ligger i själva modden: Rapportera buggen till moddförfattaren på Steam Workshop-sidan. Nämn att filreferensen har en felmatchning i stora/små bokstäver och att den misslyckas på Linux-servrar. Många moddförfattare är inte medvetna om Linux skiftlägeskänslighet.
• Som en lösning: Kontrollera kommentarerna på moddens Workshop-sida — andra Linux-serveroperatörer kan ha postat en lösning eller en kompatibel fork av modden.

5. Problem med moddars laddningsordning

Project Zomboid laddar moddar i den ordning de visas på raden Mods=. Vissa moddar är beroende av att andra moddar laddas först. Om ett beroende laddas efter den modd som kräver det, kan den beroende modden misslyckas utan felmeddelande eller orsaka fel.

Symtom

• Moddfunktioner fungerar delvis — vissa föremål eller system från en modd finns men andra saknas.
• Konsolen visar NullPointerException eller attempt to index a nil value-fel som refererar till en modds Lua-skript.
• Fel uppstår endast när en specifik kombination av moddar är installerad, men varje modd fungerar bra för sig själv.

Så åtgärdar du

1. Kontrollera varje modds Steam Workshop-sida efter ett avsnitt om "Required Mods" eller "Load Order". Många moddförfattare anger vilka moddar som måste laddas före deras.
2. Öppna /.cache/server/<servername>.ini och hitta raden Mods=.
3. Ändra ordningen på posterna så att beroendemoddar visas före de moddar som kräver dem. Om till exempel Modd B kräver Modd A, ska raden lyda Mods=\ModA;\ModB; (B42-format).
4. Ramverks- och bibliotekmoddar (såsom ModFramework, TsarLib eller Shark's Mod Utils) bör alltid listas först på raden Mods=.
5. Spara filen och starta om servern.

6. Serverkrascher efter att moddar lagts till

Om din server fungerade bra och kraschar efter att du lagt till en eller flera moddar, är den nya modden troligtvis orsaken. Det här avsnittet går igenom hur du isolerar problemmodden.

Isolering steg för steg

1. Stoppa servern i GPanel.
2. Öppna /.cache/server/<servername>.ini i filhanteraren.
3. Notera alla moddar du precis lade till. Ta bort alla från både raderna Mods= och WorkshopItems=.
4. Starta servern. Om den startar utan problem ligger problemet i en av moddarna du tog bort.
5. Lägg tillbaka moddarna en åt gången och starta om servern efter varje tillägg. När kraschen återkommer är den senast tillagda modden orsaken.
6. När den har identifierats, kontrollera moddens Workshop-sida efter:
   • En notering om B42-kompatibilitet — många B41-moddar har inte uppdaterats för B42.
   • Kända konflikter med andra moddar du kör.
   • Nödvändiga beroendemoddar som du kanske inte har installerat.

Läsa kraschloggen

Innan du utför isoleringsprocessen, kontrollera kraschloggen — den pekar ofta direkt på problemmodden:

1. I GPanel, öppna fliken Console och scrolla till slutet av utdata.
2. Leta efter rader med STACK TRACE, Exception eller ERROR.
3. Raderna omedelbart ovanför stack trace refererar vanligtvis till ett moddfilnamn eller Mod-ID — detta talar om vilken modd som utlöste kraschen.
4. För mer detaljer, öppna den fullständiga loggfilen via SFTP på /.cache/Logs/ och kontrollera den senaste filen DebugLog-server.txt eller debug.log.

7. Versionsavvikelser för moddar (server vs klient)

Project Zomboid kräver att servern och alla anslutna klienter har samma version av varje modd. Om en modd uppdateras på Steam Workshop och servern laddar ner den nya versionen men en spelare fortfarande har den gamla versionen cachelagrad (eller tvärtom), uppstår anslutningsfel eller krascher.

Symtom

• Spelare får ett "Mod mismatch"- eller "Version mismatch"-fel när de försöker ansluta.
• Vissa spelare kan ansluta men andra inte — de som inte kan ansluta har en annan moddversion cachelagrad lokalt.
• Servern fungerade bra, sedan uppdaterades en modd på Steam Workshop och plötsligt kan vissa spelare inte gå med.
• Spelare ser saknade texturer, föremål eller trasiga UI-element från moddar som nyligen uppdaterats.

Lösning för serveroperatörer

1. Stoppa servern i GPanel.
2. Starta servern igen. Vid start laddar servern ner de senaste versionerna av alla Workshop-moddar på nytt. Detta säkerställer att servern kör den senaste versionen.
3. Om servern fortfarande har en gammal version cachelagrad, anslut via SFTP och ta bort den specifika moddens Workshop-cachemapp på /steamapps/workshop/content/108600/<WorkshopID>/. Starta om servern för att tvinga fram en ren nedladdning.

Lösning för spelare

Spelare som inte kan ansluta på grund av versionsavvikelser för moddar bör:

1. Öppna Steam och navigera till Library → Project Zomboid.
2. Högerklicka på Project Zomboid, välj Properties → Local Files → Verify Integrity of Game Files.
3. Navigera även till Steam Workshop-mappen för Project Zomboid på sin lokala dator och ta bort cachelagrade moddfiler för att tvinga fram en ny nedladdning.
4. Starta spelet och anslut till servern igen.

8. Rensa Steam Workshop-cachen

Om flera moddproblem kvarstår och du misstänker att Workshops nedladdningscache är korrupt, kan du tvinga fram en fullständig omladdning av alla Workshop-moddar.

1. Stoppa servern i GPanel.
2. Anslut via SFTP och navigera till /steamapps/workshop/.
3. Ta bort hela mappen workshop/ (eller dess innehåll).
4. Starta servern. Steam laddar ner alla Workshop-objekt på nytt från grunden.
5. Bevaka GPanel-konsolen för att bekräfta att alla moddar har laddats ner klart innan servern börjar ladda världen.

Snabb diagnostikreferens

Har du fortfarande moddproblem?