原创 付费 娱乐 游戏模式 YuRelic —— RPG | 灵器成长系统丨开光养成丨器魂注魂丨饰品铭纹丨灵材炼化丨天榜排行丨跨服存储丨支持 1.8-1.26 多核心 1.0.13.31

[MD] # 🌟 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 群](https://qm.qq.com/q/8ayBLhpd28) | | ⚠️ 免费版说明 | 免费试用版本仅供体验，不提供任何免费版本支持 | | 🐛 Bug 与建议反馈 | [GitHub Issue 反馈页](https://github.com/vicuna-main/YuRelicIssueReport) | | 💎 高级版本赞助 | [爱发电赞助地址](https://afdian.com/item/0699c320541211f1b9e952540025c377) | | 📚 插件 Wiki / 使用文档 | [插件文档](https://vicuna-main.github.io/YuPluginHub) | --- ## 🎯 适合什么服务器？ 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 事件，便于附属插件扩展/拦截/联动 | --- ## 🌈 系统体验亮点 ### 🧱 从“装备”变成“角色资产” YuRelic 的核心价值在于让装备不再是一次性消耗品。玩家投入时间、材料和仪式后，灵器会拥有自己的成长记录、主人关系、器魂倾向、路线选择和天榜身份。即使后期更换基础装备，也可以通过承薪传承保留一部分养成价值，降低“旧装备直接报废”的挫败感。 ### ⚔️ 不是只有数值堆叠 插件内置的成长方向不只包含攻击、防御、暴击、吸血、闪避等战斗属性，还包含灵息经验倍率、灵材掉落、同调、器愿、套装共鸣、灵潮影响、器体损耗、封存保护、市场估价与流转印记。服务器可以把它设计成战斗系统，也可以设计成偏收藏、偏养成、偏副本、偏经济流通的系统。 ### 🧪 适合做活动与赛季内容 灵材掉落、天榜排行、觉醒材料、器愿委托、灵潮轮换、限时祝纹、Boss 专属掉落和区域倍率都可以用于活动设计。例如周末开启丰潮、活动副本掉落觉醒核心、赛季末统计灵压榜、节日开放特殊祝纹，都能直接围绕 YuRelic 做运营内容。 ### 🛡️ 面向正式服的安全设计 插件不仅有玩法，还考虑了正式服常见问题：刷怪塔刷经验、无耐久物品绕过成本、跨服复制、数据库重复档案、玩家误丢误归炉、PVP 数值过强、跨服天榜缓存、MySQL 锁、隔离裁定、Doctor 诊断等。对于有经济系统、交易系统或跨服系统的服务器，这些能力非常重要。 --- ## 🧪 玩家主线玩法流程 一个玩家的典型体验可以设计成这样： 1. 🌱 **获得一件装备** 玩家获得武器、护甲、工具、盾牌、饰品或特定模组物品。 2. ✨ **进行开光** 使用 `/yr 开光` 打开开光 GUI，选择不同档位： - 凡火初照：经验消耗，适合早期量产。 - 星炉精炼：Vault 金币消耗，更容易出高品质。 - 天工尊启：PlayerPoints 点券消耗，高品质概率更高。 3. 📈 **使用灵器成长** 通过近战、远程、击杀、挖掘、承伤、格挡、吸收经验等方式获取“灵息”。 4. 🧭 **选择路线与突破** 到达等级节点后进入突破阶段，选择适合该物品分类的道途路线。 5. 👻 **培养器魂** 注魂、塑魂、魂阶提升，让器魂影响攻击、防御、经验、吸血、闪避等方向。 6. 🧬 **铭魂与构筑** 解锁天赋，洗练词条，铭刻玄纹，形成不同流派。 7. 🛠️ **维护器体** 灵器使用会产生器体损耗，状态会从完好逐步变为微损、裂损、重损、濒毁、损毁，需要修复或投入灵材保养。 8. 👑 **最终觉醒** 满足等级、器魂、突破、天赋等条件后完成觉醒，获得后期身份与被动加成。 9. 📜 **进入器藏与天榜** 高价值灵器可被收录进器藏，参与评分、等级、魂阶、觉醒、称号等榜单竞争。 --- ## 🔥 灵器开光系统 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、音效、粒子、悬浮文本，并对旧端做了降级兼容。 --- [/MD]



