A Project Zomboid szerverek több jól ismert okból is összeomlhatnak vagy nem indulnak el. Ez az útmutató a Legion Hosting support jegyekben leggyakrabban előforduló okokat tárgyalja — a Build 42 memóriahibájától, amely extra RAM-ot igényel indításkor, a /tmp-t megtöltő biztonsági mentés túlcsordulásig, egészen a sérült konfigurációs fájlokig. Haladjon végig az alábbi szakaszokon sorrendben.

Mielőtt elkezdené — Keresse meg az összeomlási naplókat

Szinte minden Project Zomboid összeomlás nyomot hagy két hely egyikén. Ellenőrizze mindkettőt bármilyen javítás megkísérlése előtt, hogy tudja, melyik szakasz vonatkozik Önre.

GPanel konzol kimenet

1. Jelentkezzen be a GPanel-be.
2. Válassza ki a Project Zomboid szerverét a szerverlistából.
3. Kattintson a Console fülre.
4. Görgessen a kimenet aljára. Keressen ERROR, FATAL, OutOfMemoryError vagy Exception jelölésű sorokat. A szerver leállása előtti utolsó 20–30 sor általában a leglényegesebb.
5. Ha a konzol üres, a szerver folyamat még azelőtt leállt, hogy bármit írhatott volna — ez önmagában is egy nyom (lásd a B42 memória szakaszt alább).

A szerver debug.log fájlja

A Project Zomboid részletes naplót ír a debug.log fájlba a szerver adatkönyvtárában. Ez a fájl gyakran tartalmaz egy teljes Java stack trace-t, amely közvetlenül az összeomlás okára mutat.

1. A GPanel-ben lépjen a File Manager fülre.
2. Navigáljon a /.cache/Logs/ mappába. Olyan fájlokat fog látni, mint a debug.log, DebugLog-server.txt, vagy dátumozott naplófájlok.
3. Nyissa meg a legfrissebb naplófájlt. Használja a Ctrl+End billentyűkombinációt, vagy görgessen a legaljára, és onnan felfelé olvasson.
4. Keresse az OutOfMemoryError, IOException, NullPointerException vagy SandboxVars kulcsszavakat. Másolja ki a releváns sorokat — szüksége lesz rájuk, ha support jegyet nyit.

1. javítás — Build 42 magas memóriahasználat indításkor (ismert játékhiba)

Ha a szerver azonnal kilép indításkor hiba nélkül a konzolon, vagy a konzol OutOfMemoryError vagy Java heap space hibát mutat, a szerver elfogy a memóriából, mielőtt a világ betöltése befejeződne.

Tünetek

• A szerver elindul, a konzol néhány másodpercig görget, majd leáll játékos oldali hibaüzenet nélkül.
• A konzol java.lang.OutOfMemoryError: Java heap space vagy GC overhead limit exceeded üzenetet mutat.
• A szerver néhány újraindításnál működik, másoknál nem (a memória elérhetősége változó).
• A szerver jól működött B41-en, de a B42-re való frissítés után folyamatosan összeomlik.

Lépések

1. A GPanel-ben kattintson a szerverére, és lépjen a Console fülre. Jegyezze fel a szerver jelenlegi RAM-kiosztását, amely az erőforrás sávban vagy a szerver információs panelen látható.
2. Ha a csomagja kevesebb mint 10 GB RAM-ot tartalmaz, a szerver összeomolhat indításkor, mivel a B42 körülbelül 9 GB-ot igényel az inicializáláshoz. Frissítenie kell a csomagját, vagy meg kell várnia, amíg az Indie Stone kiad egy javítást.
3. Ha a csomagja már 10 GB vagy több, és a szerver továbbra is összeomlik indításkor, lépjen a Startup fülre a GPanel-ben.
4. Keressen egy Java Memory, Max RAM vagy Xmx feliratú mezőt. Győződjön meg arról, hogy a teljes rendelkezésre álló RAM 80–85%-ánál nem többre van beállítva. Például egy 12 GB-os csomagnál állítsa 10240-re (10 GB megabájtban). Ne állítsa a teljes RAM-mal megegyezőre vagy afölé — az operációs rendszernek és más folyamatoknak is szükségük van memóriára.
5. Kattintson a Save gombra a Startup fülön, majd indítsa újra a szervert.
6. Figyelje a konzolt indítás közben. Ha a szerver eléri a SERVER STARTED sort, vagy a LuaManager: Loading lua files... összeomlás nélkül befejeződik, a memóriakiosztás most már elegendő.

2. javítás — BackupsOnStart túlcsordulás a /tmp-ben (indítási összeomlás)

A Project Zomboid beállítható úgy, hogy minden szerver indításakor teljes világ biztonsági mentést készítsen. Amikor ez a mentés a /tmp-be íródik — amely a legtöbb Linux gazdagépen méretben korlátozott — a szerver az indítás közben lemezírási hibával összeomlik, amint a /tmp megtelik.

Tünetek

• A szerver megbízhatóan összeomlik minden újraindításnál, de korábban működött.
• A konzol vagy a debug.log olyan hibákat tartalmaz, mint IOException: No space left on device, vagy a /tmp/-be való írást említi.
• Az összeomlások idővel súlyosbodnak, ahogy a világ mentés mérete nő.
• A szerver néha elindul, ha röviddel a gazdagép tiszta újraindítása után próbálkozik (mielőtt a /tmp újra megtelne).

Lépések — BackupsOnStart letiltása

1. A GPanel-ben lépjen a File Manager fülre.
2. Navigáljon a /.cache/server/ mappába. Keresse meg a szerver konfigurációs fájlját — ez általában servertest.ini vagy a szerver neve, amelyet .ini követ (pl. MyServer.ini).
3. Nyissa meg az .ini fájlt szerkesztésre.
4. Használja a böngésző keresés funkcióját (Ctrl+F) a BackupsOnStart kereséséhez.
5. Módosítsa az értéket true-ról false-ra:

   BackupsOnStart=false

