二次开发 工具 【1.13-1.21|Folia】WarZCustomShop —— 无上手难度|自带Web编辑器|全可视化自定义商店｜多货币体系｜NBT 完整保留｜ 1.7.18

WarZCustomShop - 高度自定义 GUI 商店插件 | 全版本兼容 & Folia 原生适配 & 中文深度优化​

​

核心特色 | 为什么选择 WarZCustomShop？​

全环境无缝兼容：原生适配 Folia 多线程服务端，无卡顿无报错，传统 Bukkit/Spigot/Paper 端同样流畅运行，1.13-1.21 + 跨版本无需修改配置，通用 jar 包一键部署

中文极致优化：内置海量原版物品中文词典，开箱即用告别英文 ID，支持items.yml自定义 Mod 物品 / 特殊道具中文名，配置优先级可覆盖内置词典，完美适配中文服务器

四合一经济体系：同时支持 Vault 金币、PlayerPoints 点券、原版经验值、自定义物品货币交易，可单独 / 组合使用，轻松适配生存 / RPG / 公益服等各类服务器经济逻辑

Web 可视化编辑器：内置网页端编辑器（默认端口 18666，可自定义），拖拽排版商店布局、可视化配置商品属性，无需手写 Lore 代码，新手也能快速搭建专业级 GUI 商店

轻量化 & 高拓展：插件体积小不占用服务器资源，运行无冗余，同时支持丰富的自定义语法，可实现精细化权限控制、多维度限购、交易触发指令等复杂功能，满足所有商店需求

双向交易 + 灵活配置：支持系统出售物品、系统回收玩家物品，可配置玩家寄售；所有交易逻辑通过物品 Lore 简单配置，支持多条件组合，功能无上限

热重载 & 便捷运维：修改配置 / 编辑商店后，输入/cshop reload即可即刻生效，无需重启服务器；丰富的管理员指令，轻松实现商店创建、编辑、货币管理等全流程运维

🛠 核心功能 | 精细化商店配置，满足所有场景​

基础交易与交互​

• GUI 可视化操作界面，玩家左键点击购买、右键点击出售，操作简单易上手​
• 支持快速购买指令，玩家无需打开 GUI，输入指令即可直接购买指定商品，提升交易体验​
• 交易成功 / 失败实时弹窗提示，支持自定义提示文本，可添加彩色代码美化​

多维度权限与条件控制​

• 分商店 / 分商品设置访问权限，玩家需拥有对应权限才可打开商店 / 购买商品​
• 丰富的购买条件判断：背包剩余空间校验、PAPI 变量值判断（等级 / 时长等）、权限校验、反向权限限制（禁止特定组购买）、字符串匹配（玩家名 / 世界等）​
• 支持权限作为购买消耗，特定商品需拥有指定权限才可购买，适配 VIP 专属商店 / 道具场景​

灵活限购与库存管理​

• 4 种限购模式全覆盖：个人每日限购、个人终身限购、全服总库存限购、全服每日限购，可精准控制商品流通​
• 限购数据自动统计，支持插件重载 / 服务器重启后数据保留，无需担心数据丢失​

交易触发自定义功能​

• 购买成功后可触发多类型指令：控制台执行、玩家执行、OP 身份执行，支持<player>/<uuid>变量自动替换​
• 支持购买后关闭商店、跳转至其他商店，可搭建多级分类商店，提升服务器玩法体验​
• 支持 “仅执行指令不给予物品” 配置，可实现购买礼包、解锁权限、传送等非物品交易场景​

自定义物品货币体系​

• 任意物品可注册为自定义货币，手持物品输入指令即可完成注册，操作简单​
• 支持自定义货币的发放、扣除、查询，可单独作为交易货币，也可与其他经济体系组合使用，完美适配 RPG 服务器专属货币需求​

物品名称与显示自定义​

• 自动生成items.yml物品名称映射文件，包含所有原版物品中文名，可直接修改覆盖​
• 支持为 Mod 物品 / 自定义道具手动添加中文名，游戏内 F3+H 查看物品 ID 即可快速配置，支持彩色代码美化物品名称​

常用指令 | 管理员 / 玩家分权限，清晰易懂​

管理员指令（需​

• /cshop create <商店名> <行数> - 创建新 GUI 商店，行数支持 1-6 行，按需选择​
• /cshop edit <商店名> - 打开指定商店的编辑界面，手持物品即可上架​
• /cshop editmode - 切换编辑模式，开启后点击物品仅编辑不交易，避免误触​
• /cshop reload - 重载插件所有配置，修改后即刻生效，无需重启服务器​
• /cshop delete <商店名> - 删除指定废弃商店，清理服务器数据​
• /cshop open <商店名> [玩家名] - 强制为指定玩家打开商店，适配活动 / 引导场景​
• /cshop cost <create/delete/list> - 自定义货币管理，创建 / 删除 / 查看服务器自定义货币​
• /cshop givecost/takecost/seecost <玩家> <货币ID> <数量> - 发放 / 扣除 / 查询玩家自定义货币​
• /cshop list [页数] - 查看服务器所有已创建商店列表，方便多商店管理​

玩家指令（默认拥有​

• /cshop help - 查看玩家端帮助菜单，快速了解基础操作​
• /cshop open <商店名> - 打开指定商店（需拥有customshop.open.<商店名>权限）​
• /cshop costs - 查看自身拥有的所有自定义货币数量，实时掌握货币余额​
• /cshop buy <商店名> <槽位> - 快速购买指定商店指定槽位的商品，无需打开 GUI​

核心配置语法 | 简单易记，无需复杂配置文件​

• 购买消耗（b~ 开头）：b~eco~100（消耗 100 金币）、b~point~50（消耗 50 点券）、b~none（免费领取）、b~show（仅展示不购买）​
• 购买条件（c~ 开头）：c~perm~vip.buy（需 VIP 权限）、c~inv~3（需 3 个背包空格）、c~papi~%player_level%~20（等级≥20）​
• 功能设置（s~ 开头）：s~daylimitself~5（个人每日限购 5 个）、s~cmd~c~say <player> 购买成功（控制台发送提示）、s~open~vip_shop（购买后跳转 VIP 商店）​
• 出售收益（sell~ 开头）：sell~eco~50（出售获得 50 金币）、sell~cost~coin~5（出售获得 5 个自定义货币）​

适用场景 | 全类型服务器均可无缝适配​

• 生存服：搭建基础物资商店、矿物回收商店，支持多经济体系，满足玩家日常交易需求​
• RPG 服：配置自定义物品货币、专属职业商店、VIP 限定商店，通过限购和权限控制道具流通，提升玩法体验​
• 公益服 / 小游戏服：搭建福利商店、道具兑换商店，支持免费领取、点券兑换，提升玩家留存​
• 综合服：搭建多级分类商店，通过购买后跳转功能实现商店分类，让玩家快速找到所需商品​

下载与文档​

注意事项​

1. 安装插件前请确保服务器已安装Vault插件，无此插件将无法运行；​
2. 请勿重命名插件 jar 包，避免配置文件路径异常，安装前置后建议重启服务器而非热重载；​
3. 修改items.yml添加 / 修改物品名称后，需输入/cshop reload重载插件方可生效；​
4. Web 编辑器默认端口为 18666，若端口被占用可在config.yml中修改，远程服务器需开放对应端口方可访问。​