YuRelic

🌟 YuRelic 灵器成长 RPG 插件功能介绍

🧭 一句话介绍

---

YuRelic 是一款围绕“装备长期养成”打造的 灵器成长 RPG 插件。它不只是给武器加几行 Lore，也不是单纯的强化、升星或附魔扩展，而是把玩家手中的一件普通装备，逐步培养成拥有 器魂、潜质、路线、天赋、铭纹、器体寿命、传承履历、灵契主人、器藏档案与天榜排名 的长期成长型装备。✨

玩家可以把武器、护甲、工具、盾牌、饰品，甚至部分混合端/模组物品开光为“灵器”。灵器会随着玩家战斗、挖掘、承伤、格挡、完成委托、投入灵材、进行仪式而不断成长，并在不同阶段产生突破、注魂、铭魂、觉醒、传承、归炉等后续玩法。

对服务器来说，YuRelic 提供的是一套可以长期运营的装备成长生态：前期用开光建立目标，中期用等级、器魂、潜质、路线和天赋拉开差异，后期用铭纹、觉醒、器藏、天榜、传承和灵材经济延长内容寿命。管理员可以通过配置控制开光成本、成长速度、PVP/PVE 强度、灵材掉落、每日额度、跨服存储、防复制策略、展示广播与权限分层。🧩

它适合用作生存服的长期追求、RPG 服的装备主线、副本服的 Boss 掉落循环、跨服群组的贵重装备档案系统，也适合给模组服/混合端服务器补上一套可配置、可展示、可运营的装备养成框架。

---

[/md]

[md]

---

🏷️ 基础信息

| 项目 | 内容 |

|---|---|

| 插件名 | YuRelic |

| 主命令 | /yurelic |

| 默认别名 | /yr、/yrelic、/relic、/yurpg、/yrpg |

| 作者 | Vicuna |

| 插件定位 | 灵器成长、RPG 养成、装备长期培养、跨服数据与天榜展示 |

| 适配生态 | 生存服、RPG 服、副本服、混合端/模组服、跨服群组 |

| 目标适配版本 | Minecraft 1.8 - 1.26 全版本段服务端 |

| 目标适配核心 | Paper、Spigot、Paper 衍生核心、Youer、Arclight、Mohist 等常见 Bukkit/Spigot/Paper 与混合端核心 |

| 已测试环境 | Youer 1.21.1 |

| 兼容性反馈 | 如遇兼容性问题，请在 QQ 群内反馈，便于后续适配与修复 |

| 可选联动 | LevelledMobs、MythicMobs、WorldGuard、WorldEdit、Vault、PlayerPoints、EasyBot、PlaceholderAPI |

---

📦 获取、反馈与赞助

| 项目 | 说明 |

|---|---|

| 🧪 免费试用版本 | 可在 QQ 群 1080918424 群文件获取 1.0.0 免费试用版本 |

| 🔗 QQ 群入口 | 点击加入 QQ 群 |

| ⚠️ 免费版说明 | 免费试用版本仅供体验，不提供任何免费版本支持 |

| 📚 插件 Wiki / 使用文档 | 插件文档 |

| 🐛 Bug 与建议反馈 | GitHub Issue 反馈页 |

| 💎 高级版本赞助 | 爱发电赞助地址 |

---

🎯 适合什么服务器？

YuRelic 适合这些服务器

• 🏕️ 长期生存服：给玩家一个不依赖频繁换装备的长期目标。

• ⚔️ RPG / 副本服：通过灵器等级、路线、天赋、觉醒、灵材掉落形成成长闭环。

• 🧪 模组/混合端服务器：支持通过 Material、NamespacedKey、显示名、Lore、NBT 指纹识别特殊物品。

• 🌐 跨服群组：支持 SQLite / MySQL，带跨服存储、天榜、锁、掉落额度等机制。

• 💰 带经济系统的服务器：支持 Vault 金币、PlayerPoints 点券、经验、灵材等多种消耗通道。

• 📊 重视运营展示的服务器：内置 GUI、天榜、器藏、聊天分享、悬浮展示、广播与 PlaceholderAPI 占位符。

---

🧩 版本与核心兼容说明

YuRelic 的适配目标是覆盖 Minecraft 1.8 - 1.26 范围内的常见服务端核心与版本环境，尽量让传统生存服、RPG 服、跨服群组、混合端/模组服都能接入同一套灵器成长系统。🛠️

当前目标适配方向包括

• ✅ Paper

• ✅ Spigot

• ✅ Paper 衍生核心

• ✅ Youer

• ✅ Arclight

• ✅ Mohist

• ✅ 其他基于 Bukkit / Spigot / Paper 生态的常见核心

• ✅ 混合端、模组端、自定义物品较多的服务器环境

目前已测试环境：Youer 1.21.1。

由于不同核心、不同 Minecraft 大版本、不同混合端实现方式对物品、NBT、事件、耐久、属性、反射接口的处理可能存在差异，如遇到兼容性问题，请在 QQ 群内反馈，并尽量附带以下信息，方便定位：

| 反馈内容 | 示例 |

|---|---|

| 服务端核心 | Youer / Arclight / Mohist / Paper / Spigot |

| Minecraft 版本 | 1.20.1 / 1.21.1 / 1.12.2 等 |

| 插件版本 | 当前使用的 YuRelic 版本 |

| 报错日志 | 控制台完整报错或 latest.log 相关片段 |

| 触发操作 | 开光、成长、修复、器藏、饰品、跨服同步等 |

| 物品来源 | 原版物品 / 模组物品 / MMOItems / 自定义菜单 / 指令生成物品等 |

---

✨ 核心卖点总览

| 卖点 | 说明 |

|---|---|

| 🗡️ 灵器开光 | 普通装备可开光成灵器，分基础、精炼、尊启三档开光仪式 |

| 📈 长期成长 | 等级、经验、潜质、突破、路线、道韵、天赋、觉醒多线养成 |

| 👻 器魂系统 | 狂烈、坚守、轻灵、饕噬、贤明等器魂，带不同倾向与效果 |

| 🛡️ 器体寿命 | 开光后记录器体上限与损耗，损毁后需专门修复，不再只是原版耐久 |

| 💎 灵材经济 | 潜质精华、换魂玉、洗练石、觉醒核心、玄刻尘等完整材料体系 |

| 🧬 天赋/铭纹 | 天赋候选、洗练、铭纹槽、铭刻、磨去、祝纹等构筑内容 |

| 💍 饰品槽 | 4 个虚拟饰品槽，可配置解锁、权限、死亡失持与套装共鸣 |

| 🧾 器藏与天榜 | 自动收录灵器档案，支持按评分、等级、器魂、觉醒、称号排行 |

| 🔐 防复制/跨服锁 | MySQL 下可用事务原子软锁、重复档案排查、隔离与审计 |

| 🧭 运维 GUI | Doctor 体检、掉落模拟 GUI、存储状态、Hook 状态、运行库检查 |

| 📢 传播展示 | 聊天分享、悬浮完整灵纹、MiniMessage 渐变广播、EasyBot 转发适配 |

| 🧩 二开友好 | 提供 37 个 Relic API 事件，便于附属插件扩展/拦截/联动 |

---

[/md]

[md]

---

🌈 系统体验亮点

🧱 从“装备”变成“角色资产”

YuRelic 的核心价值在于让装备不再是一次性消耗品。玩家投入时间、材料和仪式后，灵器会拥有自己的成长记录、主人关系、器魂倾向、路线选择和天榜身份。即使后期更换基础装备，也可以通过承薪传承保留一部分养成价值，降低“旧装备直接报废”的挫败感。

⚔️ 不是只有数值堆叠

插件内置的成长方向不只包含攻击、防御、暴击、吸血、闪避等战斗属性，还包含灵息经验倍率、灵材掉落、同调、器愿、套装共鸣、灵潮影响、器体损耗、封存保护、市场估价与流转印记。服务器可以把它设计成战斗系统，也可以设计成偏收藏、偏养成、偏副本、偏经济流通的系统。

🧪 适合做活动与赛季内容

灵材掉落、天榜排行、觉醒材料、器愿委托、灵潮轮换、限时祝纹、Boss 专属掉落和区域倍率都可以用于活动设计。例如周末开启丰潮、活动副本掉落觉醒核心、赛季末统计灵压榜、节日开放特殊祝纹，都能直接围绕 YuRelic 做运营内容。