6. Amíg a fájlban van, ellenőrizze a BackupsOnVersionChange beállítást is, és állítsa false-ra, ha a lemezterület problémát jelent:

   BackupsOnVersionChange=false

7. Mentse el a fájlt és indítsa újra a szervert. Figyelje a konzolt, hogy a szerver elérje a SERVER STARTED sort.

3. javítás — Sérült SandboxVars.lua vagy szerver konfiguráció

A Project Zomboid a világ beállításait egy SandboxVars.lua nevű Lua fájlban tárolja. Ha ezt a fájlt kézzel szerkesztik és szintaktikai hibával mentik, vagy ha egy fájlátvitel megszakadt, a szerver azonnal összeomlik indításkor, amikor megpróbálja feldolgozni a fájlt.

Tünetek

• A konzol ERROR: SandboxVars, LuaManager error vagy Lua elemzési hibát mutat sorszámmal.
• Az összeomlás közvetlenül azután kezdődött, hogy szerkesztette a beállításokat az .ini fájlban vagy közvetlenül a SandboxVars.lua-ban.
• A szerver Bad argument #1 to vagy hasonló Lua futásidejű hibákat mutathat.

Lépések — SandboxVars.lua ellenőrzése és javítása

1. A GPanel-ben lépjen a File Manager-be és navigáljon a /.cache/saves/multiplayer/<YourServerName>/ mappába.
2. Nyissa meg a SandboxVars.lua fájlt szerkesztésre.
3. Ellenőrizze, hogy a fájl VERSION = 1, (vagy hasonló) sorral kezdődik egy SandboxVars = { blokkon belül, és záró }-vel végződik. Bármilyen hiányzó vessző, lezáratlan kapcsos zárójel vagy elszórt karakter elemzési hibát okoz.
4. Ha nem tudja azonosítani a hibát, a legbiztonságosabb javítás a SandboxVars.lua teljes törlése. A szerver alapértelmezett értékekkel újragenerálja a következő indításkor. Megjegyzés: ez visszaállítja a sandbox beállításait (zsákmány, zombi szám stb.) az alapértékekre — a térkép adatait és játékos adatait ez nem érinti.
5. Ellenőrizze az .ini fájlt is a /.cache/server/ mappában hasonló problémák miatt, ha nemrég kézzel szerkesztette. Győződjön meg arról, hogy minden sor a Key=Value formátumot követi, üres sorok nélkül egy értéken belül.
6. Mentse a módosításokat és indítsa újra a szervert.

4. javítás — Üres admin jelszó által okozott összeomlás

A Project Zomboid nem üres admin jelszót igényel egy multiplayer szerver indításához. Ha a jelszó mező üres, a szerver folyamat azonnal kilép az admin fiók inicializálási kísérlete után.

Tünetek

• Vadonatúj szerver vagy nemrég visszaállított szerver minden indítási kísérletnél meghiúsul.
• A konzol kimenet nagyon rövid — a szerver néhány inicializálási sort ír ki, majd leáll.
• A debug.log tartalmazhat hivatkozást az admin fiókra vagy jelszó érvényesítésre.

Lépések

1. A GPanel-ben kattintson a szerverére, és lépjen a Startup fülre.
2. Keressen egy Admin Password vagy RCON Password feliratú mezőt. Győződjön meg arról, hogy tartalmaz értéket — nem lehet üres.
3. Ha a mező üres, adjon meg egy jelszót. Használjon legalább 8 karaktert. Kerülje a speciális karaktereket, mint a !, #, $ vagy @ az admin jelszóban, mivel egyes PZ verziók nem tudják helyesen feldolgozni ezeket az indítási argumentumokban.
4. Kattintson a Save gombra és indítsa újra a szervert.
5. Másodlagos ellenőrzésként nyissa meg az .ini fájlt a /.cache/server/ mappában, és győződjön meg arról, hogy az AdminPassword= sornak van értéke az egyenlőségjel után.

5. javítás — Világ visszaállítása (végső megoldás tartós összeomlásokhoz)

Ha egy világ mentés megsérül — például egy kemény szerver összeomlás, sikertelen frissítés vagy fájlrendszer hibák után — a mentés adatok helyreállíthatatlanok lehetnek. Ebben az esetben a világ törlése és újrakezdés az egyetlen lehetőség.

Lépések

1. Állítsa le a szervert a GPanel-ben, mielőtt bármilyen módosítást végezne a mentés fájlokon. Futó szerveren a fájlok szerkesztése további sérülést okozhat.
2. A GPanel-ben lépjen a File Manager fülre.
3. Navigáljon a /.cache/saves/multiplayer/ mappába.
4. Egy vagy több mappát fog látni a szerver nevével (pl. servertest). Törlés előtt opcionálisan töltse le a mappát biztonsági mentésként a kiválasztás és a letöltés opció használatával — még egy sérült mentés is részben helyreállítható lehet később.
5. Törölje a szerver nevének megfelelő mappát a Multiplayer/ mappán belül. Ne törölje magát a Multiplayer mappát.
6. Navigáljon a /.cache/db/ mappába is, és törölje a <YourServerName>.db fájlt. Ez az adatbázis játékos statisztikákat tartalmaz, és hivatkozhat a régi világra — az újragenerálás elkerüli az eltéréseket.
7. Indítsa el a szervert. Egy friss világot fog generálni az .ini fájlban lévő beállítások alapján.

Gyors diagnosztikai referencia

Még mindig összeomlik az összes lépés után?