ChestCommands GUI 插件
ChestCommands GUI 插件介绍
一、插件简介
Chest Commands GUI 是 Minecraft Bukkit/Spigot 服务端最轻量级、最稳定的图形化菜单插件之一。它通过 YAML 配置文件定义物品栏界面，允许服务器管理员创建无限数量的自定义 GUI 菜单，用于展示服务器规则、执行命令、打开商店或作为服务器的主交互界面。该插件以其低性能消耗和高兼容性著称，是各类生存服、RPG服和小游戏服的基础构建工具。
资源地址：SpigotMC - ChestCommands
适用核心：Spigot, Paper, Purpur 及衍生核心
版本支持：1.8 - 最新版本
第三方网页编辑器 网页版提供GUI图像页面来编辑菜单,不会命令也不影响 https://www.tsrcraft.cn/#/
二、核心功能
可视化菜单：将复杂的指令转化为直观的背包界面（GUI）。
多菜单支持：支持创建多个独立的菜单文件，互不干扰。
灵活触发：支持通过命令（/cc open）、物品点击、甚至告示牌（Sign）打开菜单。
经济集成：原生支持 Vault 经济系统，可设置打开菜单或点击物品的金币消耗。
动态变量：完美兼容 PlaceholderAPI，支持在物品名称、Lore 中显示玩家血量、金钱等实时数据。
丰富动作：支持点击后执行玩家命令、控制台命令、广播消息、给予物品、播放音效等。
三、适用场景
服务器主菜单：玩家输入 /menu 打开服务器导航，包含传送、商城、职业等功能入口。
NPC 交互界面：配合 Citizens 插件，让村民或生物打开特定菜单。
GUI 商店：结合经济插件，制作可视化的物品购买界面。
小游戏选择器：在大厅服中，点击图标即可加入对应的游戏房间。
规则与帮助：将长篇大论的服务器规则制作成翻页式的 GUI 菜单。
四、安装与配置要点
安装：下载 Jar 文件放入 plugins 文件夹，重启服务器。
前置依赖：若需要使用经济功能或高级变量，需安装 Vault 和 PlaceholderAPI。
配置路径：
主配置：plugins/ChestCommands/config.yml
菜单文件：plugins/ChestCommands/menu/（默认生成 example.yml，新建菜单直接在此目录创建 .yml 文件）。
基本语法示例：
menu_title: '&6服务器主菜单'
size: 27 # 9的倍数，最大54
items:
'13': # 物品位置（第13格）
material: DIAMOND_SWORD
data: 0
amount: 1
display_name: '&bPvP竞技场'
lore:
- '&7点击传送到竞技场'
left_click_commands:
- '[console] warp pvp %player%'
price: 50 # 花费50金币
click_sound: ENTITY_EXPERIENCE_ORB_PICKUP
五、常用命令
| 命令 | 说明 |
| :--- | :--- |
| /cc reload | 重载所有菜单配置文件（无需重启） |
| /cc open <菜单文件名> [玩家] | 为自己或指定玩家打开某个菜单 |
| /cc list | 列出所有可用的菜单文件 |
| /cc version | 查看插件版本信息 |
六、权限节点
| 权限节点 | 说明 | 默认 |
| :--- | :--- | :--- |
| chestcommands.open.<菜单名> | 允许打开指定的菜单 | OP |
| chestcommands.open. | 允许打开所有菜单 | OP |
| chestcommands.command.cc | 允许使用 /cc 主命令 | OP |
| chestcommands.bypasscost | 绕过点击物品的费用 | OP |
| chestcommands.sign.use | 允许使用菜单告示牌 | 所有玩家 |
七、支持的点击动作
在配置文件的 left_click_commands 或 right_click_commands 下，可以使用以下前缀定义动作：
[player] <命令>：以玩家身份执行命令（默认）。
[console] <命令>：以控制台身份执行命令。
[tell] <消息>：仅发送一条消息给点击者。
[broadcast] <消息>：向全服广播一条消息。
[give] <物品> [数量]：给予玩家物品。
[sound] <声音名>：播放音效。
[close]：点击后关闭菜单。
八、菜单告示牌教程
ChestCommands 支持使用告示牌直接打开菜单，无需绑定命令：
在第一行写上 [menu]。
在第二行写上菜单文件的名称（不含 .yml 后缀）。
给予玩家 chestcommands.sign.use 权限。
右键点击告示牌即可打开对应菜单。
九、注意事项
YAML 语法：菜单文件对缩进非常敏感，建议使用 Notepad++ 或 VS Code 编辑，开启 YAML 语法检查。
材质名称：高版本服务端请使用新版材质名称（如 DIAMOND_SWORD 而非旧 ID），并注意版本差异。
性能优化：避免在单个菜单中放置过多高频刷新的 PlaceholderAPI 变量，以免卡顿。
版本兼容：虽然插件支持老版本，但在 1.13+ 使用时，请确保下载的是更新维护的版本（如作者 Filip1221 的维护版）。
十、资源信息
官方下载：SpigotMC 资源页
开源状态：免费使用
推荐搭配：LuckPerms（权限管理）、Vault（经济桥接）、PlaceholderAPI（变量支持）
帖子制作 by LT-YHC
评论 (0)