Servery Project Zomboid mohou padat nebo se nespustit z několika dobře známých důvodů. Tento průvodce pokrývá nejčastější příčiny zaznamenané v tiketech podpory Legion Hosting — od chyby s pamětí v Build 42, která vyžaduje extra RAM při spuštění, přes přetečení záloh, které zaplní /tmp, až po poškozené konfigurační soubory. Projděte si níže uvedené sekce postupně.

Než začnete — Najděte logy pádů

Téměř každý pád Project Zomboid zanechá stopy na jednom ze dvou míst. Zkontrolujte obě, než se pokusíte o jakoukoliv opravu, abyste věděli, která sekce tohoto průvodce se vás týká.

Výstup konzole GPanel

1. Přihlaste se do GPanel.
2. Vyberte svůj server Project Zomboid ze seznamu serverů.
3. Klikněte na záložku Console.
4. Přejděte na konec výstupu. Hledejte řádky označené ERROR, FATAL, OutOfMemoryError nebo Exception. Posledních 20–30 řádků před zastavením serveru je obvykle nejrelevantnějších.
5. Pokud je konzole prázdná, proces serveru se ukončil dříve, než stihl cokoliv zapsat — to samo o sobě je vodítko (viz sekce o paměti B42 níže).

Soubor debug.log serveru

Project Zomboid zapisuje podrobný log do souboru debug.log v datovém adresáři serveru. Tento soubor často obsahuje kompletní Java stack trace, který přímo ukazuje na příčinu pádu.

1. V GPanel přejděte na záložku File Manager.
2. Přejděte do /.cache/Logs/. Uvidíte soubory s názvy jako debug.log, DebugLog-server.txt nebo datované soubory logů.
3. Otevřete nejnovější soubor logu. Použijte Ctrl+End nebo přejděte úplně na konec a čtěte odtud směrem nahoru.
4. Hledejte klíčová slova OutOfMemoryError, IOException, NullPointerException nebo SandboxVars. Zkopírujte příslušné řádky — budete je potřebovat, pokud otevřete tiket podpory.

Oprava 1 — Vysoké využití paměti Build 42 při spuštění (známá chyba hry)

Pokud se váš server okamžitě ukončí při spuštění bez chyby v konzoli, nebo konzole zobrazí OutOfMemoryError nebo chybu Java heap space, serveru dochází paměť dříve, než se svět stihne načíst.

Příznaky

• Server se spustí, konzole se posouvá několik sekund a pak se zastaví bez chybové zprávy pro hráče.
• Konzole zobrazuje java.lang.OutOfMemoryError: Java heap space nebo GC overhead limit exceeded.
• Server funguje při některých restartech, ale při jiných ne (dostupnost paměti se liší).
• Server fungoval na B41, ale po upgradu na B42 konzistentně padá.

Kroky

1. V GPanel klikněte na svůj server a přejděte na záložku Console. Poznamenejte si aktuální přidělení RAM vašeho serveru zobrazené v panelu zdrojů nebo informačním panelu serveru.
2. Pokud váš plán zahrnuje méně než 10 GB RAM, server může při spuštění padat, protože B42 vyžaduje přibližně 9 GB k inicializaci. Budete muset upgradovat svůj plán nebo počkat, až Indie Stone vydají opravu.
3. Pokud váš plán již má 10 GB nebo více a server stále padá při spuštění, přejděte na záložku Startup v GPanel.
4. Hledejte pole označené Java Memory, Max RAM nebo Xmx. Potvrďte, že je nastaveno na maximálně 80–85 % vaší celkové dostupné RAM. Například u plánu s 12 GB nastavte tuto hodnotu na 10240 (10 GB v megabajtech). Nenastavujte ji na stejnou nebo vyšší hodnotu, než je vaše celková RAM — operační systém a další procesy také potřebují paměť.
5. Klikněte na Save na záložce Startup a poté restartujte server.
6. Sledujte konzoli během spouštění. Pokud server dosáhne řádku SERVER STARTED nebo se LuaManager: Loading lua files... dokončí bez pádu, přidělení paměti je nyní dostatečné.

Oprava 2 — BackupsOnStart přeplňuje /tmp (pád při spuštění)

Project Zomboid lze nakonfigurovat tak, aby vytvářel kompletní zálohu světa při každém spuštění serveru. Když se tato záloha zapisuje do /tmp — který má na většině Linux hostů omezenou velikost — server spadne uprostřed spouštění s chybou zápisu na disk, jakmile se /tmp zaplní.

Příznaky

• Server spolehlivě padá při každém restartu, ale dříve fungoval.
• Konzole nebo debug.log obsahuje chyby jako IOException: No space left on device nebo zmínky o zápisu do /tmp/.
• Pády se časem zhoršují, jak roste velikost uloženého světa.
• Server se někdy spustí, pokud to zkusíte krátce po čistém restartu hostitelského uzlu (než se /tmp znovu zaplní).

Kroky — Zakázání BackupsOnStart

