How to Use the Debug Command in Minecraft

This Minecraft tutorial explains how to use the /debug command with screenshots and step-by-step instructions.

You can use the /debug command to start or stop a debug profiling session in Minecraft. Let's explore how to use this cheat (game command).

Supported Platforms

The /debug command is available in the following versions of Minecraft:

PlatformSupported (Version*)
Java Edition (PC/Mac) Java Edition (PC/Mac)Yes (1.3.1)
Pocket Edition (PE) Pocket Edition (PE)No
Xbox 360 Xbox 360No
Xbox One Xbox OneNo
PS3 PS3No
PS4 PS4No
Wii U Wii UNo
Nintendo Switch Nintendo SwitchNo
Windows 10 Edition Windows 10 EditionNo
Education Edition Education EditionNo

* The version that it was added or removed, if applicable.
NOTE: Pocket Edition (PE), Xbox One, PS4, Nintendo Switch, and Windows 10 Edition are now called Bedrock Edition. We will continue to show them individually for version history.

Requirements

To run game commands in Minecraft, you have to turn cheats on in your world.

Debug Command

Where is the Debug File Stored?

Depending on your version of Minecraft, you would find the debug file under one of the following hidden paths (Note: path may be different on your system):

Path for Windows
C:\Users\<username>\AppData\Roaming\.minecraft\debug\
Path for Mac
/Users/<username>/Library/Application Support/minecraft/debug/
What is the Debug File Called?

Once the debug session has stopped, the game will create a debug file with a name formatted with the date and time as follows:

profile-results-yyyy-mm-dd_hh.mi.ss.txt

For example, the debug file could be called:

profile-results-2017-07-29_10.12.41.txt

How to Enter the Command

1. Open the Chat Window

The easiest way to run a command in Minecraft is within the chat window. The game control to open the chat window depends on the version of Minecraft:

  • For Java Edition (PC/Mac), press the T key to open the chat window.

2. Type the Command

In this example, we will start the debug session with the following command:

/debug start

Type the command in the chat window. As you are typing, you will see the command appear in the lower left corner of the game window. Press the Enter key to run the command.

debug command

Once the cheat has been entered, you will see the message "Started debug profiling" appear in the lower left corner of the game window to indicate that the debug session has started.

debug command

Type the following command to stop the debug session:

/debug stop

You will see the message "Stopped debug profiling after 18.40 seconds (368 ticks)" appear in the lower left corner of the game window to indicate that the debug session has stopped. This message displays the length of time in both seconds and game ticks that the debug session ran.

completed debug command

Once the debug session has stopped, the game will create a debug file. In this tutorial, the debug file is called profile-results-2017-07-29_10.12.41.txt and contains the following debug information:

---- Minecraft Profiler Results ----
// DigMinecraft Example

Time span: 18401 ms
Tick span: 368 ticks --- BEGIN PROFILE DUMP --- [00] levels - 98.64%/98.64% [01] | DigMincraft World - 99.86%/98.51% [02] | | tick - 98.88%/97.40% [03] | | | entities - 57.11%/55.63% [04] | | | | regular - 98.83%/54.98% [05] | | | | | tick - 97.26%/53.48% [06] | | | | | | ai - 32.57%/17.42% [07] | | | | | | | newAi - 95.49%/16.63% ... more results here, removed for this tutorial ... [00] tallying - 0.00%/0.00% --- END PROFILE DUMP ---

Congratulations, you just learned how to use the /debug command in Minecraft!