BetterGUI - 更优界面插件

BetterGUI 是一款高度模块化的菜单插件，允许你从简单到复杂，一步步构建出梦想中的自定义菜单。通过直观的菜单编辑器、按钮、物品修改器、动作执行和条件检查等功能，你可以轻松创建功能丰富的交互界面。

💡核心特性

• 模块化设计：从简单的菜单到复杂的交互界面，均可自由构建。
• 菜单编辑器：可视化地创建和设计你的自定义菜单。
• 按钮添加：轻松在菜单中添加可交互的按钮。
• 物品修改器：编辑菜单中用于显示的物品外观与属性。
• 动作执行：为按钮点击等事件配置执行一系列动作。
• 条件检查：在执行动作前，检查玩家是否满足特定要求。
• 参数支持：在菜单配置中使用动态参数。
• PlaceholderAPI 支持：在文本中使用各类变量占位符。

✨扩展功能与兼容性

• 插件扩展：可通过安装 Addon 获得更多高级功能。
• 跨服支持：支持 BungeeCord 网络。
• 经济与点数：集成 Vault 经济系统和 PlayerPoints 点数系统。
• 自定义条件：创建自定义的条件检查逻辑。
• PaperMC 优化：完美支持 PaperMC 及其衍生服务端。
• 自定义物品检查：可验证玩家是否持有特定物品。
• 动态标题：支持动画效果的库存界面标题。
• 基岩版表单：通过 GeyserMC 支持向基岩版玩家显示表单与对话框。
• 高级 GUI：提供更多高级图形用户界面选项。

🔧开发者与集成

如果你开发了与 BetterGUI 集成的插件或扩展，可以通过私信联系作者，将其添加到官方集成列表中。

💡BetterGUI 插件文档

BetterGUI 是一个强大的菜单插件，允许你通过配置文件创建自定义 GUI 菜单，用于执行命令、打开其他菜单、发送消息等。它支持 PlaceholderAPI 变量、条件判断、动画效果和多种菜单类型，是服务器管理和玩家交互的得力工具。

🎮主要特性

• 高度可定制：通过 YAML 配置文件轻松创建各种 GUI 菜单。
• 多种菜单类型：支持箱子菜单、熔炉菜单、发射器菜单、工作台菜单等。
• 动态内容：支持使用 PlaceholderAPI 变量，使菜单文本和物品动态变化。
• 条件系统：可为按钮设置打开条件（如权限、金钱、持有物品），并配置条件不满足时的操作。
• 动作系统：点击按钮可执行多种动作，如执行命令、发送消息、打开其他菜单、播放音效等。
• 动画支持：可为菜单和按钮添加动画效果。
• Vault 经济支持：集成经济系统，可用于条件检查和收费动作。
• 多版本兼容：支持 1.8 至最新版本的 Spigot/Paper 服务端。

🔧快速开始

安装

• 将 BetterGUI 插件文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件会自动生成配置文件夹 plugins/BetterGUI。

创建你的第一个菜单

• 在 plugins/BetterGUI/menus 文件夹内创建一个新的 YAML 文件，例如 example.yml。
• 使用以下基础模板：

title: "&a示例菜单"
rows: 3
buttons:
  example_button:
    slot: 13
    item:
      ==: org.bukkit.inventory.ItemStack
      type: DIAMOND
      meta:
        ==: ItemMeta
        display-name: "&b点击我！"
    actions:
      left:
        - 'message: &a你点击了钻石！'

• 在游戏中，使用命令 /bettergui open example 打开此菜单。

✨命令与权限

命令

• /bettergui open <菜单名> - 打开指定的菜单。
• /bettergui list - 列出所有可用的菜单。
• /bettergui reload - 重载插件配置。
• /bettergui editor - 打开内置的菜单编辑器（如果启用）。

权限

• bettergui.command.open - 允许使用 /bettergui open 命令。
• bettergui.command.open.others - 允许为其他玩家打开菜单。
• bettergui.command.list - 允许使用 /bettergui list 命令。
• bettergui.command.reload - 允许使用 /bettergui reload 命令。
• bettergui.command.editor - 允许使用 /bettergui editor 命令。
• bettergui.bypass.<条件名> - 绕过特定的按钮条件检查。

⭐配置详解

菜单属性

在菜单 YAML 文件中，可以配置以下顶级属性

• title - 菜单的标题。
• rows - 菜单的行数（1-6）。
• type - 菜单类型（如 crafting、furnace、hopper，默认为箱子菜单）。
• buttons - 定义菜单中所有按钮的节点。

按钮配置

每个按钮可以配置以下内容

• slot - 按钮在菜单中的位置（0 起始）。
• item - 按钮显示的物品，支持序列化的 ItemStack 或简化格式。
• actions - 定义玩家点击（左键、右键等）后执行的动作列表。
• conditions - 定义玩家点击按钮前需要满足的条件。
• update-interval - 按钮更新的时间间隔（刻），用于动态内容。

动作类型

按钮可以触发多种动作，常用动作包括

• command: <命令> - 执行控制台或玩家命令。
• console: <命令> - 以控制台身份执行命令。
• message: <文本> - 向玩家发送消息。
• open: <菜单名> - 打开另一个菜单。
• sound: <音效名> - 播放音效。
• close - 关闭当前菜单。

条件类型

可以设置条件来控制按钮是否可点击，常用条件包括

• permission: <权限节点> - 检查玩家权限。
• money: <金额> - 检查玩家金钱（需 Vault）。
• item: <物品> - 检查玩家是否持有指定物品。
• javascript: <表达式> - 使用 JavaScript 表达式进行复杂判断。

❓常见问题

如何让按钮根据条件显示不同的物品？

可以使用 states 功能。在按钮配置中定义多个状态，每个状态可以有自己的物品和条件。插件会显示第一个满足条件的状态对应的物品。

如何为菜单或按钮添加动画？

在菜单或按钮配置中添加 animation 部分。你可以定义多个动画帧（不同的物品），并设置帧切换间隔。

如何让菜单记住翻页状态？

使用 pagination 功能。你可以创建一个分页菜单，通过“上一页”和“下一页”按钮导航。BetterGUI 会自动处理页面状态。

支持哪些变量占位符？

支持 PlaceholderAPI 的所有占位符。在文本中使用 %placeholder% 格式即可。确保已安装 PlaceholderAPI 插件。

如何调试菜单配置问题？

启用插件的调试模式。在 config.yml 中设置 debug: true，然后查看服务器日志获取详细错误信息。

🔧更多资源

• 官方文档：<https://bettergui-mc.github.io/Docs/>
• GitHub 仓库：<https://github.com/BetterGUI-MC/BetterGUI>
• 预置菜单示例：插件包内包含示例菜单文件，位于 plugins/BetterGUI/menus/examples/。