Commands/debug

Starts or stops a time profiler session. Gets more detailed information of function execution.
== Syntax ==
debug start
: Starts a new debug time profiler session.
debug stop
: Stops the active debug time profiler session.
debug function <name>
: Used the same way as /function to get more detailed information of commands' execution.
== Arguments ==
: 
== Result ==
== Output ==
== File structure ==
=== Function trace ===
When using , a txt file titled debug-trace-yyyy-MM-dd_HH.mm.ss.txt is created in .minecraft/debug.
In this file,
*[C] <command> means the <command> is executed.
*[M] <message> means a message is returned.
*[E] <message> means a failure message is returned.
*[R = <num>] <command> means the <command> returns a brigadier return value.
*[C] <command> -> <num> means the <command> is executed and returns a brigadier return value.
*[F] <function> size=<num> means a function is called.
For most of commands, the brigadier return value is equal to the result value that can be stored with /execute store result.
But for /execute ... with one or more of the following subcommands, the brigadier return value is the number of times that the last subcommand is executed successfully:
* ... if ... (not at the end)
* ... unlesss ... (not at the end)
* ... as <targets> ...
* ... at <targets> ...
* ... positioned as <targets> ...
* ... totated as <targets> ...
* ... facing entity <targets> <anchor> ...
=== Profile result ===
When using , a txt file titled profile-results-yyyy-MM-dd_HH.mm.ss.txt is created in .minecraft/debug, which includes the result of profile dump.
=== Report ===
When using , a ZIP file is created with in .minecraft/debug/profiling the following structure:
* debug-report-yyyy-MM-dd_HH.mm.ss.zip
** levels
*** minecraft or <other custom namespaces>
**** overworld or the_end or the_nether or <other custom dimensions>
***** 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 .
***** entities.csv: Contains a list of entities in the world in the format .
***** example_crash.txt: An example crash file.
***** stats.txt: Contains some stats.
** classpath.txt: Contains the file paths of the external jars Minecraft uses.
** example_crash.txt: An example crash file.
** gamerules.txt: A plain text file containing a list of game rules and their values (<gamerule>=<value>).
** stats.txt: Contains some stats.
** threads.txt: All running threads.
== History ==
de:Befehl/debug
es:Comandos/debug
pt:Comandos/debug
zh:命令/debug