跳到正文

SealItems从一件物品,到完整 RPG 装备生态

面向 Paper / Leaf 1.21 与 Java 21 的中文使用、配置、运维和开发文档。即使第一次开服,也能按步骤完成可验证的装备玩法。

先选一条阅读路线

这份文档不假设你会 Java、Kotlin、YAML 或 Minecraft 插件开发。SealItems 负责稳定物品 ID、独立装备实例、品质、词条、鉴定、词条改造、掉落、孔位、宝石和共鸣,并可把装备贡献发布给 SealAttributes。

当前版本

项目版本为 0.1.0-SNAPSHOT,属于开发快照,不承诺长期兼容。上线前请在独立测试服验证,并备份玩家数据。

新手服主

  1. 安装前必读:确认 Java、服务端版本、可选依赖和备份。
  2. 安装与第一次启动:把 JAR 放到正确位置并判断是否 READY。
  3. 制作第一个物品:从一个最小物品开始,不先接触复杂玩法。
  4. 命令与权限:学会发放、检查、重载和诊断。
  5. 配置总览:理解目录、YAML、MiniMessage、严格校验和重载规则。

内容作者

物品定义品质、词条与方案鉴定词条改造掉落孔位、宝石与共鸣GUI 与 ArcartX。最后把它们组合成一套完整服务器示例

运维管理员与开发者

运维从迁移、备份与日常运维故障排查开始。插件开发者从开发者快速开始进入,再查阅公开 API架构与安全模型构建、IDEA 与贡献

能力地图

能力默认状态关键说明
稳定物品 ID、名称、Lore、CMD、标签可用items/*.yml
独立装备实例、品质、词条可用必须使用 instance: individual
鉴定关闭配置规则后启用指定物品
重铸、洗炼关闭可收 SealItems 材料和一种外部货币
原版实体掉落关闭规则与掉落表分开配置
MythicMobs 自定义掉落可选需要 MythicMobs;当前只支持落地投放
孔位、宝石与共鸣关闭六类配置原子加载
原版箱子 GUI可用不要求资源包
ArcartX GUI可选需要 ArcartX 2.5.36+ 和玩家资源就绪
SealAttributes 属性贡献可选只使用公开 API,不把依赖打进 JAR

三条最重要的安全规则

  1. 不要用 /minecraft:give 或 NBT/PDC 编辑器伪造 SealItems 物品;使用 /si give
  2. 不要在正式服直接实验大改配置;先复制测试服、备份,再重载。
  3. 配置错误时插件会拒绝发布新快照并保留旧快照。先看控制台精确路径,再运行 /si health,不要反复随机改字段。

获取帮助时应提供什么

请提供服务端核心与版本、Java 版本、SealItems JAR 版本、相关可选插件版本、执行的命令、完整控制台错误(从第一行到 Caused by 结尾)、相关 YAML 和 /si health 输出。不要只截一句“加载失败”。

Minecraft 服务端插件使用与开发文档