Saltearse al contenido
DarkBladeDev Docs

Centro de Documentación de CraftingEngine

Bienvenido a la documentación oficial de CraftingEngine, un motor extensible, modular y multicapa de procesos y estaciones de trabajo para servidores modernos de Minecraft (Paper y Purpur).

CraftingEngine une la comodidad del crafteo tradicional con una experiencia inmersiva en el mundo. Permite tanto crafteos instantáneos (incluyendo crafteo masivo con shift-click) como actividades avanzadas en el juego: forjar hojas de espada en yunques físicos mediante golpes rítmicos de martillo, ensamblar estructuras multibloque en 3D, elaborar elixires alquímicos complejos en calderos hirvientes y dominar minijuegos interactivos con barras de acción y hologramas flotantes.

Características Principales de Jugabilidad

+-----------------------------------------------------------------------------+
|                     ASPECTOS DESTACADOS DE JUGABILIDAD                      |
+-----------------------------------------------------------------------------+
|                                                                             |
|  [1. CRAFTEO POR ACCIONES MANUALES]                                         |
|  Golpea, enfría o cincela objetos colocados directamente sobre las          |
|  estaciones en el espacio 3D utilizando herramientas especializadas.        |
|                                                                             |
|  [2. ESTRUCTURAS MULTIBLOQUE 3D]                                            |
|  Construye hornos, altares y maquinaria industrial con previsualizaciones   |
|  virtuales de bloques fantasma que guían la colocación de bloques.          |
|                                                                             |
|  [3. HOLOGRAMAS FLOTANTES EN EL MUNDO]                                      |
|  Barras de progreso en tiempo real, temporizadores y listas de verificación |
|  flotan sobre las estaciones durante los procesos activos.                  |
|                                                                             |
|  [4. MENÚS DE INVENTARIO MATRICIALES]                                       |
|  Explora recetas disponibles, verifica ingredientes e inspecciona el avance  |
|  en interfaces gráficas personalizables de 9xN ranuras.                     |
|                                                                             |
|  [5. TRADUCCIONES NATIVAS (i18n)]                                           |
|  Todos los mensajes, descripciones de ítems y elementos de la interfaz se   |
|  muestran automáticamente en el idioma del cliente Minecraft del jugador.   |
|                                                                             |
+-----------------------------------------------------------------------------+

Terminología Central

  • Estación de Trabajo (Workstation): El bloque físico o estructura multibloque (ej. Yunque, Forja Rúnica, Caldero) donde se realiza el crafteo.
  • Proceso / Blueprint: Una secuencia de receta multicapa que consume o reserva entradas, verifica condiciones y produce salidas.
  • Etapa (Stage): Un paso diferenciado de crafteo (ej. Fundición →\rightarrow Martilleo →\rightarrow Templado →\rightarrow Afilado) con ramificaciones y rescate ante fallos.
  • Acción Manual: Golpear o interactuar con el bloque de la estación en el mundo usando la herramienta requerida.
  • Bloque Fantasma (Ghost Preview): Siluetas holográficas virtuales a nivel de paquetes que muestran cómo construir una estructura multibloque incompleta.
  • Capacidad y Política de Drenaje: Atributos modulares de estación (ej. calor, forja, presión) que pueden consumirse por uso o progresivamente por segundo.
  • Reserva Transaccional (InputMode.RESERVE): Aísla insumos en un búfer en memoria para garantizar cero pérdida de ítems ante desconexiones o reinicios del servidor.
  • Herencia de Propiedades: Copia, escala y evalúa declarativamente etiquetas PDC y atributos dinámicos de los ingredientes en los ítems producidos.