Ez az útmutató a Project Zomboid szerverek haladó mod hibaelhárítását ismerteti a Legion Hosting szolgáltatásban. Ha még nem telepítettél modokat, kezdd az alapvető mod telepítési útmutatóval. Ez a cikk a Legion Hosting támogatási jegyekben leggyakrabban előforduló mod-problémákat tárgyalja, beleértve a WorldDictionary sérülést, mod formátumhibákat, betöltési sorrend ütközéseket, valamint a szerver és kliens közötti verzióeltéréseket.

Mielőtt elkezdenéd

• Jelentkezz be a GPanel-be és válaszd ki a Project Zomboid szerveredet.
• Állítsd le a szerveredet mielőtt bármilyen konfigurációs vagy fájlmódosítást végeznél.
• Készíts biztonsági mentést a világ mentési mappájáról (/.cache/saves/multiplayer/) SFTP-n vagy GPanel-en keresztül, mielőtt bármilyen javítást megkísérelnél. Lásd az SFTP útmutatót, ha nem ismered a fájlátvitelt.
• Legyen kéznél a szervered .ini fájljának elérési útja: /.cache/server/<servername>.ini (pl. servertest.ini).

1. Mod formátumhibák (B42 vs B41)

A modok betöltési hibáinak leggyakoribb oka a helytelen formátum a szervered .ini fájljának Mods= sorában. A Build 42 és Build 41 eltérő szintaxist használ, és ezek keveredése esetén a modok csendben nem töltődnek be.

B42 formátum (jelenlegi alapértelmezett)

A Build 42 megköveteli a fordított perjel előtagot minden Mod ID előtt a Mods= sorban:

Mods=\ModID1;\ModID2;\ModID3;

A DLMP formátum a Workshop ID-kat és Mod ID-kat fordított perjel elválasztóval kombinálja:

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

A WorkshopItems= sor mindkét buildnél ugyanazt a pontosvesszővel elválasztott formátumot használja:

WorkshopItems=2392987841;1550458773;2786383654

B41 formátum (régi)

A Build 41 egyszerű, pontosvesszővel elválasztott Mod ID-kat használ fordított perjel nélkül:

Mods=ModID1;ModID2;ModID3

Javítás módja

1. Nyisd meg a /.cache/server/<servername>.ini fájlt a GPanel Fájlkezelőben.
2. Keresd meg a Mods= sort és ellenőrizd a formátumot a fenti példák alapján.
3. Ha a formátum nem megfelelő a build verziódhoz, javítsd ki. Használd a Legion Hosting Mod Organizer-t a helyesen formázott sorok automatikus generálásához.
4. Mentsd el a fájlt és indítsd el a szervert.

2. WorldDictionary sérülés

A WorldDictionary egy fájl (WorldDictionary.bin), amely az elemneveket belső numerikus azonosítókhoz rendeli. Modok hozzáadásakor vagy eltávolításakor a szótár megsérülhet, ami a szerver indításkori összeomlását okozza WorldDictionaryException hibával.

Tünetek

• A konzolon vagy a debug.log-ban WorldDictionaryException vagy WorldDictionary hibák jelennek meg.
• A szerver azonnal összeomlik indításkor, kifejezetten a világ betöltése közben.
• Az összeomlás modok hozzáadása, eltávolítása vagy frissítése után kezdődött.

A kockázat megértése

Helyreállítási lépések

1. Állítsd le a szervert a GPanel-ben.
2. Készíts biztonsági mentést a teljes mentési mappáról SFTP-n keresztül: töltsd le a teljes /.cache/saves/multiplayer/<YourWorldName>/ könyvtárat a helyi gépedre.
3. Először próbáld meg egyszerűen visszavonni a hibát okozó mod változtatást. Ha épp hozzáadtál egy modot, távolítsd el mind a Mods=, mind a WorkshopItems= sorból az .ini fájlban. Ha épp eltávolítottál egy modot, add vissza. Indítsd el a szervert és nézd meg, hogy az összeomlás megoldódott-e.
4. Ha a mod változtatás visszavonása nem működik, csatlakozz SFTP-n és navigálj a /.cache/saves/multiplayer/<YourWorldName>/ mappába.
5. Töröld a WorldDictionary.bin fájlt.
6. Indítsd el a szervert. A Project Zomboid újragenerálja a szótárat indításkor.
7. Csatlakozz a szerverre és vizsgáld meg a világot sérült elemek, hiányzó járművek vagy hibás leltárak szempontjából. Ha a világ súlyosan sérült, állítsd vissza a 2. lépésben készített biztonsági mentésből.

3. Authentic Z mod ütközések

Az Authentic Z az egyik legnépszerűbb Project Zomboid mod gyűjtemény, de gyakori támogatási jegyek forrása, mert több egymással ütköző al-modot tartalmaz.

A szabály

Gyakori hibák

