Acest ghid acoperă depanarea avansată a modurilor pentru serverele Project Zomboid găzduite cu Legion Hosting. Dacă nu ai instalat încă moduri, începe mai întâi cu ghidul de bază pentru instalarea modurilor. Acest articol abordează cele mai frecvente probleme legate de moduri întâlnite în tichetele de suport Legion Hosting, inclusiv corupția WorldDictionary, erorile de format al modurilor, conflictele de ordine de încărcare și nepotrivirile de versiune între server și client.

Înainte de a Începe

• Conectează-te la GPanel și selectează serverul tău Project Zomboid.
• Oprește serverul înainte de a face orice modificare de configurare sau de fișiere.
• Fă backup la folderul de salvare al lumii tale (/.cache/saves/multiplayer/) prin SFTP sau GPanel înainte de a încerca orice soluție. Vezi ghidul SFTP dacă nu ești familiarizat cu transferurile de fișiere.
• Pregătește calea către fișierul .ini al serverului tău: /.cache/server/<servername>.ini (ex., servertest.ini).

1. Erori de Format al Modurilor (B42 vs B41)

Cel mai frecvent motiv pentru care modurile nu se încarcă este un format incorect în linia Mods= din fișierul .ini al serverului tău. Build 42 și Build 41 folosesc sintaxe diferite, iar confundarea lor va duce la eșecul silențios al încărcării modurilor tale.

Formatul B42 (Implicit Actual)

Build 42 necesită un prefix backslash înaintea fiecărui Mod ID în linia Mods=:

Mods=\ModID1;\ModID2;\ModID3;

Formatul DLMP combină Workshop ID-urile și Mod ID-urile cu un separator backslash:

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

Linia WorkshopItems= folosește același format separat prin punct și virgulă pe ambele build-uri:

WorkshopItems=2392987841;1550458773;2786383654

Formatul B41 (Vechi)

Build 41 folosește Mod ID-uri simple separate prin punct și virgulă, fără backslash:

Mods=ModID1;ModID2;ModID3

Cum să Repari

1. Deschide /.cache/server/<servername>.ini în File Manager-ul din GPanel.
2. Găsește linia Mods= și verifică formatul față de exemplele de mai sus.
3. Dacă formatul este greșit pentru versiunea ta de build, corectează-l. Folosește Legion Hosting Mod Organizer pentru a genera automat linii formatate corect.
4. Salvează fișierul și pornește serverul.

2. Corupția WorldDictionary

WorldDictionary este un fișier (WorldDictionary.bin) care mapează numele articolelor la ID-uri numerice interne. Când modurile sunt adăugate sau eliminate, dicționarul se poate corupe, cauzând blocarea serverului la pornire cu un WorldDictionaryException.

Simptome

• Consola sau debug.log afișează erori WorldDictionaryException sau WorldDictionary.
• Serverul se blochează imediat în timpul pornirii, mai exact în timpul încărcării lumii.
• Blocarea a început după adăugarea, eliminarea sau actualizarea modurilor.

Înțelegerea Riscului

Pași de Recuperare

1. Oprește serverul în GPanel.
2. Fă backup la întregul folder de salvare prin SFTP: descarcă întregul director /.cache/saves/multiplayer/<YourWorldName>/ pe mașina ta locală.
3. Mai întâi, încearcă pur și simplu să anulezi modificarea modurilor care a cauzat eroarea. Dacă tocmai ai adăugat un mod, elimină-l atât din Mods=, cât și din WorkshopItems= în fișierul .ini. Dacă tocmai ai eliminat un mod, adaugă-l înapoi. Pornește serverul și vezi dacă blocarea s-a rezolvat.
4. Dacă anularea modificării modurilor nu funcționează, conectează-te prin SFTP și navighează la /.cache/saves/multiplayer/<YourWorldName>/.
5. Șterge WorldDictionary.bin.
6. Pornește serverul. Project Zomboid va regenera dicționarul la pornire.
7. Alătură-te serverului și inspectează lumea pentru articole corupte, vehicule lipsă sau inventare defecte. Dacă lumea este grav deteriorată, restaurează din backup-ul pe care l-ai creat la pasul 2.

3. Conflicte ale Modului Authentic Z

Authentic Z este una dintre cele mai populare colecții de moduri Project Zomboid, dar este o sursă frecventă de tichete de suport deoarece conține mai multe sub-moduri care intră în conflict între ele.

Regula

Greșeli Frecvente

