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.

Problema 4: “El crafteo se cancela con ‘Station capability exhausted’ o salta a rescate”

  • Causa: La capacidad consumible de la estación (ej. high_temperature, steam_pressure) cayó por debajo de su umbral mínimo (min_threshold) mientras la etapa avanzaba (regulado por CapabilityDrainPolicy).
  • Solución: Reabastece el recurso de la estación (añade combustible, bombea fluido) o ajusta drain_per_second, drain_per_use o min_threshold en stations/*.yml.

Problema 5: “¿Se pierden los insumos reservados si el servidor se reinicia o se recarga?”

  • Causa: En recetas con mode: RESERVE (v2.8.0+), los ítems se aíslan en memoria durante la ejecución.
  • Solución: Se garantiza cero pérdida de ítems. ItemReservationManager escucha los eventos de apagado del servidor, recarga del plugin (onDisable) y desconexión de jugadores para devolver de inmediato todos los ítems reservados al inventario o arrojarlos de forma natural al suelo (world.dropItemNaturally).

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

CraftingEngine incorpora una “caja negra” de telemetría en memoria (ProcessFlightRecorder) que registra la cronología exacta y con precisión de microsegundos de los procesos activos y terminados.

Inspección de Trazas mediante Comandos

Ventana de terminal
/cfe process list                        # Muestra UUIDs de procesos activos o terminados recientemente
/cfe process trace <uuid> [límite]       # Muestra la línea de tiempo cronológica interactiva en MiniMessage
/cfe process trace export <uuid>         # Vuelca el registro estructurado en JSON a plugins/CraftingEngine/traces/
/cfe process info <uuid>                 # Información resumida con botones interactivos [Trace Timeline] y [Export Trace]

Datos Registrados y Tipos de Eventos:

  • Ciclo de Vida de Proceso: PROCESS_START, PROCESS_COMPLETE, PROCESS_CANCEL, PROCESS_FAIL.
  • Transiciones y Ramificaciones: Muestra distintivos de colores:
    • [BRANCH 20/100]: Selección probabilística de ramas por peso.
    • [JUMP]: Salto explícito de etapa provocado por Action DSL (transition: "<stageId>").
    • [RECOVERY]: Etapa fallida derivada a failure_transition.
    • [TIMEOUT]: Transición secuencial tras cumplirse la duración programada.
  • Capacidades de Estación (v2.7.0):
    • CAPABILITY_DRAINED: Cantidad drenada, saldo restante y clave de variable.
    • CAPABILITY_EXHAUSTED: Se activa si la variable desciende por debajo de min_threshold.
  • Reserva Transaccional de Insumos (v2.8.0):
    • INPUT_RESERVED: Ítems trasladados al búfer aislado de reserva al iniciar el crafteo.
    • INPUT_RELEASED: Ítems devueltos de forma segura ante cancelación o fallo.
    • INPUT_COMMITTED: Ítems destruidos definitivamente al completar con éxito.
  • Herencia de Propiedades de Ingredientes (v2.9.0):
    • Captura etiquetas PDC de los insumos y registra el cálculo de expresiones y atributos resultantes.

3. Resumen de Comandos de Diagnóstico

ComandoFinalidad
/cfe statusMuestra el estado global, memoria utilizada, registros cargados y estado del programador de ticks.
/cfe recipe validate-allComprueba todos los blueprints en busca de errores tipográficos, materiales ausentes y fallos topológicos.
/cfe multiblock checkAnaliza el bloque objetivo para detectar fallos en la estructura multibloque y rotación cardinal.
/cfe item inspectMuestra los identificadores de espacio de nombres, CustomModelData y claves PDC del ítem que sostienes.
/cfe process trace <uuid>Inspecciona la línea de tiempo de ejecución del grabador de vuelo en tiempo real o histórico.
/cfe process trace export <uuid>Exporta de forma asíncrona el volcado completo de la traza a disco en formato JSON.

4. Canales de Soporte

Si encuentras fallos o comportamientos anómalos: