常见问题

物品无法鉴定

按以下顺序检查：

1. 物品 Lore 是否包含生成模板中的 check-lore。
2. check-lore 是否与物品 Lore 中的文本完全匹配。
3. 物品是否来自当前使用的生成模板。
4. 是否已经完成过鉴定。

插件会根据 check-lore 定位待处理物品，并将其替换为对应模板生成的御魂词条。已经鉴定过的物品不能重复鉴定。

鉴定道具无效

检查鉴定道具是否与 鉴定道具.yml 中的配置匹配：

检查项	要求
name	道具名称必须匹配配置中的 name
entry-id	必须与生成模板中的主词条或副词条节点名称一致
templates	如果填写了模板列表，当前御魂模板必须包含在列表中；留空时默认全局可用
放置位置	主词条道具放入鉴定界面第 6 格，副词条道具放入第 7 格

如果出现“主词条鉴定道具无效”或“副词条鉴定道具无效”，优先检查道具名称和 entry-id。如果提示模板不匹配，则检查 templates 是否允许当前御魂模板。

鉴定后主词条或副词条不符合预期

检查生成模板中的以下配置：

• main-attribute：控制主词条可用属性、数值范围、权重和 Lore 格式。
• entry-value：控制副词条可用属性、数值范围、权重和 Lore 格式。
• min-entry 和 max-entry：控制副词条数量，最终词条数量为 1 条主词条加指定数量的副词条。
• entry-not-repeated：控制副词条是否允许重复。

如果启用了 entry-not-repeated: true，必须保证 entry-value 中的属性数量大于 max-entry，否则可能导致生成异常。

强化提示御魂经验不足

检查玩家当前的御魂经验变量 %yuhun_value%，并确认强化模板中当前等级对应的 need-exp 配置。

强化所需经验由当前强化模板和等级共同决定。等级配置可以使用单独等级或等级范围，例如：

need-exp:
  1: 10
  2: 20
  10-15: 100

如果当前等级没有对应配置，或玩家经验小于该等级的需求值，强化会失败。

强化提示金币不足

检查以下内容：

1. 服务器是否安装并启用了 Vault 经济支持。
2. 玩家余额是否满足强化模板中当前等级的 need-vault。
3. 强化模板是否与物品生成模板使用了相同的模板名称。

need-vault 控制每个强化等级所需的 Vault 金币。配置中的等级范围也会按照当前强化等级进行匹配。

强化后词条没有变化

确认强化模板中的 keyword 能匹配物品 Lore 中对应词条的文本。

keyword 用于定位需要强化的 Lore 行。生成模板和强化模板中的关键词应保持一致，例如：

entry-value:
  攻击力:
    keyword: '&7攻击力'

如果强化模板中的 keyword 与生成模板输出的词条文本不一致，插件可能无法找到需要强化的词条。

强化没有增加随机副词条

检查强化模板中的 attribute-up-need-level。

该配置表示每提升多少级强化一次随机词条。例如：

attribute-up-need-level: 3

同时检查强化模板中的 entry-value 是否配置了可用副词条，以及每个副词条是否设置了有效的 keyword、min、max 和 weight。

强化数值与预期不一致

强化数值受以下配置共同影响：

配置	作用
multiply-value	控制强化算法是否使用乘法；关闭时使用加法
min	随机数值下限
max	随机数值上限
weight	属性或数值范围的权重
normal-distribution-offset	控制正态分布偏移，默认配置为 0.25
round	控制生成词条时保留的小数位数

生成模板负责初始词条，强化模板负责强化时的数值变化。修改生成模板不会自动改变已经生成的物品。

强化模板不生效

确认强化模板名称与生成模板名称一致。例如，物品使用 模板1 生成时，强化配置也应使用 模板1：

strengthen:
  模板1:
    # 强化配置

template:
  模板1:
    # 生成配置

强化模板与生成模板名称不一致时，可能导致强化目标无法正确识别。

强化后物品名称变化不符合预期

检查 strengthen-name 配置：

strengthen-name: ' &c+{level}'

