Sådan aktiverer du Debug mode på din Project Zomboid-server
Åbn din server i kontrolpanelet, gå til fanen Opstart (Startup), og slå Debug mode til. Indstillingen gemmes, så snart du klikker, og træder i kraft næste gang serveren genstarter.
Hvad Debug mode gør på serveren
Debug mode starter Project Zomboid-serverprocessen med spillets -debug-flag. På en server betyder det først og fremmest én ting: udviklerlogning. Hver gang Project Zomboid booter, udskriver den en Logs configuration:-tabel med sine logkategorier og det niveau, hver enkelt er sat til. Ved en normal opstart ligger næsten alle på Warning, så serveren skriver kun noget ned, når der er et problem.
Med Debug mode slået til falder alle 51 kategorier ned på General, som er det detaljerede niveau. Serveren begynder at registrere almindelig aktivitet og ikke kun advarsler og fejl, så du får et langt mere detaljeret billede af, hvad den lavede op til et problem. Det er den effekt, du kan se og bruge, og det er grunden til at gribe efter kontakten, når du jagter noget, du ellers ikke kan få fat i.
Nogle mods beder også om debug mode, og det er den anden almindelige grund til at slå det til. Læs modets egen vejledning først, for "debug mode" kan betyde serveren, eller det kan betyde din egen kopi af spillet, og det er to forskellige indstillinger. Der er et afsnit længere nede om at skelne mellem dem.
Ellers ændrer der sig ikke noget på serveren. Den booter normalt, spillerne forbinder som de plejer, og din verden, din config og dine installerede mods bliver ikke rørt.
Sådan slår du Debug mode til
- Åbn din server i panelet og vælg Opstart i sektionslisten til venstre.
- Debug mode er det første kort på fanen.
- Klik på kontakten. Den gemmer med det samme, og linjen under den siger "Træder i kraft ved næste genstart".
- Genstart serveren fra fanen Konsol.
Når den er slået til, bliver kontakten blå og bliver ved med at være det, indtil du slår den fra igen.
På en telefon, eller i et smalt browservindue, klapper sektionslisten sammen til en Sektion-vælger over indholdet. Tryk på den og vælg Opstart for at komme til det samme kort.
Der er ingen startkommando, du selv skal rette her, og det er med vilje. Project Zomboids launcher accepterer kun flaget, når det sendes efter en ---separator: giver du den et bart -debug, nægter den at boote med unknown option "-debug". Kontakten bygger kommandoen korrekt, så lad kommandoen være og brug kontakten.
Sådan tjekker du at det virkede
Genstart serveren og hold øje med fanen Konsol, mens den booter. Rul ned til Logs configuration:-blokken tidligt i loggen. Med Debug mode slået fra ender linjerne på Warning. Med Debug mode slået til ender de på General. Den blok er den klareste bekræftelse, du kan få, for det er serveren selv, der fortæller hvilket logniveau den startede med.
Hvis blokken stadig siger Warning, er serveren ikke blevet genstartet, siden du slog kontakten til. At gemme indstillingen omskriver kun startkommandoen, og startkommandoen bliver læst ved opstart.
Spillets debug-menu er en indstilling på klienten
Det er den del, der skaber mest forvirring, så det er værd at være præcis. Project Zomboid har to forskellige ting, der hedder debug, og at slå den ene til slår ikke den anden til.
Den debug-menu inde i spillet, altså insekt-ikonet der åbner udviklermenuen til at spawne genstande, teleportere og andre snydefunktioner, findes kun på klienten. Hver spiller slår den til i sin egen kopi af spillet: højreklik på Project Zomboid i dit Steam-bibliotek, vælg Properties, og tilføj -debug til launch options. Det gælder kun den spillers spil på den spillers maskine, og ingen andre bliver påvirket af det.
Der er en hage, som er værd at kende, før du sender det tip videre. På en dedikeret server bliver en spiller, der forbinder med -debug i sine launch options, koblet af igen, medmindre vedkommende er admin, og spillet melder det som Debug connection is not allowed for non-admin. Betragt launch option'en på klienten som noget til dig og dine admins, ikke noget du beder hele serveren om at slå til.
Kontakten i dit kontrolpanel gør ikke det. Den sætter serverprocessen i debug mode, og derfor viser den effekt, du kan se, sig i serverens log og ikke i nogens spil. At slå den til giver ikke dine spillere et insekt-ikon på skærmen, og en spiller, der slår -debug til i Steam, sætter ikke din server i debug mode. De to indstillinger er uafhængige, og du kan køre den ene uden den anden.
Så hvis det, du egentlig vil, er at spawne genstande eller teleportere på din egen server, er debug mode på serveren ikke den indstilling, du leder efter. Du skal bruge en admin-konto, og launch option'en på klienten hvis du også vil have udviklermenuen.
Hvornår du skal lade Debug mode være slået fra
Debug mode er et værktøj til en bestemt opgave, ikke en indstilling der skal stå til permanent. Udviklerne fraråder at køre debug under multiplayer på grund af det, det koster i ydeevne, og logmængden er den synlige side af den samme sag: hver kategori falder fra Warning til General, så serveren skriver langt mere til disken, end den ellers ville, og bliver ved så længe den kører. På en travl server med flere spillere på vokser de filer støt og æder af den diskplads, din verden og dine backups har brug for.
Der er også en praktisk pris. En detaljeret log er sværere at læse end en stille en, og den fejl, du faktisk leder efter, ender begravet under tusindvis af rutinelinjer, der kun findes, fordi Debug mode er slået til.
Så slå det til når du har brug for det, gør det du havde brug for, og slå det fra igen og genstart. Har du kørt med det slået til i et stykke tid, så åbn fanen Filer, gå ind i mappen .cache, og ryd op i de gamle logfiler, du ikke længere skal bruge.
Almindelige problemer
Jeg slog det til, men der skete ikke noget. Kontakten omskriver kun startkommandoen. Genstart serveren fra fanen Konsol, og tjek så Logs configuration:-blokken som beskrevet ovenfor.
Et mod siger, det kræver debug mode, og det virker stadig ikke. Find ud af hvilken side modet mener. Hvis det kræver serveren i debug mode, er det den her kontakt, du skal bruge. Hvis det kræver dit spil i debug mode, skal launch option'en på din egen kopi af Project Zomboid i Steam. At læse modets Workshop-beskrivelse ordentligt afgør det som regel. Det er også værd at bekræfte, at modet overhovedet er installeret og bliver indlæst: se Sådan installerer du mods på en Project Zomboid-server (Build 42).
Jeg vil spawne genstande eller teleportere, og det gav debug mode mig ikke. Det er admin-rettigheder, ikke debug mode. Log ind med din admin-konto inde i spillet og brug admin-panelet: se Sådan bliver du admin på en Project Zomboid-server.
En spiller bliver koblet af i det øjeblik, de forbinder. Tjek om de har -debug i deres egne launch options i Steam. En dedikeret server afviser en debug-forbindelse fra alle, der ikke er admin, så løsningen er at fjerne den launch option i deres ende. Det har intet med serverkontakten at gøre, og derfor bliver det ved med at ske på servere, der aldrig har haft debug mode slået til.
Min diskplads steg, efter jeg slog det til. Det er den forventede bivirkning ved detaljeret logning. Slå Debug mode fra, genstart, og slet de logfiler, du ikke længere skal bruge, fra fanen Filer.
Kan jeg bare lade det stå til? Serveren kører med det slået til, så der går ikke noget i stykker af det i sig selv. Det er stadig værd at slå fra, når du er færdig: udviklerne fraråder debug under multiplayer, og loggene bliver ved med at vokse, hele den tid det er slået til.
Debug mode er tilgængelig på alle de Project Zomboid-servere, vi hoster, fra det samme kontrolpanel, som du styrer alt andet fra. Hvis kontakten mangler, eller serveren ikke vil starte efter en genstart, så opret en ticket, og så gennemgår vi bootloggen sammen med dig.
