Minecraft:Commands/perf: Difference between revisions

Revision as of 15:44, 9 April 2026

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 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 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 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.

Result

Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table

Outputs

Template:Output table Template:Output table Template:Output table Template:Output table

History

Template:HistoryTable

Navigation

Template:Navbox commands

de:Befehl/perf ja:コマンド/perf lzh:令/perf zh:命令/perf

@@ Line 22: / Line 22: @@
 **** '''''<namespace>'''''
 ***** '''<dimension name>'''
-****** '''block_entities.csv''': Contains a list of [[Minecraft:block entities]] in the world in the format <code>x,y,z,type</code>.
+****** '''block_entities.csv''': Contains a list of block entities in the world in the format <code>x,y,z,type</code>.
 ****** '''chunks.csv''': Contains a list of chunk information in the format {{cd|x,z,level,in_memory,status,full_status,accessible_ready,ticking_ready,entity_ticking_ready,ticket,spawning,entity_count,block_entity_count}}.
-****** '''entities.csv''': Contains a list of [[Minecraft:entities]] in the world in the format {{cd|x,y,z,uuid,type,alive,custom_name}}.
+****** '''entities.csv''': Contains a list of entities in the world in the format {{cd|x,y,z,uuid,type,alive,custom_name}}.
 ****** '''entity_chunks.csv''': Contains a list of loaded chunks in the dimension in the format {{cd|x,y,z,visibility,load_status,entity_count}}.
 ****** '''example_crash.txt''': An example crash file.
@@ Line 35: / Line 35: @@
 **** '''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 rule]]s and their values (<code><gamerule>=<value></code>).
+*** '''gamerules.txt''': A plain text file containing a list of game rules and their values (<code><gamerule>=<value></code>).
 *** '''modules.txt''': Contains external modules the game is using.
 *** '''profiling.txt''': The profiler results.
@@ Line 72: / Line 72: @@
 {{Navbox commands}}
-[[Minecraft:de:Befehl/perf]]
+de:Befehl/perf
-[[Minecraft:ja:コマンド/perf]]
+ja:コマンド/perf
-[[Minecraft:lzh:令/perf]]
+lzh:令/perf
-[[Minecraft:zh:命令/perf]]
+zh:命令/perf