Debug mode

Navigation:

Modding > Debug mode

This page has been revised for the current stable version (41.78.16).

Help by adding any missing content. [edit]

This article may be in need of improvement.

Editors are encouraged to add any missing information to the article, while verifying that the article's current content is correct.

General debuggers option in debug mode.

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

Entering -debug in the Steam's launch options.

To enable the debug mode, hold LShift while the game is booting. (Windows only).

For a more permanent option, add -debug to the game startup parameters, prior to booting the game.

Debug scenario

A list of debug scenarios at main menu.

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"

in the file folder:

"ProjectZomboid\media\lua\client\DebugUIs\Scenarios"

Or creating a new scenario.

Debug menu

The debug menu.

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

When in a game, a gray 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.

Debug menu icon.

Debug menu open icon.

Main

General debuggers

Game

This option shows all general game options.

General Game Options

Option	Description	Variables
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.	default=1 fast-forward=5 fast-fast-forward=20 wait=40
Get the choppah!	Spawns the helicopter event.	(button)
Remove the choppah!	Spawns the helicopter event.	(button)
Disable radio/tv broadcasting	Disables radio and television broadcasts.	boolean
Disable media line registering		boolean

Moodles and Body

Player Stats and Body

Option	Description	Variables
Hunger	Slider that affects the hunger moodle, increases to 1 naturally.	min=0 max=1
Thirst	Slider that affects the thirst moodle, increases to 1 naturally.	min=0 max=1
Fatigue	Slider that affects the tired moodle, increases to 1 naturally.	min=0 max=1
Endurance	Slider that affects the endurance moodle, increases to 1 naturally.	min=0 max=1
Fitness	Slider that affects the fitness skill. This is a dynamic skill that will increase and decrease depending on the player's actions in 0.2 increments (per level).	min=-1 max=1
Drunkenness	Slider that affects the drunk moodle, decreases to 0 naturally. A full bottle of alcohol adds 0.41. A higher value will increase the fatigue moodle at a much higher rate.	min=0 max=100
Anger	Slider that affects the angry moodle, decreases to 0 naturally.	min=0 max=1
Fear	Slider that affects an unknown naturally static value.	min=0 max=1
Pain	Slider that affects the pain moodle, decreases to 0 naturally. Cannot be adjusted manually	min=0 max=100
Panic	Slider that affects the panic moodle, decreases to 0 naturally.	min=0 max=100
Morale	Slider that decreases to 0 naturally when stress is above 0.5. When stress is below 0.5, morale will instantly become 1.0.	min=0 max=1
Stress	Slider that affects the stress moodle, decreases to 0 naturally.	min=0 max=1
StressFromCigarettes	Slider that affects the stress moodle from cigarettes.	min=0 max=0.51
TimeSinceLastSmoke	Slider that affects time since last cigarette was smoked.	min=0 max=10
BoredomLevel	Slider that affects the bored moodle, decreases to 0 naturally.	min=0 max=100
UnhappynessLevel (sic!)	Slider that affects the unhapiness.	min=0 max=100
Sanity	Slider that can be adjusted when the BoredomLevel is above 50.	min=0 max=1
Wetness	Slider that affects the wet moodle, decreases to 0 naturally.	min=0 max=100
Temperature	Slider that affects the player's body temperature, affecting the hyperthermia and hypothermia moodles, decreases to 0 naturally.	min=20 max=40
ColdDamageStage (hypo 4)	Slider that determines how much damage the player will take when the hypoermia moodle is at level 4.	min=0 max=1
OverallBodyHealth	Slider that affects the player's overall health.	min=0 max=100
CatchAColdStrength	Slider that affects the cold moodles, increaes to 100 naturally when above 1.0.	min=0 max=100
Sickness	Slider that determines the sick moodle. Adjusts with InfectionLevel and FakeInfectionLevel Cannot be adjusted manually	min=0 max=1
InfectionLevel	Slider that affects the player's progress towards zombification, increasing rate of damage taken.	min=0 max=100
FakeInfectionLevel	Slider that affects the player's sickness, naturally occurs with the hypochondriac trait.	min=0 max=100
FoodSicknessLevel	Slider that affects the player's sickness, naturally occurs after eating bad food.	min=0 max=100
Calories	Slider that affects the player's calories.	min=-2200 max=3700
Weight	Slider that affects the player's weight.	min=35 max=130
IsInfected	Checkbox that determines whether the player has the zombie infection.	boolean
IsFakeInfected	Checkbox that determines whether the player should have zombie infection symptoms without being infected.	boolean
IsOnFire	Checkbox that determines whether the player is on fire.	boolean
Ghost	Checkbox that determines whether the zombies can see the player, and zombies can be seen regardless of visibility.	boolean
God Mode	Checkbox that determines whether the player is in god mode. Gives the player invincibility, i.e., takes no damage, max hunger, thirst, etc.	boolean
Invisible	Checkbox that determines whether the player is in invisible.	boolean

