Tento průvodce vás provede instalací modů ze Steam Workshop na váš Project Zomboid server hostovaný u Legion Hosting. Pokrývá formáty modů pro B42 a B41, nástroj Legion Hosting Mod Organizer, poznámky ke kompatibilitě velkých balíčků modů a způsob obnovy po běžném poškození světa způsobeném mody.

Předpoklady

• Aktivní Project Zomboid server u Legion Hosting, přístupný na gpanel.legionhosting.net
• Váš server musí být Offline před úpravou nastavení modů — nejprve ho zastavte v GPanel
• Steam Workshop ID a Mod ID pro každý mod, který chcete nainstalovat (najdete je na stránce každého modu ve Steam Workshop)
• Záloha vašeho aktuálního uloženého světa (důrazně doporučeno — viz varování výše)

Krok 1 — Najděte Workshop ID a Mod ID pro každý mod

Každý mod, který chcete nainstalovat, vyžaduje dva samostatné identifikátory:

• Workshop ID — číselné ID v URL adrese Steam Workshop, např. https://steamcommunity.com/sharedfiles/filedetails/?id=2392987841
• Mod ID — interní ID definované autorem modu, které najdete v popisu modu na stránce Workshop, obvykle uvedené jako "Mod ID:" nebo v souboru mod.info daného modu

Zapište si obě ID pro každý mod, než budete pokračovat. Jedna položka ve Workshop někdy obsahuje více sub-modů, každý s vlastním Mod ID.

Krok 2 — Použijte Legion Hosting Mod Organizer (doporučeno)

Nejjednodušší způsob, jak sestavit seznam modů, je Legion Hosting Zomboid Mod Organizer. Umožňuje vám prohledávat Workshop, přidávat mody podle URL nebo ID a automaticky generuje správně naformátované konfigurační řádky, které stačí vložit do GPanel.

1. Přejděte na legionhosting.net/zomboid-mod-organizer.php.
2. Vyhledejte mody podle názvu nebo vložte URL adresu ze Steam Workshop do vyhledávacího pole.
3. Přidejte každý mod do seznamu pomocí tlačítka Add.
4. Jakmile je váš seznam kompletní, klikněte na Generate Config. Nástroj vygeneruje řádky WorkshopItems a Mods připravené k použití a naformátované pro verzi buildu vašeho serveru.
5. Zkopírujte vygenerované řádky a přejděte ke Kroku 4, kde je vložíte do nastavení serveru.

Pokud dáváte přednost ručnímu zadání ID, pokračujte Krokem 3, kde je správně naformátujete pro vaši verzi buildu.

Krok 3 — Správné formátování seznamu modů

WorkshopItems (stejné pro všechny buildy)

Řádek WorkshopItems používá středník k oddělení Workshop ID. Tento formát je stejný pro B41 i B42:

Mods — Formát Build 42 (B42)

B42 používá prefix zpětného lomítka (\) před každým Mod ID:

Formát DLMP (B42)

Některé konfigurace používají formát DLMP, který kombinuje Workshop ID a Mod ID se zpětným lomítkem v jednom poli:

Mods — Formát Build 41 (B41)

B41 používá Mod ID oddělená středníky bez prefixu se zpětným lomítkem:

Krok 4 — Aplikujte seznam modů v konfiguračním souboru serveru

1. Přihlaste se do GPanel a vyberte svůj Project Zomboid server.
2. Ujistěte se, že je server Offline. V případě potřeby ho zastavte.
3. Otevřete File Manager a přejděte do /.cache/server/.
4. Otevřete konfigurační soubor serveru — jmenuje se <servername>.ini (např. servertest.ini).
5. Najděte řádky WorkshopItems= a Mods= v souboru. Vložte hodnoty, které jste vygenerovali v Kroku 2 nebo naformátovali v Kroku 3.
6. Uložte soubor.
7. Spusťte server. Stahování ze Steam Workshop začne automaticky při spuštění.

Krok 5 — Přidávejte mody postupně a testujte

Nepřidávejte celý požadovaný seznam modů najednou, zejména na aktivním serveru nebo při práci s velkou kolekcí. Místo toho:

1. Přidejte maximálně 3–5 modů najednou.
2. Spusťte server a potvrďte, že dosáhne stavu Running a že se můžete připojit a hrát.
3. Zkontrolujte konzoli GPanel, zda neobsahuje chybové zprávy nebo výpisy zásobníku, než přidáte další dávku.
4. Opakujte, dokud nejsou všechny mody načteny a stabilní.

Tento přístup výrazně usnadňuje identifikaci modu, který způsobuje problém, pokud se něco pokazí.

Instalace modů mimo Workshop

Pokud máte mod, který není na Steam Workshop (stažený jako složka nebo ZIP soubor), nahrajte ho přes SFTP na následující cestu na vašem serveru:

Umístěte složku modu (která by měla obsahovat soubor mod.info) přímo do /.cache/mods/. K tomuto adresáři se dostanete pomocí přihlašovacích údajů SFTP zobrazených v GPanel na záložce SFTP. Po nahrání přidejte Mod ID (ze souboru mod.info daného modu) do řádku Mods= v konfiguraci serveru, jak je popsáno v Kroku 4. Pro mody mimo Workshop není potřeba Workshop ID.

Poznámka ke kompatibilitě Authentic Z

