See juhend käsitleb Project Zomboid serverite täiustatud modifikatsiooni veaotsingut Legion Hosting serveritel. Kui te pole veel modifikatsioone paigaldanud, alustage esmalt modifikatsiooni paigaldamise põhijuhendist. See artikkel käsitleb levinumaid modifikatsioonidega seotud probleeme, mida esineb Legion Hosting tugiteenuse piletites, sealhulgas WorldDictionary riknemine, modifikatsiooni vormingu vead, laadimise järjekorra konfliktid ja versiooni mittevastavused serveri ja kliendi vahel.

Enne alustamist

• Logige sisse GPanel-i ja valige oma Project Zomboid server.
• Peatage server enne konfiguratsiooni- või failimuudatuste tegemist.
• Varundage oma maailma salvestuskaust (/.cache/saves/multiplayer/) SFTP või GPanel kaudu enne mis tahes paranduse katsetamist. Vaadake SFTP juhendit, kui te pole failiedastustega tuttav.
• Hoidke oma serveri .ini faili tee käepärast: /.cache/server/<servername>.ini (nt servertest.ini).

1. Modifikatsiooni vormingu vead (B42 vs B41)

Kõige levinum põhjus, miks modifikatsioonid ei laadi, on vale vorming Mods= real teie serveri .ini failis. Build 42 ja Build 41 kasutavad erinevat süntaksit ning nende segamine põhjustab modifikatsioonide vaikset laadimise ebaõnnestumist.

B42 vorming (praegune vaikimisi)

Build 42 nõuab kaldkriipsu eesliidet iga Mod ID ees Mods= real:

Mods=\ModID1;\ModID2;\ModID3;

DLMP vorming ühendab Workshop ID-d ja Mod ID-d kaldkriipsu eraldajaga:

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

WorkshopItems= rida kasutab mõlemal versioonil sama semikooloniga eraldatud vormingut:

WorkshopItems=2392987841;1550458773;2786383654

B41 vorming (pärand)

Build 41 kasutab lihtsaid semikooloniga eraldatud Mod ID-sid ilma kaldkriipsuta:

Mods=ModID1;ModID2;ModID3

Kuidas parandada

1. Avage /.cache/server/<servername>.ini GPanel failihalduris.
2. Leidke Mods= rida ja kontrollige vormingut ülaltoodud näidete põhjal.
3. Kui vorming on teie versiooni jaoks vale, parandage see. Kasutage Legion Hosting Mod Organizer-it, et genereerida automaatselt õigesti vormindatud read.
4. Salvestage fail ja käivitage server.

2. WorldDictionary riknemine

WorldDictionary on fail (WorldDictionary.bin), mis kaardistab esemete nimed sisemistele numbrilistele ID-dele. Kui modifikatsioone lisatakse või eemaldatakse, võib sõnastik rikneda, põhjustades serveri kokkujooksmise käivitamisel WorldDictionaryException veaga.

Sümptomid

• Konsool või debug.log näitab WorldDictionaryException või WorldDictionary vigu.
• Server jookseb kohe käivitamisel kokku, täpsemalt maailma laadimise ajal.
• Kokkujooksmine algas pärast modifikatsioonide lisamist, eemaldamist või uuendamist.

Riski mõistmine

Taastamise sammud

1. Peatage server GPanel-is.
2. Varundage kogu salvestuskaust SFTP kaudu: laadige alla kogu /.cache/saves/multiplayer/<YourWorldName>/ kataloog oma kohalikku arvutisse.
3. Proovige esmalt lihtsalt tühistada modifikatsiooni muudatus, mis vea põhjustas. Kui lisasite just modifikatsiooni, eemaldage see nii Mods= kui ka WorkshopItems= ridadelt .ini failis. Kui eemaldasite just modifikatsiooni, lisage see tagasi. Käivitage server ja vaadake, kas kokkujooksmine on lahendatud.
4. Kui modifikatsiooni muudatuse tühistamine ei toimi, ühenduge SFTP kaudu ja navigeerige kausta /.cache/saves/multiplayer/<YourWorldName>/.
5. Kustutage WorldDictionary.bin.
6. Käivitage server. Project Zomboid genereerib sõnastiku käivitamisel uuesti.
7. Liituge serveriga ja kontrollige maailma riknenud esemete, puuduvate sõidukite või katkiste inventaride osas. Kui maailm on tõsiselt kahjustatud, taastage 2. sammus loodud varukoopia.

3. Authentic Z modifikatsiooni konfliktid

Authentic Z on üks populaarsemaid Project Zomboid modifikatsioonide kogumikke, kuid see on sagedane tugiteenuse piletite allikas, kuna sisaldab mitmeid alammodifikatsioone, mis on omavahel vastuolus.

Reegel

Levinud vead