• Adăugarea atât a Authentic Z - Current, cât și a Authentic Z - Litemode în același timp.
• Adăugarea sub-modurilor Authentic Z care sunt concepute pentru singleplayer alături de versiunea multiplayer.
• Nerealizarea faptului că diferitele sub-moduri Authentic Z partajează același Workshop ID, dar au Mod ID-uri diferite, astfel încât descărcarea de pe Workshop reușește, dar serverul încarcă fișiere de moduri aflate în conflict.

Cum să Repari

1. Deschide /.cache/server/<servername>.ini în File Manager-ul din GPanel.
2. Caută în linia Mods= fiecare intrare care conține Authentic sau AuthenticZ.
3. Păstrează doar un singur sub-mod Authentic Z (recomandat: Authentic Z - Current). Elimină toate celelalte intrări Authentic Z atât din liniile Mods=, cât și din WorkshopItems=.
4. Salvează fișierul și repornește serverul.

4. Probleme de Sensibilitate la Majuscule pe Linux

Serverele Legion Hosting rulează pe Linux, unde numele de fișiere și foldere sunt sensibile la majuscule. Un fișier numit MyMod.lua și mymod.lua sunt tratate ca două fișiere complet diferite. Acest lucru cauzează probleme atunci când autorii de moduri dezvoltă pe Windows (insensibil la majuscule) și modurile lor conțin referințe de fișiere care nu se potrivesc.

Simptome

• Un mod funcționează perfect în singleplayer pe PC-ul tău cu Windows, dar eșuează pe server.
• Consola sau debug.log afișează erori FileNotFoundException sau can't find file care fac referire la un script Lua sau o textură dintr-un mod.
• Eroarea indică un fișier care există în folderul modului, dar cu o capitalizare diferită (ex., codul face referire la Items.txt, dar fișierul real se numește items.txt).

Cum să Diagnostichezi

1. Verifică fișierele de log din consolă sau din /.cache/Logs/ pentru calea exactă a fișierului menționată în eroare.
2. Conectează-te prin SFTP și navighează la folderul modului la /steamapps/workshop/content/108600/<WorkshopID>/.
3. Compară numele fișierelor de pe disc cu numele fișierului la care se face referire în mesajul de eroare. Caută diferențe de capitalizare.

Cum să Repari

• Dacă poți redenumi fișierul: Conectează-te prin SFTP și redenumește fișierul pentru a se potrivi cu capitalizarea așteptată de codul modului. Reține că această soluție va fi suprascrisă dacă modul se actualizează pe Steam Workshop.
• Dacă problema este în modul însuși: Raportează bug-ul autorului modului pe pagina Steam Workshop. Menționează că referința de fișier are o nepotrivire de capitalizare și că eșuează pe serverele Linux. Mulți autori de moduri nu sunt conștienți de sensibilitatea la majuscule de pe Linux.
• Ca soluție temporară: Verifică comentariile de pe pagina Workshop a modului — alți operatori de servere Linux ar putea fi postat o soluție sau un fork compatibil al modului.

5. Probleme cu Ordinea de Încărcare a Modurilor

Project Zomboid încarcă modurile în ordinea în care apar în linia Mods=. Unele moduri depind de încărcarea prealabilă a altor moduri. Dacă o dependență este încărcată după modul care o necesită, modul dependent poate eșua silențios sau cauza erori.

Simptome

• Funcțiile modului funcționează parțial — unele articole sau sisteme dintr-un mod sunt prezente, dar altele lipsesc.
• Consola afișează erori NullPointerException sau attempt to index a nil value care fac referire la scripturile Lua ale unui mod.
• Erorile apar doar când este instalată o combinație specifică de moduri, dar fiecare mod funcționează bine individual.

Cum să Repari

