YuRelic 插件联动

本页保留跨插件联动总览。权限、PlaceholderAPI 和 Bukkit 事件已拆到独立页面，日常查表可以直接进入对应章节。

权限节点玩家、系统、管理、高危操作与倍率权限PlaceholderAPI灵器状态、开光、面板和天榜变量Bukkit 事件开光、成长、战斗、资源、市场和天榜监听命令手册玩家、管理员与运维命令

软依赖与联动

YuRelic 在 plugin.yml 中声明的软依赖：

LevelledMobs, MythicMobs, WorldGuard, WorldEdit, Vault, PlayerPoints, EasyBot, PlaceholderAPI

这些插件不存在时，YuRelic 不应阻断启动。用 /yurelic hooks 可以看到当前服务端的联动状态。

插件	典型用途
PlaceholderAPI	将灵器等级、评分、器体、天榜等信息显示到菜单、计分板或聊天。
Vault / PlayerPoints	开光、修复、仪式、商店等经济成本。
LevelledMobs / MythicMobs	灵材掉落、怪物等级和副本生态联动。
WorldGuard / WorldEdit	区域倍率、掉落限制、战斗场景和副本区域判断。
EasyBot	将开光、觉醒、入藏、天榜等事件广播到外部机器人。

EasyBot 与广播

YuRelic 的广播系统支持游戏内 MiniMessage、控制台纯文本、EasyBot RPC 和玩家聊天兜底。典型 payload 包含：

• action：事件类型。
• message：MiniMessage 文本。
• plain：去色纯文本。
• player、item、relic、quality、id、short_id。
• placeholders：完整占位符表。

如果 EasyBot RPC 不可用，可以让广播走玩家聊天路径，方便 QQ 桥按普通玩家消息捕获。游戏内 hover/click 组件与 QQ 纯文本转发天然不同，跨平台公告建议保留短文本版本。

集成建议

• 活动倍率、VIP 加成、区域规则优先监听 RelicGainExpEvent。
• 竞技场、职业插件、领地插件优先监听 RelicCombatModifyEvent 或使用场景规则配置。
• 自定义掉落与副本结算优先监听 RelicLootResourceEvent。
• 经济插件不要直接改 NBT，优先调用命令或监听仪式、资源、市场事件。
• 高危操作如归炉、传承、清理、软锁裁定，应保留管理员权限与审计链。