Inicia ou interrompe uma sessão de depuração. Enquanto ativo, inclui notificações sobre possíveis gargalos de desempenho no console. Quando interrompido, cria um arquivo de resultados do profiler na pasta "debug".
Sintaxe[]
debug start
- Inicia uma nova sessão de perfil de depuração.
debug stop
- Para a sessão ativa do criador de perfil de tempo de depuração.
debug function <name>
- Usado da mesma maneira que /function para obter informações mais detalhadas sobre a execução dos comandos.
Argumentos[]
<name>: function
- Isso deve ser um ID de espaço de nome, que se refere a uma única função ou prefixada com um
#, que se refere a uma função de tag.
Resultados[]
| Comando | Gatilho | Edição Java |
|---|---|---|
/debug start | uma sessão de depuração de perfil já foi iniciada | Falha |
/debug stop | não há sessão de depuração de perfil em execução. | |
/debug function | as funções ou tags de função especificadas não existem | |
| qualquer | Com sucesso | Inicia/interrompe a criação de perfil de depuração, ou obtenha informações mais detalhadas sobre a execução da função. |
Saída[]
| Comando | Edição | Situação | Contagem de sucesso | /execute store succeess ... | /execute store result ... |
|---|---|---|---|---|---|
| qualquer | Edição Java | Falha | N/A | 0 | 0 |
/debug start | On success | N/A | 1 | 0 | |
/debug stop | Com sucesso | N/A | 1 | a média de tps (ticks por segundo) durante o perfil de depuração | |
/debug function | Com sucesso | N/A | 1 | o número de comandos executados (com sucesso ou não) mais o número de funções incorporadas. Veja também Comandos/Function |
Estrutura de arquivo[]
Rastreamento de função[]
Ao usar /debug report, um arquivo txt com o título debug-trace-yyyy-MM-dd_HH.mm.ss.txt é criado na pasta .minecraft/debug.
Neste arquivo,
[C] <command>significa o<command>é executado.[M] <message>significa que uma mensagem é retornada.[E] <message>significa que uma mensagem de falha foi retornada.[R = <num>] <command>significa que<command>retorna um brigadier return value.[C] <command> -> <num>significa que<command>é executado e retorna um brigadier return value.[F] <function> size=<num>significa que uma função é chamada.
Para a maioria dos comandos, o brigadier return value é igual ao valor do resultado que pode ser armazenado com /execute store result.
Mas pelo /execute ... com um ou mais dos seguintes subcomandos, o brigadier return value é o número de vezes que o último subcomando é executado com sucesso:
... if ...(não no final)... unlesss ...(não no final)... as <targets> ...... at <targets> ...... positioned as <targets> ...... totated as <targets> ...... facing entity <targets> <anchor> ...
Resultado do perfil[]
Ao usar /debug stop, um arquivo txt com o título profile-results-yyyy-MM-dd_HH.mm.ss.txt é criado na pasta .minecraft/debug, que inclui o resultado do despejo de perfil.
Relatório[]
Ao usar /debug report, um arquivo ZIP é criado na pasta .minecraft/debug com a seguinte estrutura:
- debug-report-yyyy-MM-dd_HH.mm.ss.zip
- levels
- minecraft ou <outros espaço de nome personalizados>
- overworld ou the_end ou the_nether ou <outros espaço de nome personalizados>
- block_entities.csv: Contém uma lista de entidades de bloco no mundo no formato
x,y,z,type. - chunks.csv: Contém uma lista de informações de bloco no formato
x,z,level,in_memory,status,full_status,accessible_ready,ticking_ready,entity_ticking_ready,ticket,spawning,entity_count,block_entity_count. - entities.csv: Contém uma lista de entidades no mundo no formato
x,y,z,uuid,type,alive,custom_name. - example_crash.txt: Um exemplo de arquivo de travamento/falhas.
- stats.txt: Contém algumas estatísticas.
- block_entities.csv: Contém uma lista de entidades de bloco no mundo no formato
- overworld ou the_end ou the_nether ou <outros espaço de nome personalizados>
- minecraft ou <outros espaço de nome personalizados>
- classpath.txt: Contém os caminhos de arquivo dos jars externos que o Minecraft usa.
- example_crash.txt: Um exemplo de arquivo de travamento/falhas.
- gamerules.txt: Um arquivo de texto simples contendo uma lista de regras do jogo e seus valores (
<gamerule>=<value>). - stats.txt: Contém algumas estatísticas.
- threads.txt: Todos os tópicos em execução.
- levels
Histórico[]
| Edição Java | |||||
|---|---|---|---|---|---|
| 1.3.1 | 12w27a | Adicionado /debug. | |||
| 1.8 | 14w31a | /debug agora pode ser executado no modo single player. | |||
Adicionado /debug chunk. | |||||
| ? | Removido/debug chunk. | ||||
| 1.13 | 18w03a | Adicionado comandos ao profiler. | |||
| 1.14.4 | pre1 | Adicionado /debug report, usado para obter informações mais detalhadas durante a depuração de desempenho. | |||
| 1.17 | 21w15a | Adiiconado /debug function | |||
| Pre-release 1 | Removido /debug report. Substituído por F3+L e /perf. | ||||