- 版权类型
- 原创
- 插件中文名称
- 材料兑换
- 插件英文名称
- CyRedeem
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.21
CyRedeem材料兑换 · 左边选物品，右边放材料
7 项精确比对 / 分页菜单 / 后台管理 / SQLite 存储
你是不是也遇到过
- 想做个材料兑换，只能用告示牌写「10 个钻石换 1 个下界合金」
- 玩家放错材料、放少材料，还要管理员手动补
- 兑换项一多，菜单排不下，只能分好几个 NPC
- 同名不同附魔的材料被当成同一种，白白亏本
服主 说：
CyRedeem 就是把这个流程做成菜单的插件。
它是怎么工作的
- 玩家执行
/cr打开兑换菜单 - 左侧列出所有可兑换物品，支持翻页
- 点一个物品，右侧出现所需材料槽位
- 玩家把材料放进去
- 数量够了，点确认，直接兑换
全程不需要管理员在线。
核心功能
- 材料精确比对：材质、名字、lore、附魔、NBT/PDC、模型、耐久，7 项独立开关
- 数量自动累计：同一材料分几组放也能识别
- 分页菜单：兑换项再多也能翻页，不用开多个菜单
- 后台管理：手持物品
/cr create <名字>就能创建兑换项 - 显示控制：每个兑换项可单独显示 / 隐藏
- GUI 可自定义：
gui/目录改标题、图标、按钮、lore - 文案集中：
messages.yml统一改提示 - 日志记录：兑换、失败、管理操作可选记录，自动清理旧日志
三个常见场景
生存服材料回收
腐肉、蜘蛛眼、火药换钱或换物资，玩家有动力打怪，经济也稳。
活动兑换
活动期间开放「活动材料 → 限定物品」，活动结束
/cr hide 隐藏即可。
自定义物品服
配合 CraftEngine / 自定义模型物品，靠
model 和 nbt 两项比对，普通同名物品换不了。
运行环境
- 服务端：Paper 1.21.11
- Java：21 及以上
- 硬依赖：无
- 软依赖：无（自定义物品按 NBT / 模型比对）
SQLite 驱动由 Paper 启动时自动加载，不需要手动装数据库。
安装与创建第一个兑换项
- 把
CyRedeem-1.4.7.jar放进plugins/，重启 - 手持想作为「兑换结果」的物品
- 执行
/cr create 下界合金 - 按提示把所需材料放进界面
- 保存后
/cr打开菜单即可看到
命令
/cr—— 打开兑换菜单/cr open—— 打开兑换菜单/cr create <名字>—— 以手持物品创建兑换项/cr list [页码]—— 兑换项列表，每页 10 条/cr show <编号>—— 显示兑换项/cr hide <编号>—— 隐藏兑换项/cr toggle <编号>—— 切换显示 / 隐藏/cr remove <编号>—— 删除兑换项（需二次确认）/cr confirm—— 确认删除/cr cancel—— 取消删除/cr reload—— 重载配置/cr help—— 帮助
权限
cyredeem.use—— 打开兑换菜单，默认所有玩家可用cyredeem.admin—— 创建 / 编辑 / 删除兑换项，默认 OP
配置示例
YAML：
# 材料比对：true = 这一项参与比对
match:
material: true # 材质
name: true # 名字
lore: true # lore
enchantments: true # 附魔
nbt: true # NBT / PDC
model: true # item_model / custom_model_data
durability: true # 耐久
# 日志
logs:
enabled: true
keep-days: 7
cleanup-time: "00:00"
record:
redeem: true
redeem-failed: false
admin: true
open-menu: false
system: true
console: false数量永远不参与比对，需求数量单独累计。
常见问题
Q：材料放进去了，但提示不足？
检查
config.yml 的 match 对应项。比如物品名字不同，name 开着就不算同一种材料。Q：同名不同附魔会混在一起吗？
不会。
enchantments 和 nbt 默认开启，附魔或 NBT 不同就算不同材料。Q：玩家打不开菜单？
确认他有
cyredeem.use 权限，默认所有玩家都有。Q：兑换项太多怎么办？
菜单自动分页，
/cr list [页码] 也能按页查看。Q：数据存在哪？
插件目录下的 SQLite 数据库，重启不丢。
Q：支持自定义模型物品吗？
支持。
model 和 nbt 两项比对能区分同材质不同模型的物品。
文档
license.mc33.top/docs/cyredeem
如果这个插件帮到了你，欢迎评分和反馈。