该配置用于设置强化后追加到物品名称末尾的文本，{level} 会表示当前强化等级。

回收经验不符合预期

回收经验由生成模板和强化模板共同影响：

配置	作用
template.<模板名>.recycle-exp	模板基础回收经验
strengthen.<模板名>.recycle-exp-ratio	强化经验回收比例

先确认物品使用的生成模板和强化模板名称，再检查这两个配置是否匹配。强化后的物品还会受到强化模板中 recycle-exp-ratio 的影响。

回收界面没有可回收物品

检查物品是否放入回收界面，并确认物品已经被插件识别为御魂。

如果界面提示“界面内没有可回收御魂”，通常需要检查：

• 物品是否为已经生成或鉴定的御魂。
• 物品 Lore 是否被手动修改，导致插件无法识别。
• 物品是否使用了有效的生成模板。
• 回收界面是否仍然显示当前物品。

回收界面中的可获得经验由模板基础回收经验和强化回收比例计算。

MySQL 数据没有保存或读取

如果启用了 mysql.enable，必须同时满足以下条件：

1. 安装 LyMySQLCore。
2. 在配置中填写正确的数据库地址、端口、数据库名、用户名和密码。
3. 数据库连接成功。
4. 修改 MySQL 开关后重启服务器。

只有安装 LyMySQLCore 且成功连接数据库后，依赖 MySQL 的相关功能才会生效。MySQL 配置位于 config.yml 的 mysql 节点。

mysql:
  enable: false
  databasename: mc2
  username: mc2
  password: admin
  port: 3306
  ip: 127.0.0.1

关闭 MySQL 后配置没有立即生效

mysql.enable 的注释明确要求修改数据库开关后重启服务器。仅修改配置文件而不重启，可能不会切换当前使用的存储方式。

变量没有显示

插件配置中提供的御魂经验变量为 %yuhun_value%。如果变量没有显示，检查：

• 使用变量的插件是否支持 PlaceholderAPI。
• PlaceholderAPI 是否已安装并正常加载。
• 变量名称是否完整填写为 %yuhun_value%。
• 玩家是否已经拥有可读取的御魂经验数据。

物品库物品无法匹配

插件配置提供以下物品库开关：

配置	作用
neigeItems	是否启用 NeigeItems 物品库支持
AzureFlow	是否启用 AzureFlow 物品库支持
SX-Item	是否启用 SX-Item 物品库支持

这些开关关闭时，插件会按照配置中的物品匹配逻辑处理物品。启用对应物品库支持后，仍需确保对应物品库插件已安装并正常运行。

高版本物品材料写法无效

GUI 物品配置支持旧版材料数字格式，也支持高版本材料名称格式。例如：

fill-item: '160:0'
button-item: '267:0'

高版本也可以使用类似以下格式：

fill-item: 'APPLE:0'
button-item: 'BOOK:0'

请保持物品格式与当前服务器版本兼容。

GUI 中强化、鉴定或回收按钮显示异常

分别检查对应 GUI 节点下的配置：

• gui
• appraisal-gui
• recycle-gui

重点确认 title、fill-item、button-item、button-name 和 button-lore 是否填写完整。强化、鉴定和回收界面使用的是不同配置节点，修改其中一个不会自动影响另外两个界面。

为什么强化模板中的 command 没有执行

main-attribute 和 entry-value 下都可以配置 command 列表。请确认：

• command 位于正确的属性节点下。
• 配置格式为 YAML 列表。
• 触发的是对应的主属性或副词条强化逻辑。

示例：

main-attribute:
  攻击力:
    keyword: '&7攻击力'
    min: 10
    max: 30
    command: []

空列表表示当前属性没有配置要执行的指令。

修改配置后原有物品没有变化

生成模板中的词条、格式和数值范围主要用于生成或鉴定时处理物品；强化模板用于后续强化。已经生成或鉴定的物品不会因为修改配置文件而自动重新生成词条。

修改配置后，应先确认新配置对应的模板名称、Lore 关键词和属性节点都能匹配现有物品。