• Nii Authentic Z - Current kui ka Authentic Z - Litemode lisamine samal ajal.
• Üksik-mängija jaoks mõeldud Authentic Z alammodifikatsioonide lisamine koos mitmemängija versiooniga.
• Mitte teadmine, et erinevatel Authentic Z alammodifikatsioonidel on sama Workshop ID, kuid erinevad Mod ID-d, mistõttu Workshop allalaadimine õnnestub, kuid server laadib vastuolulised modifikatsioonifailid.

Kuidas parandada

1. Avage /.cache/server/<servername>.ini GPanel failihalduris.
2. Otsige Mods= realt kõiki kirjeid, mis sisaldavad Authentic või AuthenticZ.
3. Jätke alles ainult üks Authentic Z alammodifikatsioon (soovitatav: Authentic Z - Current). Eemaldage kõik muud Authentic Z kirjed nii Mods= kui ka WorkshopItems= ridadelt.
4. Salvestage fail ja taaskäivitage server.

4. Linux tõstutundlikkuse probleemid

Legion Hosting serverid töötavad Linux-il, kus failide ja kaustade nimed on tõstutundlikud. Fail nimega MyMod.lua ja mymod.lua on kaks täiesti erinevat faili. See põhjustab probleeme, kui modifikatsioonide autorid arendavad Windows-il (tõstutundetu) ja nende modifikatsioonid sisaldavad mittevastavaid failiviiteid.

Sümptomid

• Modifikatsioon töötab ideaalselt üksik-mängija režiimis teie Windows arvutis, kuid ebaõnnestub serveris.
• Konsool või debug.log näitab FileNotFoundException või can't find file vigu, mis viitavad Lua skriptile või tekstuurile modifikatsioonis.
• Viga viitab failile, mis modifikatsiooni kaustas on olemas, kuid erineva suurtähtede kasutusega (nt kood viitab failile Items.txt, kuid tegelik failinimi on items.txt).

Kuidas diagnoosida

1. Kontrollige konsoolist või /.cache/Logs/ logifailidest veateates mainitud täpset failiteed.
2. Ühenduge SFTP kaudu ja navigeerige modifikatsiooni kausta aadressil /steamapps/workshop/content/108600/<WorkshopID>/.
3. Võrrelge kettal olevaid failinimesid veateates viidatud failinimega. Otsige suurtähtede erinevusi.

Kuidas parandada

• Kui saate faili ümber nimetada: ühenduge SFTP kaudu ja nimetage fail ümber, et see vastaks modifikatsiooni koodi poolt oodatavale suurtähtede kasutusele. Pange tähele, et see parandus kirjutatakse üle, kui modifikatsioon Steam Workshop-is uueneb.
• Kui probleem on modifikatsioonis endas: teatage veast modifikatsiooni autorile Steam Workshop lehel. Mainige, et failiviitel on tõstuviga ja see ebaõnnestub Linux serveritel. Paljud modifikatsioonide autorid pole Linux tõstutundlikkusest teadlikud.
• Ajutise lahendusena: kontrollige modifikatsiooni Workshop lehe kommentaare — teised Linux serverioperaatorid võivad olla postitanud paranduse või ühilduva modifikatsiooni haru.

5. Modifikatsioonide laadimise järjekorra probleemid

Project Zomboid laadib modifikatsioone selles järjekorras, nagu need ilmuvad Mods= real. Mõned modifikatsioonid sõltuvad sellest, et teised modifikatsioonid laaditakse enne. Kui sõltuvus laaditakse pärast modifikatsiooni, mis seda vajab, võib sõltuv modifikatsioon vaikselt ebaõnnestuda või põhjustada vigu.

Sümptomid

• Modifikatsiooni funktsioonid töötavad osaliselt — mõned modifikatsiooni esemed või süsteemid on olemas, kuid teised puuduvad.
• Konsool näitab NullPointerException või attempt to index a nil value vigu, mis viitavad modifikatsiooni Lua skriptidele.
• Vead ilmnevad ainult siis, kui konkreetne modifikatsioonide kombinatsioon on paigaldatud, kuid iga modifikatsioon töötab eraldi hästi.

Kuidas parandada

