原创 娱乐 经济 【KzShop】可视化编辑的「商城 / 收购 / 折扣」三合一商店插件 · 支持金币 + 点券 · 1.12 ~ 1.21 全版本兼容 1.2.0

Kz系列插件交流群：1080271688
（群内免费获取，且不定时更新作者的精品插件）

功能特性​

三种商店类型，一套搞定​

• 普通商城（buy）：经典商品出售，左键购买 1 个，右键打开快捷购买菜单
• 收购商店（buyback）：回收玩家物品并发放金币 / 点券，左键出售 1 个，右键打开快捷出售菜单
• 折扣商店（discount）：从商品池随机抽选商品上架，每位玩家获得独立随机折扣，支持每日 / 每周 / 每月自动刷新

全可视化编辑，零配置文件起步​

• 执行 /kzshop edit 即可打开编辑界面，把物品拖进格子就是上架；商店不存在时自动创建
• 关闭界面自动保存，无需手写任何配置
• 单价、点券、购买命令等精细配置可在对应商店 yml 中调整，配合 /kzshop reload 热重载

双货币 & 混合支付​

• 金币（Vault + 任意经济插件）、点券（PlayerPoints）双货币并存
• 单个商品可同时收取「金币 + 点券」，也可设置为免费商品
• 支持纯命令商品（购买后只执行指令、不发物品，适合称号 / 权限 / 礼包类商品）

快捷购买 / 快捷出售​

• 左键单击购买 / 出售 1 个，右键打开快捷数量菜单（默认 1 / 5 / 10 / 16 / 32 / 64，可配置）
• 商品上直接显示单价、总价；余额不足时提示所需金额与当前余额

超大商店自动分页​

• 商品超过 45 格自动分页，上一页 / 下一页 / 分页信息齐全
• 编辑界面同样支持分页翻页，商品再多也不愁

购买指令系统​

• 每个商品可配置多条购买后执行的命令
• 支持 [console] / [player] 执行者前缀，以及 {player}、{player_uuid}、{quantity}、{item_name} 占位符
• 命令默认执行者（玩家 / 控制台）可在 config.yml 全局设置

防刷与交易安全​

• 折扣商品每个周期每种限购 1 个（按玩家独立记录，刷新前无法再次购买）
• 购买冷却防连点误触（默认 1 秒，可配置，过期记录自动清理）
• 对应经济系统不可用时直接阻止交易，杜绝「白拿」
• 折扣购买记录保存失败自动退款；收购时点券发放失败自动回滚金币
• 背包空间检查、背包满自动掉落，均可配置

完整购买日志​

• 每次交易异步写入 logs/purchases/商店名.log，记录玩家、商品、数量、金币 / 点券花费
• 过期折扣玩家数据定期自动清理，不堆积文件

多版本 / 多端支持​

• 兼容 1.12.2 ~ 1.21 全版本
• 支持 Folia 分区域线程调度
• 软依赖设计：Vault / PlayerPoints 缺失时对应功能自动禁用，插件照常运行

命令一览​

• /kzshop help —— 查看帮助（树形帮助，按权限过滤）｜权限：所有玩家
• /kzshop open buy <商店名> [玩家] —— 打开商城（可替他人打开）｜权限：kzshop.command.open
• /kzshop open buyback <商店名> [玩家] —— 打开收购商店（可替他人打开）｜权限：kzshop.command.open
• /kzshop open discount <商店名> [玩家] —— 打开折扣商店（可替他人打开）｜权限：kzshop.command.open
• /kzshop edit buy <商店名> —— 编辑商城（不存在自动创建）｜权限：kzshop.command.edit
• /kzshop edit buyback <商店名> —— 编辑收购商店（不存在自动创建）｜权限：kzshop.command.edit
• /kzshop edit discount <商店名> —— 编辑折扣商店商品池（不存在自动创建）｜权限：kzshop.command.edit
• /kzshop delete buy|buyback|discount <商店名> —— 删除商店｜权限：kzshop.admin
• /kzshop reload —— 重载配置与所有商店｜权限：kzshop.command.reload

主命令别名：/kzs；替其他玩家打开商店需要 kzshop.admin 权限。

点击展开...

权限节点​

• kzshop.command.main —— 使用主命令｜默认：所有玩家
• kzshop.command.open —— 打开商店｜默认：所有玩家
• kzshop.use —— 在商店中购买 / 出售｜默认：所有玩家
• kzshop.command.edit —— 编辑商店｜默认：OP
• kzshop.command.reload —— 重载配置｜默认：OP
• kzshop.admin —— 管理员权限（替他人打开商店、删除商店）｜默认：OP

前置插件​

• Vault + 任意经济插件（EssentialsX、CMI、EconomyX 等）：金币功能
• PlayerPoints：点券功能（兼容 2.x / 3.x）
• 均为软依赖：不装也能运行，只是对应货币不可用

快速上手​

1. 下载 KzShop v1.2.0 的 jar 文件，放入 plugins 文件夹，重启服务器
2. 游戏内执行 /kzshop edit buy 我的商店，创建并打开编辑界面
3. 把要卖的商品拖进格子，关闭界面自动保存
4. 执行 /kzshop open buy 我的商店 即可打开商城
5. 需要调整单价、点券、购买命令？编辑 plugins/KzShop/shops/我的商店.yml（如 items.0.price.vault），随后 /kzshop reload