Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Minecraft:Commands/perf: Difference between revisions

From SAS Gaming Wiki
imported>Beelover
m Improve wording
 
SyncBot (talk | contribs)
Fix template calls: add MC/ prefix
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{exclusive|java}}
{{MC/Exclusive|java}}


{{Infobox command
{{Infobox command
Line 8: Line 8:
Captures information and metrics about the game such as tick durations, used heap sizes, and other more detailed stats.
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 {{key|F3+L}} run the performance profiler on a locally hosted world.
Note that this command can only be executed on a dedicated server; use {{MC/Key|F3+L}} run the performance profiler on a locally hosted world.


== Usage ==
== Usage ==
Line 22: Line 22:
**** '''''<namespace>'''''
**** '''''<namespace>'''''
***** '''<dimension name>'''
***** '''<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}}.
****** '''chunks.csv''': Contains a list of chunk information in the format {{MC/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 {{MC/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}}.
****** '''entity_chunks.csv''': Contains a list of loaded chunks in the dimension in the format {{MC/Cd|x,y,z,visibility,load_status,entity_count}}.
****** '''example_crash.txt''': An example crash file.
****** '''example_crash.txt''': An example crash file.
****** '''stats.txt''': Contains some stats.
****** '''stats.txt''': Contains some stats.
Line 35: Line 35:
**** '''ticking.csv'''
**** '''ticking.csv'''
*** '''classpath.txt''': Contains file paths of external jars the game is using.
*** '''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.
*** '''modules.txt''': Contains external modules the game is using.
*** '''profiling.txt''': The profiler results.
*** '''profiling.txt''': The profiler results.
Line 58: Line 58:


== Outputs ==
== Outputs ==
{{Output table}}
{{MC/Output table}}
{{Output table|edition=je|On fail|N/A|0|0}}
{{MC/Output table|edition=je|On fail|N/A|0|0}}
{{Output table|On success|N/A|1|0}}
{{MC/Output table|On success|N/A|1|0}}
{{Output table}}
{{MC/Output table}}


== History ==
== History ==
{{HistoryTable
{{HistoryTable
|{{HistoryLine|java}}
|{{MC/HistoryLine|java}}
|{{HistoryLine||1.17|dev=Pre-release 1|Added {{cmd|perf|link=none}}.}}
|{{HistoryLine||1.17|dev=Pre-release 1|Added {{MC/Cmd|perf|link=none}}.}}
}}
}}


== Navigation ==
== Navigation ==
{{Navbox commands}}
{{MC/Navbox commands}}


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

Latest revision as of 20:12, 9 April 2026

Script error: No such module "Exclusive".

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

  1. REDIRECT Template:Keys

Template:Redr 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
  1. REDIRECT Template:Code

Template:Redr.

            • entities.csv: Contains a list of entities in the world in the format
  1. REDIRECT Template:Code

Template:Redr.

            • entity_chunks.csv: Contains a list of loaded chunks in the dimension in the format
  1. REDIRECT Template:Code

Template:Redr.

            • 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

{{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

{{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|N/A}}{{#vardefine:output2-{{#var:output-table-lines}}|0}}{{#vardefine:output3-{{#var:output-table-lines}}|0}}{{#vardefine:command-row-{{#var:commands-num}}|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-editions-num|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-edition-{{#var:output-editions-num}}|je}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|N/A}}{{#vardefine:output2-{{#var:output-table-lines}}|1}}{{#vardefine:output3-{{#var:output-table-lines}}|0}}{{#vardefine:command-row-{{#var:commands-num}}|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|Expression error: Unrecognized punctuation character "{".}}

{{#vardefine:output-table-lines|Expression error: Unrecognized punctuation character "{".}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

History

Template:HistoryTable

Navigation

All editions
Removed
Template:El only
Debug
Removed
Template:Els only
Template:El only
Removed
Template:El only
Removed
Template:Els only
Removed
Joke
Related

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