鉴定道具
鉴定道具.yml 用于配置鉴定界面中的主词条卷轴和副词条卷轴。玩家鉴定御魂时，可以放入对应道具，指定本次鉴定生成的主词条或副词条。
| 配置节点 | 道具类型 | 鉴定界面位置 | 作用 |
|---|---|---|---|
main-items | 主词条鉴定道具 | 第 6 格 | 指定本次鉴定的主词条 |
entry-items | 副词条鉴定道具 | 第 7 格 | 指定本次鉴定的副词条 |
主词条与副词条道具可以同时使用。插件会根据道具名称识别配置，再检查词条 ID 和御魂模板是否匹配。
完整配置结构
yaml
# 主词条鉴定道具配置，放入鉴定界面第 6 格
main-items:
主攻击卷轴:
name: '&6主攻击卷轴'
entry-id: '攻击力'
templates: []
# 副词条鉴定道具配置，放入鉴定界面第 7 格
entry-items:
副暴击卷轴:
name: '&b副暴击卷轴'
entry-id: '暴击几率'
templates: []通用字段
main-items 和 entry-items 下的每个节点都是一类鉴定道具。节点名是配置 ID，例如 主攻击卷轴、副暴击卷轴。
| 字段 | 类型 | 说明 |
|---|---|---|
| 配置 ID | 字符串 | 道具配置的唯一标识，同一分类下不可重复 |
name | 字符串 | 用于识别鉴定道具的物品名称，支持 & 颜色代码 |
entry-id | 字符串 | 此道具指定的词条节点名称，只能填写一个词条 ID |
templates | 字符串列表 | 允许使用此道具的御魂生成模板 ID；空列表表示全局可用 |
注意
entry-id 是单个字符串，不是列表。每种鉴定道具只能指定一个主词条或副词条。需要支持多个词条时，应分别创建多个道具配置。
主词条鉴定道具
主词条鉴定道具配置在 main-items 下，需要放入鉴定界面第 6 格。鉴定成功后，该道具指定本次生成的主词条。
yaml
main-items:
主攻击卷轴:
name: '&6主攻击卷轴'
entry-id: '攻击力'
templates: []
主防御卷轴:
name: '&6主防御卷轴'
entry-id: '防御力'
templates: []
主生命卷轴:
name: '&6主生命卷轴'
entry-id: '生命值'
templates: []主词条 ID
主词条道具的 entry-id 必须对应生成模板 template.<模板 ID>.main-attribute 下的节点名称。
以下配置中的有效主词条 ID 为 攻击力、防御力 和 生命值：
yaml
template:
模板1:
main-attribute:
攻击力:
min: 10
max: 30
weight: 10
format: '&7攻击力+{value}'
round: '%.0f'
防御力:
min: 5
max: 15
weight: 10
format: '&7防御力+{value}'
round: '%.0f'
生命值:
min: 50
max: 150
weight: 10
format: '&7生命值+{value}'
round: '%.0f'因此，对应道具应填写：
yaml
entry-id: '攻击力'不要填写词条显示格式、关键词或完整 Lore，例如 &7攻击力、&7攻击力+{value} 均不是此处需要的节点名称。
副词条鉴定道具
副词条鉴定道具配置在 entry-items 下，需要放入鉴定界面第 7 格。鉴定成功后，该道具指定本次生成的副词条。
yaml
entry-items:
副暴击卷轴:
name: '&b副暴击卷轴'
entry-id: '暴击几率'
templates: []
副攻击卷轴:
name: '&b副攻击卷轴'
entry-id: '攻击力'
templates: []
副防御卷轴:
name: '&b副防御卷轴'
entry-id: '防御力'
templates: []
副生命卷轴:
name: '&b副生命卷轴'
entry-id: '生命值'
templates: []
副暴伤卷轴:
name: '&b副暴伤卷轴'
entry-id: '暴击伤害'
templates: []副词条 ID
副词条道具的 entry-id 必须对应生成模板 template.<模板 ID>.entry-value 下的节点名称。
以下配置中的有效副词条 ID 为 攻击力、防御力、生命值、暴击几率 和 暴击伤害：
yaml
template:
模板1:
entry-value:
攻击力:
min: 10
max: 30
weight: 10
format: '&7攻击力+{value}'
round: '%.0f'
防御力:
min: 5
max: 15
weight: 10
format: '&7防御力+{value}'
round: '%.0f'
生命值:
min: 50
max: 150
weight: 10
format: '&7生命值+{value}'
round: '%.0f'
暴击几率:
min: 1
max: 5
weight: 10
format: '&7暴击几率+{value}%'
round: '%.1f'
暴击伤害:
min: 3
max: 30
weight: 10
format: '&7暴击伤害+{value}%'
round: '%.1f'限制适用模板
templates 用于限制鉴定道具可以作用于哪些御魂生成模板。
全部模板可用
空列表表示不限制模板：
yaml
main-items:
主攻击卷轴:
name: '&6主攻击卷轴'
entry-id: '攻击力'
templates: []仅指定模板可用
列表中的名称必须与 template 下的模板 ID 一致：
yaml
main-items:
主攻击卷轴:
name: '&6主攻击卷轴'
entry-id: '攻击力'
templates:
- '模板1'
- '模板2'yaml
template:
模板1:
check-lore: '&7<< 御魂属性待激活 >>'
模板2:
check-lore: '&7<< 御魂属性待激活2 >>'如果当前御魂所属模板不在 templates 列表中，插件不会应用该鉴定道具，并返回对应的模板不匹配提示。
匹配规则
| 检查项目 | 主词条道具 | 副词条道具 |
|---|---|---|
| 配置分类 | main-items | entry-items |
| 界面位置 | 第 6 格 | 第 7 格 |
| 物品识别 | 匹配配置中的 name | 匹配配置中的 name |
| 词条来源 | template.<模板 ID>.main-attribute | template.<模板 ID>.entry-value |
| 模板限制 | templates | templates |
| 空模板列表 | 全部模板可用 | 全部模板可用 |
配置时需要同时满足以下条件：
- 道具名称能够匹配
name。 - 主词条道具的
entry-id存在于目标模板的main-attribute。 - 副词条道具的
entry-id存在于目标模板的entry-value。 templates不为空时，目标模板 ID 必须包含在列表中。
相关提示文本
鉴定道具的处理结果由 config.yml 中的 message 节点控制。
| 配置项 | 触发情况 | 可用替换内容 |
|---|---|---|
message.鉴定道具 | 成功使用鉴定道具 | {item}、{type}、{entry} |
message.主词条道具无效 | 第 6 格中的主词条鉴定道具无效 | 无 |
message.副词条道具无效 | 第 7 格中的副词条鉴定道具无效 | 无 |
message.主词条道具模板不匹配 | 主词条道具不适用于当前御魂模板 | 无 |
message.副词条道具模板不匹配 | 副词条道具不适用于当前御魂模板 | 无 |
yaml
message:
鉴定道具: '&7本次鉴定使用了{item}&7, 获得了指定{type}: {entry}'
主词条道具无效: '&7主词条鉴定道具无效.'
副词条道具无效: '&7副词条鉴定道具无效.'
主词条道具模板不匹配: '&7主词条鉴定道具不适用于该御魂.'
副词条道具模板不匹配: '&7副词条鉴定道具不适用于该御魂.'配置检查
| 问题 | 检查内容 |
|---|---|
| 提示主词条道具无效 | 检查道具是否放在第 6 格，并确认物品名称与 main-items 中的 name 匹配 |
| 提示副词条道具无效 | 检查道具是否放在第 7 格，并确认物品名称与 entry-items 中的 name 匹配 |
| 提示主词条模板不匹配 | 检查当前模板是否在 templates 中，或将其设置为空列表 [] |
| 提示副词条模板不匹配 | 检查当前模板是否在 templates 中，或将其设置为空列表 [] |
| 指定词条配置错误 | 检查 entry-id 是否为模板中的节点名，而不是 Lore、关键词或显示格式 |
| 多个道具配置互相覆盖 | 检查同一分类下的配置 ID 是否重复，并为不同词条分别创建配置 |