🛡️ 面向正式服的安全设计

插件不仅有玩法，还考虑了正式服常见问题：刷怪塔刷经验、无耐久物品绕过成本、跨服复制、数据库重复档案、玩家误丢误归炉、PVP 数值过强、跨服天榜缓存、MySQL 锁、隔离裁定、Doctor 诊断等。对于有经济系统、交易系统或跨服系统的服务器，这些能力非常重要。

---

🧪 玩家主线玩法流程

一个玩家的典型体验可以设计成这样

• 🌱 获得一件装备

玩家获得武器、护甲、工具、盾牌、饰品或特定模组物品。

• ✨ 进行开光

使用 /yr 开光 打开开光 GUI，选择不同档位：

• 凡火初照：经验消耗，适合早期量产。

• 星炉精炼：Vault 金币消耗，更容易出高品质。

• 天工尊启：PlayerPoints 点券消耗，高品质概率更高。

• 📈 使用灵器成长

通过近战、远程、击杀、挖掘、承伤、格挡、吸收经验等方式获取“灵息”。

• 🧭 选择路线与突破

到达等级节点后进入突破阶段，选择适合该物品分类的道途路线。

• 👻 培养器魂

注魂、塑魂、魂阶提升，让器魂影响攻击、防御、经验、吸血、闪避等方向。

• 🧬 铭魂与构筑

解锁天赋，洗练词条，铭刻玄纹，形成不同流派。

• 🛠️ 维护器体

灵器使用会产生器体损耗，状态会从完好逐步变为微损、裂损、重损、濒毁、损毁，需要修复或投入灵材保养。

• 👑 最终觉醒

满足等级、器魂、突破、天赋等条件后完成觉醒，获得后期身份与被动加成。

• 📜 进入器藏与天榜

高价值灵器可被收录进器藏，参与评分、等级、魂阶、觉醒、称号等榜单竞争。

---

🔥 灵器开光系统

YuRelic 的开光不是简单打标签，而是给物品建立完整的灵器数据：ID、主人、分类、品质、器魂、等级、经验、评分、器体、路线、天赋、历史记录等。

✨ 默认三档开光

| 档位 | 默认名称 | 默认消耗 | 特点 |

|---|---|---:|---|

| basic | 🌱 凡火初照 | 1500 经验 | 低成本，适合早期和日常开光 |

| refined | 💠 星炉精炼 | 2000 Vault 金币 | 更容易出现良好/卓越品质 |

| exalted | 👑 天工尊启 | 100 PlayerPoints | 高品质概率显著提升，适合高级玩家 |

🧱 开光物品支持

支持识别

• 🗡️ 剑、斧、三叉戟、重锤等近战武器

• 🏹 弓、弩、枪械类关键词物品

• 🛡️ 盾牌

• 🪖 护甲

• ⛏️ 工具

• 💍 饰品类物品

• 🧩 混合端/模组物品

• 🧪 自定义配置规则命中的特殊物品

默认要求物品能读取到最大耐久，防止无耐久物品无限刷成长。特殊无耐久模组物品可加入白名单，走独立低倍率、冷却、每分钟上限与重复目标衰减规则。

---

🧬 物品识别与混合端兼容

YuRelic 对混合端/模组物品做了比较完整的识别体系，并以 1.8 - 1.26 多版本、多核心环境 为目标进行兼容设计：

• 🔑 Material 名称识别

• 🧭 现代 NamespacedKey 反射识别

• 🏷️ 显示名识别

• 📜 Lore 哈希识别

• 🧬 NBT 指纹识别

• 🛠️ 自定义物品规则 custom-item-rules

• 🧱 模组物品可通过 namespace:item、名称、关键词、指纹等配置匹配

这对 Youer、模组服、自定义装备服非常关键，可以减少“开光后识别错物品”“模组物品显示异常”“换服后档案不稳定”等问题。

---

📈 成长、经验与反刷机制

🌿 基础成长

默认等级上限为 50 级，基础升级经验为 200，经验曲线为 2.0。灵器可以通过不同玩法获得灵息：

• ⚔️ 近战命中

• 🏹 远程命中

• ☠️ 击杀怪物

• ⛏️ 挖掘方块

• 🛡️ 护甲承伤

• 🛡️ 盾牌格挡

• 🟢 玩家经验随行成长

• 💍 饰品经验成长

• 👻 器魂/共鸣/任务类成长

🧯 防刷设计

插件内置多层防刷

• 🪓 耐久门禁：默认只有物品真实发生耐久损耗，才会写入经验。

• 🐄 友好生物限制：友好生物默认不给灵器经验。

• 🐺 中立生物低倍率：中立生物默认只有很低收益。

• 🔁 重复击杀/命中衰减：短时间重复目标会降低收益。

• 🛡️ 承伤防挂机：按最终入体伤害判断，避免高护甲站桩刷经验。

• 🌬️ 灵息疲劳：短时间内收益过高会进入疲劳窗口，hard-cap 后最低只保留 10% 收益。

• 🧪 无耐久白名单独立限制：冷却、每分钟上限、重复目标/方块衰减。

这些机制非常适合正式服，能避免玩家靠除草、养殖场、无伤站桩、刷怪塔等方式把灵器刷爆。

---

🛠️ 器体寿命与修复系统

YuRelic 有独立的 器体寿命 概念。开光后，物品会记录器体上限与器体已损耗，不完全等同于原版耐久。

🧱 器体状态

| 状态 | 含义 |

|---|---|

| 🟢 完好 | 器体健康，正常成长 |

| 🟢 微损 | 轻微损耗，基本不影响体验 |

| 🟡 裂损 | 开始出现成长/战斗衰减 |

| 🟠 重损 | 明显衰减，建议维护 |

| 🔴 濒毁 | 高风险状态，收益明显下降 |

| 🟥 损毁 | 默认阻止成长与效果，需要修复 |

🔧 修复特点

• 支持 /yurelic repair 使用经验修复。

• 支持 /yurelic repair resource <灵材> [数量|all] 投入修灵晶等灵材修复。

• 支持 /yurelic repair bodymax 对旧器进行器体上限升格。

• 默认不要求必须损毁，只要器体有损耗即可保养。

• 默认 YuRelic 修复会同时修复原版外壳耐久。

• 原版铁砧/普通修复默认不会恢复 YuRelic 器体，避免绕过插件经济。

---

💞 灵契、认主、同调与器忆

💍 灵契系统

灵器可绑定器主，并记录

• 当前器主

• 初照/第一任主人

• 灵契代数

• 是否无主

• 是否允许成长

• 重新认主成本

支持

• /yurelic pact info 查看灵契

• /yurelic pact rebind 涤契归心，重新认主

• /yurelic pact clear 清空灵契

🌌 同调与器忆

同调是玩家与灵器之间的契合度系统

• 同调最高默认 5 级。

• 同调可带来经验加成、修复折扣等。

• /yurelic affinity meditate [注入量] 可进行静修共鸣。

• /yurelic affinity memory 可查看器忆文本。

这部分很适合服务器做沉浸式文案和长期绑定感，让玩家不是“换一把武器”，而是在养自己的本命器。💗

---

👻 器魂系统

每件灵器都有器魂倾向，默认包括

| 器魂 | 倾向 | 可能效果方向 |

|---|---|---|

| 🔥 狂烈 | 攻击 | 更偏输出、爆发 |

| 🛡️ 坚守 | 护甲 | 更偏防御、承伤 |

| 🌪️ 轻灵 | 移速/闪避 | 更偏灵巧、闪避 |

| 🩸 饕噬 | 吸血/续航 | 更偏续航，但修复压力更高 |

| 📘 贤明 | 经验 | 更偏成长效率 |

支持

• /yurelic soul info 查看器魂

• /yurelic soul feed [注魂量] 注养器魂

• /yurelic soul reshape [目标] 塑魂/换魂

器魂最高默认 5 级，并且可触发“器魂共鸣”，例如攻击加成、减伤、击杀回复、被动经验、修补器体等。

---

💎 潜质品质系统

灵器开光时会获得潜质品质，影响成长倍率、评分、估价和后续养成价值。

