Saltearse al contenido
DarkBladeDev Docs

Creando tu Primer Proceso

Este tutorial explica paso a paso cómo crear tu primer blueprint de crafteo personalizado utilizando el esquema YAML unificado de CraftingEngine.

1. Creación del Archivo de Blueprint

Crea un archivo llamado copper_dagger.yml dentro de la carpeta plugins/CraftingEngine/processes/:

id: "copper_dagger"
name: "<gradient:#e57373:#d32f2f>Daga de Cobre Ancestral</gradient>"


# Gestión de fallos: devuelve los ingredientes si el jugador cancela o se agota el tiempo
policies:
  failure: "REFUND_INPUTS"
  obtaining: "DROP_IN_INVENTORY"


# Requisitos de estación y capacidades
requirements:
  capabilities:
    - "forging"
  stations:
    - "blacksmith_anvil"
    - "minecraft:anvil"


# Materiales consumibles requeridos en el inventario o ranuras de la estación
inputs:
  - resource: "minecraft:copper_ingot"
    display: "<gradient:#e57373:#d32f2f>Lingote de Cobre Templado</gradient>"
    quantity: 2
    mode: "CONSUME"
  - resource: "minecraft:stick"
    quantity: 1
    mode: "CONSUME"


# Herramienta requerida en la mano principal (no se consume)
tools:
  - resource: "minecraft:iron_pickaxe"
    display: "Martillo de Herrero"
    quantity: 1


# Activación: clic derecho en la estación para comenzar
triggers:
  - type: "INTERACTION"


# Secuencia de etapas
stages:
  - id: "shaping"
    duration: "3s"
    on_start:
      - action: "play_sound(block.anvil.use)"
      - action: "spawn_particle(CRIT, 5, 0.2, 0.5, 0.2)"
    transitions:
      - target_stage: "sharpening"


  - id: "sharpening"
    duration: "2s"
    on_start:
      - action: "play_sound(block.grindstone.use)"
    on_complete:
      - action: "play_sound(ui.toast.challenge_complete)"


# Recompensa final
outputs:
  - resource: "minecraft:stone_sword"
    display: "<gradient:#e57373:#d32f2f><b>Daga de Cobre Afilada</b></gradient>"
    quantity: 1
    type: "SUCCESS"

2. Desglose del Blueprint

  • id: Identificador único en formato kebab-case o snake_case en todo el servidor.
  • name: Título formateado con etiquetas MiniMessage de Adventure (gradientes, negritas, colores hex).
  • requirements: Define qué capacidades (ej. forging) o estaciones específicas requiere la receta.
  • inputs: Ítems necesarios para el proceso. Con mode: CONSUME se retiran; con mode: PRESERVE se conservan (útil para moldes o planos).
  • tools: Herramientas que el jugador debe sostener en la mano activa.
  • stages: Las etapas de progreso. En este ejemplo, el crafteo ejecuta una etapa de shaping de 3 segundos, salta automáticamente a sharpening durante 2 segundos y activa efectos visuales y sonoros.
  • outputs: Los objetos finales otorgados al finalizar con éxito todas las etapas.

3. Recarga y Validación en el Juego

Guarda el archivo y compruébalo sin reiniciar el servidor:

Ventana de terminal
/cfe reload processes
/cfe recipe info copper_dagger
/cfe recipe validate copper_dagger

Si el comando reporta PASSED, acércate a un yunque con 2 lingotes de cobre y 1 palo, equipa un pico de hierro en la mano y haz clic derecho en el yunque para iniciar el proceso.

Siguientes Pasos