Authentic Z je jeden z nejpopulárnějších balíčků modů pro Project Zomboid, ale skládá se z mnoha sub-modů. Instalujte vždy pouze jeden sub-mod a doporučený sub-mod pro multiplayerové servery je:

Neaktivujte více sub-modů Authentic Z současně na stejném serveru. Spuštění více než jednoho sub-modu z této kolekce způsobuje konflikty, které mohou způsobit pád serveru nebo poškození tabulek kořisti. Pokud si nejste jisti, který sub-mod je aktivní, zkontrolujte řádek Mods= ve vaší konfiguraci a ujistěte se, že je uveden pouze Authentic Z - Current (nebo vámi zvolený jediný sub-mod).

Ověření

Po spuštění serveru s novými mody potvrďte, že se úspěšně načetly:

1. V GPanel otevřete záložku Console a sledujte spouštěcí log. Hledejte řádky odkazující na načítání každého modu — měli byste vidět něco jako [ModLoader] Loading mod: ModID pro každý nainstalovaný mod.
2. Připojte se k serveru ve hře a otevřete nabídku Mods z hlavního menu (Esc → Mods). Nainstalované mody by se měly zobrazit v seznamu.
3. V logu konzole hledejte frázi STACK TRACE. Pokud se neobjeví, server se spustil čistě. Pokud ji vidíte, poznamenejte si mod zmíněný v horní části výpisu — tento mod je pravděpodobnou příčinou problému.
4. Projděte se ve hře a potvrďte, že obsah přidaný mody (předměty, budovy, zombie) se zobrazuje podle očekávání.

Řešení problémů

Mody se nenačítají / server se spustí, ale mody se zdají neaktivní

• Ověřte, že řádek Mods používá správný formát pro váš build — prefix se zpětným lomítkem (\ModID) pro B42, prosté Mod ID pro B41. Formát WorkshopItems je stejný pro oba buildy.
• Potvrďte, že Mod ID v řádku Mods= přesně odpovídá ID zobrazenému v popisu modu ve Workshop nebo v souboru mod.info. Mod ID rozlišují velká a malá písmena.
• Zkontrolujte, že obě pole WorkshopItems a Mods jsou uložena — přejděte jinam a vraťte se v GPanel, abyste potvrdili, že hodnoty zůstaly zachovány.

Stahování ze Steam Workshop selhává / mody se při spuštění nestahují

Pokud se server spustí, ale mody z Workshop se zdánlivě nestahují, může být poškozena složka mezipaměti Steam. Oprava:

1. Zastavte server v GPanel.
2. Připojte se přes SFTP a přejděte do /steamapps/workshop/.
3. Smažte celou složku workshop/ (nebo její obsah).
4. Znovu spusťte server. Steam stáhne všechny položky Workshop znovu od začátku.

WorldDictionaryException / poškození slovníku světa

Pokud log konzole zobrazuje chybu WorldDictionaryException, slovník světa se poškodil — k tomu může dojít při přidávání nebo odebírání modů, které zavádějí nové předměty nebo dlaždice.

Pokud musíte pokusit o obnovu:

1. Zastavte server v GPanel.
2. Zálohujte celou složku s uložením přes SFTP nebo GPanel zálohy.
3. Připojte se přes SFTP a přejděte do /.cache/saves/multiplayer/<YourWorldName>/.
4. Smažte WorldDictionary.bin.
5. Spusťte server. Project Zomboid při spuštění slovník znovu vygeneruje.
6. Zkontrolujte ve hře poškozené předměty nebo vozidla. Pokud je svět vážně poškozen, obnovte ho ze zálohy vytvořené v kroku 2.

Server spadne při spuštění s výpisem STACK TRACE v logu konzole

Výpis zásobníku ihned po spuštění obvykle indikuje konflikt modů nebo mod nekompatibilní s vaší aktuální verzí buildu. Diagnostika:

1. V GPanel otevřete log Console a vyhledejte STACK TRACE.
2. Přečtěte si řádky nad výpisem, kde je zmíněn název souboru modu nebo Mod ID — to je obvykle problémový mod.
3. Odeberte tento mod z řádků WorkshopItems i Mods, uložte a restartujte server.
4. Pokud se server po odebrání spustí čistě, zkontrolujte stránku modu ve Workshop, zda je k dispozici aktualizace kompatibilní s B42 nebo poznámka o známém konfliktu v komentářích.

Můžete také otevřít celý soubor debug.log přes SFTP na cestě /.cache/Logs/<date>_DebugLog-server.txt pro více podrobností, než zobrazuje konzole GPanel.

Server spadne, když se připojí hráči s konkrétními mody

Pokud server běží čistě, ale spadne, když se připojí hráč, může mít hráč mody na straně klienta, které jsou v konfliktu se serverem. Požádejte hráče, aby zakázal všechny své lokální mody pro Project Zomboid z nabídky Mods ve hře a zkusil se připojit znovu. Pokud pády přestanou, hráč by měl mody znovu zapínat jeden po druhém, aby našel konfliktní mod.

Mod byl odebrán, ale server se ho stále pokouší načíst

Pokud jste odebrali ID modu z konfigurace, ale server na něj stále odkazuje při spuštění, položka Workshop může být stále v mezipaměti. Smažte konkrétní složku položky Workshop z /steamapps/workshop/content/108600/<workshopID>/ přes SFTP a poté restartujte server.