Ovaj vodič pokriva napredno rešavanje problema sa modovima za Project Zomboid servere hostovane kod Legion Hosting. Ako još niste instalirali modove, prvo počnite sa osnovnim vodičem za instalaciju modova. Ovaj članak se bavi najčešćim problemima vezanim za modove koji se viđaju u Legion Hosting tiketima za podršku, uključujući oštećenje WorldDictionary, greške u formatu moda, konflikte redosleda učitavanja i neusklađenosti verzija između servera i klijenta.

Pre nego što počnete

• Prijavite se na GPanel i izaberite svoj Project Zomboid server.
• Zaustavite svoj server pre nego što izvršite bilo kakve promene konfiguracije ili datoteka.
• Napravite rezervnu kopiju foldera sa sačuvanim svetom (/.cache/saves/multiplayer/) putem SFTP-a ili GPanel-a pre nego što pokušate bilo kakvo rešenje. Pogledajte SFTP vodič ako niste upoznati sa prenosom datoteka.
• Pripremite putanju do .ini datoteke svog servera: /.cache/server/<servername>.ini (npr. servertest.ini).

1. Greške u formatu moda (B42 naspram B41)

Najčešći razlog zašto modovi ne uspevaju da se učitaju jeste neispravan format u Mods= liniji .ini datoteke vašeg servera. Build 42 i Build 41 koriste različitu sintaksu, a njihovo mešanje će tiho dovesti do neuspelog učitavanja vaših modova.

B42 format (trenutni podrazumevani)

Build 42 zahteva prefiks obrnute kose crte pre svakog Mod ID-ja u Mods= liniji:

Mods=\ModID1;\ModID2;\ModID3;

DLMP format kombinuje Workshop ID-jeve i Mod ID-jeve sa obrnutom kosom crtom kao razdvajačem:

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

WorkshopItems= linija koristi isti format razdvojen tačkom-zarezom na oba build-a:

WorkshopItems=2392987841;1550458773;2786383654

B41 format (zastareli)

Build 41 koristi obične Mod ID-jeve razdvojene tačkom-zarezom bez obrnute kose crte:

Mods=ModID1;ModID2;ModID3

Kako rešiti

1. Otvorite /.cache/server/<servername>.ini u GPanel File Manager-u.
2. Pronađite Mods= liniju i proverite format u odnosu na primere iznad.
3. Ako je format neispravan za vašu verziju build-a, ispravite ga. Koristite Legion Hosting Mod Organizer da automatski generišete ispravno formatirane linije.
4. Sačuvajte datoteku i pokrenite server.

2. Oštećenje WorldDictionary

WorldDictionary je datoteka (WorldDictionary.bin) koja mapira imena predmeta na interne numeričke ID-jeve. Kada se modovi dodaju ili uklone, rečnik može postati oštećen, što izaziva rušenje servera pri pokretanju sa WorldDictionaryException.

Simptomi

• Konzola ili debug.log prikazuje WorldDictionaryException ili WorldDictionary greške.
• Server se ruši odmah tokom pokretanja, konkretno tokom učitavanja sveta.
• Rušenje je počelo nakon dodavanja, uklanjanja ili ažuriranja modova.

Razumevanje rizika

Koraci za oporavak

1. Zaustavite svoj server u GPanel-u.
2. Napravite rezervnu kopiju celog foldera sa sačuvanim svetom putem SFTP-a: preuzmite ceo /.cache/saves/multiplayer/<YourWorldName>/ direktorijum na svoj lokalni računar.
3. Prvo pokušajte da jednostavno poništite promenu moda koja je izazvala grešku. Ako ste upravo dodali mod, uklonite ga i iz Mods= i iz WorkshopItems= u .ini datoteci. Ako ste upravo uklonili mod, dodajte ga ponovo. Pokrenite server i proverite da li je rušenje rešeno.
4. Ako poništavanje promene moda ne uspe, povežite se putem SFTP-a i idite do /.cache/saves/multiplayer/<YourWorldName>/.
5. Obrišite WorldDictionary.bin.
6. Pokrenite server. Project Zomboid će ponovo generisati rečnik pri pokretanju.
7. Pridružite se serveru i pregledajte svet u potrazi za oštećenim predmetima, nedostajućim vozilima ili pokvarenim inventarima. Ako je svet ozbiljno oštećen, vratite ga iz rezervne kopije koju ste napravili u koraku 2.