| 潜质 | 默认成长倍率 | 定位 |

|---|---:|---|

| 粗糙 | 0.90 | 低底子，可作为过渡 |

| 普通 | 1.00 | 标准品质 |

| 良好 | 1.08 | 中等优秀 |

| 卓越 | 1.15 | 值得培养 |

| 完美 | 1.22 | 高价值灵器 |

| 神铸 | 1.30 | 极稀有核心灵器 |

支持 /yurelic potential upgrade 进行潜质淬炼。默认高阶潜质会逐步消耗经验、Vault 金币、PlayerPoints 点券以及灵材，适合做后期经济回收。💰

---

🧭 突破、路线与道韵精通

灵器在等级成长过程中会进入突破阶段，默认突破等级节点为：

• Lv.10

• Lv.20

• Lv.30

• Lv.40

突破时会提供候选路线，不同分类有不同路线

🗡️ 近战武器路线

• 破军：高攻击、高破甲

• 迅刃：连击、暴击、灵巧

• 血饮：击杀回复、吸血、续航

• 守反：防守反击、承伤强化

🏹 远程路线

• 狙猎：远距离高伤害

• 穿云：快速拉弓、弹道稳定

• 猎魂：命中成长、续航倾向

🪖 护甲路线

• 铁壁：高减伤和韧性

• 血甲：低血承伤与生存

• 轻甲：机动和闪避

⛏️ 工具路线

• 掘进：挖掘效率

• 寻珍：采集幸运、稀有收益

• 耐耗：耐久效率与低耐久收益

🛡️ 盾牌路线

• 壁垒：格挡强度、群体防护

• 反制：反击与控制

道韵精通会根据成长行为逐渐提升，提供攻击、防御、经验等长期小加成。📚

---

🧬 天赋、铭魂、铭纹与觉醒

🌟 天赋系统

默认最多 5 个天赋，支持

• /yurelic talent list 查看天赋

• /yurelic talent prepare 准备/解锁候选

• /yurelic talent choose <序号> 选择天赋

• /yurelic talent reroll <序号> 洗练天赋

默认天赋包含锋锐、坚韧、轻盈、猎杀、连击、耐耗、嗜血、专注、穿云、厚甲、冰返、反击、寻珍、急采、庇佑、穿透、怒锋、裂甲、追击、连环、踏风、血契、绝境、守鸣、铁意、息壤、魂鸣等。⚡

🔮 铭纹系统

支持铭纹槽与铭刻

• /yurelic glyph info

• /yurelic glyph list

• /yurelic glyph inscribe <铭纹>

• /yurelic glyph erase <序号>

默认铭纹包括

| 铭纹 | 效果方向 |

|---|---|

| 炽纹 | 攻击倍率 |

| 壁纹 | 减伤 |

| 风纹 | 成长倍率 |

| 息纹 | 修复折扣 |

| 魂纹 | 器魂与综合成长 |

👑 觉醒系统

默认觉醒条件

• 等级达到 50

• 器魂等级达到 4

• 突破阶段达到 4

• 至少 3 个天赋

觉醒后可获得额外攻击、减伤、击杀爆发等被动，并让灵器进入后期身份阶段。

---

💍 饰品槽与套装共鸣

插件内置虚拟饰品槽系统，默认 4 个槽位

| 槽位 | 默认名称 | 默认限制 |

|---|---|---|

| 1 | 灵佩 | 默认开放 |

| 2 | 魂坠 | 默认开放 |

| 3 | 戒印 | 需要 yurelic.accessory.slot.3 |

| 4 | 符令 | 需要 yurelic.accessory.slot.4 |

支持

• /yurelic accessory list

• /yurelic accessory equip [槽位]

• /yurelic accessory unequip [槽位]

• /yurelic accessory unlock [槽位]

饰品可以参与灵威计算，也可触发套装共鸣。默认套装包括血月、荒雷、深岩、游猎、星辉，按 2/3/4 件提供攻击、减伤、经验倍率等效果。

---

🧾 灵材、仪式与灵物坊

💠 默认灵材体系

| Key | 名称 | 用途方向 |

|---|---|---|

| POTENTIAL_ESSENCE | 潜质精华 | 潜质淬炼 |

| SOUL_JADE | 换魂玉 | 塑魂/换魂 |

| TALENT_STONE | 洗练石 | 天赋洗练 |

| AWAKENING_CORE | 觉醒核心 | 觉醒仪式 |

| GLYPH_DUST | 玄刻尘 | 铭纹/玄刻 |

| REPAIR_CRYSTAL | 修灵晶 | 修复器体 |

| SOUL_MARROW | 魂髓 | 器魂深层成长 |

| LEGACY_JADE | 承薪玉 | 传承吸纳 |

| SEAL_WAX | 灵匣封蜡 | 封存/灵匣 |

| NAME_SCROLL | 名笺 | 铸名赐号 |

| RELIC_DUST | 器尘 | 归炉与基础仪式 |

| BLESSING_INK | 祝纹灵墨 | 灵祝/祝纹 |

🏮 灵物坊

内置 /yurelic shop 灵物坊，可用于点券购买插件自带灵材。默认价格偏高，定位更像“保底兑换”，不建议完全替代副本/活动产出。

支持

• /yurelic shop gui

• /yurelic shop list

• /yurelic shop buy <商品Key> [数量]

🧯 灵材外壳安全守卫

插件会阻止灵材使用下界之星、龙蛋、鞘翅、图腾、下界合金、钻石、绿宝石、信标、命令方块等高价值原版物品作为实际外壳，避免玩家把带 NBT 的灵材拿去参与原版/第三方合成绕出贵重物品。🔐

---

🧟 灵材掉落生态

YuRelic 有独立掉落表系统，可按怪物、等级、世界、区域、MythicMobs ID 等条件产出灵材。

默认特性

• 🎲 单次最终概率上限默认 6%。

• 🐄 友好/中立生物默认不掉 YuRelic 灵材。

• 🌍 支持世界倍率，例如副本世界更高、竞技场更低。

• 🧭 支持 WorldGuard 区域倍率。

• 👹 支持 MythicMobs 内部 ID 命中。

• 📈 支持 LevelledMobs 等级段倍率。

• 🎁 支持保底 pity 机制。

• 📅 支持每日额度：资源级、掉落表级、玩家总量级。

• 🌐 MySQL 下可用数据库级每日额度，减少跨服并发超发。

掉落模拟

管理员可以用

• /yurelic loot info

• /yurelic loot sim ...

• /yurelic loot simgui ...

模拟不同等级、世界、实体、MythicID、区域、击杀次数下的期望产出，适合上线前调概率。📊

---

⚔️ 战斗属性与 PVP/PVE 分离

YuRelic 不直接替代原版装备系统，而是在原版、附魔、药水和其他插件结算后追加自己的战斗修正。

支持方向

• 🗡️ 攻击加成

• 🛡️ 护甲/减伤

• 💥 暴击

• 🩸 吸血

• 🌪️ 闪避

• 🪞 反伤

• 🏹 投射物加成

• 🧱 破甲

• 💍 套装加成

• 👻 器魂共鸣

• 🔮 铭纹/祝纹/器势/灵潮倍率

并且 PVE 与 PVP 有独立倍率。默认 PVP 输出、吸血、闪避、反伤等会被压低，方便避免数值爆炸。竞技场、副本等世界还可以单独配置倍率。⚖️

---

🧘 器势、灵潮、器愿与灵息疲劳

🥋 器势

玩家可切换器势，默认包括

• 均衡：攻守无偏

• 攻伐：攻击更强，防御略低

• 守御：防御更强，成长略低

• 蕴养：牺牲少量战力换成长

• 狩猎：适合挑战高阶生物

常用输入：/yr 器势 查看可用器势，/yr 器势 切换 攻伐 切换到攻伐器势。

🌊 天地灵潮

服务器会按周期变化天地灵潮，默认 45 分钟轮换一次：

• 平潮

• 涨潮

• 锋潮

• 寂潮

• 丰潮

灵潮可影响经验、攻击、防御、灵材倍率，适合做“限时狩猎/活动窗口”。

📜 器愿委托

灵器可承接阶段目标，例如击杀、命中、高阶讨伐、承伤、采集、经验积累等。完成后可获得经验和灵材奖励。

