Jak zainstalować mody na serwerze Project Zomboid (Build 42)
Dodawanie modów ze Steam Workshop do dedykowanego serwera Project Zomboid wymaga trzech informacji na mod i dwóch linii w konfiguracji serwera. Ten przewodnik krok po kroku omawia proces dla serwera multiplayer Build 42 hostowanego na panelu opartym na Pterodactyl (w tym DoomHosting).
Uwaga Build 42: Multiplayer jest obecnie na branchu unstable. Wiele modów z Build 41 nie działa na Build 42 — zawsze sprawdzaj stronę Workshop pod kątem wyraźnego oznaczenia "B42 supported" przed dodaniem moda.
Szybkie odniesienie
| Pole | Gdzie to znaleźć |
|---|---|
| Workshop ID | Numeryczny ID w URL Workshop (np. ?id=2392709985) |
| Mod ID | W opisie Workshop, podane jako Mod ID: ExampleMod |
| Nazwa folderu mapy | Tylko dla modów map, np. Map Folder: Bedford Falls |
Krok 1 — Zatrzymaj serwer przed edycją
Project Zomboid nadpisuje zarówno servertest.ini, jak i servertest_SandboxVars.lua przy wyłączaniu. Jeśli edytujesz, gdy serwer działa, twoje zmiany zostaną nadpisane. Najpierw zatrzymaj serwer z panelu.
Krok 2 — Otwórz servertest.ini w menedżerze plików
Przejdź do:
/home/container/Zomboid/Server/servertest.ini
Jeśli zmieniłeś nazwę serwera, plik używa twojej nazwy (np. MyServer.ini). Otwórz go we wbudowanym edytorze panelu lub przez SFTP.
Krok 3 — Dodaj linie WorkshopItems i Mods
Znajdź te dwie linie (istnieją domyślnie, ale są zwykle puste):
WorkshopItems=
Mods=
Dodaj swoje ID rozdzielone średnikami. Przykład z trzema modami (Common Sense, Brita's Weapon Pack, ModOptions):
WorkshopItems=2685168362;2900665603;2169435993
Mods=Common Sense;Brita;ModOptions
Linia WorkshopItems mówi SteamCMD, które mody pobrać. Linia Mods mówi grze, które mody faktycznie załadować. Obie muszą być wypełnione — a kolejność w Mods= kontroluje kolejność ładowania.
Krok 4 — Dodawanie modów map
Mody map wymagają dodatkowej linii. Pole Map= kontroluje, z której mapy generowany jest świat. Domyślnie (Knox County) jest to Muldraugh, KY. Aby użyć Bedford Falls:
WorkshopItems=2392709985
Mods=BedfordFalls
Map=BedfordFalls;Muldraugh, KY
Zawsze kończ łańcuch Map= na Muldraugh, KY, żeby vanilla-referencje map nadal działały.
Krok 5 — Zalecana kolejność ładowania modów
Konflikty modów są częste. Użyj tej kolejności ładowania w linii Mods=:
- Mody map
- Tile packs (np.
Tile Pack v1) - Frameworks (Common Sense, ModOptions, itd.)
- Mody pojazdów
- Mody broni i przedmiotów
- Mody UI i QoL na końcu
Krok 6 — Zapisz, uruchom ponownie i obserwuj konsolę
Zapisz plik i uruchom serwer. SteamCMD pobierze każde Workshop ID z listy. Pierwsze pobieranie dużej listy modów może zająć 5–15 minut. Obserwuj konsolę pod kątem linii takich jak:
LOG : General , 1234567890, Mod "BedfordFalls" loaded.
Jeśli zobaczysz Mod "X" not found, sprawdź dwukrotnie, czy Mod ID dokładnie odpowiada opisowi Workshop — rozróżnia wielkość liter.
Gdzie pobierane są mody
SteamCMD przechowuje cache modów w:
/home/container/Zomboid/Workshop/
/home/container/Zomboid/steamapps/workshop/content/108600/
Jeśli mod nie chce się aktualizować, usunięcie tych folderów wymusi świeże pobranie przy następnym uruchomieniu.
Gracze potrzebują tych samych modów
Zarówno serwer, jak i każdy łączący się gracz musi mieć włączone te same mody. Gracze dołączający do serwera są automatycznie proszeni o subskrypcję brakujących modów — wystarczy, że uruchomią grę ponownie po subskrypcji.
Częste błędy i naprawy
"Mod not found in PZModFileSystem" — niewłaściwy Mod ID. Otwórz stronę Workshop i skopiuj ID z opisu (nie z tytułu).
Serwer crashuje przy starcie po dodaniu moda — zła kolejność ładowania lub dwa mody w konflikcie. Usuń mod i sprawdź komentarze Workshop pod kątem problemów kompatybilności.
Pobieranie Workshop utknęło na 0% — autoryzacja SteamCMD nie powiodła się. Uruchom ponownie serwer; zwykle naprawia się przy drugiej próbie.
Mod działa w singleplayer, ale nie w multiplayer — wiele modów wymaga aktualizacji servertest_spawnregions.lua lub ma notki "SP only" na Workshop.
FAQ
Czy muszę restartować serwer za każdym razem, gdy dodaję mod?
Tak. Ładowanie modów odbywa się tylko przy bootowaniu. Dodawanie moda na żywo przez /changeoption nie działa dla pól modów.
Czy mogę zainstalować mody spoza Steam Workshop?
Tak — wrzuć folder moda do /home/container/Zomboid/mods/ i dodaj tylko Mod ID (nie Workshop ID) do linii Mods=.
Ile modów to za dużo? Większość serwerów B42 spokojnie obsługuje 20–60 modów. Powyżej 80 modów oczekuj 2× dłuższego bootu i wyższego zużycia RAM. Użyj naszego kalkulatora RAM do planowania.
Czy mody wpływają na wydajność serwera? Tak. Ciężkie mody gameplay (Brita's, vehicle expansions) dodają 1–3 GB RAM i mogą spowolnić ładowanie chunków. Lekkie mody QoL są praktycznie darmowe.