3. Konflikti Authentic Z moda

Authentic Z je jedna od najpopularnijih kolekcija modova za Project Zomboid, ali je čest izvor tiketa za podršku jer sadrži više pod-modova koji su u međusobnom konfliktu.

Pravilo

Česte greške

• Dodavanje i Authentic Z - Current i Authentic Z - Litemode istovremeno.
• Dodavanje Authentic Z pod-modova dizajniranih za singleplayer pored multiplayer verzije.
• Neshvatanje da različiti Authentic Z pod-modovi dele isti Workshop ID, ali imaju različite Mod ID-jeve, pa Workshop preuzimanje uspeva, ali server učitava konfliktne datoteke modova.

Kako rešiti

1. Otvorite /.cache/server/<servername>.ini u GPanel File Manager-u.
2. Pretražite Mods= liniju 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= linija.
4. Sačuvajte datoteku i ponovo pokrenite server.

4. Problemi sa razlikovanjem velikih i malih slova na Linux-u

Legion Hosting serveri rade na Linux-u, gde imena datoteka i foldera razlikuju velika i mala slova. Datoteka pod imenom MyMod.lua i mymod.lua tretiraju se kao dve potpuno različite datoteke. Ovo izaziva probleme kada autori modova razvijaju na Windows-u (koji ne razlikuje velika i mala slova) i njihovi modovi sadrže neusklađene reference na datoteke.

Simptomi

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

Kako dijagnostikovati

1. Proverite konzolu ili log datoteke u /.cache/Logs/ za tačnu putanju datoteke navedenu u grešci.
2. Povežite se putem SFTP-a i idite do foldera moda na /steamapps/workshop/content/108600/<WorkshopID>/.
3. Uporedite imena datoteka na disku sa imenom datoteke navedenim u poruci o grešci. Potražite razlike u velikim i malim slovima.

Kako rešiti

• Ako možete da preimenujete datoteku: Povežite se putem SFTP-a i preimenujte datoteku da odgovara velikim/malim slovima koje kod moda očekuje. Imajte na umu da će ovo rešenje biti prepisano ako se mod ažurira na Steam Workshop.
• Ako je problem u samom modu: Prijavite grešku autoru moda na Steam Workshop stranici. Pomenite da referenca na datoteku ima neusklađenost velikih/malih slova i da ne uspeva na Linux serverima. Mnogi autori modova nisu svesni Linux razlikovanja velikih i malih slova.
• Kao zaobilazno rešenje: Proverite komentare na Workshop stranici moda — drugi operateri Linux servera su možda objavili rešenje ili kompatibilan fork moda.

5. Problemi sa redosledom učitavanja modova

Project Zomboid učitava modove redosledom kojim se pojavljuju u Mods= liniji. Neki modovi zavise od toga da se drugi modovi prvo učitaju. Ako se zavisnost učita nakon moda koji je zahteva, zavisni mod može tiho da ne uspe ili da izazove greške.

Simptomi

• Funkcije moda delimično rade — neki predmeti ili sistemi iz moda su prisutni, ali drugi nedostaju.
• Konzola prikazuje NullPointerException ili attempt to index a nil value greške koje upućuju na Lua skripte moda.
• Greške se pojavljuju samo kada je instalirana određena kombinacija modova, ali svaki mod radi dobro pojedinačno.

Kako rešiti