常用输入：/yr 器愿 查看委托，/yr 器愿 承愿 承接目标，/yr 器愿 换愿 更换目标，/yr 器愿 领取 领取奖励。

🌬️ 灵息疲劳

短时间收益过高会进入疲劳窗口。当前配置支持根据 rpg.base-exp 和 rpg.exp-curve 动态计算阈值，更适合不同等级段平衡。

---

🧿 传承、封存、铸名、归炉、灵护、灵祝

🔥 承薪传承

/yr 承薪 承薪 可让主手灵器吸纳副手旧器的经验、魂息、权重、天赋概率等。默认会消耗供体旧器，适合做“旧装备不完全报废”的长期养成机制。

📦 灵匣封存

/yr 封存 封存 可封存灵器，/yr 封存 启封 可解除封存。封存适合保存收藏、避免误成长或误参与战斗。

🏷️ 铸名赐号

/yr 铸名 赐号 <称号> 可给灵器自定义称号。默认不直接修改原物品显示名，但可通过配置启用展示名格式。

🔥 归炉祭炼

/yr 归炉 预览 可先查看回收结果，/yr 归炉 归炉 可将灵器归炉为灵材。默认阻止觉醒灵器归炉，并要求潜行确认，降低误操作风险。

🔐 灵护

/yr 灵护 立护 可给灵器立下灵护，/yr 灵护 撤护 可解除灵护，/yr 灵护 切换 可快速切换状态。灵护默认用于防误丢、防误归炉、防破坏性操作。是否死亡保留可配置，默认不是无成本永久保护，还带维护消耗。

✨ 灵祝/祝纹

/yr 灵祝 列表 可查看可用祝纹，/yr 灵祝 加护 <祝纹键> 可给主手灵器施加限时祝纹；攻击、防御、成长、掉落等方向均可配置。

---

📜 器藏、天榜、鉴灵札与聊天分享

📚 器藏名录

器藏会收录玩家灵器档案，可在 GUI 或命令中查看：

• /yurelic archive stats

• /yurelic archive scan

• /yurelic archive list [页码]

• /yurelic archive gui [排序] [页码]

• /yurelic archive detail <编号/ID>

• /yurelic archive share <编号/ID>

支持登录、退出、开光、觉醒时自动扫描。

🏆 灵器天榜

支持按多种维度排行

• 评分榜

• 等级榜

• 器魂榜

• 觉醒榜

• 称号榜

常用输入

• /yr 天榜：查看默认评分榜。

• /yr 天榜 界面：打开天榜 GUI。

• /yr 天榜 score 10：查看评分榜前 10 名。

• /yr 天榜 level 10：查看等级榜前 10 名。

• /yr 天榜 soul 10：查看器魂榜前 10 名。

• /yr 天榜 详情 score 1：查看指定榜单中的灵器详情。

• /yr 天榜 缓存 状态、/yr 天榜 缓存 刷新、/yr 天榜 缓存 清空：管理天榜缓存。

天榜数据源支持 AUTO / LOCAL / STORAGE，MySQL 下可做跨服聚合榜，并带缓存、异步刷新和管理员完整 Lore 查看。

🔮 鉴灵札

/yr 鉴灵 会对主手灵器进行评估，展示短板和下一步养成建议，非常适合引导玩家继续培养。

📢 聊天分享

/yr 分享 可把主手灵器发到聊天中，支持悬浮查看完整摘要：等级、灵压、器魂、路线、器主、器体、经验、天赋、铭纹、完整灵纹、综合加成等。默认不暴露灵器 UUID 和内部技术 ID，更适合正式服展示。

---

🖼️ GUI 与视觉表现

插件内置非常完整的 GUI

| GUI 页面 | 用途 |

|---|---|

| ✨ 主菜单 | 灵器总览、开光、养成、灵契、器藏、饰品、鉴灵、修复、运维入口 |

| 🔥 开光页 | 三档开光、概率预览、消耗展示 |

| 📈 等级加成页 | 查看等级、攻击、减伤、路线、经验倍率等推演 |

| 🌌 养成页 | 突破、天赋、注魂、觉醒等入口 |

| ⚔️ 灵器面板 | 完整灵纹、灵威、器魂、器体、下一步建议 |

| 💞 灵契页 | 器主、同调、器势、器忆相关入口 |

| 👻 器魂页 | 器魂查看、注魂、塑魂 |

| 👑 觉醒页 | 觉醒条件和仪式 |

| 💎 潜质页 | 潜质查看和淬炼 |

| 🔮 铭纹页 | 铭纹查看、铭刻、磨去 |

| 📜 器愿页 | 委托目标、进度、领取 |

| 🏆 里程碑页 | 器史里程碑与奖励 |

| 🔁 生命周期页 | 传承、封存、铸名、归炉 |

| 🧭 运维页 | 存储、依赖、Hook、诊断、调试 |

视觉上支持 MiniMessage 渐变、ActionBar、Title、音效、粒子、悬浮文本，并对旧端做了降级兼容。

---

---

🧭 管理、运维与调试

🛠️ 常用管理命令

| 中文功能 | 实际输入示例 | 说明 |

|---|---|---|

| 自定义开光 | /yr 自定义开光 tier=basic level=10 power=500 | 管理员按指定档位、等级、灵压等参数生成测试灵器 |

| 增加主经验 | /yr 经验管理 主经验 1000 | 给主手灵器增加 1000 点主经验 |

| 设置魂息 | /yr 经验管理 魂息 5000 设置 | 将主手灵器魂息设置为指定数值 |

| 扣除同调经验 | /yr 经验管理 同调 500 扣除 | 从主手灵器扣除指定同调经验 |

| 查看可发物品 | /yr 物品管理 列表 | 查看可发放的 YuRelic 灵材和配置样本物品 |

| 发放插件物品 | /yr 物品管理 发放 <物品键> 1 | 发放灵材或配置样本物品；显示名、描述、模型、耐久等运行时参数需配置开启 |

| 查看物品识别 | /yr debugid | 查看主手物品 Material、命名空间、显示名、Lore、NBT 指纹，适合排查模组物品 |

| 查看联动状态 | /yr hooks | 查看 LevelledMobs、MythicMobs、WorldGuard、PlaceholderAPI、EasyBot 等联动状态 |

| 查看运行库 | /yr libs | 查看运行时依赖库加载状态 |

| 查看存储状态 | /yr storage status | 查看 SQLite/MySQL 状态、队列、灵器档案、审计记录等 |

| 手动同步存储 | /yr storage sync | 手动提交在线灵器跨服数据快照 |

| 排查重复档案 | /yr storage duplicates | 扫描疑似重复灵器 ID |

| 灵籍巡检 | /yr 灵籍 巡检 | 检查在线灵器完整性与潜在复制风险 |

| 查看灵籍 | /yr 灵籍 查看 | 查看主手灵器完整性状态 |

| 查看锁列表 | /yr 灵籍 锁 | 查看当前跨服锁/软锁记录 |

| 隔离异常灵器 | /yr 灵籍 隔离 <原因> | 将疑似异常灵器隔离，限制成长或战斗 |

| 裁定解除异常 | /yr 灵籍 裁定 | 清理主手灵器异常/隔离状态 |

| 打开诊断界面 | /yr 诊断 界面 | 图形化检查配置、运行库、联动、存储与风险 |

| 导出诊断报告 | /yr 诊断 export | 导出完整诊断信息，便于反馈问题 |

| 彻底清档 | /yr 彻底清除 <灵器ID> | 彻底清理灵器档案，属于高危操作 |

| 抹除手中灵器 | /yr 抹除手中灵器 | 抹除主手灵器身份并清理档案，属于高危操作 |

| 重载配置 | /yr reload | 重载配置；大范围配置变更仍建议重启服务器 |

🩺 Doctor 诊断

Doctor 会检查

• 默认键缺失/自定义键

• 存储状态

• Hook 状态

• 运行库状态

• 运行环境

• 跨服风险

• 可导出诊断报告

这对于正式服排错很实用，能减少“玩家说不涨经验，但不知道是配置、场景、耐久还是权限问题”的排查成本。🧰

---

🗄️ 存储、跨服与防复制

YuRelic 支持 SQLite 与 MySQL：