1. Kontrollige iga modifikatsiooni Steam Workshop lehelt "Required Mods" või "Load Order" sektsiooni. Paljud modifikatsioonide autorid täpsustavad, millised modifikatsioonid peavad olema nende omast enne laaditud.
2. Avage /.cache/server/<servername>.ini ja leidke Mods= rida.
3. Järjestage kirjed ümber nii, et sõltuvusmodifikatsioonid ilmuvad enne modifikatsioone, mis neid vajavad. Näiteks kui Mod B vajab Mod A-d, peaks rida olema Mods=\ModA;\ModB; (B42 vorming).
4. Raamistiku ja teegi modifikatsioonid (nagu ModFramework, TsarLib või Shark's Mod Utils) peaksid alati olema Mods= real esimesena.
5. Salvestage fail ja taaskäivitage server.

6. Server jookseb pärast modifikatsioonide lisamist kokku

Kui teie server töötas hästi ja jookseb pärast ühe või mitme modifikatsiooni lisamist kokku, on tõenäoliselt uus modifikatsioon põhjuseks. See jaotis juhendab probleemse modifikatsiooni tuvastamisel.

Samm-sammuline isoleerimine

1. Peatage server GPanel-is.
2. Avage /.cache/server/<servername>.ini failihalduris.
3. Märkige üles kõik äsja lisatud modifikatsioonid. Eemaldage need kõik nii Mods= kui ka WorkshopItems= ridadelt.
4. Käivitage server. Kui see käivitub edukalt, on probleem ühes eemaldatud modifikatsioonis.
5. Lisage modifikatsioonid tagasi üks korraga, taaskäivitades serveri pärast iga lisamist. Kui kokkujooksmine kordub, on viimati lisatud modifikatsioon põhjuseks.
6. Pärast tuvastamist kontrollige modifikatsiooni Workshop lehelt:
   • Märkust B42 ühilduvuse kohta — paljud B41 modifikatsioonid pole B42 jaoks uuendatud.
   • Teadaolevaid konflikte teiste teie kasutatavate modifikatsioonidega.
   • Nõutavaid sõltuvusmodifikatsioone, mis teil võivad puududa.

Kokkujooksmise logi lugemine

Enne isoleerimisprotsessi alustamist kontrollige kokkujooksmise logi — see viitab sageli otse probleemse modifikatsioonile:

1. GPanel-is avage Console vahekaart ja kerige väljundi lõpuni.
2. Otsige STACK TRACE, Exception või ERROR ridu.
3. Vahetult pinujälje kohal olevad read viitavad tavaliselt modifikatsiooni failinimele või Mod ID-le — see ütleb teile, milline modifikatsioon kokkujooksmise põhjustas.
4. Täpsema teabe saamiseks avage täielik logifail SFTP kaudu aadressil /.cache/Logs/ ja kontrollige viimast DebugLog-server.txt või debug.log faili.

7. Modifikatsiooni versiooni mittevastavused (server vs klient)

Project Zomboid nõuab, et serveril ja kõigil ühendatud klientidel oleks iga modifikatsiooni sama versioon. Kui modifikatsioon uueneb Steam Workshop-is ja server laadib alla uue versiooni, kuid mängijal on endiselt vana versioon vahemälus (või vastupidi), tekivad ühenduse katkemised või kokkujooksmised.

Sümptomid

• Mängijad saavad ühenduse loomisel "Mod mismatch" või "Version mismatch" vea.
• Mõned mängijad saavad ühenduda, kuid teised mitte — need, kes ei saa ühenduda, omavad kohalikult vahemälus teist modifikatsiooni versiooni.
• Server töötas hästi, seejärel modifikatsioon uuenes Steam Workshop-is ja äkki mõned mängijad ei saa liituda.
• Mängijad näevad puuduvaid tekstuure, esemeid või katkiseid kasutajaliidese elemente hiljuti uuendatud modifikatsioonidest.

Lahendus serverioperaatoritele

1. Peatage server GPanel-is.
2. Käivitage server uuesti. Käivitamisel laadib server alla kõigi Workshop modifikatsioonide uusimad versioonid. See tagab, et server kasutab uusimat versiooni.
3. Kui serveril on endiselt vana versioon vahemälus, ühenduge SFTP kaudu ja kustutage konkreetse modifikatsiooni Workshop vahemälu kaust aadressil /steamapps/workshop/content/108600/<WorkshopID>/. Taaskäivitage server, et sundida puhas allalaadimine.

Lahendus mängijatele

Mängijad, kes ei saa modifikatsiooni versiooni mittevastavuse tõttu ühenduda, peaksid:

1. Avama Steam ja navigeerima Library → Project Zomboid.
2. Paremklõpsama Project Zomboid peal, valima Properties → Local Files → Verify Integrity of Game Files.
3. Navigeerima ka oma kohalikus arvutis Project Zomboid Steam Workshop kausta ja kustutama vahemällu salvestatud modifikatsioonifailid, et sundida uut allalaadimist.
4. Käivitama mängu ja ühenduma uuesti serveriga.

8. Steam Workshop vahemälu tühjendamine

Kui mitu modifikatsiooniga seotud probleemi püsivad ja kahtlustate, et Workshop allalaadimise vahemälu on riknenud, saate sundida kõigi Workshop modifikatsioonide täielikku uuesti allalaadimist.

1. Peatage server GPanel-is.
2. Ühenduge SFTP kaudu ja navigeerige kausta /steamapps/workshop/.
3. Kustutage kogu workshop/ kaust (või selle sisu).
4. Käivitage server. Steam laadib kõik Workshop esemed nullist uuesti alla.
5. Jälgige GPanel konsooli, et kinnitada, et kõik modifikatsioonid lõpetavad allalaadimise enne, kui server alustab maailma laadimist.

Kiire diagnostika viide

Kas modifikatsioonide probleemid püsivad?