• Az Authentic Z - Current és az Authentic Z - Litemode egyidejű hozzáadása.
• Egyjátékos módra tervezett Authentic Z al-modok hozzáadása a többjátékos verzió mellé.
• Nem tudni, hogy a különböző Authentic Z al-modok ugyanazt a Workshop ID-t használják, de eltérő Mod ID-kkal rendelkeznek, így a Workshop letöltés sikeres, de a szerver ütköző mod fájlokat tölt be.

Javítás módja

1. Nyisd meg a /.cache/server/<servername>.ini fájlt a GPanel Fájlkezelőben.
2. Keresd a Mods= sorban az összes Authentic vagy AuthenticZ bejegyzést.
3. Tartsd meg csak egy Authentic Z al-modot (ajánlott: Authentic Z - Current). Távolítsd el az összes többi Authentic Z bejegyzést mind a Mods=, mind a WorkshopItems= sorokból.
4. Mentsd el a fájlt és indítsd újra a szervert.

4. Linux kis- és nagybetű érzékenységi problémák

A Legion Hosting szerverei Linux-on futnak, ahol a fájl- és mappanevek kis- és nagybetű érzékenyek. A MyMod.lua és a mymod.lua nevű fájlok két teljesen különböző fájlnak számítanak. Ez problémákat okoz, amikor a mod készítők Windows-on (nem kis- és nagybetű érzékeny) fejlesztenek, és modjaik eltérő fájlhivatkozásokat tartalmaznak.

Tünetek

• Egy mod tökéletesen működik egyjátékos módban a Windows PC-den, de a szerveren nem.
• A konzolon vagy a debug.log-ban FileNotFoundException vagy can't find file hibák jelennek meg, amelyek egy modon belüli Lua szkriptre vagy textúrára hivatkoznak.
• A hiba olyan fájlra mutat, amely létezik a mod mappájában, de eltérő nagybetűzéssel (pl. a kód Items.txt-re hivatkozik, de a tényleges fájlnév items.txt).

Diagnosztizálás módja

1. Ellenőrizd a konzolt vagy a /.cache/Logs/ naplófájlokat a hibában említett pontos fájl elérési útért.
2. Csatlakozz SFTP-n és navigálj a mod mappájához: /steamapps/workshop/content/108600/<WorkshopID>/.
3. Hasonlítsd össze a lemezen lévő fájlneveket a hibaüzenetben hivatkozott fájlnévvel. Figyelj a nagybetűzési különbségekre.

Javítás módja

• Ha át tudod nevezni a fájlt: Csatlakozz SFTP-n és nevezd át a fájlt, hogy megfeleljen a mod kódjában elvárt nagybetűzésnek. Figyelem: ez a javítás felülíródik, ha a mod frissül a Steam Workshop-on.
• Ha a probléma magában a modban van: Jelentsd a hibát a mod készítőjének a Steam Workshop oldalon. Említsd meg, hogy a fájlhivatkozásban nagybetűzési eltérés van, és hogy Linux szervereken nem működik. Sok mod készítő nem tudja, hogy a Linux kis- és nagybetű érzékeny.
• Megkerülő megoldásként: Nézd meg a mod Workshop oldal hozzászólásait — más Linux szerver üzemeltetők posztolhattak javítást vagy a mod kompatibilis változatát.

5. Mod betöltési sorrend problémák

A Project Zomboid a modokat a Mods= sorban megjelenő sorrendben tölti be. Egyes modok megkövetelik, hogy más modok előttük legyenek betöltve. Ha egy függőség a rá épülő mod után töltődik be, a függő mod csendben hibázhat vagy hibákat okozhat.

Tünetek

• A mod funkciók részlegesen működnek — egy mod egyes elemei vagy rendszerei jelen vannak, mások hiányoznak.
• A konzolon NullPointerException vagy attempt to index a nil value hibák jelennek meg, amelyek egy mod Lua szkriptjeire hivatkoznak.
• A hibák csak modok meghatározott kombinációja esetén jelennek meg, de minden mod külön-külön jól működik.

Javítás módja

