Start a 10 second run
/perf startRecords performance for 10 seconds, then saves the report.
/perf command in Minecraft
/perf records the server performance for 10 seconds and saves a debug report. Server admins and data pack authors use it to see what takes time in each tick, then study or share the report to fix lag.
Syntax
/perf start/perf stop// Only on a dedicated server: the command does not exist in single player or in a world opened to LAN.
Examples
Stop the run early
/perf stopEnds the run before 10 seconds and saves the report.
Build your commandFill in the fields, then copy the command.
Command generatorHow it works
perf start launches a 10 second run that stops by itself; perf stop ends it early if you already have what you need. The chat then shows the recorded seconds, ticks and ticks per second, followed by Created debug report in and the location of the report.
Good to know
/perf needs permission level 4. Only one run at a time: a second start answers The performance profiler is already started. For a recording with no time limit, use /debug or the more detailed /jfr.
✓ Checked in Java Edition 26.3 · updated 2 November 2026
/perf: FAQ
How long does /perf record?
10 seconds, then it stops by itself and saves the report. Run /perf stop to end it sooner.
What does "The performance profiler hasn't started" mean?
You ran /perf stop while no run was active. Start one with /perf start first.
How do I use /perf?
On a server, as an operator or from the server console: /perf start. It does not exist in single player.
Who can use /perf?
Server owner or console, level 4. Only on a dedicated server: the command does not exist in single player or in a world opened to LAN.
Since when does /perf exist?
It is in the official command tree since Java Edition 1.17.