1. Verifică pagina Steam Workshop a fiecărui mod pentru o secțiune „Required Mods" sau „Load Order". Mulți autori de moduri specifică ce moduri trebuie încărcate înaintea modurilor lor.
2. Deschide /.cache/server/<servername>.ini și găsește linia Mods=.
3. Reordonează intrările astfel încât modurile de dependență să apară înaintea modurilor care le necesită. De exemplu, dacă Modul B necesită Modul A, linia ar trebui să fie Mods=\ModA;\ModB; (format B42).
4. Modurile de tip framework și bibliotecă (cum ar fi ModFramework, TsarLib sau Shark's Mod Utils) ar trebui listate întotdeauna primele în linia Mods=.
5. Salvează fișierul și repornește serverul.

6. Serverul Se Blochează După Adăugarea Modurilor

Dacă serverul tău funcționa bine și se blochează după adăugarea unuia sau mai multor moduri, noul mod este probabil cauza. Această secțiune te ghidează prin izolarea modului problematic.

Izolare Pas cu Pas

1. Oprește serverul în GPanel.
2. Deschide /.cache/server/<servername>.ini în File Manager.
3. Notează toate modurile pe care tocmai le-ai adăugat. Elimină-le pe toate atât din liniile Mods=, cât și din WorkshopItems=.
4. Pornește serverul. Dacă pornește cu succes, problema se află într-unul dintre modurile pe care le-ai eliminat.
5. Adaugă modurile înapoi câte unul pe rând, repornind serverul după fiecare adăugare. Când blocarea revine, ultimul mod pe care l-ai adăugat este cauza.
6. Odată identificat, verifică pagina Workshop a modului pentru:
   • O notă despre compatibilitatea cu B42 — multe moduri B41 nu au fost actualizate pentru B42.
   • Conflicte cunoscute cu alte moduri pe care le rulezi.
   • Moduri de dependență necesare pe care s-ar putea să nu le ai instalate.

Citirea Log-ului de Blocare

Înainte de a efectua procesul de izolare, verifică log-ul de blocare — acesta indică adesea direct modul problematic:

1. În GPanel, deschide tab-ul Console și derulează până la sfârșitul ieșirii.
2. Caută liniile STACK TRACE, Exception sau ERROR.
3. Liniile imediat deasupra stack trace-ului fac de obicei referire la un nume de fișier de mod sau la un Mod ID — acest lucru îți spune ce mod a declanșat blocarea.
4. Pentru mai multe detalii, deschide fișierul de log complet prin SFTP la /.cache/Logs/ și verifică cel mai recent fișier DebugLog-server.txt sau debug.log.

7. Nepotriviri de Versiune a Modurilor (Server vs Client)

Project Zomboid necesită ca serverul și toți clienții conectați să aibă aceeași versiune a fiecărui mod. Dacă un mod se actualizează pe Steam Workshop și serverul descarcă noua versiune, dar un jucător încă are versiunea veche în cache (sau invers), vor apărea eșecuri de conexiune sau blocări.

Simptome

• Jucătorii primesc o eroare „Mod mismatch" sau „Version mismatch" când încearcă să se conecteze.
• Unii jucători se pot conecta, dar alții nu — cei care nu se pot conecta au o versiune diferită de mod în cache-ul local.
• Serverul funcționa bine, apoi un mod s-a actualizat pe Steam Workshop și brusc unii jucători nu se mai pot alătura.
• Jucătorii văd texturi lipsă, articole lipsă sau elemente UI defecte de la modurile care au fost actualizate recent.

Soluția pentru Operatorii de Servere

1. Oprește serverul în GPanel.
2. Pornește serverul din nou. La pornire, serverul redescarcă cele mai recente versiuni ale tuturor modurilor de pe Workshop. Acest lucru asigură că serverul rulează cea mai nouă versiune.
3. Dacă serverul încă are o versiune veche în cache, conectează-te prin SFTP și șterge folderul de cache Workshop al modului specific la /steamapps/workshop/content/108600/<WorkshopID>/. Repornește serverul pentru a forța o descărcare curată.

Soluția pentru Jucători

Jucătorii care nu se pot conecta din cauza nepotrivirilor de versiune a modurilor ar trebui să:

1. Deschidă Steam și navigheze la Library → Project Zomboid.
2. Facă click dreapta pe Project Zomboid, selecteze Properties → Local Files → Verify Integrity of Game Files.
3. Navigheze, de asemenea, la folderul Steam Workshop pentru Project Zomboid de pe mașina lor locală și șteargă fișierele de moduri din cache pentru a forța o redescărcare.
4. Lanseze jocul și să se conecteze din nou la server.

8. Ștergerea Cache-ului Steam Workshop

Dacă mai multe probleme cu modurile persistă și suspectezi că cache-ul de descărcare Workshop este corupt, poți forța o redescărcare completă a tuturor modurilor de pe Workshop.

1. Oprește serverul în GPanel.
2. Conectează-te prin SFTP și navighează la /steamapps/workshop/.
3. Șterge întregul folder workshop/ (sau conținutul acestuia).
4. Pornește serverul. Steam va redescărca toate articolele Workshop de la zero.
5. Urmărește Consola GPanel pentru a confirma că toate modurile au terminat de descărcat înainte ca serverul să înceapă încărcarea lumii.

Referință Rapidă de Diagnosticare

Încă Ai Probleme cu Modurile?