• SQLite：适合单服。

• MySQL：适合跨服群组、跨服天榜、数据库级每日掉落额度、跨服锁。

🔐 防复制/完整性机制

包括

• 灵器唯一 ID

• NBT 作为主真相源

• 数据库作为跨服索引、审计、防复制和恢复辅助

• 存储快照

• 重复档案扫描

• 灵器软锁

• MySQL 事务原子锁

• 锁续租、过期接管、强制解锁

• 隔离状态：可禁成长、禁战斗、显示在 Lore

• 冲突附魔剥离，例如第三方 soulbound 与 YuRelic 灵护冲突时可自动处理

对有交易、跨服、排行、贵重装备流转的服务器来说，这是很关键的底层能力。🧱

---

🔌 外部插件联动

| 联动 | 用途 |

|---|---|

| LevelledMobs | 读取怪物等级，影响经验、掉落、潜质材料门槛、高阶击杀等 |

| MythicMobs | 掉落表可按 MythicMobs 内部 ID 匹配 Boss/精英怪 |

| WorldGuard | 掉落区域倍率、区域过滤、场景联动 |

| Vault | 金币消耗：开光、重绑、注魂、灵护维护等 |

| PlayerPoints | 点券消耗：高阶开光、潜质、商店、赞助面板引导等 |

| PlaceholderAPI | 注册 %yurelic_*% 占位符，用于菜单、计分板、TAB、聊天等 |

| EasyBot | 结构化广播/玩家聊天输出，适配 QQ/机器人转发场景 |

未安装相关插件时，YuRelic 会尽量静默降级，不强制硬依赖。

---

🧩 PlaceholderAPI 占位符生态

安装 PlaceholderAPI 后，插件会注册 %yurelic_*%。常用占位符包括：

| 占位符 | 说明 |

|---|---|

| %yurelic_item% | 当前主手灵器名称 |

| %yurelic_level% | 灵器等级 |

| %yurelic_exp_percent% | 当前等级经验百分比 |

| %yurelic_score% | 灵器评分/灵压 |

| %yurelic_potential% | 潜质品质 |

| %yurelic_route% | 当前路线 |

| %yurelic_body_left% | 剩余器体 |

| %yurelic_open_can% | 当前主手是否可开光 |

| %yurelic_lingwei% / %yurelic_spirit_power% | 综合灵威，统计主手与饰品 |

| %yurelic_panel_item% | 菜单面板用物品名 |

| %yurelic_panel_power% | 菜单面板用灵威 |

| %yurelic_panel_progress% | 菜单面板用进度 |

| %yurelic_panel_body% | 菜单面板用器体 |

| %yurelic_panel_next% | 下一步建议 |

| %yurelic_rank_score_1_owner% | 天榜第 1 名主人 |

| %yurelic_rank_score_1_item% | 天榜第 1 名物品 |

| %yurelic_rank_score_1_score% | 天榜第 1 名评分 |

这让灵器信息可以很方便地接入菜单、计分板、TAB、聊天称号或官网展示。

---

📢 广播与机器人转发

内置广播系统支持

• 开光广播

• 升级广播

• 觉醒广播

• 器魂升级/塑魂广播

• 同调升级广播

• 灵契重绑/清契广播

• 铭纹广播

• 彻底清理广播

• 更多事件模板可开关

广播支持 MiniMessage 渐变、悬浮灵纹摘要，也支持 EasyBot 输出。默认 EasyBot 采用 chat 输出模式，避免 QQ 转发时把 <gradient>、<hover> 标签原样发出去。🤖

---

🧩 API 与二开能力

插件提供 37 个 Relic 相关 Bukkit 事件，适合附属插件做限制、奖励、日志、活动、跨服联动或特殊副本规则。

事件覆盖

• 开光、升级、经验获取、突破准备

• 潜质、器魂、同调、灵契

• 天赋、铭纹、觉醒、器魂共鸣

• 资源变化、仪式消耗、掉落灵材

• 修复、耐久、器体损耗

• 传承、封存、铸名、归炉、灵护、灵祝

• 器愿、里程碑、试炼进度、路线精通

• 战斗属性构筑与战斗修正

• 器藏记录、天榜查询、天榜详情

• 市场估价与流转印记

• 饰品槽变化

这说明插件不是封闭黑盒，后期扩展空间比较大。🛠️

---

📘 操作手册

本手册按“玩家怎么用”和“管理怎么上线维护”整理，适合直接放到插件介绍页、服务器 Wiki 或群公告中。命令默认以 /yr 为示例，实际也可使用 /yurelic、/yrelic、/relic、/yurpg、/yrpg。

👤 玩家上手流程

1️⃣ 打开主界面

玩家进入服务器后，可先输入

/yr

该命令会打开 YuRelic 主菜单。主菜单通常包含开光、养成、灵契、器藏、饰品、鉴灵、修复等入口，适合新玩家从 GUI 中理解系统。🧭

2️⃣ 准备一件可开光物品

把想培养的物品拿在主手，例如剑、斧、弓、弩、三叉戟、盾牌、护甲、工具、饰品或服务器配置允许的模组物品。默认情况下，物品需要能读取到最大耐久；无耐久特殊物品需要服务器在配置中加入白名单。

3️⃣ 进行开光

推荐通过 GUI 开光

/yr 开光

开光时会根据服务器配置消耗经验、金币、点券或灵材，并生成灵器的基础数据，包括器魂、潜质、器体、等级、评分、灵契、成长路线等。不同开光档位会影响高品质出现概率，正式服通常会把高阶开光作为活动、点券或高成本玩法。

4️⃣ 查看灵器状态

开光后，把灵器拿在主手，可查看详细信息

/yr info

如果想把主手灵器展示给其他玩家，可使用

/yr 分享

聊天分享支持悬浮查看完整灵纹摘要，适合交易、炫耀、天榜竞争和活动展示。📢

5️⃣ 通过实际使用获得成长

灵器会在实际使用中获得灵息经验。常见来源包括

• ⚔️ 使用武器近战命中、击杀怪物

• 🏹 使用弓、弩等远程武器命中目标

• ⛏️ 使用工具挖掘方块

• 🛡️ 穿戴护甲承受伤害

• 🛡️ 使用盾牌格挡伤害

• 💍 饰品入槽后参与部分成长与灵威统计

• 📜 完成器愿、里程碑、试炼等长期目标

如果发现成长变慢，可能是灵息疲劳、目标重复衰减、场景倍率、PVP/PVE 倍率、器体损毁或服务器防刷规则生效。

6️⃣ 到达节点后突破路线

灵器到达阶段节点后，会出现突破候选。先查看候选路线：

/yr breakthrough

选择第 1 条路线示例

/yr breakthrough 1

路线会影响后续属性倾向和成长方向，例如更偏攻击、防御、成长、狩猎、工具效率或特殊效果。

7️⃣ 培养器魂、潜质、天赋与铭纹

灵器中期成长主要围绕几条线展开

/yr 器魂

/yr 器魂 注魂 500

/yr 器魂 塑魂

/yr 潜质

/yr 潜质 淬炼

/yr 铭魂

/yr 铭魂 铭魂

/yr 铭魂 选择 1

/yr 铭魂 洗练 1

/yr 铭纹

/yr 铭纹 列表

/yr 铭纹 玄刻 <铭纹键>

/yr 铭纹 磨去 1

其中 <铭纹键> 需要按服务器配置或 GUI 显示填写。普通玩家更推荐通过 GUI 操作，减少输错配置键。

8️⃣ 器体维护与修复

灵器有独立器体寿命。器体损耗过高会影响成长和效果，严重时会进入损毁状态。查看器体：

/yr 器体

使用经验修复

/yr repair 500

使用灵材修复

/yr repair 灵材 <灵材键> 1

/yr repair 灵材 <灵材键> 全部

/yr repair 升格

9️⃣ 后期觉醒与展示

满足等级、器魂、突破、天赋、试炼等条件后，可查看觉醒条件：

/yr 觉醒

开始觉醒

/yr 觉醒 觉醒

完成觉醒的灵器适合进入器藏、参与天榜、聊天展示或作为服务器高价值装备流转。👑

---

🧑‍💼 管理上线流程

1️⃣ 安装与依赖检查

• 将插件放入服务器 plugins 文件夹。

