自定义菜单配置
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"
其中:- 是绑定物品槽位,B 和 A 是自定义物品节点
支持的动作类型
[bind]
[console]
[player]
[message]
[close]
BindShopMenu.yml - 绑定商城菜单
此菜单用于配置绑定商城界面,玩家可以在这里购买绑定服务或物品。
布局示例
layout:
- "BBBBBBBBB"
- "B-BBBBBAB"
- "BBBBBBBBB"
其中:- 是绑定物品槽位,B 和 A 是自定义物品节点
支持的动作类型
[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命令重载配置 - 确保布局中的特殊字符(如
-和+)使用正确且数量不超过限制 - 每个自定义物品节点(字母)都需要在配置文件中定义对应的物品信息
- 使用合适的音效名称,确保服务器中存在该音效资源