LyYuhun

MySQL 前置要求

启用 MySQL 存储时，必须安装 LyMySQLCore，并确认它已成功连接数据库。否则本插件的 MySQL 数据读取、保存、同步或相关记录不会生效。修改 mysql.enable 后需要重启服务器。

LyYuhun 是一套御魂鉴定、强化与回收插件。玩家可以将带有指定待激活 Lore 的物品放入鉴定界面，随机生成主词条和副词条，再消耗御魂经验与 Vault 金币进行强化。无用御魂可以放入回收界面，转换为御魂经验，形成鉴定、养成和回收循环。

插件支持多个御魂模板。每个模板可以独立设置识别 Lore、主词条、副词条、数值范围、抽取权重、词条数量、强化消耗、强化间隔和回收经验。

插件信息

项目	内容
插件名	LyYuhun
插件版本	1.1.7
作者	Liyuan
主命令	/yuhun
API 版本声明	1.13
数据存储	本地 YAML 或 MySQL
软依赖	PlaceholderAPI、MythicMobs、LyMySQLCore、Vault

支持版本

项目包含以下服务端版本的 NMS 适配：

Minecraft 版本	NMS 版本
1.7.10	V1_7_R4
1.8.8	V1_8_R3
1.11.2	V1_11_R1
1.12.2	V1_12_R1
1.13.2	V1_13_R2
1.14.4	V1_14_R1
1.15.2	V1_15_R1
1.16.5	V1_16_R3
1.17.1	V1_17_R1
1.18.2	V1_18_R2
1.19.2	V1_19_R1
1.19.4	V1_19_R3
1.20.1	V1_20_R1
1.20.2	V1_20_R2
1.20.3	V1_20_R3

表格只列出项目中实际存在适配模块的版本，不代表未列出的中间版本也受支持。

依赖说明

插件	用途	是否必须
Vault	读取和扣除玩家金币	使用鉴定或强化金币消耗时必须安装，并需要可用的经济插件
PlaceholderAPI	注册御魂经验变量，并解析界面 Lore、公告和强化指令中的变量	使用变量功能时必须安装
MythicMobs	为 /yuhun get 提供 MythicMobs 物品来源	使用对应物品来源时需要安装
LyMySQLCore	提供 MySQL 存储前置	启用 MySQL 存储时必须安装并成功连接数据库

插件还提供 NeigeItems、AzureFlow 和 SX-Item 物品库支持开关。没有启用对应物品库支持，或没有取得对应物品时，会继续尝试匹配 MythicMobs 物品。

玩法流程

1. 准备带有模板 check-lore 的待鉴定物品。
2. 使用 /yuhun jd 打开鉴定界面，将待鉴定物品放入御魂槽位。
3. 可以额外放入主词条鉴定道具或副词条鉴定道具，用于指定本次生成的词条。
4. 鉴定成功后，插件替换待激活 Lore，生成主词条和若干副词条，并写入御魂模板与强化等级数据。
5. 使用 /yuhun qh 打开强化界面，消耗御魂经验和 Vault 金币提升御魂等级。
6. 使用 /yuhun hs 打开回收界面，将不需要的御魂转换为御魂经验。

主要功能

功能	说明
御魂鉴定	通过模板的 check-lore 识别待激活物品，并替换为生成后的词条 Lore
鉴定消耗	每次鉴定可以统一消耗御魂经验和 Vault 金币
随机主词条	根据模板中的主词条权重随机选择，并在配置范围内生成数值
随机副词条	根据最小、最大词条数与权重生成副词条
指定主词条	在鉴定界面第 6 格放入已配置道具，指定本次主词条
指定副词条	在鉴定界面第 7 格放入已配置道具，保证本次包含指定副词条
道具模板限制	鉴定道具可以限制为仅适用于指定御魂模板
防止重复鉴定	已写入御魂模板数据的物品不能再次鉴定
词条去重	模板可以禁止生成重复副词条，并按可用副词条数量限制最大词条数
御魂强化	根据御魂所属模板读取下一等级的经验与金币消耗
主词条成长	每次成功强化都会提升主词条数值
副词条成长	每达到指定强化等级间隔，随机强化已有副词条或新增副词条
加法与乘法强化	强化模板可使用固定增量模式或倍率模式计算新数值
强化等级名称	首次强化时追加等级后缀，后续强化时替换为新的等级
强化触发命令	主词条或副词条强化后可以执行配置中的控制台命令
全服强化公告	成功强化后可以广播物品名称和强化等级，留空可关闭
御魂回收	批量回收界面内的有效御魂并发放御魂经验
强化经验返还	回收经验包含模板基础经验与已消耗强化经验的一定比例
多模板扩展	可以从额外 YAML 配置继续载入 template 和 strengthen 模板
玩家 Lore 替换	鉴定和强化完成后，会将生成 Lore 中的 %player% 替换为玩家名称
数据持久化	可使用本地 YAML 保存玩家数据，也可切换到 MySQL 存储
御魂经验变量	通过 PlaceholderAPI 显示玩家当前拥有的御魂经验
插件 API	提供御魂鉴定、强化、回收经验计算和玩家经验管理接口