• 启动服务器生成配置文件。

• 确认服务器核心与版本环境。插件目标适配 1.8 - 1.26，覆盖 Paper、Spigot、Paper 衍生核心、Youer、Arclight、Mohist 等常见核心与混合端；当前已测试环境为 Youer 1.21.1。

• 根据服务器类型决定是否接入 Vault、PlayerPoints、PlaceholderAPI、LevelledMobs、MythicMobs、WorldGuard、EasyBot。

• 跨服群组建议配置 MySQL，并确保每个子服的 server-id 唯一。

• 修改配置后建议重启服务器，正式服不建议只依赖热重载完成大版本配置变更。

• 如果在特定核心或版本下出现开光、物品识别、NBT、耐久、属性、GUI、跨服同步等兼容性问题，请在 QQ 群内反馈。

检查联动状态

/yr hooks

检查运行库

/yr libs

打开诊断界面

/yr 诊断 界面

2️⃣ 兼容性测试

不同核心和版本建议先做一轮基础兼容性检查，尤其是混合端和模组端：

• 原版武器、护甲、工具、盾牌能否正常开光。

• 模组物品或自定义物品能否正确识别分类、最大耐久、名称、Lore 与 NBT。

• 战斗、挖掘、承伤、格挡是否能正常触发成长。

• GUI 是否能正常打开，按钮是否能点击，物品是否会被异常吞掉或复制。

• 重启服务器后，灵器数据、器藏数据、饰品槽数据是否仍然正常。

• 跨服环境下，不同子服的灵器档案和锁状态是否同步稳定。

如遇兼容性问题，建议在群内反馈服务端核心、Minecraft 版本、YuRelic 版本、完整报错日志、触发操作和问题物品来源。

3️⃣ 开光测试

用普通玩家权限测试三件事

• 主手普通装备能否打开开光界面。

• 经验、金币、点券或灵材消耗是否符合预期。

• 开光后 Lore、属性、器魂、潜质、器体是否正常显示。

管理员自定义开光可用于测试

/yr 自定义开光 tier=basic level=10 power=500

4️⃣ 成长与反刷测试

建议分别测试以下场景

• 普通怪物击杀是否给经验。

• 友好生物是否被限制。

• 挖掘、承伤、盾牌格挡是否触发成长。

• PVP 世界的数值是否过高。

• 无耐久模组物品是否被正确限制。

• 灵息疲劳是否能防止短时间爆刷。

查看战斗乘区

/yr 战斗

查看当前场景规则

/yr 场景

查看灵息疲劳

/yr 灵息

4️⃣ 灵材掉落与经济测试

查看掉落生态

/yr 掉落

打开掉落模拟界面

/yr 掉落 模拟界面

测试灵物坊

/yr 灵物坊

/yr 灵物坊 列表

管理员发放灵材测试

/yr 资源 发放 <灵材键> 64 <玩家名>

建议上线前确认灵材产出、灵物坊价格、Boss 掉落、每日上限和点券消耗，避免后期经济膨胀。

5️⃣ 数据库、跨服与防复制检查

单服可使用 SQLite，跨服服群建议使用 MySQL。正式服上线前至少检查：

/yr storage status

/yr storage sync

/yr storage duplicates

灵籍完整性巡检

/yr 灵籍 巡检

查看主手灵器锁信息

/yr 灵籍 查看

跨服出现疑似复制、锁冲突、异常档案时，可使用 Doctor 导出报告，再结合数据库记录处理。

6️⃣ 权限分层建议

普通玩家通常只需要使用、开光、养成、修复、分享、天榜、器藏、饰品、灵物坊等权限。以下权限建议只给 OP 或高级管理：

• yurelic.open.admin

• yurelic.exp.admin

• yurelic.item.admin

• yurelic.resource.admin

• yurelic.storage

• yurelic.integrity

• yurelic.diagnose

• yurelic.purge

• yurelic.reload

其中清档、发物品、改经验、跨服锁和数据库相关权限一定不要给普通玩家。🔐

---

🧯 常见问题排查

| 问题 | 优先检查 |

|---|---|

| 物品无法开光 | 主手是否为空、是否已有灵器、物品是否支持、是否有最大耐久、无耐久白名单是否配置 |

| 灵器不涨经验 | 器体是否损毁、是否封存/隔离、是否命中防刷规则、是否在禁用世界/区域、是否达到灵息疲劳 |

| 开光提示金币/点券不足 | Vault、PlayerPoints 是否安装并 Hook 成功，玩家余额是否足够 |

| 模组物品识别异常 | 使用 /yr debugid 查看 Material、命名空间、显示名、Lore、NBT 指纹 |

| 天榜不刷新 | 检查天榜数据源、缓存设置、MySQL 状态，必要时执行天榜刷新 |

| 跨服出现重复档案 | 检查 MySQL、server-id、跨服锁、storage duplicates 与灵籍巡检结果 |

| 玩家误归炉/误丢 | 开启灵护、封存、二次确认、归炉限制和高价值操作提示 |

| PVP 数值过强 | 检查 PVP damage/defense/crit/lifesteal 缩放和世界覆盖配置 |

---

🧾 玩家常用命令汇总

> 说明：下表优先使用中文别名和中文动作词，尽量避免原先 info|list|set 这类英文管道写法。少数功能的插件主入口本身没有中文别名，表中会保留实际可输入命令，避免写成无效指令。<灵材键>、<商品键>、<铭纹键>、<玩家名> 等需要按服务器实际配置或 GUI 提示填写。

🌱 新手与日常操作

| 中文功能 | 实际输入示例 | 用途说明 |

|---|---|---|

| 打开主菜单 | /yr | 打开 YuRelic 主 GUI，进入开光、养成、修复、饰品、器藏等页面 |

| 打开开光界面 | /yr 开光 | 对主手物品进行开光，推荐玩家使用 GUI 选择档位 |

| 基础开光 | /yr 开光 basic | 直接使用基础档位开光，适合低成本体验 |

| 精炼开光 | /yr 开光 refined | 直接使用精炼档位开光，品质概率更高 |

| 尊启开光 | /yr 开光 exalted | 直接使用高阶档位开光，适合点券/活动玩法 |

| 查看主手灵器 | /yr info | 查看等级、经验、潜质、器魂、路线、器体、灵契等信息 |

| 分享灵器 | /yr 分享 | 将主手灵器发送到聊天，其他玩家可悬浮查看摘要 |

| 鉴灵建议 | /yr 鉴灵 | 查看主手灵器短板、成长建议和后续培养方向 |

| 查看器体 | /yr 器体 | 查看主手灵器器体耐久与损耗状态 |

| 查看战斗乘区 | /yr 战斗 | 查看当前 PVP/PVE、暴击、吸血、闪避、反伤等战斗开关 |

| 查看场景规则 | /yr 场景 | 查看当前世界/区域的成长、掉落、战斗倍率规则 |

| 查看灵息疲劳 | /yr 灵息 | 查看当前养成效率、疲劳窗口、软/硬阈值 |

📈 成长、突破与养成

| 中文功能 | 实际输入示例 | 用途说明 |

|---|---|---|

| 查看突破候选 | /yr breakthrough | 灵器达到节点后查看可选路线 |

| 选择突破路线 | /yr breakthrough 1 | 选择第 1 条突破路线，数字按候选列表填写 |

| 查看潜质 | /yr 潜质 | 查看当前潜质、下一阶潜质和淬炼消耗 |

| 淬炼潜质 | /yr 潜质 淬炼 | 消耗配置材料/经验提升灵器潜质 |

| 查看器魂 | /yr 器魂 | 查看器魂类型、魂阶、魂息和塑魂状态 |

| 注养器魂 | /yr 器魂 注魂 500 | 消耗配置货币或经验注入魂息，推动器魂进阶 |

| 重塑器魂 | /yr 器魂 塑魂 | 使用换魂类资源重塑器魂倾向 |

| 查看同调 | /yr 同调 | 查看灵契同调等级、经验和当前回应状态 |

| 静修共鸣 | /yr 同调 静修 500 | 注入一定经验/资源提升同调 |

| 查看器忆 | /yr 同调 器忆 | 查看灵器记忆、回响或相关成长记录 |

