Comandos / depuración

Quien soy
Judit Llordes
@juditllordes
Autor y referencias
Este artículo trata sobre el comando. Para otros usos, consulte Depurar. Esta función es exclusiva de Java Edition.  depurar
Nivel de permiso
son requeridos

3



Restricciones

Sin bloques de mando

Inicia o detiene una sesión de depuración. Mientras está activo, incluye notificaciones sobre posibles cuellos de botella de rendimiento en la consola. Cuando se detiene, crea un archivo de resultados del generador de perfiles en la carpeta "debug".

Contenido

  • 1 Sintaxis
  • 2 Argumentos
  • 3 Resultado
  • salida 4
  • 5 Estructura de archivos
    • 5.1 Seguimiento de funciones
    • 5.2 Resultado del perfil
    • Informe 5.3
  • Historia de 6

Sintaxis

inicio de depuración

Inicia una nueva sesión del generador de perfiles de tiempo de depuración.

parada de depuración

Detiene la sesión activa del generador de perfiles de tiempo de depuración.

función de depuración

Se usa de la misma manera que / function para obtener información más detallada de la ejecución de los comandos.

Argumentos

: función


Debe ser una ubicación de recurso, que se refiere a una sola función, o una con el prefijo #, que se refiere a una etiqueta de función.

Resultado


ComandoDesencadenarEdición Java
/ debug startya se ha iniciado una sesión de depuración de perfiles Fallidos
/ debug stopno se está ejecutando una sesión de depuración de perfiles.
/ función de depuraciónlas funciones o etiquetas de función especificadas no existen
cualquierSobre el éxitoInicia / detiene la generación de perfiles de depuración,
u obtenga información más detallada sobre la ejecución de la función.

Salida

ComandoEdiciónSituaciónRecuento de éxitos/ ejecutar el éxito de la tienda .../ ejecutar el resultado de la tienda ...
cualquierEdición JavaAl fallarN/A00
/ debug startSobre el éxitoN/A10
/ debug stopSobre el éxitoN/A1el promedio de tps (ticks por segundo) durante la generación de perfiles de depuración
/ función de depuraciónSobre el éxitoN/A1el número de comandos ejecutados (con éxito o no) y también el número de funciones integradas. Comandos / función

Estructura de archivo

Seguimiento de función

Al usar / debug report, un archivo txt titulado debug-trace-aaaa-MM-dd_HH.mm.ss.txt se crea en .minecraft / debug.


En este archivo,

  • [C] significa el es ejecutado.
  • [METRO] significa que se devuelve un mensaje.
  • [MI] significa que se devuelve un mensaje de error.
  • [R = ] significa el devuelve un valor de retorno del brigadier.
  • [C] -> significa el se ejecuta y devuelve un valor de retorno del brigadier.
  • [F] tamaño = significa que se llama a una función.

Para la mayoría de los comandos, valor de retorno del brigadier es igual al valor de resultado que se puede almacenar con / execute store result.


Pero para / ejecutar ... con uno o más de los siguientes subcomandos,la valor de retorno del brigadier es el número de veces que el último subcomando se ejecuta con éxito:

  • ... si ... (no al final)
  • ... a menos que ... (no al final)
  • ... como ...
  • ... a ...
  • ... posicionado como ...
  • ... totalizado como ...
  • ... entidad enfrentada ...

Resultado del perfil

Esta sección describe el contenido que existe solo en versiones desactualizadas de Minecraft.  Esta característica solía estar en el juego, pero desde entonces se ha eliminado.

Al usar / debug stop, un archivo txt titulado perfil-resultados-aaaa-MM-dd_HH.mm.ss.txt se crea en .minecraft / debug, que incluye el resultado del volcado de perfil.



Reportar

Esta sección describe el contenido que existe solo en versiones desactualizadas de Minecraft.  Esta característica solía estar en el juego, pero desde entonces se ha eliminado.

Cuando se usa / debug report, se crea un archivo ZIP con .minecraft / debug con la siguiente estructura:

  • debug-report-yyyy-MM-dd_HH.mm.ss.zip
      • Minecraft or
        • supramundo or el fin or el inferior or
          • block_entities.csv: Contiene una lista de entidades de bloque en el mundo en el formato x, y, z, tipo.
          • chunks.csv: Contiene una lista de información de fragmentos en el formato x, z, nivel, in_memory, status, full_status, access_ready, ticking_ready, entity_ticking_ready, ticket, spawning, entity_count, block_entity_count.
          • entidades.csv: Contiene una lista de entidades en el mundo en el formato x, y, z, uuid, type, alive, custom_name.
          • example_crash.txt: Un ejemplo de archivo de bloqueo.
          • stats.txt: Contiene algunas estadísticas.
    • classpath.txt: Contiene las rutas de archivo de los archivos jar externos que usa Minecraft.
    • example_crash.txt: Un ejemplo de archivo de bloqueo.
    • gamerules.txt: Un archivo de texto sin formato que contiene una lista de las reglas del juego y sus valores ( = ).
    • stats.txt: Contiene algunas estadísticas.
    • threads.txt: Todos los subprocesos en ejecución.

Historia

Edición Java
1.3.112w27aAgregado / depurado.
1.814w31a/ debug ahora se puede ejecutar en un solo jugador.
Agregado / depurado.
?Eliminado / depurado.
1.1318w03aSe agregaron comandos al generador de perfiles.
1.14.4pre1Informe agregado / de depuración, utilizado para obtener información más detallada mientras se depura el rendimiento.
1.1721w15aFunción agregada / depurada
Prelanzamiento 1Informe eliminado / depurado. Reemplazado por F3 + L y / perf.

Comandos

Ver en: Plantilla: Comandos / contenido [editar]

Añade un comentario de Comandos / depuración
¡Comentario enviado con éxito! Lo revisaremos en las próximas horas.