[MD] --- ## 🧭 管理、运维与调试 ### 🛠️ 常用管理命令 | 中文功能 | 实际输入示例 | 说明 | |---|---|---| | 自定义开光 | `/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️⃣ 打开主界面 玩家进入服务器后，可先输入： ```text /yr ``` 该命令会打开 YuRelic 主菜单。主菜单通常包含开光、养成、灵契、器藏、饰品、鉴灵、修复等入口，适合新玩家从 GUI 中理解系统。🧭 #### 2️⃣ 准备一件可开光物品 把想培养的物品拿在主手，例如剑、斧、弓、弩、三叉戟、盾牌、护甲、工具、饰品或服务器配置允许的模组物品。默认情况下，物品需要能读取到最大耐久；无耐久特殊物品需要服务器在配置中加入白名单。 #### 3️⃣ 进行开光 推荐通过 GUI 开光： ```text /yr 开光 ``` 开光时会根据服务器配置消耗经验、金币、点券或灵材，并生成灵器的基础数据，包括器魂、潜质、器体、等级、评分、灵契、成长路线等。不同开光档位会影响高品质出现概率，正式服通常会把高阶开光作为活动、点券或高成本玩法。 #### 4️⃣ 查看灵器状态 开光后，把灵器拿在主手，可查看详细信息： ```text /yr info ``` 如果想把主手灵器展示给其他玩家，可使用： ```text /yr 分享 ``` 聊天分享支持悬浮查看完整灵纹摘要，适合交易、炫耀、天榜竞争和活动展示。📢 #### 5️⃣ 通过实际使用获得成长 灵器会在实际使用中获得灵息经验。常见来源包括： - ⚔️ 使用武器近战命中、击杀怪物 - 🏹 使用弓、弩等远程武器命中目标 - ⛏️ 使用工具挖掘方块 - 🛡️ 穿戴护甲承受伤害 - 🛡️ 使用盾牌格挡伤害 - 💍 饰品入槽后参与部分成长与灵威统计 - 📜 完成器愿、里程碑、试炼等长期目标 如果发现成长变慢，可能是灵息疲劳、目标重复衰减、场景倍率、PVP/PVE 倍率、器体损毁或服务器防刷规则生效。 #### 6️⃣ 到达节点后突破路线 灵器到达阶段节点后，会出现突破候选。先查看候选路线： ```text /yr breakthrough ``` 选择第 1 条路线示例： ```text /yr breakthrough 1 ``` 路线会影响后续属性倾向和成长方向，例如更偏攻击、防御、成长、狩猎、工具效率或特殊效果。 #### 7️⃣ 培养器魂、潜质、天赋与铭纹 灵器中期成长主要围绕几条线展开： ```text /yr 器魂 /yr 器魂 注魂 500 /yr 器魂 塑魂 ``` ```text /yr 潜质 /yr 潜质 淬炼 ``` ```text /yr 铭魂 /yr 铭魂 铭魂 /yr 铭魂 选择 1 /yr 铭魂 洗练 1 ``` ```text /yr 铭纹 /yr 铭纹 列表 /yr 铭纹 玄刻 <铭纹键> /yr 铭纹 磨去 1 ``` 其中 `<铭纹键>` 需要按服务器配置或 GUI 显示填写。普通玩家更推荐通过 GUI 操作，减少输错配置键。 #### 8️⃣ 器体维护与修复 灵器有独立器体寿命。器体损耗过高会影响成长和效果，严重时会进入损毁状态。查看器体： ```text /yr 器体 ``` 使用经验修复： ```text /yr repair 500 ``` 使用灵材修复： ```text /yr repair 灵材 <灵材键> 1 /yr repair 灵材 <灵材键> 全部 ``` 器体上限升格： ```text /yr repair 升格 ``` #### 9️⃣ 后期觉醒与展示 满足等级、器魂、突破、天赋、试炼等条件后，可查看觉醒条件： ```text /yr 觉醒 ``` 开始觉醒： ```text /yr 觉醒 觉醒 ``` 完成觉醒的灵器适合进入器藏、参与天榜、聊天展示或作为服务器高价值装备流转。👑 --- ### 🧑‍💼 管理上线流程 #### 1️⃣ 安装与依赖检查 1. 将插件放入服务器 `plugins` 文件夹。 2. 启动服务器生成配置文件。 3. 确认服务器核心与版本环境。插件目标适配 **1.8 - 1.26**，覆盖 Paper、Spigot、Paper 衍生核心、Youer、Arclight、Mohist 等常见核心与混合端；当前已测试环境为 **Youer 1.21.1**。 4. 根据服务器类型决定是否接入 Vault、PlayerPoints、PlaceholderAPI、LevelledMobs、MythicMobs、WorldGuard、EasyBot。 5. 跨服群组建议配置 MySQL，并确保每个子服的 `server-id` 唯一。 6. 修改配置后建议重启服务器，正式服不建议只依赖热重载完成大版本配置变更。 7. 如果在特定核心或版本下出现开光、物品识别、NBT、耐久、属性、GUI、跨服同步等兼容性问题，请在 QQ 群内反馈。 检查联动状态： ```text /yr hooks ``` 检查运行库： ```text /yr libs ``` 打开诊断界面： ```text /yr 诊断 界面 ``` #### 2️⃣ 兼容性测试 不同核心和版本建议先做一轮基础兼容性检查，尤其是混合端和模组端： - 原版武器、护甲、工具、盾牌能否正常开光。 - 模组物品或自定义物品能否正确识别分类、最大耐久、名称、Lore 与 NBT。 - 战斗、挖掘、承伤、格挡是否能正常触发成长。 - GUI 是否能正常打开，按钮是否能点击，物品是否会被异常吞掉或复制。 - 重启服务器后，灵器数据、器藏数据、饰品槽数据是否仍然正常。 - 跨服环境下，不同子服的灵器档案和锁状态是否同步稳定。 如遇兼容性问题，建议在群内反馈服务端核心、Minecraft 版本、YuRelic 版本、完整报错日志、触发操作和问题物品来源。 #### 3️⃣ 开光测试 用普通玩家权限测试三件事： - 主手普通装备能否打开开光界面。 - 经验、金币、点券或灵材消耗是否符合预期。 - 开光后 Lore、属性、器魂、潜质、器体是否正常显示。 管理员自定义开光可用于测试： ```text /yr 自定义开光 tier=basic level=10 power=500 ``` #### 4️⃣ 成长与反刷测试 建议分别测试以下场景： - 普通怪物击杀是否给经验。 - 友好生物是否被限制。 - 挖掘、承伤、盾牌格挡是否触发成长。 - PVP 世界的数值是否过高。 - 无耐久模组物品是否被正确限制。 - 灵息疲劳是否能防止短时间爆刷。 查看战斗乘区： ```text /yr 战斗 ``` 查看当前场景规则： ```text /yr 场景 ``` 查看灵息疲劳： ```text /yr 灵息 ``` #### 4️⃣ 灵材掉落与经济测试 查看掉落生态： ```text /yr 掉落 ``` 打开掉落模拟界面： ```text /yr 掉落 模拟界面 ``` 测试灵物坊： ```text /yr 灵物坊 /yr 灵物坊 列表 ``` 管理员发放灵材测试： ```text /yr 资源 发放 <灵材键> 64 <玩家名> ``` 建议上线前确认灵材产出、灵物坊价格、Boss 掉落、每日上限和点券消耗，避免后期经济膨胀。 #### 5️⃣ 数据库、跨服与防复制检查 单服可使用 SQLite，跨服服群建议使用 MySQL。正式服上线前至少检查： ```text /yr storage status /yr storage sync /yr storage duplicates ``` 灵籍完整性巡检： ```text /yr 灵籍 巡检 ``` 查看主手灵器锁信息： ```text /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 已经具备比较完整的闭环：**开光 → 成长 → 突破 → 构筑 → 维护 → 觉醒 → 传承/收藏/天榜**。✨ [/MD]