插件介绍

本插件用于在版本或插件升级后,把玩家手中「旧版抽奖钥匙」批量换成「新版钥匙」(例如补齐 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(内含 group1group6oldItem / newItem 序列化数据)。

常见问题

请确认 items.yml 中对应组的 oldItem 与玩家手持物在插件的「同物品」判定下一致(显示名、Lore、CustomModelData、额外 NBT 等都会影响匹配)。