1. Proverite Steam Workshop stranicu svakog moda za odeljak „Required Mods" ili „Load Order". Mnogi autori modova navode koji modovi moraju biti učitani pre njihovog.
2. Otvorite /.cache/server/<servername>.ini i pronađite Mods= liniju.
3. Promenite redosled unosa tako da se modovi zavisnosti pojavljuju pre modova koji ih zahtevaju. Na primer, ako Mod B zahteva Mod A, linija treba da glasi Mods=\ModA;\ModB; (B42 format).
4. Framework i library modovi (kao što su ModFramework, TsarLib ili Shark's Mod Utils) uvek treba da budu navedeni prvi u Mods= liniji.
5. Sačuvajte datoteku i ponovo pokrenite server.

6. Server se ruši nakon dodavanja modova

Ako je vaš server radio dobro i ruši se nakon dodavanja jednog ili više modova, novi mod je verovatni uzrok. Ovaj odeljak vas vodi kroz izolovanje problematičnog moda.

Izolacija korak po korak

1. Zaustavite server u GPanel-u.
2. Otvorite /.cache/server/<servername>.ini u File Manager-u.
3. Zabeležite sve modove koje ste upravo dodali. Uklonite ih sve iz Mods= i WorkshopItems= linija.
4. Pokrenite server. Ako se uspešno pokrene, problem je u jednom od modova koje ste uklonili.
5. Dodajte modove ponovo jedan po jedan, ponovo pokrećući server nakon svakog dodavanja. Kada se rušenje vrati, poslednji mod koji ste dodali je uzrok.
6. Kada ga identifikujete, proverite Workshop stranicu moda za:
   • Napomenu o B42 kompatibilnosti — mnogi B41 modovi nisu ažurirani za B42.
   • Poznate konflikte sa drugim modovima koje pokrećete.
   • Potrebne modove zavisnosti koje možda niste instalirali.

Čitanje loga rušenja

Pre izvođenja procesa izolacije, proverite log rušenja — on često direktno upućuje na problematični mod:

1. U GPanel-u otvorite karticu Console i skrolujte do kraja izlaza.
2. Potražite STACK TRACE, Exception ili ERROR linije.
3. Linije neposredno iznad stack trace-a obično upućuju na ime datoteke moda ili Mod ID — to vam govori koji je mod izazvao rušenje.
4. Za više detalja otvorite kompletnu log datoteku putem SFTP-a na /.cache/Logs/ i proverite najnoviju DebugLog-server.txt ili debug.log datoteku.

7. Neusklađenosti verzija modova (server naspram klijenta)

Project Zomboid zahteva da server i svi povezani klijenti imaju istu verziju svakog moda. Ako se mod ažurira na Steam Workshop i server preuzme novu verziju, ali igrač i dalje ima staru verziju u kešu (ili obrnuto), doći će do neuspeha povezivanja ili rušenja.

Simptomi

• Igrači dobijaju grešku „Mod mismatch" ili „Version mismatch" kada pokušaju da se povežu.
• Neki igrači mogu da se povežu, a drugi ne — oni koji ne mogu da se povežu imaju različitu verziju moda keširanu lokalno.
• Server je radio dobro, zatim se mod ažurirao na Steam Workshop i odjednom neki igrači ne mogu da se pridruže.
• Igrači vide nedostajuće teksture, predmete ili pokvarene UI elemente iz modova koji su nedavno ažurirani.

Rešenje za operatere servera

1. Zaustavite server u GPanel-u.
2. Ponovo pokrenite server. Pri pokretanju, server ponovo preuzima najnovije verzije svih Workshop modova. Ovo osigurava da server pokreće najnoviju verziju.
3. Ako server i dalje ima staru verziju u kešu, povežite se putem SFTP-a i obrišite folder Workshop keša određenog moda na /steamapps/workshop/content/108600/<WorkshopID>/. Ponovo pokrenite server da biste forsirali čisto preuzimanje.

Rešenje za igrače

Igrači koji ne mogu da se povežu zbog neusklađenosti verzija modova treba da:

1. Otvore Steam i odu do Library → Project Zomboid.
2. Kliknu desnim tasterom na Project Zomboid, izaberu Properties → Local Files → Verify Integrity of Game Files.
3. Takođe odu do Steam Workshop foldera za Project Zomboid na svom lokalnom računaru i obrišu keširane datoteke modova da bi forsirali ponovno preuzimanje.
4. Pokrenu igru i ponovo se povežu na server.

8. Brisanje Steam Workshop keša

Ako više problema sa modovima i dalje postoji i sumnjate da je keš za preuzimanje sa Workshop-a oštećen, možete forsirati potpuno ponovno preuzimanje svih Workshop modova.

1. Zaustavite server u GPanel-u.
2. Povežite se putem SFTP-a i idite do /steamapps/workshop/.
3. Obrišite ceo workshop/ folder (ili njegov sadržaj).
4. Pokrenite server. Steam će ponovo preuzeti sve Workshop stavke od početka.
5. Pratite GPanel Console da biste potvrdili da su svi modovi završili preuzimanje pre nego što server započne učitavanje sveta.

Brza dijagnostička referenca

I dalje imate probleme sa modovima?