SealItems 1.0.0

SealItems 是一套面向 Minecraft RPG 服务器的物品与装备养成插件。

它把物品产出、鉴定、培养、穿戴、收藏和回收放进同一套系统。服主既可以只开放某一种玩法，也可以搭建完整的装备成长循环。

插件能做什么

功能	玩家体验
自定义物品	创建武器、防具、宝石、图纸和各种材料
品质与词条	同一种装备可以生成不同品质、属性和随机词条
装备鉴定	未鉴定装备隐藏品质与词条，鉴定后才正式生效
重铸与洗炼	重铸所选词条，或洗炼数值并锁住想保留的词条
宝石与共鸣	解锁孔位、选择孔型、镶嵌宝石并触发组合效果
装备强化	配置成功率、失败结果、保底、保护符和直升卷轴
绑定与解绑	在鉴定或装备时绑定，并提供高代价二次确认解绑
图纸与合成	学习图纸、搜索配方、选择数量并批量制作物品
物品分解	左侧放装备，右侧查看预计产物，分解后回收材料
怪物掉落	为原版怪物或 MythicMobs 怪物设置自定义掉落
套装与图鉴	配置套装件数效果、收藏进度、获取来源和收藏奖励
客户端特效	在背包中显示强化角标和围绕物品槽旋转的巡光

一套完整的装备成长流程

怪物掉落或图纸合成
        ↓
获得未鉴定装备
        ↓
鉴定品质与随机词条
        ↓
重铸、洗炼、宝石、强化
        ↓
绑定、穿戴并组成套装
        ↓
点亮图鉴或分解回收材料

品质与随机词条

服主可以创建普通、稀有、史诗等品质，并决定不同品质的显示颜色、词条数量和数值范围。

词条可以分为主词条和副词条。同一种装备每次生成时都可能得到不同结果，适合副本掉落、刷宝和毕业装备养成。

鉴定、重铸与洗炼

• 鉴定：公开隐藏的品质与词条。
• 重铸：玩家选择一条或多条词条重新生成。
• 洗炼：默认重洗全部词条数值，玩家可以锁住一条或多条。

费用可以跟随品质、等级和选择数量变化，也可以设置连续结果不理想后的保底。

宝石、孔位与共鸣

玩家可以自己选择解锁孔位、镶嵌宝石、改变孔型或拆卸宝石。

宝石可以限制单件装备和全身生效数量。多颗宝石满足组合条件后，可以自动触发共鸣效果。

镶嵌后会在装备说明中显示宝石。服主可以全服统一选择显示宝石属性，或者只显示宝石名称。

装备强化

每个强化阶段都可以设置成功率、费用、失败降级、保底和属性奖励。

玩家可以自行投入：

• 幸运材料：提高成功率。
• 不同等级的保护符：减少或免除失败损失。
• 直升卷轴：让符合类型和等级要求的装备直接升到指定等级。

保护符无论强化成功还是失败都会消耗。达到指定等级后，还可以改变装备名称、说明、模型、附魔光效和客户端巡光效果。

图纸、合成与分解

图纸本身也是普通物品。玩家右键学习配方，再进入合成界面选择数量制作。合成没有随机成功率，条件满足后即可完成。

分解界面左侧放入装备，右侧显示预计产物。产物超过一页时可以翻页，不会因为格子不足而漏掉内容。

适合哪些服务器

• 副本服：怪物掉落未鉴定装备，玩家鉴定后决定是否培养。
• 刷宝服：通过品质、随机词条和分解形成长期掉落循环。
• 养成服：使用强化、洗炼、宝石和共鸣培养毕业装备。
• 制作服：收集图纸、材料和工具，制作指定装备。
• 收集服：发现装备、点亮图鉴、完成套装并获得奖励。
• 多服网络：使用 MySQL 共用图纸和收藏记录。

使用条件

服务端

• Java 21。
• Paper、Purpur 或 Leaf 1.21.x。
• 推荐 Minecraft 1.21.4。
• 装备属性需要 SealAttributes 1.0.12。

按实际玩法选装：

• Vault：收取金币。
• PlayerPoints：收取点数。
• MythicMobs：配置自定义怪物掉落。

客户端特效

强化角标和槽位巡光需要：

• Minecraft 1.21.4。
• Fabric Loader 0.16.10 或更高版本。
• SealItems-Client-Fabric-1.21.4-1.0.0.jar。

