shuaxingchoujiangyaoshi ¥1
多组「旧钥匙 → 新钥匙」一键刷新:右键匹配旧物,背包内同种旧物全部替换为新物(最多 6 组)
Paper 1.20+
物品匹配
插件介绍
本插件用于在版本或插件升级后,把玩家手中「旧版抽奖钥匙」批量换成「新版钥匙」(例如补齐 ExcellentCrates 等插件写入的 NBT)。最多支持 6 组 旧/新物品对,通过 items.yml 持久化;管理员可用多组命令分别设置每组的旧物品模板与新物品模板。
玩家用法
- 手持旧物品(与某组配置的 oldItem 匹配)
- 右键空气或方块触发刷新
- 插件会统计整个背包中与手上同款的旧物总数量,全部扣除,并发放同等数量的新物品
一次性全背包同种旧物都会转换
若不希望玩家误触,请配合权限、世界规则或仅在指定区域开放使用。
管理员命令
每组对应两个命令:一个设置旧物品,一个设置新物品(手持执行 set)。第 1 组旧物命令名为 /shuaxingyaoshi(别名 /sxy、/sxy1),其余组为 /shuaxingyaoshi3、/shuaxingyaoshi5… 奇数;新物命令为 /shuaxingyaoshi2、/shuaxingyaoshi4… 偶数。
| 子命令 | 说明 |
|---|---|
set | 将主手物品写入当前组(旧或新) |
info | 查看当前组已保存的旧/新物品信息 |
reload | 从磁盘重新加载 items.yml |
权限节点
| 权限 | 说明 | 默认 |
|---|---|---|
shuaxingyaoshi.admin | 使用各组 set/info/reload 管理命令 | OP |
shuaxingyaoshi.use | 插件声明的玩家权限(默认所有人) | 所有人 |
说明:当前版本右键刷新逻辑在监听器中未单独校验 shuaxingyaoshi.use;若你需要限制使用范围,请用其它权限插件或世界规则配合。
数据文件
物品模板保存在插件数据目录下的 items.yml(内含 group1 … group6 的 oldItem / newItem 序列化数据)。
常见问题
请确认
items.yml 中对应组的 oldItem 与玩家手持物在插件的「同物品」判定下一致(显示名、Lore、CustomModelData、额外 NBT 等都会影响匹配)。