Advertisement

Comandos/debug

Esse artigo fala sobre comando. Para outros usos, veja Depuração.
Esse recurso é exclusivo para Edição Java. 
debug
Nível de permissão
requirido

3

Restrições

Sem blocos de comandos

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

Syntax

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 /função para obter informações mais detalhadas sobre a execução dos comandos.

Argumentos

<name>: função

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

ComandoGatilhoEdição Java
/debug startuma sessão de depuração de perfil já foi iniciada Falha
/debug stopnão há sessão de depuração de perfil em execução.
/debug functionas funções ou tags de função especificadas não existem
qualquerCom sucessoInicia/interrompe a criação de perfil de depuração,
ou obtenha informações mais detalhadas sobre a execução da função.

Saída

ComandoEdiçãoSituaçãoContagem de sucesso/execute store succeess .../execute store result ...
qualquerEdição JavaFalhaN/A00
/debug startOn successN/A10
/debug stopCom sucessoN/A1a média de tps (ticks por segundo) durante o perfil de depuração
/debug functionCom sucessoN/A1o número de comandos executados (com sucesso ou não) mais o número de funções incorporadas. Veja também Comandos/Fução

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

Essa seção descreve o conteúdo que existe apenas em versões desatualizadas de Minecraft. 
Esse recurso costumava estar no jogo, mas foi removido

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

Essa seção descreve o conteúdo que existe apenas em versões desatualizadas de Minecraft. 
Esse recurso costumava estar no jogo, mas foi removido

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

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.
O conteúdo da comunidade está disponível sob CC BY-NC-SA 3.0 salvo indicação em contrário.