SealItems

SealItems 是面向 Paper 系服务端的 RPG 物品系统。它负责自定义物品、品质与词缀、鉴定、重铸、掉落、镶嵌、锻造和原版容器 GUI；属性计算可交给 SealAttributes。

服主用户手册

从完整用户手册开始，照着完成安装、第一次体验和玩家操作。需要搭建正式玩法时继续阅读：

1. 管理员操作指南：目录职责、费用、数据库、命令、重载和运维底线。
2. 核心配置逐字段参考：完整 config.yml 与 messages.yml。
3. 物品定义完整参考：从复制示例到重载、发放和检查。
4. 12 类玩法规则参考：品质、词条、鉴定、改造、孔位、共鸣、强化、绑定、合成、分解、掉落和套装。
5. 8 套 GUI 配置参考：每个界面的完整默认 YAML 与验收方法。

开发者 API

• 接入教程与完整示例：Bukkit Services、GUI、合成、强化事件、套装和属性联动。
• 可编译接入项目：从 Gradle、plugin.yml 到完整 Kotlin 主类和失败场景验收。
• 全部公开类型参考：sealitems-api 1.0.0 的真实签名、状态枚举和线程契约。

适合谁

• 需要 YAML 驱动 RPG 物品的服主。
• 希望先用原版客户端上线、再选配客户端增强的项目。
• 需要让物品定义、玩家实例和玩法规则分离的服务器。

明确边界

• Java 21；Paper / Purpur / Leaf 1.21.x，推荐 1.21.4。
• 不支持 Folia，也不支持热卸载或 Bukkit /reload。
• Fabric 客户端模组是可选增强，不安装也能使用服务端核心功能。
• 与 SealAttributes 联动前，先阅读版本状态；生产服还应阅读已知限制。