Så aktiverar du Debug mode på din Project Zomboid-server
Öppna din server i kontrollpanelen, gå till fliken Start (Startup) och slå på Debug mode. Inställningen sparas så fort du klickar och träder i kraft nästa gång servern startar om.
Vad Debug mode gör på servern
Debug mode startar Project Zomboid-serverprocessen med spelets -debug-flagga. På en server betyder det framför allt en sak: utvecklarloggning. Varje gång Project Zomboid startar skriver den ut en Logs configuration:-tabell med sina loggkategorier och vilken nivå var och en står på. Vid en normal start ligger nästan alla på Warning, så servern skriver bara ner något när det uppstår ett problem.
Med Debug mode påslaget faller alla 51 kategorier ner till General, som är den utförliga nivån. Servern börjar registrera vanlig aktivitet och inte bara varningar och fel, så du får en betydligt mer detaljerad bild av vad den höll på med i upptakten till ett problem. Det är den effekt du kan se och använda, och det är därför man griper efter reglaget när man letar efter något man annars inte kommer åt.
Vissa mods ber också om debug mode, och det är den andra vanliga anledningen att slå på det. Läs moddens egen anvisning först, för "debug mode" kan syfta på servern eller på din egen kopia av spelet, och det är två olika inställningar. Längre ner finns ett avsnitt om hur du skiljer dem åt.
I övrigt ändras ingenting på servern. Den startar som vanligt, spelarna ansluter som de alltid gjort, och din värld, din config och dina installerade mods lämnas orörda.
Så slår du på Debug mode
- Öppna din server i panelen och välj Start i avsnittslistan till vänster.
- Debug mode är det första kortet på fliken.
- Klicka på reglaget. Det sparar direkt, och raden under säger "Träder i kraft vid nästa omstart".
- Starta om servern från fliken Konsol.
När det är påslaget blir reglaget blått och förblir så tills du stänger av det igen.
På en telefon, eller i ett smalt webbläsarfönster, fälls avsnittslistan ihop till en Avsnitt-väljare ovanför innehållet. Tryck på den och välj Start för att komma till samma kort.
Det finns inget startkommando som du behöver redigera för hand här, och det är med flit. Project Zomboids launcher accepterar bara flaggan när den skickas efter en ---separator: ger du den ett blankt -debug vägrar den starta med unknown option "-debug". Reglaget bygger kommandot korrekt, så låt kommandot vara och använd reglaget.
Kontrollera att det fungerade
Starta om servern och håll ett öga på fliken Konsol medan den startar. Bläddra till Logs configuration:-blocket tidigt i loggen. Med Debug mode avstängt slutar raderna på Warning. Med Debug mode påslaget slutar de på General. Det blocket är den tydligaste bekräftelsen du kan få, eftersom det är servern själv som rapporterar vilken loggnivå den startade med.
Står det fortfarande Warning har servern inte startats om sedan du slog på reglaget. Att spara inställningen skriver bara om startkommandot, och startkommandot läses vid uppstart.
Debug-menyn i spelet är en inställning på klienten
Det är den här delen som skapar mest förvirring, så det är värt att vara exakt. Project Zomboid har två olika saker som heter debug, och att slå på den ena slår inte på den andra.
Den debug-meny som finns i spelet, alltså insektsikonen som öppnar utvecklarmenyn för att spawna föremål, teleportera och andra fusk, finns bara på klienten. Varje spelare slår på den för sin egen kopia av spelet: högerklicka på Project Zomboid i ditt Steam-bibliotek, välj Properties och lägg till -debug i launch options. Det gäller bara den spelarens spel på den spelarens dator, och ingen annan påverkas av det.
Det finns en hake som är värd att känna till innan du för tipset vidare. På en dedikerad server kopplas en spelare som ansluter med -debug i sina launch options bort igen om han eller hon inte är admin, och spelet rapporterar det som Debug connection is not allowed for non-admin. Se launch option på klienten som något för dig och dina admins, inte något du ber hela servern att slå på.
Reglaget i din kontrollpanel gör inte det där. Det sätter serverprocessen i debug mode, och därför syns den effekt du kan se i serverns logg och inte i någons spel. Att slå på det ger inte dina spelare någon insektsikon på skärmen, och en spelare som slår på -debug i Steam sätter inte din server i debug mode. De två inställningarna är oberoende av varandra, och du kan köra den ena utan den andra.
Så om det du egentligen vill är att spawna föremål eller teleportera på din egen server är debug mode på servern inte den inställning du letar efter. Du behöver ett admin-konto, och launch option på klienten om du dessutom vill ha utvecklarmenyn.
När du bör låta Debug mode vara avstängt
Debug mode är ett verktyg för ett bestämt jobb, inte en inställning som ska stå på permanent. Utvecklarna avråder från att köra debug under multiplayer på grund av prestandakostnaden, och loggmängden är den synliga sidan av samma sak: varje kategori faller från Warning till General, så servern skriver betydligt mer till disken än den annars skulle göra, och fortsätter så länge den är igång. På en välbesökt server med flera spelare inne växer de filerna stadigt och äter av det diskutrymme som din värld och dina backuper behöver.
Det finns en praktisk kostnad också. En utförlig logg är svårare att läsa än en tyst, och felet du faktiskt letar efter hamnar begravt under tusentals rutinrader som bara finns där för att Debug mode är påslaget.
Så slå på det när du behöver det, gör det du behövde det till, och slå av det igen och starta om. Har du kört med det påslaget ett tag, öppna fliken Filer, gå in i mappen .cache och rensa bort de gamla loggfilerna du inte längre behöver.
Vanliga problem
Jag slog på det men ingenting hände. Reglaget skriver bara om startkommandot. Starta om servern från fliken Konsol och kontrollera sedan Logs configuration:-blocket enligt ovan.
En mod säger att den kräver debug mode, och det fungerar ändå inte. Ta reda på vilken sida modden menar. Kräver den servern i debug mode är det det här reglaget du ska använda. Kräver den ditt spel i debug mode hör launch option hemma på din egen kopia av Project Zomboid i Steam. Att läsa moddens Workshop-beskrivning ordentligt brukar avgöra saken. Det är också värt att bekräfta att modden alls är installerad och laddas: se Hur du installerar mods på en Project Zomboid-server (Build 42).
Jag vill spawna föremål eller teleportera, och det gav Debug mode mig inte. Det är admin-rättigheter, inte debug mode. Logga in med ditt admin-konto inne i spelet och använd admin-panelen: se Hur du blir admin på en Project Zomboid-server.
En spelare kopplas bort i samma stund som han ansluter. Kontrollera om spelaren har -debug i sina egna launch options i Steam. En dedikerad server avvisar en debug-anslutning från alla som inte är admin, så lösningen är att ta bort den launch option i deras ände. Det har ingenting med reglaget på servern att göra, och det är därför det fortsätter hända på servrar som aldrig haft debug mode påslaget.
Min diskanvändning ökade efter att jag slog på det. Det är den väntade bieffekten av utförlig loggning. Slå av Debug mode, starta om och radera de loggfiler du inte längre behöver från fliken Filer.
Kan jag inte bara låta det vara på? Servern kör med det påslaget, så ingenting går sönder av det i sig. Det är ändå värt att slå av när du är klar: utvecklarna avråder från debug under multiplayer, och loggarna fortsätter växa hela den tid det är påslaget.
Debug mode finns på varje Project Zomboid-server vi hostar, från samma kontrollpanel som du sköter allt annat ifrån. Saknas reglaget, eller vägrar servern starta efter en omstart, skapa ett ärende så går vi igenom startloggen tillsammans med dig.
