Ovaj vodič pokriva napredno rješavanje problema s modovima za Project Zomboid servere hostirane na Legion Hosting. Ako još niste instalirali modove, počnite s osnovnim vodičem za instalaciju modova. Ovaj članak obrađuje najčešće probleme vezane uz modove viđene u Legion Hosting zahtjevima za podršku, uključujući oštećenje WorldDictionary datoteke, greške u formatu modova, konflikte u redoslijedu učitavanja i nepodudarnost verzija između servera i klijenta.

Prije nego započnete

• Prijavite se na GPanel i odaberite svoj Project Zomboid server.
• Zaustavite server prije bilo kakvih promjena konfiguracije ili datoteka.
• Napravite sigurnosnu kopiju mape spremljenog svijeta (/.cache/saves/multiplayer/) putem SFTP-a ili GPanel-a prije pokušaja bilo kakvog popravka. Pogledajte SFTP vodič ako niste upoznati s prijenosom datoteka.
• Pripremite putanju do .ini datoteke vašeg servera: /.cache/server/<servername>.ini (npr. servertest.ini).

1. Greške u formatu modova (B42 vs B41)

Najčešći razlog zašto se modovi ne učitavaju je neispravan format u Mods= retku vaše serverske .ini datoteke. Build 42 i Build 41 koriste različitu sintaksu, a miješanje formata će tiho propustiti učitavanje vaših modova.

B42 format (trenutni zadani)

Build 42 zahtijeva prefiks s obrnutom kosom crtom ispred svakog Mod ID-a u Mods= retku:

Mods=\ModID1;\ModID2;\ModID3;

DLMP format kombinira Workshop ID-ove i Mod ID-ove s razdvajačem u obliku obrnute kose crte:

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

WorkshopItems= redak koristi isti format odvojen točkom-zarezom na oba builda:

WorkshopItems=2392987841;1550458773;2786383654

B41 format (zastarjeli)

Build 41 koristi obične Mod ID-ove odvojene točkom-zarezom bez obrnute kose crte:

Mods=ModID1;ModID2;ModID3

Kako popraviti

1. Otvorite /.cache/server/<servername>.ini u GPanel upravitelju datoteka.
2. Pronađite Mods= redak i provjerite format prema gornjim primjerima.
3. Ako je format pogrešan za vašu verziju builda, ispravite ga. Koristite Legion Hosting Mod Organizer za automatsko generiranje ispravno formatiranih redaka.
4. Spremite datoteku i pokrenite server.

2. Oštećenje WorldDictionary datoteke

WorldDictionary je datoteka (WorldDictionary.bin) koja mapira nazive predmeta na interne numeričke ID-ove. Kada se modovi dodaju ili uklone, rječnik se može oštetiti, uzrokujući pad servera pri pokretanju s WorldDictionaryException greškom.

Simptomi

• Konzola ili debug.log prikazuje WorldDictionaryException ili WorldDictionary greške.
• Server se ruši odmah tijekom pokretanja, posebno tijekom učitavanja svijeta.
• Pad je započeo nakon dodavanja, uklanjanja ili ažuriranja modova.

Razumijevanje rizika

Koraci za oporavak

1. Zaustavite server u GPanel-u.
2. Napravite sigurnosnu kopiju cijele mape spremljenog svijeta putem SFTP-a: preuzmite cijeli /.cache/saves/multiplayer/<YourWorldName>/ direktorij na svoje lokalno računalo.
3. Najprije pokušajte jednostavno vratiti promjenu moda koja je uzrokovala grešku. Ako ste upravo dodali mod, uklonite ga iz Mods= i WorkshopItems= u .ini datoteci. Ako ste upravo uklonili mod, dodajte ga natrag. Pokrenite server i provjerite je li pad riješen.
4. Ako vraćanje promjene moda ne uspije, povežite se putem SFTP-a i navigirajte do /.cache/saves/multiplayer/<YourWorldName>/.
5. Obrišite WorldDictionary.bin.
6. Pokrenite server. Project Zomboid će regenerirati rječnik pri pokretanju.
7. Pridružite se serveru i pregledajte svijet za oštećene predmete, nestala vozila ili pokvarene inventare. Ako je svijet ozbiljno oštećen, vratite ga iz sigurnosne kopije koju ste napravili u koraku 2.

3. Konflikti Authentic Z modova

Authentic Z je jedna od najpopularnijih Project Zomboid kolekcija modova, ali čest je izvor zahtjeva za podršku jer sadrži više pod-modova koji međusobno konfliktiraju.

Pravilo

Česte greške

