自定义菜单配置

GuibindPro 提供了灵活的自定义菜单系统,让您可以根据需求定制插件的界面体验。以下是可自定义的菜单文件及其配置方法。

通用配置项

基本配置参数

  • title - 定义菜单界面的显示名称
  • open_sound - 定义菜单打开时播放的音效

布局符号含义

  • A, B, C, D 等字母 - 代表自定义物品节点,对应菜单中的图标
  • - - 代表放入绑定物品的槽位(每个菜单中只能存在一个)
  • + - 代表放入解绑石的槽位(仅在解绑菜单中使用,每个菜单中只能存在一个)

通用动作类型 (actions)

  • [bind] - 触发绑定事件
  • [unbind] - 触发解绑事件
  • [console] - 执行控制台命令
  • [player] - 以玩家身份执行命令
  • [message] - 向玩家发送消息
  • [close] - 关闭界面

物品创建例子

以下是在菜单配置文件中创建自定义物品按钮的示例:

buttons:
  A:
    #物品类型
    material: GREEN_STAINED_GLASS_PANE
    #自定义名字
    name: "&a自定义名字"
    #自定义Lore
    lore:
      - "&7自定义Lore"
    custom-model-data: 0
    #动作类型
    actions:
      - ""

物品参数详解

基础属性
  • material - 设置物品类型,使用Minecraft物品ID
  • name - 自定义物品显示名称,支持颜色代码
  • lore - 设置物品描述文本,可添加多行
  • custom-model-data - 设置自定义模型数据值(用于资源包)
动作配置

actions - 定义点击物品时触发的动作列表

可以添加多个动作,按顺序执行,例如:

actions:
  - "[message] &a你点击了按钮!"
  - "[close]"
  - "[console] say 玩家 {player} 点击了按钮"

BindMenu.yml - 绑定菜单

此菜单用于配置物品绑定界面,玩家可以在这里将物品绑定到自己。

布局示例

layout:
  - "BBBBBBBBB"
  - "B-BBBBBAB"
  - "BBBBBBBBB"

其中:- 是绑定物品槽位,BA 是自定义物品节点

支持的动作类型

[bind] [console] [player] [message] [close]

BindShopMenu.yml - 绑定商城菜单

此菜单用于配置绑定商城界面,玩家可以在这里购买绑定服务或物品。

布局示例

layout:
  - "BBBBBBBBB"
  - "B-BBBBBAB"
  - "BBBBBBBBB"

其中:- 是绑定物品槽位,BA 是自定义物品节点

支持的动作类型

[bind] [console] [player] [message] [close]

UnbindMenu.yml - 解绑菜单

此菜单用于配置物品解绑界面,玩家可以在这里使用解绑石解除物品绑定。

布局示例

layout:
  - "BCBBBBBDB"
  - "C-CBABD+D"
  - "BCBBBBBDB"

其中:- 是绑定物品槽位,+ 是解绑石槽位,B, C, D 是自定义物品节点

支持的动作类型

[unbind] [console] [player] [message] [close]

RecoveryMenu.yml - 物品找回菜单

此菜单用于配置物品找回界面,玩家可以在这里找回丢失的绑定物品。

注:RecoveryMenu.yml 菜单界面当前版本还不支持自定义布局,但是支持自定义物品。

支持的功能

  • 自定义菜单内的物品图标
  • 自定义物品的显示名称和描述
  • 自定义物品的点击动作

配置提示

  • 修改菜单配置后,使用 /guibindpro reload 命令重载配置
  • 确保布局中的特殊字符(如 -+)使用正确且数量不超过限制
  • 每个自定义物品节点(字母)都需要在配置文件中定义对应的物品信息
  • 使用合适的音效名称,确保服务器中存在该音效资源