Saltearse al contenido
DarkBladeDev Docs

Diagnóstico, Preguntas Frecuentes y Grabador de Vuelo

Esta guía aborda los problemas más habituales de configuración y uso, errores de validación y la herramienta de telemetría Process Flight Recorder incorporada en la versión v2.5.0.

1. Problemas Comunes y Soluciones

Problema 1: “La estación no se reconoce” o abre el yunque vanilla

  • Causa: El material del bloque no coincide con blocks: en stations/*.yml, o fallback_to_vanilla: true está cediendo el control a la interfaz de Minecraft.
  • Solución: Ejecuta /cfe station list para confirmar que la estación cargó. Asegúrate de que el material sea el exacto de Bukkit. Si usas etiquetas personalizadas, comprueba que la clave PDC coincida con pdc_key:.

Problema 2: “El crafteo no inicia al hacer clic”

  • Causa: Falta la herramienta requerida en la mano, faltan ingredientes o no se alcanzan las capacidades exigidas (ej. temperatura insuficiente).
  • Solución: Ejecuta /cfe recipe info <id_receta> para revisar los requisitos. Usa /cfe status para inspeccionar las capacidades activas en la estación.

Problema 3: “No se ven los bloques fantasma del multibloque”

  • Causa: PacketEvents no está instalado o se encuentra deshabilitado.
  • Solución: Asegúrate de contar con PacketEvents v2.14.0+ en la carpeta plugins/ y revisa los logs de arranque del servidor.

2. Grabador de Vuelo de Procesos (Process Flight Recorder)

CraftingEngine incorpora una “caja negra” en memoria que registra la cronología exacta de cada proceso de crafteo.

Inspección de Trazas

Ventana de terminal
/cfe process list                    # Muestra los UUIDs de procesos activos o recientes
/cfe process info <uuid_proceso>     # Imprime la traza cronológica detallada

Datos Registrados en la Telemetría:

  • Inicio del Proceso: UUID del jugador, coordenadas de la estación e ID del blueprint.
  • Transiciones de Etapa: Duración en cada etapa, pesos probabilísticos evaluados y ramas de recuperación elegidas.
  • Acciones del Jugador: Marcas de tiempo de los golpes, puntuación de minijuegos y cumplimiento de cooldowns.
  • Ciclo de Vida de Recursos: Momento exacto en que los ingredientes fueron consumidos, devueltos o transformados.

3. Resumen de Comandos de Diagnóstico

ComandoFinalidad
/cfe statusMuestra el estado global, memoria utilizada y cantidad de elementos cargados.
/cfe recipe validate-allComprueba todos los blueprints en busca de errores de sintaxis o materiales ausentes.
/cfe multiblock checkAnaliza el bloque objetivo para detectar fallos en la estructura multibloque.
/cfe item inspectMuestra los identificadores y espacios de nombres del ítem que sostienes en la mano.

4. Canales de Soporte

Si encuentras fallos o comportamientos anómalos: