Yu Plugin Hub

切换深色模式

YuRelic 常见问题 ​

物品不能开光 ​

先确认主手不是空气，且不是已经开光的灵器。然后让管理员执行：

text
/yurelic debugid

常见原因：

  • 无法读取最大耐久。默认只有可损耗物品能开光。
  • 混合端模组物品没有被分类规则识别，需要补 custom-item-rules。
  • 无耐久物品没有加入 rpg.non-durable-relics.whitelist。
  • 开光档位成本不足，例如 Vault 金币、PlayerPoints 点券或灵材不足。
  • 物品剩余耐久太低，不能承载开光。

开光后不涨经验 ​

按顺序排查：

  1. /yurelic info 看灵器是否为半损毁、封存、隔离或非当前器主。
  2. /yurelic pact info 看灵契是否回应当前玩家。
  3. /yurelic breath 看灵息疲劳是否严重衰减。
  4. /yurelic scene 看当前世界或区域是否禁成长。
  5. 确认行为真的消耗了物品耐久。YuRelic 默认有耐久门禁，防止无损刷经验。
  6. 如果是击杀经验，确认目标不是友好生物或被反刷规则压低收益。
  7. 如果依赖 LevelledMobs 倍率，执行 /yurelic hooks 看是否识别成功。

灵材不掉落 ​

执行：

text
/yurelic loot
/yurelic loot simgui

重点检查 loot.enabled、世界倍率、WorldGuard 区域倍率、MythicMobs ID、等级门槛、友好/中立生物门禁、每日额度和保底配置。正式服默认掉率较克制，loot.max-final-chance 会限制最终概率。

动态依赖下载失败 ​

执行 /yurelic libs 看具体依赖状态。离线服可以把依赖 jar 手动放入：

text
plugins/YuRelic/libs/

如果是校验失败，确认 jar 完整；生产服不建议长期关闭 library.verify-checksum。

MySQL 或跨服数据异常 ​

执行：

text
/yurelic storage status
/yurelic doctor storage

常见原因：

  • MySQL 地址、端口、库名、账号或密码错误。
  • 数据库用户没有建表或写入权限。
  • 多个子服使用了相同 storage.server-id。
  • 动态依赖中的 MySQL Connector 或 HikariCP 未加载。
  • 网络防火墙阻止服务端连接数据库。

疑似复制或重复灵器 ID ​

先不要直接删除玩家物品。建议流程：

text
/yurelic storage duplicates
/yurelic integrity scan
/yurelic integrity info
/yurelic integrity locks

对可疑 ID 查看审计链、最后出现服务器、持有人和锁状态。确认误入库或作弊后，再用 /yurelic purge <灵器ID> 或 /yurelic erasehand 处理。

PlaceholderAPI 没有值 ​

执行 /yurelic hooks，确认 PlaceholderAPI 插件启用、API 可见、YuRelic 扩展已注册。

如果某个占位符为空，可能是：

  • 玩家主手没有灵器。
  • 使用的是天榜占位符，但器藏/天榜暂无记录。
  • integrations.placeholderapi.empty 被配置为空字符串。
  • 服务器菜单插件缓存了旧值，需要刷新菜单或重载对应插件。

EasyBot 或 QQ 群广播异常 ​

先看 /yurelic hooks 和 /yurelic doctor hooks。如果 RPC 不可用，检查 EasyBot 插件是否启用、BridgeClient 是否可见、目标插件 ID 与方法名是否匹配。

跨平台转发建议区分两类文本：

  • 游戏内公告：可以使用 MiniMessage、hover、click。
  • QQ 转发：建议使用纯文本或玩家聊天兜底，避免交互标签被原样发送。

GUI 显示材质不对 ​

GUI 材质解析会兼容旧版与现代材质名，但混合端仍可能有特殊物品。优先检查 gui.pages.* 中按钮材质；如果是灵器图标，确认物品的 baseKey、Material 或自定义规则能被当前服务端识别。

升级后配置提示缺项 ​

这是正常的版本迁移保护。YuRelic 会在补全配置前备份旧文件到：

text
plugins/YuRelic/backups/

执行 /yurelic doctor config 查看缺失项。深度自定义过的服，建议手动把新默认项合并到自己的配置，而不是直接覆盖旧文件。

旧命令 /yurpg 还能用吗 ​

能。正式命名后主命令是 /yurelic，但 /yurpg 与 /yrpg 作为迁移兼容别名保留。新文档统一使用 /yurelic。

不想让普通玩家做高风险操作 ​

限制对应权限，并在 GUI 中移除或隐藏按钮。尤其建议谨慎开放：

text
yurelic.salvage
yurelic.heritage
yurelic.seal
yurelic.guard
yurelic.market

高危管理员权限如 yurelic.purge、yurelic.open.admin、yurelic.exp.admin、yurelic.item.admin 不应给普通玩家。