/perf Command in Minecraft Java Edition

Run Performance Profiling on Minecraft Servers

Java EditionDebug & DeveloperPermission: Level 4Added in 1.17

The /perf command is a tool in Minecraft Java Edition that lets server owners control performance profiling. It has two main actions: starting the profiler and stopping it.

Server administrators use this command when they want to inspect server performance. Because it is a management tool, it requires the highest permission level to run.

Syntax (Java 26.3, 2 forms)

  1. /perf start
  2. /perf stop

The forms you will use most

/perf start
Starts a performance profiling session.
/perf stop
Stops a currently running performance profiling session.

Examples

Version history

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

  1. 1.17 Command added.

Tips

Common mistakes

Java vs Bedrock

Minecraft Bedrock Edition does not have a /perf command, as this feature is exclusive to Java Edition.

FAQ

What permission level is needed for the /perf command?

You need permission level 4, which is reserved for the server owner, to use the /perf command.

When was the /perf command added to Minecraft?

The /perf command was added to Minecraft Java Edition in version 1.17.

Can I use /perf in Minecraft Bedrock Edition?

No, Bedrock Edition has no command with this name.

Related commands

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

More on 9Minecraft