GUI 配置

Forge 的 GUI 配置位于 gui/ 目录，主要包括锻造 GUI、配方书 GUI 和运行时编辑器 GUI。GUI 不只是显示菜单，还负责保护输入槽、处理点击、返还物品和触发锻造流程。

文件说明

文件	作用
forge_gui.yml	玩家执行锻造的主界面。
recipe_book.yml	玩家查看配方的配方书。
editor_gui.yml	管理员编辑图纸、材料或配方相关资源。

常见区域

区域	作用
图纸槽	放入配方图纸或显示图纸要求。
目标槽	目标输入模式下放入要重铸的装备。
材料槽	放入必需材料和可选材料。
预览槽	显示可能的输出、品质池和失败风险。
确认按钮	触发锻造流程。
返回按钮	返回配方列表或关闭菜单。

最小布局示例

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

按钮示例

confirm_button:
  material: ANVIL
  name: '<green>开始锻造'
  lore:
    - '<gray>消耗图纸和材料。'
    - '<gray>可能获得更高品质。'
  actions:
    click:
      - 'forge_start'

展示参数

字段	类型	必填	说明
title	string	是	GUI 标题，支持 MiniMessage。
rows	integer	是	行数，取值 1–6，通常使用 5 或 6。
slots.blueprint	integer	是	图纸槽位索引。
slots.target	integer	是	目标装备槽位索引。
slots.materials	list<integer>	是	材料槽位索引列表。数量应与 forge_capacity 配合。
slots.preview	integer	否	结果预览槽位索引。
slots.confirm	integer	是	确认按钮槽位索引。
slots.back	integer	否	返回按钮槽位索引。
background	object	否	背景填充物品配置。

玩家体验建议

• 在预览 Lore 中写清楚必需材料、可选材料上限和品质概率。
• 权限不足或材料不足时，确认按钮应显示红色状态，而不是点击后才提示。
• 目标输入模式要明确提示“不会生成新装备，而是改造放入的装备”。
• 高价值锻造建议加入二次确认，防止误点。