Jak włączyć Debug mode na serwerze Project Zomboid
Otwórz swój serwer w panelu, przejdź na zakładkę Uruchamianie (Startup) i włącz Debug mode. Ustawienie zapisuje się od razu po kliknięciu i zaczyna obowiązywać przy następnym restarcie serwera.
Co Debug mode robi na serwerze
Debug mode uruchamia proces serwera Project Zomboid z flagą -debug. Na serwerze oznacza to przede wszystkim jedno: logowanie deweloperskie. Przy każdym starcie Project Zomboid wypisuje tabelę Logs configuration: z listą kategorii logów i poziomem ustawionym dla każdej z nich. Przy normalnym starcie prawie wszystkie stoją na Warning, więc serwer zapisuje coś tylko wtedy, gdy pojawia się problem.
Z włączonym Debug mode wszystkie 51 kategorii spada na General, czyli poziom szczegółowy. Serwer zaczyna zapisywać także zwykłą aktywność, a nie tylko ostrzeżenia i błędy, dzięki czemu masz o wiele dokładniejszy obraz tego, co się działo tuż przed problemem. To efekt, który widać i da się wykorzystać, i właśnie dlatego sięga się po ten przełącznik, gdy szukasz czegoś, do czego inaczej nie da się dotrzeć.
Niektóre mody też proszą o debug mode i to drugi częsty powód, żeby go włączyć. Przeczytaj najpierw instrukcję samego moda, bo "debug mode" może oznaczać serwer albo twoją własną kopię gry, a to dwa różne ustawienia. Niżej jest sekcja o tym, jak je rozróżnić.
Poza tym na serwerze nic się nie zmienia. Startuje normalnie, gracze łączą się tak jak zawsze, a twój świat, config i zainstalowane mody pozostają nietknięte.
Włączanie Debug mode
- Otwórz serwer w panelu i wybierz Uruchamianie z listy sekcji po lewej stronie.
- Debug mode to pierwsza karta na zakładce.
- Kliknij przełącznik. Zapisuje się natychmiast, a linijka pod nim mówi "Zacznie obowiązywać po następnym restarcie".
- Zrestartuj serwer z zakładki Konsola.
Po włączeniu przełącznik robi się niebieski i taki zostaje, dopóki go nie wyłączysz.
Na telefonie albo w wąskim oknie przeglądarki lista sekcji zwija się do selektora Sekcja nad treścią. Dotknij go i wybierz Uruchamianie, żeby dostać się do tej samej karty.
Nie ma tu żadnej komendy startowej, którą trzeba by poprawiać ręcznie, i to celowo. Launcher Project Zomboid przyjmuje tę flagę tylko wtedy, gdy zostanie przekazana po separatorze --: podaj mu samo -debug, a odmówi startu z komunikatem unknown option "-debug". Przełącznik buduje komendę poprawnie, więc zostaw komendę w spokoju i korzystaj z przełącznika.
Jak sprawdzić, czy zadziałało
Zrestartuj serwer i obserwuj zakładkę Konsola podczas startu. Przewiń do bloku Logs configuration: na początku logu. Przy wyłączonym Debug mode te linijki kończą się na Warning. Przy włączonym kończą się na General. Ten blok to najpewniejsze potwierdzenie, jakie dostaniesz, bo to sam serwer melduje, z jakim poziomem logowania wystartował.
Jeśli w bloku nadal jest Warning, serwer nie został zrestartowany od czasu przestawienia przełącznika. Zapisanie ustawienia jedynie przepisuje komendę startową, a komenda startowa czytana jest przy uruchamianiu.
Menu debug w grze to ustawienie po stronie klienta
To ta część, która budzi najwięcej nieporozumień, więc warto powiedzieć precyzyjnie: Project Zomboid ma dwie różne rzeczy nazywane debug i włączenie jednej nie włącza drugiej.
Menu debug w grze, czyli ikona robaka otwierająca menu deweloperskie do spawnowania przedmiotów, teleportacji i innych cheatów, istnieje wyłącznie po stronie klienta. Każdy gracz włącza je sobie sam w swojej kopii gry: kliknij prawym przyciskiem na Project Zomboid w bibliotece Steam, wybierz Properties i dodaj -debug do launch options. Działa to tylko dla gry tego gracza, na jego komputerze, i nikogo innego nie dotyczy.
Jest jednak haczyk, o którym warto wiedzieć, zanim podasz tę wskazówkę dalej. Na serwerze dedykowanym gracz, który połączy się z -debug w swoich launch options, zostaje od razu rozłączony, o ile nie jest adminem, a gra zgłasza to jako Debug connection is not allowed for non-admin. Traktuj więc tę launch option po stronie klienta jako coś dla siebie i swoich adminów, a nie jako polecenie dla całego serwera.
Przełącznik w twoim panelu nie robi tego wszystkiego. Przestawia w tryb debug proces serwera, i dlatego widoczny efekt pojawia się w logach serwera, a nie w czyjejś grze. Włączenie go nie doda graczom ikony robaka na ekranie, a gracz włączający -debug w Steamie nie przestawia twojego serwera w debug mode. Te dwa ustawienia są niezależne i możesz używać jednego bez drugiego.
Jeśli więc naprawdę chodzi ci o spawnowanie przedmiotów albo teleportację na własnym serwerze, debug mode na serwerze nie jest ustawieniem, którego szukasz. Potrzebujesz konta admina, a do tego launch option po stronie klienta, jeśli chcesz mieć jeszcze menu deweloperskie.
Kiedy zostawić Debug mode wyłączony
Debug mode to narzędzie do konkretnego zadania, a nie ustawienie do trzymania włączonego na stałe. Twórcy odradzają uruchamianie debug w trybie wieloosobowym ze względu na koszt wydajnościowy, a ilość logów to widoczna strona tej samej sprawy: każda kategoria spada z Warning na General, więc serwer zapisuje na dysk znacznie więcej niż normalnie i robi to tak długo, jak długo działa. Na ruchliwym serwerze z kilkoma graczami te pliki rosną systematycznie i zjadają miejsce potrzebne twojemu światu i backupom.
Jest też koszt czysto praktyczny. Szczegółowy log czyta się gorzej niż spokojny, a błąd, którego naprawdę szukasz, ginie pod tysiącami rutynowych linijek, które istnieją tylko dlatego, że Debug mode jest włączony.
Włączaj go więc wtedy, kiedy jest potrzebny, zrób to, do czego był potrzebny, a potem wyłącz i zrestartuj serwer. Jeśli działał włączony przez dłuższy czas, otwórz zakładkę Pliki, wejdź do folderu .cache i posprzątaj stare pliki logów, których już nie potrzebujesz.
Częste problemy
Włączyłem, ale nic się nie zmieniło. Przełącznik jedynie przepisuje komendę startową. Zrestartuj serwer z zakładki Konsola, a potem sprawdź blok Logs configuration: tak jak opisano wyżej.
Mod pisze, że wymaga debug mode, a i tak nie działa. Ustal, o którą stronę modowi chodzi. Jeśli potrzebuje serwera w debug mode, to właśnie ten przełącznik. Jeśli potrzebuje twojej gry w debug mode, launch option trafia do twojej własnej kopii Project Zomboid w Steamie. Uważne przeczytanie opisu moda na Workshop zwykle rozstrzyga sprawę. Warto też potwierdzić, że mod w ogóle jest zainstalowany i się ładuje: zobacz Jak zainstalować mody na serwerze Project Zomboid (Build 42).
Chcę spawnować przedmioty albo się teleportować, a Debug mode mi tego nie dał. To uprawnienia admina, a nie debug mode. Zaloguj się w grze na konto admina i skorzystaj z panelu admina: zobacz Jak zostać adminem na serwerze Project Zomboid.
Gracz zostaje rozłączony w chwili, gdy się połączy. Sprawdź, czy nie ma -debug we własnych launch options w Steamie. Serwer dedykowany odrzuca połączenie debug od każdego, kto nie jest adminem, więc rozwiązaniem jest usunięcie tej launch option po jego stronie. Nie ma to nic wspólnego z przełącznikiem na serwerze i właśnie dlatego zdarza się to również na serwerach, które nigdy nie miały włączonego debug mode.
Zużycie dysku wzrosło po włączeniu. To spodziewany efekt uboczny szczegółowego logowania. Wyłącz Debug mode, zrestartuj serwer i usuń niepotrzebne już pliki logów z zakładki Pliki.
Czy mogę go po prostu zostawić włączonego? Serwer z nim działa, więc samo w sobie nic się nie zepsuje. Mimo to warto go wyłączyć po skończonej robocie: twórcy odradzają debug w trybie wieloosobowym, a logi rosną przez cały czas, gdy jest włączony.
Debug mode jest dostępny na każdym serwerze Project Zomboid, który u nas hostujesz, z tego samego panelu, w którym zarządzasz wszystkim innym. Jeśli przełącznika brakuje albo serwer nie chce wstać po restarcie, załóż zgłoszenie, a przejdziemy z tobą przez log startowy.