不安装客户端 Mod 仍可使用全部服务端玩法，只是不显示角标和巡光。

安装

1. 关闭服务器。
2. 把 SealItems-1.0.0.jar 放入 plugins 文件夹。
3. 安装 SealAttributes。
4. 打开 SealAttributes 的 sources.yml，把 built-in-equipment-reader.enabled 改成 false。
5. 启动服务器，等待插件生成配置文件。
6. 输入：

/si admin system status

看到运行状态为 READY，并且装备属性联动可用，即表示安装成功。

第一次体验

插件自带一套可以互相配合的中文示例。文件名以 示例- 开头时不会加载，不会影响正式服务器。

1. 复制 items/示例-物品.yml，把副本改名为 测试物品.yml。
2. 复制 rules/ 各文件夹中的示例，并去掉文件名开头的 示例-。
3. 输入：

/si admin system reload all

4. 查看加载结果：

/si admin item list

5. 给自己发放示例装备：

/si admin item give 玩家名 demo_blade 1

整套示例包含装备、宝石、图纸、鉴定材料、强化材料、解绑材料和分解产物，可以直接测试全部玩法。

玩家命令

命令	功能
/si gui identify	装备鉴定
/si gui modify	重铸与洗炼
/si gui socket	宝石工作台
/si gui enhance	装备强化
/si gui craft	图纸合成
/si gui decompose	物品分解
/si gui sets	套装图鉴
/si gui unbind	装备解绑

所有操作都会在确认前显示材料、费用、成功率或预计结果。分解和解绑完成后不能撤销。

配置目录

plugins/SealItems/
├─ config.yml
├─ messages.yml
├─ items/
├─ rules/
└─ gui/

位置	用途
config.yml	玩法总开关、数据库和全服统一设置
messages.yml	提示文字和命令颜色
items/	武器、防具、宝石、图纸和材料
rules/	各玩法可以重复使用的规则
gui/	界面标题、按钮、文字、位置和声音

items/ 和 rules/ 支持子文件夹，可以按区域、等级、武器和防具自行整理。

最简单的配置方式是复制中文示例，修改编号和名称，再删除不需要的玩法。正式发放后不要随意修改物品、品质、词条、配方和套装编号。

完整字段和可填写的值都写在各目录的中文示例中。

常用管理命令

命令	用途
/si admin system status	查看插件与玩法状态
/si admin system reload all	重载全部配置
/si admin item list	查看已加载物品
/si admin item give <玩家> <物品编号> [数量]	发放物品
/si admin item inspect	检查主手物品
/si admin item binding	打开管理员绑定页面

只修改某项内容时，可以使用：

/si admin system reload <目标> config
/si admin system reload <目标> gui

例如强化使用 enhancement，宝石使用 sockets，合成使用 crafting，分解使用 decomposition。

权限

权限	用途
sealitems.identify	鉴定
sealitems.modify	重铸与洗炼
sealitems.socket	宝石工作台
sealitems.enhance	强化
sealitems.craft	合成
sealitems.decompose	分解
sealitems.sets	套装图鉴
sealitems.gui.unbind	解绑
sealitems.admin	管理命令
sealitems.admin.editor	管理员绑定页面

数据保存

单台服务器默认使用本地文件保存数据，不需要安装 MySQL：

database:
  mysql:
    enabled: false

多台服务器需要共用图纸和收藏记录时，再开启 MySQL 并填写地址、端口、数据库名、账号和密码。

Redis 当前不是必需功能，没有明确需求时保持关闭即可。

更新与排错

更新前先关闭服务器并备份整个 plugins/SealItems 文件夹。替换 JAR 后重新启动，再执行：

/si admin system status

如果配置修改后没有生效：

1. 查看控制台给出的文件和位置。
2. 修正后重新执行重载。
3. 使用状态命令确认玩法可用。
4. 发放一件测试物品实际操作。

新配置有问题时，插件不会立即使用它，玩家会继续使用上一套正常配置。

当前范围

• 不支持 Folia。
• 客户端 Mod 目前只支持 Minecraft 1.21.4。
• 当前装备属性适配 SealAttributes。
• 材料只从玩家普通背包和快捷栏中收取。
• 没有资源包也能使用玩法，但不会显示资源包提供的自定义外观。
• 不提供旧测试版配置自动转换。

更详细的配置与维护说明见 管理员指南。