鉴定机制

待鉴定物品必须包含某个生成模板配置的 check-lore。鉴定时，插件会移除该 Lore，并在原位置写入以下内容：

1. 模板的 last-line-lore。
2. 一条主词条。
3. 模板范围内生成的副词条。
4. 模板的 next-line-lore。

主词条和副词条会根据各自的 weight 参与随机抽取。词条数值使用正态分布计算，并强制限制在配置的 min 与 max 范围内。

模板中的 min-entry 和 max-entry 表示副词条数量，不包含主词条。程序会将小于 1 的 min-entry 修正为 1。开启 entry-not-repeated 后，最大副词条数量不会超过当前模板可用的副词条种类数。

使用指定副词条道具时，该词条会占用本次随机副词条数量中的一个位置。鉴定成功后，实际使用的主词条和副词条鉴定道具各消耗一个。

强化机制

强化物品必须带有插件写入的御魂模板和强化等级数据。插件会根据该模板读取对应的强化配置：

• need-exp 决定每一级消耗的御魂经验。
• need-vault 决定每一级消耗的 Vault 金币。
• main-attribute 决定主词条每次强化的数值范围。
• attribute-up-need-level 决定每隔多少级强化一次副词条。
• entry-value 决定副词条新增或提升时的数值范围与权重。
• multiply-value 决定强化数值使用加法还是乘法。

每次成功强化都会提升主词条。达到副词条强化间隔时，如果当前副词条已经达到模板上限，插件会随机提升一条已有副词条；未达到上限时，则可能提升已有副词条，也可能新增一条副词条。

当 need-exp 中不存在下一级配置时，该御魂会被视为达到强化上限。玩家御魂经验或金币不足时，不会进行强化。

回收机制

回收界面的前 27 格用于放置御魂，第 31 格为回收按钮。点击后，插件只会移除能够正确识别模板和强化数据的御魂。

单个御魂的回收经验由两部分组成：

• 生成模板的 recycle-exp 基础经验。
• 已强化等级消耗的御魂经验总和乘以 recycle-exp-ratio。

堆叠物品会按物品数量计算总回收经验。关闭界面时，未被回收的物品会退回玩家背包；背包已满时会掉落在玩家所在位置。

界面槽位

鉴定界面

槽位	用途
第 4 格	待鉴定的御魂物品，只处理数量为 1 的物品
第 6 格	主词条鉴定道具
第 7 格	副词条鉴定道具
第 8 格	鉴定按钮

强化界面

槽位	用途
第 4 格	待强化的御魂物品，只处理数量为 1 的物品
第 8 格	强化按钮

回收界面

槽位	用途
第 0 至 26 格	放置需要回收的御魂
第 31 格	回收按钮，显示预计获得的御魂经验

指令

插件没有在 plugin.yml 中声明权限节点。管理指令通过是否为服务器管理员判断，界面指令仅能由玩家执行。

指令	使用者	说明
/yuhun	服务器管理员	查看插件内置指令帮助
/yuhun qh	玩家	打开御魂强化界面
/yuhun jd	玩家	打开御魂鉴定界面
/yuhun hs	玩家	打开御魂回收界面
/yuhun get [玩家] [MM物品]	服务器管理员	获取物品并生成对应御魂，目标玩家必须在线
/yuhun give [玩家] [经验]	服务器管理员	增加在线玩家的御魂经验，数值必须大于 0
/yuhun take [玩家] [经验]	服务器管理员	扣除在线玩家的御魂经验，玩家经验最低保持为 0
/yuhun set [玩家] [经验]	服务器管理员	设置在线玩家的御魂经验，玩家经验最低保持为 0
/yuhun reload	服务器管理员	重载插件配置、御魂模板和鉴定道具配置

配置重载范围

普通配置修改可以使用 /yuhun reload 重新载入。mysql.enable 的切换需要重启服务器，不能只依靠重载完成。

数据与变量

玩家御魂经验使用整数保存，最低为 0。插件启用 PlaceholderAPI 后会注册以下变量：

变量	说明
%yuhun_value%	玩家当前拥有的御魂经验

界面按钮 Lore、强化公告和强化触发命令支持 PlaceholderAPI 变量解析。具体说明见 插件变量。

页面导航

页面	内容
配置说明	物品库开关、消息、存储方式、界面和基础参数
模板配置	生成模板、强化模板、词条数值与回收规则
鉴定道具	指定主词条和副词条的鉴定道具配置
插件变量	御魂经验变量与变量解析位置
常见问题	数据加载、依赖、鉴定、强化和回收排查