1. Ellenőrizd minden mod Steam Workshop oldalán a "Required Mods" vagy "Load Order" részt. Sok mod készítő megadja, mely modokat kell előbb betölteni.
2. Nyisd meg a /.cache/server/<servername>.ini fájlt és keresd meg a Mods= sort.
3. Rendezd át a bejegyzéseket úgy, hogy a függőségi modok az őket igénylő modok előtt szerepeljenek. Például, ha a B mod függ az A modtól, a sornak így kell kinéznie: Mods=\ModA;\ModB; (B42 formátum).
4. A keretrendszer és könyvtár modokat (mint például ModFramework, TsarLib vagy Shark's Mod Utils) mindig elsőként kell felsorolni a Mods= sorban.
5. Mentsd el a fájlt és indítsd újra a szervert.

6. Szerver összeomlás modok hozzáadása után

Ha a szervered eddig rendben működött és modok hozzáadása után omlik össze, az új mod valószínűleg az oka. Ez a rész végigvezet a problémás mod azonosításán.

Lépésről lépésre történő elkülönítés

1. Állítsd le a szervert a GPanel-ben.
2. Nyisd meg a /.cache/server/<servername>.ini fájlt a Fájlkezelőben.
3. Jegyezd fel az összes újonnan hozzáadott modot. Távolítsd el mindet a Mods= és WorkshopItems= sorokból egyaránt.
4. Indítsd el a szervert. Ha sikeresen elindul, a probléma valamelyik eltávolított modban van.
5. Add vissza a modokat egyenként, minden hozzáadás után újraindítva a szervert. Amikor az összeomlás visszatér, az utoljára hozzáadott mod az oka.
6. Az azonosítás után ellenőrizd a mod Workshop oldalát:
   • B42 kompatibilitási megjegyzés — sok B41 mod nem lett frissítve B42-re.
   • Ismert ütközések más futtatott modokkal.
   • Szükséges függőségi modok, amelyeket esetleg nem telepítettél.

Az összeomlási napló olvasása

Az elkülönítési folyamat előtt ellenőrizd az összeomlási naplót — gyakran közvetlenül a problémás modra mutat:

1. A GPanel-ben nyisd meg a Console fület és görgess a kimenet végére.
2. Keress STACK TRACE, Exception vagy ERROR sorokat.
3. A stack trace fölötti sorok általában egy mod fájlnévre vagy Mod ID-ra hivatkoznak — ez megmutatja, melyik mod okozta az összeomlást.
4. Részletesebb információért nyisd meg a teljes naplófájlt SFTP-n a /.cache/Logs/ mappában és ellenőrizd a legfrissebb DebugLog-server.txt vagy debug.log fájlt.

7. Mod verzióeltérések (szerver vs kliens)

A Project Zomboid megköveteli, hogy a szerver és az összes csatlakozott kliens minden mod azonos verziójával rendelkezzen. Ha egy mod frissül a Steam Workshop-on és a szerver letölti az új verziót, de egy játékosnál még a régi verzió van gyorsítótárazva (vagy fordítva), csatlakozási hibák vagy összeomlások lépnek fel.

Tünetek

• A játékosok "Mod mismatch" vagy "Version mismatch" hibát kapnak csatlakozáskor.
• Egyes játékosok tudnak csatlakozni, mások nem — azok nem tudnak, akiknél más mod verzió van helyben gyorsítótárazva.
• A szerver jól működött, majd egy mod frissült a Steam Workshop-on és hirtelen egyes játékosok nem tudnak csatlakozni.
• A játékosok hiányzó textúrákat, elemeket vagy hibás felületi elemeket látnak a nemrég frissített modoknál.

Javítás szerver üzemeltetők számára

1. Állítsd le a szervert a GPanel-ben.
2. Indítsd el újra a szervert. Indításkor a szerver újra letölti az összes Workshop mod legfrissebb verzióját. Ez biztosítja, hogy a szerver a legújabb verziókat futtassa.
3. Ha a szerveren még mindig régi verzió van gyorsítótárazva, csatlakozz SFTP-n és töröld az adott mod Workshop gyorsítótár mappáját: /steamapps/workshop/content/108600/<WorkshopID>/. Indítsd újra a szervert a tiszta letöltés kikényszerítéséhez.

Javítás játékosok számára

A mod verzióeltérés miatt csatlakozni nem tudó játékosoknak:

1. Nyisd meg a Steam-et és navigálj a Library → Project Zomboid részhez.
2. Kattints jobb gombbal a Project Zomboid-ra, válaszd a Properties → Local Files → Verify Integrity of Game Files lehetőséget.
3. Navigálj a helyi gépen a Project Zomboid Steam Workshop mappájába és töröld a gyorsítótárazott mod fájlokat az újbóli letöltés kikényszerítéséhez.
4. Indítsd el a játékot és csatlakozz újra a szerverhez.

8. A Steam Workshop gyorsítótár törlése

Ha több mod probléma is fennáll és a Workshop letöltési gyorsítótár sérülését gyanítod, kikényszerítheted az összes Workshop mod teljes újratöltését.

1. Állítsd le a szervert a GPanel-ben.
2. Csatlakozz SFTP-n és navigálj a /steamapps/workshop/ mappába.
3. Töröld a teljes workshop/ mappát (vagy a tartalmát).
4. Indítsd el a szervert. A Steam az összes Workshop elemet a semmiből tölti le újra.
5. Figyeld a GPanel Console-t, hogy az összes mod letöltése befejeződjön, mielőtt a szerver megkezdi a világ betöltését.

Gyors diagnosztikai referencia

Továbbra is mod problémáid vannak?