• Dodavanje i Authentic Z - Current i Authentic Z - Litemode u isto vrijeme.
• Dodavanje Authentic Z pod-modova koji su dizajnirani za singleplayer zajedno s multiplayer verzijom.
• Nesvjesnost da različiti Authentic Z pod-modovi dijele isti Workshop ID ali imaju različite Mod ID-ove, pa preuzimanje s Workshopa uspijeva ali server učitava konfliktne datoteke modova.

Kako popraviti

1. Otvorite /.cache/server/<servername>.ini u GPanel upravitelju datoteka.
2. Pretražite Mods= redak za svaki unos koji sadrži Authentic ili AuthenticZ.
3. Zadržite samo jedan Authentic Z pod-mod (preporučeno: Authentic Z - Current). Uklonite sve ostale Authentic Z unose iz Mods= i WorkshopItems= redaka.
4. Spremite datoteku i ponovo pokrenite server.

4. Problemi s razlikovanjem velikih i malih slova na Linuxu

Legion Hosting serveri rade na Linuxu, gdje su nazivi datoteka i mapa osjetljivi na velika i mala slova. Datoteka nazvana MyMod.lua i mymod.lua tretiraju se kao dvije potpuno različite datoteke. Ovo uzrokuje probleme kada autori modova razvijaju na Windowsu (koji nije osjetljiv na velika/mala slova) i njihovi modovi sadrže nepodudarajuće reference na datoteke.

Simptomi

• Mod radi savršeno u singleplayeru na vašem Windows računalu ali ne radi na serveru.
• Konzola ili debug.log prikazuje FileNotFoundException ili can't find file greške koje referenciraju Lua skriptu ili teksturu unutar moda.
• Greška upućuje na datoteku koja postoji u mapi moda, ali s drugačijim velikim/malim slovima (npr. kod referencira Items.txt ali stvarna datoteka se zove items.txt).

Kako dijagnosticirati

1. Provjerite konzolu ili log datoteke u /.cache/Logs/ za točnu putanju datoteke navedenu u grešci.
2. Povežite se putem SFTP-a i navigirajte do mape moda na /steamapps/workshop/content/108600/<WorkshopID>/.
3. Usporedite nazive datoteka na disku s nazivom datoteke navedenim u poruci greške. Potražite razlike u velikim i malim slovima.

Kako popraviti

• Ako možete preimenovati datoteku: Povežite se putem SFTP-a i preimenujte datoteku tako da odgovara velikim/malim slovima koje očekuje kod moda. Imajte na umu da će ovaj popravak biti prepisan ako se mod ažurira na Steam Workshopu.
• Ako je problem u samom modu: Prijavite bug autoru moda na Steam Workshop stranici. Napomenite da referenca na datoteku ima nepodudarnost velikih/malih slova i da ne radi na Linux serverima. Mnogi autori modova nisu svjesni osjetljivosti Linuxa na velika/mala slova.
• Kao zaobilazno rješenje: Provjerite komentare na Workshop stranici moda — drugi operateri Linux servera možda su objavili popravak ili kompatibilnu verziju moda.

5. Problemi s redoslijedom učitavanja modova

Project Zomboid učitava modove redoslijedom kojim se pojavljuju u Mods= retku. Neki modovi ovise o tome da drugi modovi budu učitani prvi. Ako se ovisnost učita nakon moda koji je zahtijeva, ovisni mod može tiho zakazati ili uzrokovati greške.

Simptomi

• Funkcionalnosti moda djelomično rade — neki predmeti ili sustavi iz moda su prisutni ali drugi nedostaju.
• Konzola prikazuje NullPointerException ili attempt to index a nil value greške koje referenciraju Lua skripte moda.
• Greške se pojavljuju samo kada je instalirana specifična kombinacija modova, ali svaki mod radi ispravno pojedinačno.

Kako popraviti

