Saltearse al contenido
DarkBladeDev Docs

Estaciones de Trabajo y Multibloques

Las estaciones de trabajo (workstations) son los lugares físicos en el mundo de Minecraft donde se llevan a cabo los procesos de crafteo. Se configuran como archivos YAML en plugins/CraftingEngine/stations/, vinculando bloques a capacidades, menús y patrones estructurales.

1. Arquitecturas de Estaciones

CraftingEngine admite tres arquitecturas de estación:

  1. SINGLE_BLOCK: Bloques vanilla o personalizados (ej. ANVIL, SMITHING_TABLE, o bloques de ExecutableBlocks eb:<id>).
  2. MULTIBLOCK: Estructuras volumétricas 3D compuestas por bloques dispuestos de forma precisa alrededor de un núcleo interactivo.
  3. FLUID_BASIN: Calderos alquímicos que albergan fluidos y reaccionan a fuentes térmicas (ver Calderos y Fluidos).

2. Configuración de Estación de Bloque Único

id: "blacksmith_anvil"
name: "<gradient:#b0bec5:#78909c>Yunque de Maestro Herrero</gradient>"
type: "SINGLE_BLOCK"


# Bloques coincidentes
blocks:
  - "ANVIL"
  - "CHIPPED_ANVIL"
  - "DAMAGED_ANVIL"


# Capacidades ofrecidas por esta estación
capabilities:
  - "forging"
  - high_temperature:
      drain:
        variable: "temperature"
        drain_per_second: 5.0
        drain_per_use: 10.0
        min_threshold: 200.0


# Comportamientos de interacción
open_gui_on_click: true
fallback_to_vanilla: true
close_gui_on_craft: false
cancel_on_gui_close: false

Opciones Destacadas

  • blocks: Lista de materiales Bukkit que actúan como esta estación.
  • capabilities: Capacidades que se otorgan a las recetas ejecutadas aquí. Admite:
    • Texto plano: Capacidad permanente (ej. - "forging").
    • Capacidad Consumible Estructurada (drain:): Regulada por CapabilityDrainPolicy, monitoreando una variable de estado, drenaje continuo por segundo/tick, deducción por uso al inicio y umbral mínimo operacional (ver Capacidades Modulares).
  • fallback_to_vanilla: Si es true, los clics que no coincidan con recetas de CraftingEngine abrirán la interfaz vanilla normal. Si es false, la interacción vanilla se intercepta por completo.
  • pdc_key: (Opcional) Exige que el bloque posea una clave PersistentDataContainer específica.

3. Estructuras Multibloque 3D

Permiten construir hornos industriales, altares rúnicos o santuarios mágicos:

       Capa 2 (Y = +1)                 Capa 1 (Y = 0) Núcleo
       +---+---+---+                   +---+---+---+
       | B | L | B |                   | S | M | S |
       +---+---+---+                   +---+---+---+
       | . | . | . |                   | M | C | M |  <-- (C = Yunque Núcleo)
       +---+---+---+                   +---+---+---+
       | B | L | B |                   | S | M | S |
       +---+---+---+                   +---+---+---+

Definición YAML de Multibloque

id: "example_runic_forge"
name: "<gradient:#ff4500:#ff8c00>Forja Rúnica Ancestral</gradient>"
type: "MULTIBLOCK"


capabilities:
  - "forging"
  - "high_temperature"
  - "runic_infusion"


multiblock:
  core_symbol: "C"
  allowed_rotations:
    - "NORTH"
    - "SOUTH"
    - "EAST"
    - "WEST"


  palette:
    "C": "ANVIL"
    "S": "STONE_BRICKS"
    "M": "MAGMA_BLOCK"
    "B": "IRON_BARS"
    "L": "SOUL_LANTERN"
    ".": "AIR"


  layers:
    - name: "base"
      pattern:
        - "S M S"
        - "M C M"
        - "S M S"
    - name: "upper_pillars"
      pattern:
        - "B . B"
        - "L . L"
        - "B . B"

Orientación y Comprobación en Vivo

  • Rotación Cardinal: Al incluir NORTH, SOUTH, EAST, WEST, CraftingEngine aplica matrices de rotación 2D (0∘,90∘,180∘,270∘0^\circ, 90^\circ, 180^\circ, 270^\circ) para verificar la estructura sin importar la dirección en la que mire el jugador.
  • Inspección en el Juego: Administradores con craftingengine.command.multiblock.check pueden mirar cualquier bloque y ejecutar /cfe multiblock check para validar la estructura al instante.

4. Previsualización con Bloques Fantasma

Al hacer clic derecho sobre el núcleo de una estructura incompleta, CraftingEngine envía paquetes virtuales con PacketEvents mostrando los bloques que faltan:

  • Cero Modificación del Mundo: Los bloques fantasma existen solo en la memoria del cliente; ningún bloque real del mundo es alterado.
  • Limpieza Automática: Desaparecen tan pronto como el jugador se aleja o completa la construcción.

Siguientes Pasos