二次开发 工具 【1.13-1.21+|Folia】WarZChestCommands｜老牌插件重出江湖|全兼容CC4.x 新版重构菜单插件｜支持Folia/多货币/可视化Web编辑器 5.0.2

---

---

[MD] # WarZChestCommands v5.0.0-SNAPSHOT > 把老 ChestCommands，升级成现代菜单工作台 **兼容范围**：Spigot / Paper / Folia · Java 8 · Minecraft 1.13+　|　**系列**：WarZ Series Plugin WarZChestCommands 是基于 ChestCommands 4.x 重制的菜单命令插件：旧菜单 YAML、/cc、/chestcommands 和旧 Java API 继续可用，同时补上 Web 编辑器、游戏内 GUI 编辑器、PAPI 全字段、ItemsAdder / CraftEngine / CustomModelData、多点击动作、分页、热重载和多货币扣费。老服可以平滑替换，新服也能用可视化方式快速做菜单。 **核心标签**：旧菜单无痛继承 · Web 可视化编辑器 · 游戏内 GUI 编辑器 · PAPI 全字段变量 · ItemsAdder / CraftEngine · Vault / PlayerPoints / CustomShop · 热重载不打断 · 旧 API 兼容 ## 一句话说清楚 *不是推倒重来，而是让老菜单长出新工具。* 如果你的服务器还在用 ChestCommands 老配置，但又想要现代菜单插件那套可视化编辑、分页、PAPI、条件、多货币和热重载，WarZChestCommands 就是为这个场景做的。 旧 YAML 能继续读，旧 /cc 能继续用，旧 API 也尽量保住；管理员可以直接在网页里点槽位做图标，或者进游戏用箱子界面快速改菜单。 ## 核心卖点 *老服替换稳，新服上手快。* - **旧菜单不白写**：保留 ChestCommands 4.x 菜单 YAML、/cc、/chestcommands 和 me.filoghost.chestcommands.api.* 旧 API。 - **网页点槽位编辑**：Web 编辑器支持菜单列表、搜索、新建、槽位预览、图标表单、动作构建、源码校验和保存热重载。 - **游戏内也能改**：/cc editor open <file> 直接打开箱子编辑器，右键图标改名称、材质、Lore、数量和动作。 - **现代菜单能力**：多点击动作、分页、优先级、命令参数上下文、PAPI 条件、货币条件和动作延时/概率修饰符都已补上。 - **资源包生态接入**：支持 MATERIAL、CUSTOM-MODEL-DATA、ItemsAdder 和 CraftEngine，自定义图标不再只能靠原版材质凑。 - **多货币扣费**：PRICE 继续兼容 Vault，新 COSTS 支持 Vault、PlayerPoints、CustomShop，并带预检查和失败回滚。 ## Web 编辑器：给不想背语法的人 *点一个槽位，填几项内容，就能做出一个菜单图标。* - **菜单文件管理**：左侧列出 menu/*.yml，支持搜索、新建和直接读取。 - **箱子槽位预览**：中间按 9xN 渲染菜单，支持翻页、点击槽位、拖拽移动和多选复制。 - **图标表单编辑**：右侧可改节点 ID、物品来源、材质或外部 ID、名称、数量、模型数据、页码、Lore、动作和扣费。 - **源码兜底**：高级用户仍可直接编辑 YAML，校验通过后保存并触发菜单热重载。 ## Web 工作台概念效果 *真实功能在上图，这张负责让第一眼更有发布质感。* - **给新人降低门槛**：通过下拉菜单、输入框和按钮完成图标配置，不需要先把所有 YAML 键背下来。 - **给老用户保留效率**：表单和源码两个入口并存，熟悉配置的人可以直接粘贴片段。 - **给服务器减少停机**：保存后自动热重载，单个菜单改动只重载对应文件，解析失败时保留旧版本。 ## 游戏内 GUI 编辑器 *不切出游戏，也能快速改菜单。* - **创建与打开**：/cc editor create <file> 创建菜单，/cc editor open <file> 打开编辑器。 - **手持物品导入**：点击空槽位可以把手上的物品导入为菜单图标，适合快速搭原型。 - **右键编辑图标**：右键已有图标进入配置菜单，可改名称、材质、Lore、数量、动作和 KEEP-OPEN。 - **保存前自动备份**：/cc editor save 会保存并自动重载，同时尽力保留旧文件备份。 ## 游戏内编辑概念效果 *真实截图讲功能，概念图讲体验氛围。* - 真实截图：改材质时能看到当前材质与物品信息。 - 真实截图：命令参数图标会展示节点、动作和编辑提示。 ## 游戏内编辑细节 *这些是真实截图，不是概念图。* - 改名称：直接在游戏里改图标显示名。 - 编辑 Lore：用 | 分隔多行，也可以输入 clear 清空。 - 添加动作：已有动作数量会显示在图标提示里。 - 清空动作：维护菜单时可以一键清掉 ACTIONS。 ## 动作、参数、分页和上下文 *不只是打开菜单，还能按点击类型跑不同逻辑。* - **多点击动作**：ACTIONS、LEFT-ACTIONS、RIGHT-ACTIONS、SHIFT-LEFT-ACTIONS、SHIFT-RIGHT-ACTIONS 分开配置。 - **命令参数变量**：支持 {wcc_command}、{wcc_args}、{wcc_arg: 1}，可以按玩家输入动态展示和执行。 - **分页动作**：next-page、previous-page、set-page 可做翻页按钮。 - **延时和概率**：动作前可加 [delay=2s]、[chance=50%]，不用写额外脚本。 ## 扣费系统也升级了 *Vault 继续兼容，多货币也能一起扣。* - **旧 PRICE 继续可用**：PRICE: 50 仍等价于 Vault 金币扣费，旧菜单不用重写。 - **COSTS 多货币**：可同时配置 vault、playerpoints、customshop，CustomShop 使用 id 对应 costId。 - **预检查与回滚**：先检查余额，再按顺序扣费；中途失败会尽力回滚已扣项目。 - **条件里也能查余额**：CLICK-REQUIREMENTS 支持 currency:vault >= 50、currency:customshop:token >= 3。 ## 自定义图标生态 *资源包服、RPG 服、末日服常用的图标方式都照顾到。* - **原版材质兜底**：MATERIAL 继续作为基础物品和外部物品失败时的 fallback。 - **CustomModelData**：CUSTOM-MODEL-DATA 支持现代资源包图标，旧服务端不支持时自动降级。 - **ItemsAdder**：通过反射调用 CustomStack.getInstance(id).getItemStack() 构建自定义物品。 - **CraftEngine**：通过反射桥接 CraftEngine 物品管理器，避免硬依赖。 ## Web Token 可点击打开 *发给玩家/管理员的是能点的链接，不是让人手抄一长串。* - **默认本机访问**：Web 编辑器默认绑定 127.0.0.1:8765，更适合本机/面板/反代后安全使用。 - **一次性 Token**：Token 默认 30 分钟有效，接口会校验 token，过期后需要重新生成。 - **可配置 public-url**：需要公网或反代访问时，可以配置 public-url 生成更友好的外部链接。 ## 命令速查 */cc、/wcc、/chestcommands、/warzchestcommands 都可用。* ``` /cc help 查看帮助 /cc reload 重载配置、菜单、热重载监听器和 Web 编辑器 /cc errors 在控制台重新打印最近一次加载错误 /cc list 列出菜单，玩家可点击菜单名直接打开 /cc open <菜单> [玩家] 打开菜单或为指定玩家打开菜单 /cc web token 生成 Web 编辑器一次性链接 /cc editor create <文件> 创建菜单文件 /cc editor open <文件> 打开游戏内菜单编辑器 /cc editor save 保存当前游戏内编辑器内容 ``` > 命令有 Tab 补全；/cc list 和 /cc web token 对玩家发送可点击消息。 ## 权限节点 *新旧权限都保留，老服迁移不用大改权限组。* - `warzchestcommands.*` — WarZChestCommands 全部新权限 - `chestcommands.*` — 旧版 ChestCommands 全部权限，继续保留 - `warzchestcommands.command.help` — 查看命令帮助 - `warzchestcommands.command.reload` — 重载插件配置和菜单 - `warzchestcommands.command.errors` — 查看最近一次加载错误 - `warzchestcommands.command.list` — 列出已加载菜单 - `warzchestcommands.command.open` — 打开菜单 - `warzchestcommands.command.open.others` — 为其他玩家打开菜单 - `warzchestcommands.command.editor` — 使用游戏内 GUI 编辑器 - `warzchestcommands.command.web` — 生成 Web 编辑器链接 - `warzchestcommands.open.<菜单>` — 打开指定菜单的权限节点 ## 安装与上手 *先跑起来，再慢慢把旧菜单升级成现代菜单。* 1. **放入 plugins 并重启**：把 jar 放进服务器 plugins 目录，启动后会生成配置和 example.yml。 2. **旧菜单放进 menu 目录**：旧 ChestCommands 菜单 YAML 放到 plugins/WarZChestCommands/menu/ 下即可尝试直接加载。 3. **执行 /cc list**：确认菜单已加载，玩家点击列表里的菜单名就能打开。 4. **生成 Web 链接**：执行 /cc web token，在浏览器打开链接，用槽位编辑器改菜单。 5. **需要游戏内编辑就用 /cc editor**：快速改第一页图标、名称、Lore、材质、动作时很顺手。 6. **出错看 /cc errors**：菜单解析失败时会保留旧版本，控制台和 /cc errors 会给出最近一次加载错误。 ## 适合谁用 *尤其适合已经有一堆 ChestCommands 菜单的服务器。* - **老服迁移**：不想重写全部菜单，但又想要 PAPI、Web 编辑器、热重载和多货币。 - **资源包 / RPG 服**：需要 CustomModelData、ItemsAdder、CraftEngine 图标来源。 - **末日 / 生存服**：菜单里经常要做传送、商店、礼包、跨服、提示、条件和扣费。 - **服主管理**：不想每次改菜单都停服、不想每个图标都手写 YAML。 ## 联系方式与支持 - **插件技术交流群**：398893720 - **末日类服务器交流群**：1063544727 - **插件定制开发**：QQ 1285988665 - **支持作者**：https://afdian.com/a/sunjood --- 如果你手里已经有 ChestCommands 老菜单，WarZChestCommands 更像一次平滑升级：旧东西能继续跑，新功能也能慢慢加。遇到问题、想要定制功能或适配你的服务器体系，可以进群找我聊。 [/MD]