BetterGUI - 更优界面插件

一个动态菜单，一个简单的菜单设计工具，或者只是一个更好的GUI插件

Bukkit / Spigot 作者 HSGamer 支持版本 1.8 - 1.21.11

访问 Spigot 访问 Modrinth 下载插件

服务器使用量

430

服务玩家数

4,489

下载量

61,320

插件详细介绍

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，然后查看服务器日志获取详细错误信息。

BetterGUI - 更优界面插件

💡核心特性

✨扩展功能与兼容性

🔧开发者与集成

💡BetterGUI 插件文档

🎮主要特性

🔧快速开始

安装