Minecraft:Commands/perf

Template:Infobox command Captures information and metrics about the game such as tick durations, used heap sizes, and other more detailed stats.

Note that this command can only be executed on a dedicated server; use Template:Key run the performance profiler on a locally hosted world.

Usage

When a performance profiling session is stopped, a ZIP file is created in .minecraft/debug/profiling with the following structure:

• yyyy-MM-dd_HH.mm.ss-<world name>-<game version>.zip
  • system.txt
  • server
    • deviations
      • ticktime
        • <current tick>@yyyy-MM-dd_HH.mm.ss.SSS.txt
    • levels
      • <namespace>
        • <dimension name>
          • block_entities.csv: Contains a list of Minecraft:block entities in the world in the format x,y,z,type.
          • chunks.csv: Contains a list of chunk information in the format Template:Cd.
          • entities.csv: Contains a list of Minecraft:entities in the world in the format Template:Cd.
          • entity_chunks.csv: Contains a list of loaded chunks in the dimension in the format Template:Cd.
          • example_crash.txt: An example crash file.
          • stats.txt: Contains some stats.
    • metrics
      • cpu.csv
      • event_loops.csv
      • jvm.csv
      • mailboxes.csv
      • ticking.csv
    • classpath.txt: Contains file paths of external jars the game is using.
    • gamerules.txt: A plain text file containing a list of Minecraft:game rules and their values (<gamerule>=<value>).
    • modules.txt: Contains external modules the game is using.
    • profiling.txt: The profiler results.
    • server.properties.txt: Current Minecraft:server.properties.
    • stats.txt: Contains some stats.
    • threads.txt: All running threads.

Syntax

perf start

Starts a 10-second performance profiling recording.

perf stop

Ends the recording early before 10 seconds have passed.