1. Provjerite Steam Workshop stranicu svakog moda za odjeljak "Required Mods" ili "Load Order". Mnogi autori modova navode koji modovi moraju biti učitani prije njihovog.
2. Otvorite /.cache/server/<servername>.ini i pronađite Mods= redak.
3. Preuredite unose tako da se ovisni modovi pojavljuju prije modova koji ih zahtijevaju. Na primjer, ako Mod B zahtijeva Mod A, redak bi trebao glasiti Mods=\ModA;\ModB; (B42 format).
4. Framework i bibliotečni modovi (poput ModFramework, TsarLib ili Shark's Mod Utils) uvijek trebaju biti navedeni prvi u Mods= retku.
5. Spremite datoteku i ponovo pokrenite server.

6. Padovi servera nakon dodavanja modova

Ako je vaš server radio ispravno i padne nakon dodavanja jednog ili više modova, novi mod je vjerojatno uzrok. Ovaj odjeljak vas vodi kroz izoliranje problematičnog moda.

Izolacija korak po korak

1. Zaustavite server u GPanel-u.
2. Otvorite /.cache/server/<servername>.ini u upravitelju datoteka.
3. Zabilježite sve modove koje ste upravo dodali. Uklonite sve njih iz Mods= i WorkshopItems= redaka.
4. Pokrenite server. Ako se uspješno pokrene, problem je u jednom od modova koje ste uklonili.
5. Dodajte modove natrag jedan po jedan, ponovo pokrećući server nakon svakog dodavanja. Kada se pad vrati, posljednji mod koji ste dodali je uzrok.
6. Nakon identificiranja, provjerite Workshop stranicu moda za:
   • Napomenu o B42 kompatibilnosti — mnogi B41 modovi nisu ažurirani za B42.
   • Poznate konflikte s drugim modovima koje koristite.
   • Potrebne ovisne modove koje možda nemate instalirane.

Čitanje zapisa o padu

Prije provođenja procesa izolacije, provjerite zapis o padu — često izravno upućuje na problematični mod:

1. U GPanel-u otvorite karticu Console i pomaknite se do kraja ispisa.
2. Potražite retke STACK TRACE, Exception ili ERROR.
3. Redci neposredno iznad stack tracea obično referenciraju naziv datoteke moda ili Mod ID — to vam govori koji mod je izazvao pad.
4. Za više detalja, otvorite potpunu log datoteku putem SFTP-a na /.cache/Logs/ i provjerite najnoviju DebugLog-server.txt ili debug.log datoteku.

7. Nepodudarnost verzija modova (Server vs Klijent)

Project Zomboid zahtijeva da server i svi povezani klijenti imaju istu verziju svakog moda. Ako se mod ažurira na Steam Workshopu i server preuzme novu verziju, ali igrač još ima staru verziju u predmemoriji (ili obrnuto), doći će do grešaka pri povezivanju ili padova.

Simptomi

• Igrači dobivaju grešku "Mod mismatch" ili "Version mismatch" pri pokušaju povezivanja.
• Neki igrači se mogu povezati ali drugi ne mogu — oni koji se ne mogu povezati imaju drugačiju verziju moda lokalno u predmemoriji.
• Server je radio ispravno, zatim se mod ažurirao na Steam Workshopu i odjednom se neki igrači ne mogu pridružiti.
• Igrači vide teksture, predmete koji nedostaju ili pokvarene UI elemente iz modova koji su nedavno ažurirani.

Rješenje za operatere servera

1. Zaustavite server u GPanel-u.
2. Ponovo pokrenite server. Pri pokretanju, server ponovno preuzima najnovije verzije svih Workshop modova. Ovo osigurava da server koristi najnoviju verziju.
3. Ako server još uvijek ima staru verziju u predmemoriji, povežite se putem SFTP-a i obrišite mapu predmemorije specifičnog moda na /steamapps/workshop/content/108600/<WorkshopID>/. Ponovo pokrenite server za čisto preuzimanje.

Rješenje za igrače

Igrači koji se ne mogu povezati zbog nepodudarnosti verzija modova trebaju:

1. Otvoriti Steam i navigirati do Library → Project Zomboid.
2. Desnom tipkom kliknuti Project Zomboid, odabrati Properties → Local Files → Verify Integrity of Game Files.
3. Također navigirati do Steam Workshop mape za Project Zomboid na svom lokalnom računalu i obrisati datoteke modova u predmemoriji za prisilno ponovno preuzimanje.
4. Pokrenuti igru i ponovo se povezati na server.

8. Brisanje Steam Workshop predmemorije

Ako više problema s modovima i dalje postoji i sumnjate da je predmemorija preuzimanja s Workshopa oštećena, možete prisiliti potpuno ponovno preuzimanje svih Workshop modova.

1. Zaustavite server u GPanel-u.
2. Povežite se putem SFTP-a i navigirajte do /steamapps/workshop/.
3. Obrišite cijelu workshop/ mapu (ili njezin sadržaj).
4. Pokrenite server. Steam će ponovo preuzeti sve Workshop stavke ispočetka.
5. Pratite GPanel konzolu kako biste potvrdili da su svi modovi završili preuzimanje prije nego server započne učitavanje svijeta.

Brza dijagnostička referenca

Još uvijek imate problema s modovima?