GUI

Forge GUI files live in gui/ and usually include the main forge GUI, recipe book, and editor GUI. The GUI protects input slots, handles clicks, returns items, and starts the forge process.

Common areas

Area	Purpose
Blueprint slot	Holds or displays the required blueprint.
Target slot	Holds the equipment modified in target-input mode.
Material slots	Hold required and optional materials.
Preview slot	Shows possible output, quality pool, and risks.
Confirm button	Starts forging.
Back button	Returns to the recipe list or closes the menu.

Layout example

gui:
  title: '<dark_gray>Forge'
  rows: 6
  slots:
    blueprint: 10
    target: 13
    materials: [28, 29, 30, 31, 32, 33, 34]
    preview: 16
    confirm: 49

Confirm button example

confirm_button:
  material: ANVIL
  name: '<green>Start Forging'
  lore:
    - '<gray>Consumes blueprint and materials.'
    - '<gray>May produce a higher quality item.'
  actions:
    click:
      - 'forge_start'

Troubleshooting

If the confirm button does nothing, check slot conflicts, action names, permissions, and material validation. Always re-check inventory contents when the player confirms; do not rely only on cached state from when the GUI opened.