Minecraft:Commands/perf: Difference between revisions
More actions
Remove broken links to missing pages |
Fix template calls: add MC/ prefix |
||
| Line 1: | Line 1: | ||
{{ | {{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 {{ | 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 23: | Line 23: | ||
***** '''<dimension name>''' | ***** '''<dimension name>''' | ||
****** '''block_entities.csv''': Contains a list of 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 {{ | ****** '''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 entities in the world in the format {{ | ****** '''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 {{ | ****** '''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 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 {{ | |{{HistoryLine||1.17|dev=Pre-release 1|Added {{MC/Cmd|perf|link=none}}.}} | ||
}} | }} | ||
== Navigation == | == Navigation == | ||
{{Navbox commands}} | {{MC/Navbox commands}} | ||
de:Befehl/perf | de:Befehl/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
- 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
- ticktime
- 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
- block_entities.csv: Contains a list of block entities in the world in the format
- <dimension name>
- <namespace>
- deviations
- REDIRECT Template:Code
- entities.csv: Contains a list of entities in the world in the format
- REDIRECT Template:Code
- entity_chunks.csv: Contains a list of loaded chunks in the dimension in the format
- REDIRECT Template:Code
- 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
de:Befehl/perf ja:コマンド/perf lzh:令/perf zh:命令/perf