/debug Command in Minecraft Java Edition

Run Debug Sessions and Test Data Pack Functions

Java EditionDebug & DeveloperPermission: Level 3

The /debug command lets server admins start and stop debugging sessions or run debug checks on data pack functions in Minecraft Java Edition. It requires permission level 3, so only server admins and operators with the right permissions can use it.

Players and map makers mainly use this command when creating custom data packs or checking server status. You can use it to start a session, stop a session, or target a specific function or function tag.

Syntax (Java 26.3, 3 forms)

  1. /debug function <name>
  2. /debug start
  3. /debug stop

The forms you will use most

/debug start
Starts a new debug session.
/debug stop
Stops the currently running debug session.
/debug function <name>
Runs a debug check on a specific function or function tag from a data pack.

Arguments

ArgumentTypeWhat it means
<name>functionSpecifies a function or a #function tag from an active data pack.

Examples

Version history

Measured from the game files of every Java release from 1.13 to 26.3.

  1. 1.17 Syntax changed.
    + /debug function <name>− /debug report
  2. 1.14.4 Syntax changed.
    + /debug report
  3. 1.13 Already in the game in 1.13, the oldest Java version we track.

Tips

Common mistakes

Java vs Bedrock

Minecraft Bedrock Edition does not have a command with the name /debug. This command is only available in Minecraft Java Edition.

FAQ

Who has permission to use the /debug command?

You need permission level 3 (Server admin) to run the /debug command in Minecraft Java Edition.

Why does /debug report not work anymore?

The /debug report syntax was added in Java Edition 1.14.4, but it was removed in version 1.17 when /debug function <name> was introduced.

Can I use /debug in Minecraft Bedrock Edition?

No, Bedrock Edition has no command with this name, so you can only use it in Java Edition.

Related commands

/compute/help/jfr/perf/stopwatch/test/tick/version

More on 9Minecraft