Yu Plugin Hub

切换深色模式

YuRelic 配置说明 ​

配置结构 ​

config.yml 是轻量入口，真实默认配置按模块拆分。加载顺序由 config-modules 控制，后加载的同路径配置覆盖先加载值，主 config.yml 中的覆盖项优先级最高。

yaml
config-version: 46
messages-file: messages.yml
config-modules:
- configs/01-core.yml
- 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
- configs/08-advanced-systems.yml
- configs/09-loot-integrity-scene.yml

建议只在 config.yml 末尾写少量覆盖项，保留模块文件的默认注释，升级时更容易比较。

模块地图 ​

文件主要内容
01-core.yml命令别名、动态依赖、SQLite/MySQL、LevelledMobs、MythicMobs、WorldGuard、诊断
02-items.yml物品身份指纹、分类关键词、自定义物品规则、潜质、评分
03-growth-combat.yml灵契、同调、道韵、反刷、试炼、经验、耐久、战斗乘区
04-souls-routes-talents.yml器魂、突破路线、天赋、觉醒
05-accessories-sets.yml饰品槽、槽位解锁、死亡清理、套装共鸣
06-resources-rituals.yml灵材、仪式成本、铭纹、里程碑、点券不足引导
07-display-effects-gui.yml中文显示、音效粒子、聊天分享、管理员物品、灵物坊、GUI、广播
08-advanced-systems.yml器势、灵潮、器愿、灵息疲劳、传承、封存、铸名、归炉、器藏、天榜、灵护、商契、灵祝、PAPI
09-loot-integrity-scene.yml掉落生态、每日额度、防复制、跨服软锁、轻量场景规则

存储配置 ​

单服可以使用默认 SQLite：

yaml
storage:
  enabled: true
  type: SQLITE
  server-id: server-1
  sqlite:
    file: data/yurelic.db

跨服、天榜聚合、防复制软锁建议使用 MySQL：

yaml
storage:
  enabled: true
  type: MYSQL
  server-id: survival-1
  mysql:
    host: 127.0.0.1
    port: 3306
    database: yurelic
    username: yurelic
    password: change-me
    params: useSSL=false&characterEncoding=utf8&autoReconnect=true

每个子服必须设置不同 server-id。上线后用 /yurelic storage status 检查连接状态。

物品识别与混合端 ​

YuRelic 会读取 Material、现代 key、显示名、Lore 哈希和 NBT 指纹。遇到无法识别的模组物品，先让管理员手持物品执行：

text
/yurelic debugid

再补自定义规则：

yaml
custom-item-rules:
  refined_obsidian_paxel:
    category: TOOL
    keys:
    - mekanismtools:refined_obsidian_paxel
    names:
    - 精致黑曜石镐斧铲
    keywords:
    - REFINED_OBSIDIAN

默认不允许无耐久物品开光。确实需要把无耐久模组物品作为特殊灵器时，使用无耐久白名单，并配置低倍率、冷却、每分钟上限和重复目标衰减。

成本通道 ​

多个系统支持 exp、vault、playerpoints、resource 或 none。常见位置包括开光档位、涤契、静修、注魂、觉醒、灵祝、归炉、灵物坊。

示例：

yaml
soul:
  feed:
    cost:
      type: vault
      amount-per-unit: 18.0
      resource: ''

如果使用 vault，需要经济插件和 Vault。使用 playerpoints 时可以配置点券不足自动打开赞助兑换菜单。

成长与战斗 ​

重点配置项：

  • pact.*：器主、无主灵器兼容、涤契、同调。
  • rpg.max-level：灵器等级上限。
  • rpg.exp.*：行为经验、耐久门禁、友好/中立生物收益、权限倍率。
  • anti-farm.*：反刷、重复目标衰减、窗口限制。
  • route-mastery.*：路线熟练度。
  • rpg.combat.pve.* 与 rpg.combat.pvp.*：PVE/PVP 乘区压缩。
  • scene-rules.*：不依赖 WorldGuard 的世界/区域倍率和禁用规则。

战斗管线不会长期写入玩家 Attribute，也不会覆盖其他插件已经算好的伤害；它只在 Bukkit 伤害事件中追加 YuRelic 自己的贡献。

掉落生态 ​

loot.* 控制灵材掉落、世界倍率、WorldGuard 区域倍率、MythicMobs ID、等级门槛、每日额度、保底和模拟 GUI。

正式服建议关注：

  • loot.max-final-chance：最终掉率上限。
  • loot.mob-nature：友好/中立生物门禁。
  • loot.daily-limits：每日资源、掉落表、总量限制。
  • loot.tables.<table>.mythic-mobs：MythicMobs 内部 ID。
  • loot.tables.<table>.regions：WorldGuard 区域限制。
  • /yurelic loot simgui：上线前模拟不同等级、世界、区域和击杀数。

GUI、展示与广播 ​

展示相关配置集中在 07-display-effects-gui.yml：

  • display.*：中文物品名、品阶、器魂、路线、状态、Lore 文案。
  • effects.*：Title、ActionBar、声音、粒子。
  • share.*：聊天分享模板、悬浮内容、范围。
  • gui.pages.*：主菜单、养成、修复、器藏、天榜、运维、灵物坊等页面。
  • broadcast.*：开光、升级、觉醒、清理等事件广播。

EasyBot 联动位于广播配置中。建议 QQ 转发场景优先使用插件当前的 EasyBot RPC 或玩家聊天兜底模式，避免 MiniMessage 交互标签原样转发。

防复制与跨服软锁 ​

跨服环境建议开启 MySQL，并使用：

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

integrity.* 管理灵籍巡检、隔离、裁定、原子软锁、过期锁清理。怀疑复制时优先查审计链，不建议直接自动删除玩家物品。

消息文件 ​

玩家可见文案在 messages.yml。它有独立 messages-version，适合服主改中文、颜色、提示语。升级时如果缺少新消息键，诊断系统会提示。