1. V GPanel přejděte na záložku File Manager.
2. Přejděte do /.cache/server/. Najděte konfigurační soubor vašeho serveru — obvykle se jmenuje servertest.ini nebo podle názvu vašeho serveru s příponou .ini (např. MyServer.ini).
3. Otevřete soubor .ini pro úpravy.
4. Použijte funkci vyhledávání vašeho prohlížeče (Ctrl+F) a vyhledejte BackupsOnStart.
5. Změňte hodnotu z true na false:

   BackupsOnStart=false

6. Když jste v souboru, zkontrolujte také nastavení BackupsOnVersionChange a nastavte ho na false, pokud je místo na disku problém:

   BackupsOnVersionChange=false

7. Uložte soubor a restartujte server. Sledujte konzoli, abyste potvrdili, že server dosáhne řádku SERVER STARTED.

Oprava 3 — Poškozený SandboxVars.lua nebo konfigurace serveru

Project Zomboid ukládá nastavení světa v Lua souboru nazvaném SandboxVars.lua. Pokud je tento soubor ručně upraven a uložen se syntaktickou chybou, nebo pokud byl přenos souboru přerušen, server spadne okamžitě při spuštění, když se pokusí soubor zpracovat.

Příznaky

• Konzole zobrazuje ERROR: SandboxVars, LuaManager error nebo chybu parsování Lua s číslem řádku.
• Pád začal ihned poté, co jste upravili nastavení v souboru .ini nebo SandboxVars.lua přímo.
• Server může zobrazit Bad argument #1 to nebo podobné runtime chyby Lua.

Kroky — Kontrola a oprava SandboxVars.lua

1. V GPanel přejděte na File Manager a přejděte do /.cache/saves/multiplayer/<YourServerName>/.
2. Otevřete SandboxVars.lua pro úpravy.
3. Zkontrolujte, že soubor začíná VERSION = 1, (nebo podobně) uvnitř bloku SandboxVars = { a končí uzavírací }. Jakákoliv chybějící čárka, neuzavřená závorka nebo zbloudilý znak způsobí chybu parsování.
4. Pokud nemůžete identifikovat chybu, nejbezpečnější opravou je smazat SandboxVars.lua celý. Server jej při dalším spuštění vygeneruje znovu s výchozími hodnotami. Poznámka: tím se vaše nastavení sandboxu (loot, počet zombie atd.) resetují na výchozí — vaše data mapy a data hráčů nejsou ovlivněna.
5. Zkontrolujte také soubor .ini v /.cache/server/ pro podobné problémy, pokud jste jej nedávno ručně upravovali. Ujistěte se, že každý řádek dodržuje formát Key=Value bez prázdných řádků uvnitř hodnoty.
6. Uložte změny a restartujte server.

Oprava 4 — Prázdné heslo administrátora způsobující pád

Project Zomboid vyžaduje neprázdné heslo administrátora pro spuštění multiplayerového serveru. Pokud je pole hesla prázdné, proces serveru se okamžitě ukončí po pokusu o inicializaci administrátorského účtu.

Příznaky

• Zcela nový server nebo nedávno resetovaný server selže při každém pokusu o spuštění.
• Výstup konzole je velmi krátký — server vypíše několik inicializačních řádků a poté se zastaví.
• debug.log může obsahovat odkaz na administrátorský účet nebo ověření hesla.

Kroky

1. V GPanel klikněte na svůj server a přejděte na záložku Startup.
2. Hledejte pole označené Admin Password nebo RCON Password. Potvrďte, že obsahuje hodnotu — nesmí být prázdné.
3. Pokud je pole prázdné, zadejte heslo. Použijte alespoň 8 znaků. Vyhněte se speciálním znakům jako !, #, $ nebo @ v hesle administrátora, protože některé verze PZ je nedokážou správně zpracovat v parametrech spuštění.
4. Klikněte na Save a restartujte server.
5. Jako sekundární kontrolu otevřete soubor .ini v /.cache/server/ a potvrďte, že řádek AdminPassword= má za rovnítkem hodnotu.

Oprava 5 — Reset světa (poslední možnost při přetrvávajících pádech)

Pokud se uložená data světa poškodí — například po tvrdém pádu serveru, neúspěšné aktualizaci nebo chybách souborového systému — uložená data mohou být neobnovitelná. V takovém případě je jedinou možností smazání světa a začátek od nuly.

Kroky

1. Zastavte server v GPanel před prováděním jakýchkoliv změn v souborech uložených dat. Úpravy souborů na běžícím serveru mohou způsobit další poškození.
2. V GPanel přejděte na záložku File Manager.
3. Přejděte do /.cache/saves/multiplayer/.
4. Uvidíte jednu nebo více složek s názvem vašeho serveru (např. servertest). Před smazáním si volitelně stáhněte složku jako zálohu jejím výběrem a použitím možnosti stažení — i poškozená záloha může být později částečně obnovitelná.
5. Smažte složku odpovídající názvu vašeho serveru uvnitř Multiplayer/. Nemažte samotnou složku Multiplayer.
6. Také přejděte do /.cache/db/ a smažte soubor <YourServerName>.db. Tato databáze obsahuje statistiky hráčů a může odkazovat na starý svět — její přegenerování zabrání nesouladům.
7. Spusťte server. Vygeneruje nový svět pomocí nastavení ve vašem souboru .ini.

Rychlý diagnostický přehled

Stále padá po všech krocích?