| 查看道韵精通 | /yr 道韵 | 查看主手灵器路线精通与积累 |

| 查看觉醒条件 | /yr 觉醒 | 查看是否满足觉醒所需等级、器魂、突破、天赋、试炼等条件 |

| 开始觉醒 | /yr 觉醒 觉醒 | 满足条件后执行觉醒仪式 |

🧬 天赋、铭纹、器愿与里程碑

| 中文功能 | 实际输入示例 | 用途说明 |

|---|---|---|

| 查看天赋 | /yr 铭魂 | 查看当前天赋数量和已拥有天赋 |

| 准备铭魂 | /yr 铭魂 铭魂 | 生成候选天赋，等待玩家选择 |

| 选择天赋 | /yr 铭魂 选择 1 | 从候选中选择第 1 项铭入灵器 |

| 洗练天赋 | /yr 铭魂 洗练 1 | 洗练第 1 个已有天赋 |

| 查看铭纹 | /yr 铭纹 | 查看当前铭纹槽和已玄刻铭纹 |

| 查看可用铭纹 | /yr 铭纹 列表 | 查看可玄刻铭纹、说明和材料需求 |

| 玄刻铭纹 | /yr 铭纹 玄刻 <铭纹键> | 将指定铭纹刻入主手灵器 |

| 磨去铭纹 | /yr 铭纹 磨去 1 | 移除第 1 个铭纹 |

| 查看器愿 | /yr 器愿 | 查看当前器愿委托与进度 |

| 承接器愿 | /yr 器愿 承愿 | 为主手灵器承接阶段目标 |

| 更换器愿 | /yr 器愿 换愿 | 重新刷新器愿目标 |

| 领取器愿 | /yr 器愿 领取 | 完成目标后领取器愿奖励 |

| 查看里程碑 | /yr 里程碑 | 查看器史里程碑完成情况 |

| 领取里程碑 | /yr 里程碑 领取 <编号> | 达成后领取对应奖励 |

| 查看试炼 | /yr 试炼 | 查看讨伐、采掘、承伤、远击、Boss 等长期试炼记录 |

| 查看图鉴履历 | /yr 图鉴 | 查看主手灵器图鉴、履历和成长记录 |

💍 饰品、套装与器势

| 中文功能 | 实际输入示例 | 用途说明 |

|---|---|---|

| 打开饰品界面 | /yr 饰品 界面 | 打开虚拟饰品槽 GUI |

| 查看饰品槽 | /yr 饰品 | 查看已解锁槽位和当前佩戴饰品 |

| 佩戴饰品 | /yr 饰品 佩戴 1 | 将主手饰品类灵器放入第 1 个饰品槽 |

| 卸下饰品 | /yr 饰品 卸下 1 | 清空第 1 个饰品槽 |

| 解锁槽位 | /yr 饰品 解锁 3 | 解锁第 3 个饰品槽，具体条件由服务器配置决定 |

| 查看套装共鸣 | /yr 共鸣 | 查看当前穿戴/饰品触发的套装共鸣 |

| 查看器势 | /yr 器势 | 查看可用器势与当前器势 |

| 切换器势 | /yr 器势 切换 攻伐 | 切换到指定器势，器势键按服务器提示填写 |

| 查看灵潮 | /yr 灵潮 | 查看当前天地灵潮及其成长、攻击、防御、灵材倍率 |

🛠️ 修复、保护与生命周期

| 中文功能 | 实际输入示例 | 用途说明 |

|---|---|---|

| 打开修复界面 | /yr repair 界面 | 打开灵器修复/保养 GUI |

| 经验修复 | /yr repair 500 | 投入指定经验点修复器体 |

| 灵材修复 | /yr repair 灵材 <灵材键> 1 | 使用指定灵材修复器体 |

| 投入全部灵材 | /yr repair 灵材 <灵材键> 全部 | 一次性投入可用灵材进行修复 |

| 器体升格 | /yr repair 升格 | 对旧器进行器体上限升格或重塑 |

| 查看灵契 | /yr qiyue | 查看主手灵器当前器主、初照主人、契序和成长回应状态 |

| 重新认主 | /yr qiyue 认主 | 让灵器重新绑定当前玩家，具体消耗按服务器配置执行 |

| 查看灵护 | /yr 灵护 | 查看主手灵器灵护状态 |

| 立下灵护 | /yr 灵护 立护 | 防误丢、防误归炉、防破坏性操作 |

| 撤销灵护 | /yr 灵护 撤护 | 关闭灵护保护 |

| 查看封存 | /yr 封存 | 查看主手灵器是否处于灵匣封存状态 |

| 封存灵器 | /yr 封存 封存 | 将灵器封存，适合收藏或暂停使用 |

| 启封灵器 | /yr 封存 启封 | 解除封存，恢复正常使用 |

| 查看承薪 | /yr 承薪 | 查看主手灵器承薪信息，副手放旧器可预览收益 |

| 承薪传承 | /yr 承薪 承薪 | 主手灵器吸纳副手旧器的部分成长，通常会消耗旧器 |

| 查看铸名 | /yr 铸名 | 查看灵器当前称号 |

| 设置称号 | /yr 铸名 赐号 星陨之刃 | 为灵器设置专属称号 |

| 清除称号 | /yr 铸名 清除 | 移除灵器称号 |

| 归炉预览 | /yr 归炉 预览 | 查看归炉可获得的灵材，避免误操作 |

| 确认归炉 | /yr 归炉 归炉 | 将主手灵器祭炼回收为灵材，通常不可逆 |

📚 器藏、天榜、市场与展示

| 中文功能 | 实际输入示例 | 用途说明 |

|---|---|---|

| 查看器藏统计 | /yr 器藏 统计 | 查看器藏记录数量与统计信息 |

| 扫描器藏 | /yr 器藏 扫描 | 扫描背包灵器并收录档案 |

| 打开器藏 | /yr 器藏 界面 | 打开器藏 GUI，查看灵器名录 |

| 查看器藏详情 | /yr 器藏 详情 <编号或ID> | 查看某件收录灵器详情 |

| 分享器藏记录 | /yr 器藏 分享 <编号或ID> | 将器藏中的灵器记录分享到聊天 |

| 查看天榜 | /yr 天榜 | 默认查看灵压/评分榜 |

| 打开天榜界面 | /yr 天榜 界面 | 打开天榜 GUI |

| 查看等级榜 | /yr 天榜 level 10 | 查看等级榜前 10 名 |

| 查看器魂榜 | /yr 天榜 soul 10 | 查看器魂相关排行 |

| 查看觉醒榜 | /yr 天榜 awakened 10 | 查看觉醒灵器排行 |

| 查看称号榜 | /yr 天榜 title 10 | 查看拥有称号的灵器排行 |

| 查看天榜详情 | /yr 天榜 详情 score 1 | 查看指定榜单指定编号/ID 的详情 |

| 查看估价 | /yr 估价 | 查看主手灵器市场估价 |

| 主副手对比 | /yr 估价 对比 | 对比主手与副手灵器价值 |

| 标记流转 | /yr 估价 流转 | 为灵器记录一次流转/转手印记 |

| 清除流转 | /yr 估价 清除 | 清理流转标记 |

✨ 灵祝、掉落与灵物坊

| 中文功能 | 实际输入示例 | 用途说明 |

|---|---|---|

| 查看灵祝 | /yr 灵祝 | 查看当前祝纹/加护状态 |

| 查看祝纹列表 | /yr 灵祝 列表 | 查看可领取祝纹 |

| 领取祝纹 | /yr 灵祝 加护 growth | 为主手灵器施加指定祝纹，祝纹键按服务器配置填写 |

| 清除祝纹 | /yr 灵祝 清除 | 移除当前祝纹 |

| 查看掉落生态 | /yr 掉落 | 查看灵材掉落、额度、表和倍率信息 |

| 掉落模拟 | /yr 掉落 模拟 | 文本模拟掉落结果，适合管理测试 |

| 掉落模拟界面 | /yr 掉落 模拟界面 | 打开按钮式掉落模拟 GUI |

| 打开灵物坊 | /yr 灵物坊 | 打开插件内置灵材商店 |

| 查看商品列表 | /yr 灵物坊 列表 | 以文字查看可购买商品 |

