原创 娱乐 游戏模式 SealItems #

[MD] # SealItems 1.0.0 [点击链接一键加入【Seal系列插件交流群】](https://qm.qq.com/q/qoxe0UbMMU) SealItems 是一套面向 Minecraft RPG 服务器的物品与装备养成插件。 它把物品产出、鉴定、培养、穿戴、收藏和回收放进同一套系统。服主既可以只开放某一种玩法，也可以搭建完整的装备成长循环。 ## 插件能做什么 | 功能 | 玩家体验 | | --- | --- | | 自定义物品 | 创建武器、防具、宝石、图纸和各种材料 | | 品质与词条 | 同一种装备可以生成不同品质、属性和随机词条 | | 装备鉴定 | 未鉴定装备隐藏品质与词条，鉴定后才正式生效 | | 重铸与洗炼 | 重铸所选词条，或洗炼数值并锁住想保留的词条 | | 宝石与共鸣 | 解锁孔位、选择孔型、镶嵌宝石并触发组合效果 | | 装备强化 | 配置成功率、失败结果、保底、保护符和直升卷轴 | | 绑定与解绑 | 在鉴定或装备时绑定，并提供高代价二次确认解绑 | | 图纸与合成 | 学习图纸、搜索配方、选择数量并批量制作物品 | | 物品分解 | 左侧放装备，右侧查看预计产物，分解后回收材料 | | 怪物掉落 | 为原版怪物或 MythicMobs 怪物设置自定义掉落 | | 套装与图鉴 | 配置套装件数效果、收藏进度、获取来源和收藏奖励 | | 客户端特效 | 在背包中显示强化角标和围绕物品槽旋转的巡光 | ## 一套完整的装备成长流程 ```text 怪物掉落或图纸合成 ↓ 获得未鉴定装备 ↓ 鉴定品质与随机词条 ↓ 重铸、洗炼、宝石、强化 ↓ 绑定、穿戴并组成套装 ↓ 点亮图鉴或分解回收材料 ``` ### 品质与随机词条 服主可以创建普通、稀有、史诗等品质，并决定不同品质的显示颜色、词条数量和数值范围。 词条可以分为主词条和副词条。同一种装备每次生成时都可能得到不同结果，适合副本掉落、刷宝和毕业装备养成。 ### 鉴定、重铸与洗炼 - 鉴定：公开隐藏的品质与词条。 - 重铸：玩家选择一条或多条词条重新生成。 - 洗炼：默认重洗全部词条数值，玩家可以锁住一条或多条。 费用可以跟随品质、等级和选择数量变化，也可以设置连续结果不理想后的保底。 ### 宝石、孔位与共鸣 玩家可以自己选择解锁孔位、镶嵌宝石、改变孔型或拆卸宝石。 宝石可以限制单件装备和全身生效数量。多颗宝石满足组合条件后，可以自动触发共鸣效果。 镶嵌后会在装备说明中显示宝石。服主可以全服统一选择显示宝石属性，或者只显示宝石名称。 ### 装备强化 每个强化阶段都可以设置成功率、费用、失败降级、保底和属性奖励。 玩家可以自行投入： - 幸运材料：提高成功率。 - 不同等级的保护符：减少或免除失败损失。 - 直升卷轴：让符合类型和等级要求的装备直接升到指定等级。 保护符无论强化成功还是失败都会消耗。达到指定等级后，还可以改变装备名称、说明、模型、附魔光效和客户端巡光效果。 ### 图纸、合成与分解 图纸本身也是普通物品。玩家右键学习配方，再进入合成界面选择数量制作。合成没有随机成功率，条件满足后即可完成。 分解界面左侧放入装备，右侧显示预计产物。产物超过一页时可以翻页，不会因为格子不足而漏掉内容。 ## 适合哪些服务器 - 副本服：怪物掉落未鉴定装备，玩家鉴定后决定是否培养。 - 刷宝服：通过品质、随机词条和分解形成长期掉落循环。 - 养成服：使用强化、洗炼、宝石和共鸣培养毕业装备。 - 制作服：收集图纸、材料和工具，制作指定装备。 - 收集服：发现装备、点亮图鉴、完成套装并获得奖励。 - 多服网络：使用 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. 输入： ```text /si admin system status ``` 看到运行状态为 `READY`，并且装备属性联动可用，即表示安装成功。 ## 第一次体验 插件自带一套可以互相配合的中文示例。文件名以 `示例-` 开头时不会加载，不会影响正式服务器。 1. 复制 `items/示例-物品.yml`，把副本改名为 `测试物品.yml`。 2. 复制 `rules/` 各文件夹中的示例，并去掉文件名开头的 `示例-`。 3. 输入： ```text /si admin system reload all ``` 4. 查看加载结果： ```text /si admin item list ``` 5. 给自己发放示例装备： ```text /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` | 装备解绑 | 所有操作都会在确认前显示材料、费用、成功率或预计结果。分解和解绑完成后不能撤销。 ## 配置目录 ```text 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` | 打开管理员绑定页面 | 只修改某项内容时，可以使用： ```text /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： ```yaml database: mysql: enabled: false ``` 多台服务器需要共用图纸和收藏记录时，再开启 MySQL 并填写地址、端口、数据库名、账号和密码。 Redis 当前不是必需功能，没有明确需求时保持关闭即可。 ## 更新与排错 更新前先关闭服务器并备份整个 `plugins/SealItems` 文件夹。替换 JAR 后重新启动，再执行： ```text /si admin system status ``` 如果配置修改后没有生效： 1. 查看控制台给出的文件和位置。 2. 修正后重新执行重载。 3. 使用状态命令确认玩法可用。 4. 发放一件测试物品实际操作。 新配置有问题时，插件不会立即使用它，玩家会继续使用上一套正常配置。 ### 当前范围 - 不支持 Folia。 - 客户端 Mod 目前只支持 Minecraft 1.21.4。 - 当前装备属性适配 SealAttributes。 - 材料只从玩家普通背包和快捷栏中收取。 - 没有资源包也能使用玩法，但不会显示资源包提供的自定义外观。 [/MD]