YuRelic 安装部署

环境要求

环境项	要求
服务端	Bukkit/Spigot/Paper/Paper衍生/Youer/Arclight/其余混合端等 1.8.x - 1.26.x，已测试 1.21.1
Java	JDK 8 及以上；发布包保持 Java 8 字节码兼容
主插件目录	plugins/YuRelic/
配置入口	plugins/YuRelic/config.yml
动态依赖目录	plugins/YuRelic/libs/
单服存储	默认 SQLite，文件在 plugins/YuRelic/data/yurelic.db
跨服存储	建议 MySQL，并为每个子服设置不同 storage.server-id

可选联动：LevelledMobs、MythicMobs、WorldGuard、WorldEdit、Vault、PlayerPoints、EasyBot、PlaceholderAPI。这些都是软依赖，未安装时插件应静默降级。

版本来源

版本	用途	获取方式
免费版 1.0.0	适合先测试开光、基础成长与常规服务器兼容性	Yu 插件交流群
赞助版 1.0.13.31	适合正式服使用完整玩法、GUI、诊断、掉落、跨服与防复制能力	爱发电赞助入口

直接部署

1. 将发布得到的 YuRelic-版本-obf.jar 放入服务端 plugins/。
2. 第一次启动服务端，让插件生成 plugins/YuRelic/。
3. 检查后台是否出现 YuRelic 已启动。。
4. 执行 /yurelic libs，确认运行时依赖加载状态。
5. 执行 /yurelic doctor gui 或 /yurelic doctor summary，查看配置、存储、联动和风险项。
6. 让管理员手持可损耗装备执行 /yurelic open，确认开光 GUI 与物品 Lore 正常。

版本与发布包

请从 Yu 插件交流群或爱发电赞助入口获取可直接部署的发布包，再按“直接部署”放入 plugins/ 目录。

常见发布包：

文件	用途
YuRelic-1.0.13.31-obf.jar	正式服建议使用的发布包，放入服务端 plugins/ 后启动
YuRelic-1.0.0.jar	免费试用版发布包，适合先验证基础开光与成长流程

动态依赖

YuRelic 将数据库驱动、NBT-API、HikariCP、SLF4J 等运行库放到运行时加载，避免多个插件各自打包同一依赖导致类冲突。

library:
  enabled: true
  verify-checksum: true
  fail-on-required-missing: true
  connect-timeout-ms: 15000
  read-timeout-ms: 60000

首次启动会优先检查 plugins/YuRelic/libs/。如果服务器不能访问外网，可以手动把依赖 jar 放入该目录，再保持 library.enabled: true。生产服建议保持 verify-checksum: true。

首次上线清单

• 给普通玩家分配基础权限：yurelic.use、yurelic.open、yurelic.repair、yurelic.breakthrough、yurelic.pact。
• 给管理员分配运维权限：yurelic.reload、yurelic.debug、yurelic.libs、yurelic.storage、yurelic.diagnose。
• 如果使用 Vault 或 PlayerPoints 支付开光、注魂、静修、商店等成本，先确认经济插件已启用。
• 如果使用跨服天榜、防复制和软锁，将 storage.type 改为 MYSQL，并给每个服务器不同 storage.server-id。
• 如果是混合端或模组服，先用 /yurelic debugid 采集特殊物品 key，再补 custom-item-rules 或无耐久白名单。
• 如果运行在较新的实验服务端版本，先在测试服确认开光、伤害、掉落、GUI 与数据库写入，再迁移到正式服。

升级建议

YuRelic 会用 config-version 与 messages-version 管理配置迁移。升级前建议备份整个 plugins/YuRelic/，升级后执行：

/yurelic doctor full
/yurelic storage status
/yurelic hooks

如果诊断报告提示配置缺失或版本落后，先查看 plugins/YuRelic/backups/ 中自动备份，再决定是接受自动补全，还是手动合并自定义配置。