| 购买商品 | /yr 灵物坊 购买 <商品键> 1 | 购买指定灵材或配置商品 |

| 查看背包灵材 | /yr 资源 | 查看自己持有的 YuRelic 灵材数量 |

🧭 管理常用命令

| 中文功能 | 实际输入示例 | 用途说明 |

|---|---|---|

| 自定义开光 | /yr 自定义开光 tier=basic level=10 power=500 | 管理员按指定参数生成测试灵器 |

| 查看识别信息 | /yr debugid | 查看主手物品 Material、命名空间、Lore、NBT 指纹等识别信息 |

| 查看联动状态 | /yr hooks | 检查 Vault、PlayerPoints、WorldGuard、MythicMobs、LevelledMobs、EasyBot 等 Hook 状态 |

| 查看运行库 | /yr libs | 检查运行时依赖库加载状态 |

| 打开诊断 | /yr 诊断 界面 | 打开 Doctor 诊断 GUI |

| 导出诊断 | /yr 诊断 export | 导出配置、存储、Hook、运行库和风险信息 |

| 存储状态 | /yr storage status | 查看 SQLite/MySQL、队列、灵器记录和审计状态 |

| 同步存储 | /yr storage sync | 手动提交在线灵器快照 |

| 查重档案 | /yr storage duplicates | 检查疑似重复灵器 ID |

| 灵籍巡检 | /yr 灵籍 巡检 | 扫描在线灵器完整性和潜在风险 |

| 查看主手灵籍 | /yr 灵籍 查看 | 查看主手灵器完整性信息 |

| 查看锁列表 | /yr 灵籍 锁 | 查看当前软锁/跨服锁记录 |

| 隔离主手灵器 | /yr 灵籍 隔离 <原因> | 将异常灵器隔离，限制成长或战斗 |

| 裁定解除 | /yr 灵籍 裁定 | 清理主手灵器隔离/异常标记 |

| 给予经验 | /yr 经验管理 主经验 1000 | 给主手灵器增加主经验 |

| 设置经验 | /yr 经验管理 主经验 5000 设置 | 将主手灵器主经验设置为指定值 |

| 扣除经验 | /yr 经验管理 主经验 500 扣除 | 扣除主手灵器指定经验 |

| 查看可发物品 | /yr 物品管理 list | 查看可发放的插件灵材和配置样本物品 |

| 发放物品 | /yr 物品管理 <物品键> 1 | 给自己发放插件物品或灵材 |

| 彻底清档 | /yr 彻底清除 <灵器ID> | 删除指定灵器档案，属于高危操作 |

| 抹除手中灵器 | /yr 抹除手中灵器 | 抹除主手灵器身份并清理档案，属于高危操作 |

| 重载配置 | /yr reload | 重载配置；大改配置后仍建议重启服务器 |

---

🔑 权限概览

👤 玩家默认权限

多数玩家功能默认开启，例如

• yurelic.use

• yurelic.open

• yurelic.share

• yurelic.repair

• yurelic.breakthrough

• yurelic.pact

• yurelic.affinity

• yurelic.soul

• yurelic.talent

• yurelic.awaken

• yurelic.accessory

• yurelic.potential

• yurelic.resource

• yurelic.codex

• yurelic.trial

• yurelic.sets

• yurelic.glyph

• yurelic.milestone

• yurelic.stance

• yurelic.tide

• yurelic.vow

• yurelic.breath

• yurelic.heritage

• yurelic.seal

• yurelic.title

• yurelic.salvage

• yurelic.archive

• yurelic.rank

• yurelic.appraise

• yurelic.durability

• yurelic.guard

• yurelic.market

• yurelic.blessing

• yurelic.combat

• yurelic.loot

• yurelic.mastery

• yurelic.scene

• yurelic.gui

• yurelic.shop

🛡️ OP/管理权限

• yurelic.open.admin

• yurelic.resource.admin

• yurelic.pact.admin

• yurelic.debug

• yurelic.libs

• yurelic.storage

• yurelic.integrity

• yurelic.diagnose

• yurelic.reload

• yurelic.rank.admin

• yurelic.exp.admin

• yurelic.item.admin

• yurelic.purge

🚀 经验倍率权限

• yurelic.exp.multiplier.2

• yurelic.exp.multiplier.1.5

• yurelic.exp.multiplier.2_5

多个倍率权限默认取最高值，适合会员、活动、周末倍率等运营场景。

---

🗂️ 配置结构

主配置 config.yml 很轻，实际配置拆分为模块：

| 文件 | 内容 |

|---|---|

| configs/01-core.yml | 命令、运行库、存储、Hook、诊断 |

| configs/02-items.yml | 物品识别、分类、潜质、评分 |

| configs/03-growth-combat.yml | 成长、经验、耐久、器体、战斗、反刷 |

| configs/04-souls-routes-talents.yml | 器魂、路线、突破、天赋、觉醒 |

| configs/05-accessories-sets.yml | 饰品槽、槽位解锁、死亡规则、套装 |

| configs/06-resources-rituals.yml | 灵材、仪式、铭纹、里程碑 |

| configs/07-display-effects-gui.yml | 展示文本、特效、分享、灵物坊、GUI、广播 |

| configs/08-advanced-systems.yml | 器势、灵潮、器愿、疲劳、传承、封存、铸名、归炉、器藏、天榜、灵护、估价、灵祝、PAPI |

| configs/09-loot-integrity-scene.yml | 掉落生态、防复制、跨服锁、场景规则 |

| messages.yml | 全部消息文本 |

主 config.yml 支持写覆盖项，方便保留默认模块文件，只在主配置中覆盖少量平衡参数。

---

🧑‍💼 运营与配置建议

✅ 生存服推荐开法

• 开启基础开光和精炼开光，尊启作为点券/活动档。

• 灵材主要靠副本、Boss、活动掉落，商店只做高价保底。

• 开启灵息疲劳、耐久门禁、友好生物限制。

• PVP 倍率保持默认压低，避免灵器变成秒人系统。

• 灵护维护费用不要太低，防止高价值灵器完全无风险。

✅ RPG/副本服推荐开法

• 接 LevelledMobs / MythicMobs / WorldGuard。

• 给不同副本区域配置掉落倍率。

• 用 MythicMobs ID 绑定 Boss 专属掉落表。

• 用天榜、器藏、广播刺激玩家追求高评分灵器。

• 把觉醒核心、承薪玉、魂髓作为高阶副本产出。

✅ 跨服服群推荐开法

• 使用 MySQL，不建议跨服用 SQLite。

• 天榜数据源使用 STORAGE 或 AUTO。

• 掉落额度建议使用 STORAGE，严格服群可关闭 fallback-local。

• 跨服锁建议开启 MySQL 原子锁。

• 定期使用 /yurelic storage duplicates 和 Doctor 导出报告巡检。

⚠️ 上线前重点检查

• 确认 Vault / PlayerPoints 是否安装，否则相关消耗档位需要调整。

• 确认是否需要 PlaceholderAPI、EasyBot、LevelledMobs、MythicMobs、WorldGuard。

• 确认 storage.server-id 每个子服唯一。

• 检查 loot.daily-limit 是否符合服群经济。

• 检查 PVP 世界倍率是否过高。

• 检查开光档位价格和高品质概率。

• 检查灵材商店价格，避免点券/金币通胀。

• 检查无耐久白名单，避免无耐久物品绕过成长成本。

• 检查管理员权限，不要把 yurelic.purge、yurelic.item.admin、yurelic.exp.admin 给普通玩家。

---

🧾 总结

YuRelic 的定位是一个 重养成、重运营、重长期目标 的灵器 RPG 系统。它的亮点不是“给装备加一点攻击力”，而是把服务器装备体系变成可持续运营的内容：

• 玩家有长期培养目标；

• 服务器有经济回收点；

• 活动有灵材和觉醒核心作为奖励；

• 高玩有天榜、器藏、称号、分享展示；

• 管理有诊断 GUI、存储、跨服锁、防复制；

• 二开有 API 事件和 PlaceholderAPI 生态。

如果服务器希望增加一个能贯穿前期、中期、后期的装备成长系统，YuRelic 已经具备比较完整的闭环：开光 → 成长 → 突破 → 构筑 → 维护 → 觉醒 → 传承/收藏/天榜。✨