CustomGUI

插件

· 作者 Flan0x

CustomGUI 是一个轻量级的、基于配置的 GUI 引擎,允许你使用 YAML 构建完全自定义的菜单,支持可点击物品、发光效果、链式操作、十六进制颜色以及基于选择器的命令。

0 本站下载 0 关注 更新于 1 个月前

最新 1.0.0 · 1.20.6 · Paper / Purpur

一键开服(送7天)

CustomGUI

一款灵活、基于 YAML 的 Spigot 1.20.1 GUI 引擎。

CustomGUI 允许服务器管理员使用简单的 YAML 文件创建完全可定制的库存菜单。无需编写 Java 代码,即可配置布局、物品、权限、冷却时间、点击动作、导航和动态刷新。

CustomGUI 专为开发者和服务器所有者设计,还提供了公共 API 和自定义事件,以便与其他插件集成。

特性

? 完全可定制的 GUI

  • 配置 1–9 列 和 1–6 行 的 GUI 尺寸。
  • 将物品布局左对齐、居中或右对齐。
  • 使用坐标、位置列表或槽位范围定位物品。
  • 使用可配置的填充物填充空槽。
  • 使用传统颜色代码和十六进制颜色自定义标题。

? 丰富的物品配置

  • 自定义材质、名称和描述(Lore)。
  • 传统颜色(&a)和十六进制颜色(&#RRGGBB)。
  • 附魔发光效果。
  • 支持自定义模型数据(Model Data)。
  • 每个物品的独立权限和冷却时间。
  • 内置占位符:
    • %player% — 玩家名称。
    • %displayname% — 玩家显示名称。
    • %uuid% — 玩家 UUID。
    • %world% — 当前世界。
    • %online% — 在线玩家数量。
    • %gui% — 当前 GUI 标识符。

⚡ 强大的点击动作

为每种鼠标输入配置不同的动作:

  • 左键点击
  • 右键点击
  • Shift+左键点击
  • Shift+右键点击
  • 中键点击
  • 针对任意点击的回退动作

支持按顺序链接多个动作,并支持延迟。

动作 描述
[player] 以玩家身份执行命令
[console] 以控制台身份执行命令
[message] 发送聊天消息
[actionbar] 显示操作栏消息
[title] 显示标题和副标题
[sound] 播放音效
[open] 打开另一个 GUI
[close] 关闭当前 GUI
[refresh] 刷新当前 GUI
[delay] 延迟后续动作

GUI 还可以定义 open_actions 和 close_actions,以便在打开或关闭时执行动作。

? 动态 GUI

  • 以可配置的间隔自动刷新菜单。
  • 更新动态内容,无需重启服务器。
  • 使用单个命令重新加载配置和所有 GUI 文件。

? 库存安全

  • 取消受管 GUI 内的库存点击和拖拽。
  • 防止玩家通过常规库存交互取出 GUI 物品。
  • 减少Shift键点击复制和物品被盗的风险。
  • 在主服务器线程上,点击发生后的一个刻(tick)调度点击动作。

?️ 开发者 API

CustomGUI 公开了用于与其他插件集成的公共 API。

可用事件:

  • GuiOpenEvent
  • GuiClickEvent — 可取消
  • GuiCloseEvent

通过以下方式访问 GUI 管理器:

CustomGUI.getInstance().getGuiManager()

命令

命令 描述
/customgui gui open <gui> [player|@p|@a|@r|@s] 打开一个 GUI
/customgui gui close [player] 关闭一个 GUI
/customgui gui list 列出已加载的 GUI
/customgui reload 重新加载配置和 GUI 文件

别名: /cgui

权限

权限 描述 默认值
customgui.admin 访问所有 CustomGUI 命令 OP

示例配置

为你的 GUI 创建一个 YAML 文件,例如 main-menu.yml:

title: "&#FFAA00&l主菜单"
columns: 9
rows: 3

filler:
  material: BLACK_STAINED_GLASS_PANE
  name: " "

items:
  heal:
    material: GOLDEN_APPLE
    position: "4,1"
    glow: true
    name: "&#55FF55&l治疗"
    cooldown: 100
    actions:
      left:
        - "[console] effect give %player% minecraft:instant_health 1 1 true"
        - "[sound] entity.player.levelup 1 1.5"
        - "[message] &a你已被治愈!"

此示例创建了一个三行的菜单,其中包含一个发光的金苹果,点击后会给玩家施加短暂的瞬间生命效果。

要求

要求 版本
Minecraft 1.20.1
服务器软件 Spigot 或兼容分支
Java 17 或更高版本

快速开始

  1. 在服务器上安装 CustomGUI。
  2. 参考上述示例为你的 GUI 创建一个 YAML 文件。
  3. 加载或重新加载配置。
  4. 使用 /customgui gui open <gui> 打开你的菜单。

有关确切的配置目录、支持的 YAML 选项和动作语法,请参阅项目的文档。

支持

发现错误或有任何功能请求?请通过项目的问题跟踪器进行报告。

CustomGUI — 无需为每个 GUI 编写自定义插件,即可构建强大的服务器菜单。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源