安装前必读

1. 最低环境

• Java 21。先在服务器命令行运行 java -version，确认实际启动服务端的 Java 是 21，而不是只在 IDEA 中配置了 21。
• Paper 或兼容的 Leaf 1.21 服务端。项目当前按固定 Paper 1.21 API 基线编译。
• 不支持 Folia。插件描述符明确声明 folia-supported: false。
• 一份可恢复的服务器与玩家数据备份。

不要因为“同为 Bukkit 插件”就假定 Spigot 1.20、Purpur 1.21.x 的所有版本、Folia 或未来版本一定兼容。先在副本测试服启动和跑玩法。

2. 哪些插件是必需的

SealItems 核心 JAR 不把第三方插件打包进去。以下都是软依赖：

插件	何时需要	当前编译基线
SealAttributes	让装备、词条、宝石、共鸣真正提供属性	API artifact 1.0.9 / API baseline 1.3
Vault + 经济插件	改造或宝石操作使用 Vault 金币	VaultAPI 1.7.1
PlayerPoints	使用点券费用	3.3.5
MythicMobs	注册 MythicMobs 自定义掉落	5.13.0
ArcartX	使用资源包界面	2.5.36.8；建议 2.5.36+

只想创建物品并用原版 GUI，可以先只装 SealItems。想做完整 RPG 装备，通常还应安装 SealAttributes。

3. 先决定你的目标

• 只创建有名字的物品：学习 items/*.yml、instance: stackable 和 /si give。
• 制作随机装备：需要 individual、品质、词条、词条方案，通常还要 SealAttributes。
• 完整刷装循环：按物品 → 品质/词条 → 掉落 → 鉴定 → 改造 → 宝石/共鸣的顺序启用。

不要一次开启所有系统，否则出现配置错误时很难定位。

4. 上线前备份

至少备份：

• 服务端 plugins/SealItems/；
• 玩家数据与世界数据；
• SealAttributes 配置；
• Vault 经济或 PlayerPoints 使用的数据库；
• ArcartX UI 与资源包文件。

备份必须能恢复。仅复制一份配置但没有玩家数据，不是完整回滚方案。

5. 认识“默认关闭”

鉴定、改造、原版掉落、孔位系统的正式默认配置都是关闭状态。这不是安装失败，而是为了避免插件第一次启动就改变现有服务器玩法。按对应章节配置后再重载。

6. 预安装检查清单

• [ ] java -version 是 21。
• [ ] 服务端是测试过的 Paper/Leaf 1.21。
• [ ] 没有使用 Folia。
• [ ] 已经停服并备份。
• [ ] 需要的软依赖版本已准备好。
• [ ] 知道服务器真正的 plugins 目录。
• [ ] 准备先在测试服验证，不直接让正式服玩家试错。

完成后继续 安装与第一次启动。