Blood

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

SearchMode

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Cheats

This article may be outdated.

Editors are encouraged to update this article with new information.

Option	Description	Variables
Build Cheat	Checkbox that determines whether all buildables in the metalwork and carpentry menus can be instantly built without the need of a skill or tool.	boolean
Health Panel Cheat	Checkbox that determines whether the debug options inside the health panel are available.	boolean
Moveable Cheat	Checkbox that determines whether all moveables can be instantly moved/rotated without the need of a skill or tool.	boolean
Mechanics Cheat	Checkbox that determines whether the debug options inside the mechanics menu are available.	boolean

Climate debuggers

This article may be outdated.

Editors are encouraged to update this article with new information.

The climate control panel

FX panel

This is opened by selecting "Other debuggers", then "WeatherFX Panel". Here you can play around with various values such as fog intensity, precipitation levels and precipitation type. Please note that to play around with these you will need to disable the ‘Climate’ manager or the simulated daily climate will overrule your changes.

Please also note that fog enabled through this method is for testing fog masking around buildings, and won’t look as good/varied as the fog generated by the virtual climate system – as it won’t take into account color or desaturation.

Climate view panels

The debug climate control and climate values panels can be accessed by selecting "Other debuggers", then "Weather plotter" and "Daily values" respectively. These panels provide a stockmarket-type graph of the current/recent weather over hours (H1), days (D1) and months (M1)

To see what values are running under the bonnet use the legend/panel on the right, and values turned on will be green. The climate values panel, meanwhile, displays additional info about seasons, cloud cover, etc.

These panels are overall for the provision of information, but that said when you toggle "airMass" on, when it crosses the 0 middle line you will see weather generated when airmass switches from hot/cold.

Thunder panel

This panel can be opened by selecting "Other debuggers", then "Thunderbug", but is only useful if there is a storm active. A geographical indication of where the storm is over the PZ map can be seen, as well as lightning locations.

Player's Stats

Access to player traits and skills interface.

Items List

Allows the spawning of any item in-game to the player's inventory.

Dev

isoRegions

The IsoRegions panel

This will display all buildings (including player-made) and can be used to detect when buildings are fully closed off from the PZ map – and as such will allow fog/precipitation to surround structures, but not appear within them. PLEASE NOTE: this is a real performance hog, so may well slow down the game when turned on.

Zombie Population

Shows all zombies as red dots on a map.

Stash debuggers

Allows the debugging of "annotated map" house stashes.

Anim monitor

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Zomboid Radio

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Animation Viewer

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Attachment Editor

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Chunk Debugger

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Global Objects

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Map Editor

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Vehicle Editor

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

World Flares

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Statistic

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

GlobalModData

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Contextual menus

There are new contextual menus availble in the debug mode available from right click menu.

Main

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

UIs

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Objects

Availble only when clicking some tiles.

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Zombies

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Brush Tool Manager

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Copy tile

This option allows to copy and then paste a tile that is right clicked. There is a submenu to select tile, handy if multiple tiles are present in the spot. A tile ID is also shown.

Destroy tile

This option allows to destroy a tile that is right clicked, similar to the sledgehammer, except it works on any kind of tiles. There is a submenu to select tile, handy if multiple tiles are present in the spot. A tile ID is also shown.

Item

Edit Item

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Destroy Item

Allows to destroy item permanently, similar to trash cans.

Map options

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Command console

Also known as Lua Console in options.

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Lua Debugger

The Lua Debugger can be accessed by pressing F11 by default (which can be rebound in options); 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.

Options

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Within the Lua Debugger menu there is an options menu with a long drop down, you can select from a variety of sources to help you find further information about your current session. Be careful with these options because some of them might cause your client to freeze and continuously crash upon launch. If this happens you can set the offending option to false in C:\Users\Username\Zomboid\debug-options.init.

DebugLog

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Errors

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Current Coroutine

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Lua file browser

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Watch Window

This article may need more content.

Editors are encouraged to add new material to the page while expanding upon current topics.

Lua Files

You can use the in-game Lua file browser to search for the .lua file you're modifying and select it where it will be updated in the above window. If you make changes to the file, you can hit the "reload file" button and it will attempt to apply the changes you made in-game, though this is often an unreliable way to test recently updated code.

Trivia

Glitches

• I'm getting sick of these Zomboid cars | Project Zomboid Multiplayer - Major glitch when driving.
• We Found the MOST CURSED Dog Mod in Project Zomboid - Dog opens doors by itself, but when it jumps over a fence, it is majorly and hilariously glitched.

Gallery

• 

  Cemetery parking lot with a glitch. Ranger vehicle is on the fence

• 

  Finding items in debug mode Military Research Facility

• 
• 
• 
• 
•