Debug mode

This article is currently under construction.

It is in the process of an expansion or major restructuring. You are welcome to assist in its construction by editing it as well.

If this page has not been updated in a while, please replace this notice with {{Improve}}. Last edit was 24/07/2019.

Debug mode is a modified game state in Project Zomboid. In this mode, the player has access to multiple developer tools which can spawn items, enable various cheats, teleport the player to any destination, and more.

Enabling

To enable the debug mode, hold LShift while the game is booting, or for a more permanent option, add -debug to the game launch parameters prior to booting the game.

Debug scenario

A list of debug scenarios can be found on the main menu, double-clicking will start the game in a predefined scenario. Custom scenarios can be made by editing "DebugScenario.lua" at "ProjectZomboid\media\lua\client\DebugUIs\Scenarios", or creating a new scenario.

Debug menu

The debug menu is a user interface allowing the player to view/manipulate the game state.

When in a game, a grey bug icon on the left of the HUD will appear when in debug mode. Clicking this, will make it red and display the debug menu.

General debuggers

Game

This option shows all general game options. Currently, the only option is "GameSpeed".

• GameSpeed
  Adjust the game speed by moving the slider. Clicking the left and right arrows will increase/decrease the game speed by 0.1 increment at a time, or 1.0 if holding the sprint key (LShift by default). This value can range from 1 to 1000, with 0.1 increments.
  (1=default, 5=fast-forward, 20=fast-fast-forward, 40=wait)

Moodles and Body

• Hunger
  (min=0, max=1)
• Thirst
  (min=0, max=1)
• Fatigue
  (min=0, max=1)
• Endurance
  (min=0, max=1)
• Fitness
  (min=-1, max=1)
• Drunkenness
  (min=0, max=100)
• Anger
  (min=0, max=1)
• Fear
  (min=0, max=1)
• Pain
  (min=0, max=100)
• Panic
  (min=0, max=100)
• Morale
  (min=0, max=1)
• Stress
  (min=0, max=1)
• BoredomLevel
  (min=0, max=100)
• Sanity
  (min=0, max=1)
• Wetness
  (min=0, max=100)
• Temperature
  (min=20, max=40)
• ColdDamageStage (hypo 4)
  (min=0, max=1)
• OverallBodyHealth
  (min=0, max=1)
• CatchAColdStrength
  (min=0, max=100)
• Sickness
  (min=0, max=1)
• InfectionLevel
  (min=0, max=100)
• FakeInfectionLevel
  (min=0, max=100)
• FoodSicknessLevel
  (min=0, max=100)
• IsInfected
  (boolean)
• IsOnFire
  (boolean)
• Ghost
  (boolean)
• God Mode
  (boolean)

General Cheats

• Build Cheat
  (boolean)
• Health Panel Cheat
  (boolean)
• Moveable Cheat
  (boolean)
• Mechanics Cheat
  (boolean)

Lua debugger

The Lua debugger can be accessed by pressing F11; breaking into debugger at the next available Lua entry point. A list of all loaded Lua files are displayed on the right, with the currently selected file above the list. The line highlighted green is the entry point to the debugger, allowing for quick in-game debugging.

Map Debugger

The map debugger is opened by clicking the "Map" button at the top. The player can teleport to the location of the cursor, by pressing T. There is no prompt to inform the user of the teleport; after closing the debugger, the player will have teleported.