配置说明
LyStrengthen2 的配置由全局配置、强化方案、强化道具和强化转移四部分组成。修改配置后，可使用 /qh reload 重新加载。
MySQL 前置要求
只要启用 MySQL 存储，就必须先安装 LyMySQLCore，并确认它已成功连接数据库。LyMySQLCore 未加载或连接失败时，本插件的 MySQL 保底数据读取与保存不会生效。
重启要求
修改 mysql.enable 后需要重启服务器。重载配置可以重新读取字段并尝试连接数据库，但 YAML 与 MySQL 对应的玩家数据监听器是在插件启动时选择的，不能仅靠重载完整切换。
配置文件
| 文件 / 目录 | 用途 |
|---|---|
config.yml | 全局设置、GUI、消息、保底和数据库连接 |
强化方案/ | 存放一套或多套装备强化方案 |
强化方案/强化方案.yml | 默认强化方案示例 |
强化道具.yml | 强化券和强化石配置 |
强化转移.yml | 强化组、转移关系、等级损耗和转移消耗 |
data/玩家UUID.yml | 未启用 MySQL 时保存玩家的保底计数 |
data/玩家UUID.yml.bak | YAML 玩家数据的上一份稳定备份，用于损坏恢复 |
插件会读取 强化方案/ 目录中的配置文件，因此可以按装备类型拆分为多个 YAML 文件。每个文件可以继续包含多套强化方案。
config.yml
失败结果展示
replace-content 用于生成强化按钮中的失败结果说明。只有在 gui.open-button-lore 中加入 {fail_result}，这些内容才会显示。
| 配置项 | 可用替换 | 说明 |
|---|---|---|
replace-content.fail-result-head | 无 | 失败结果列表的标题 |
replace-content.fail-result-take-level | {chance}、{result} | 掉级结果的显示格式 |
replace-content.fail-result-no-change | {chance} | 强化等级不变的显示格式 |
replace-content.fail-result-break | {chance} | 装备破碎的显示格式 |
{chance} 根据当前等级下所有 强化失败 条目的权重换算为百分比，保留两位小数。{result} 为配置中的等级变化值，例如 -1、-2。
yaml
replace-content:
fail-result-head:
- '&7当强化失败时:'
fail-result-take-level:
- '&7有{chance}几率强化等级&6{result}'
fail-result-no-change:
- '&7有{chance}几率强化等级&a不变'
fail-result-break:
- '&7有{chance}几率&c物品破碎'物品库开关
这些选项控制物品获取时使用的物品库支持和优先级。
| 配置项 | 默认值 | 说明 |
|---|---|---|
neigeItems | false | 是否启用 NeigeItems 支持，配置注释标明其优先级高于 OriginAttribute |
originAttribute | false | 是否优先从 OriginAttribute 获取物品；未检测到时再检测 MythicMobs |
SX-Item | false | 是否启用 SX-Item 支持 |
强化方案中的 替换物品 还标明支持 AzureFlow、SX-Item、NeigeItems 和 OriginAttribute；未指定其他来源时默认使用 MythicMobs 物品库。
禁止强化关键词
禁止强化功能Lore关键词 用于拦截指定物品参与强化系统功能。插件会遍历物品 Lore，只要任意一行包含列表中的任意关键词，就会拒绝强化、强化券和强化转移操作。
yaml
禁止强化功能Lore关键词:
- '禁止强化'配置支持 & 颜色代码。无需限制时设置为空列表：
yaml
禁止强化功能Lore关键词: []命中关键词时发送 msg.禁止强化功能物品。
公式边界符
| 配置项 | 默认值 | 说明 |
|---|---|---|
calculate-key-left | '<' | 公式左边界 |
calculate-key-right | '>' | 公式右边界 |
公式可以用于强化 Lore 和 NBT 内容。边界内以 ~ 分隔计算表达式和数字格式：
yaml
强化内容:
- '&e物理攻击: <{level}*10~%.0f>'
- '&e成长系数: <{level}*0.25~%.2f>'其中：
| 内容 | 说明 |
|---|---|
{level} | 当前写入的强化等级 |
{v.变量ID} | 从装备 Lore 中读取的数值 |
| PlaceholderAPI 变量 | 在计算前替换为玩家变量值 |
%.0f | 不保留小数 |
%.1f | 保留一位小数 |
%.2f | 保留两位小数 |
如果边界符与其他插件的文本格式冲突，可以同时修改左右边界。强化方案中的公式也要同步改成新的边界符。
强化 Lore 写入
| 配置项 | 默认值 | 说明 |
|---|---|---|
强化识别字符 | ------[强化信息]------- | 定位强化 Lore 的插入位置 |
强化插入方式 | next | next 插入定位行下方，其他值按定位行上方处理 |
强化标识符 | 114514 | 隐藏写入到每行强化 Lore 前的识别字符 |
强化名称 | &c+%lv | 追加到装备名称后的强化等级格式 |
如果物品 Lore 中找不到 强化识别字符，强化内容会写到 Lore 最后。单个强化等级可以通过方案内的 强化识别字符 覆盖全局定位行。
强化标识符 用于删除旧的强化 Lore 后重新写入，强化名称 用于展示并识别装备当前强化等级。正式投入使用后不要随意修改，否则已经生成的旧装备可能无法正确识别或清理强化数据。
保护符选中效果
保护符使用lore 会临时添加到 GUI 中当前选中的保护符上，同时插件会添加附魔光效。关闭界面或取消选择不会修改玩家背包中的保护符原件。
yaml
保护符使用lore:
- ' '
- '§a已选择该保护符 √'每个强化等级最多可以在界面中显示前三种可用保护符。强化失败时，若玩家选择了保护符，插件会消耗一个对应物品，并阻止本次掉级或破碎结果。
福星成功率
| 配置项 | 默认值 | 说明 |
|---|---|---|
福星变量 | 空字符串 | 用于读取福星数值的 PlaceholderAPI 变量；留空时关闭福星计算 |
福星乘法 | false | 控制本级 福星 数值的计算方式 |
设当前等级基础成功率为 基础概率，方案中的配置为 福星配置，福星变量 返回值为 变量值：
福星乘法 | 福星加成计算 |
|---|---|
false | 福星配置 × 变量值 |
true | 福星配置 × 变量值 × 基础概率 × 0.01 |
最终强化判定会合并基础成功率、强化石加成、保底加成和福星加成。
强化音效
| 配置值 | 说明 |
|---|---|
1.7 | 使用旧版本铁砧音效名称 |
1.12 | 使用新版本铁砧音效名称 |
yaml
sound: '1.7'该选项会影响普通强化、强化券和强化转移完成时播放的成功或失败音效。
GUI 配置
gui 下包含三套界面：
| 前缀 | 界面 | 大小 |
|---|---|---|
open-* | 普通装备强化界面 | 54 格 |
qhq-* | 强化券直升界面 | 27 格 |
zy-* | 强化等级转移界面 | 54 格 |
物品字段使用 物品ID:子ID 格式，例如 160:0。界面的交互槽位由插件固定，配置只能修改标题、装饰物品、按钮物品、名称和 Lore，不能通过配置移动实际操作槽位。
普通强化界面
| 配置项 | 说明 |
|---|---|
gui.open-title | 界面标题 |
gui.open-fill-item | 填充物品材质 |
gui.open-fill-name | 填充物品名称 |
gui.open-zb-item | 装备槽提示物品材质 |
gui.open-zb-name | 装备槽提示名称 |
gui.open-qhs-item | 强化石槽提示物品材质 |
gui.open-qhs-name | 强化石槽提示名称 |
gui.open-bhf-item | 保护符区域提示物品材质 |
gui.open-bhf-name | 保护符区域提示名称 |
gui.open-button-item | 强化按钮材质 |
gui.open-button-name | 强化按钮名称 |
gui.open-button-lore | 强化按钮说明 |
普通强化界面的固定功能槽位：
| 槽位 | 用途 |
|---|---|
10 | 待强化装备 |
37 | 执行强化 |
39 至 41 | 保护符选择，最多显示三种 |
43 | 强化石 |
3 至 8、12 至 17、21 至 26 | 展示本次强化所需材料，最多显示 18 项 |
gui.open-button-lore 支持以下内部替换：
| 替换内容 | 说明 |
|---|---|
%per | 玩家是否拥有当前等级的强化权限，显示“是”或“否” |
%cg | 当前等级基础成功率 |
%qhs | 强化石提供的成功率加成 |
%fx | 福星提供的成功率加成 |
%guaranteed | 当前生效的保底成功率加成 |
{guaranteed_now} | 当前方案累计失败次数 |
{guaranteed_max} | 当前等级触发保底所需次数 |
%vault | 计算强化石金币倍率后的金币消耗 |
%qh | 展开下一级的全部 强化内容 |
{fail_result} | 展开当前等级的失败结果和对应概率 |
%qh 和 {fail_result} 会替换为多行内容，不是普通的单行文本替换。
材料展示
| 配置项 | 可用替换 | 说明 |
|---|---|---|
gui.need-item-amount-lore | {need}、{has} | 追加到材料展示物品 Lore 的内容 |
gui.need-item-name-replace | {name}、{amount} | 材料展示物品的名称格式 |
yaml
gui:
need-item-amount-lore:
- ''
- '&7需要{need} 你有{has}'
need-item-name-replace: '{name}x{amount}'| 替换内容 | 说明 |
|---|---|
{need} | 本次强化实际需要的数量，已计算公式和强化石材料倍率 |
{has} | 玩家背包内拥有的匹配材料数量 |
{name} | 材料物品原始显示名；没有自定义名称时使用材质名称 |
{amount} | 本次需要的材料数量 |
强化券界面
| 配置项 | 说明 |
|---|---|
gui.qhq-title | 界面标题 |
gui.qhq-fill-item | 中间区域填充物品材质 |
gui.qhq-fill-name | 中间区域填充物品名称 |
gui.qhq-zb-item | 装备槽提示物品材质 |
gui.qhq-zb-name | 装备槽提示名称 |
gui.qhq-qhq-item | 强化券槽提示物品材质 |
gui.qhq-qhq-name | 强化券槽提示名称 |
gui.qhq-button-item | 使用按钮材质 |
gui.qhq-button-name | 使用按钮名称 |
gui.qhq-button-lore | 使用按钮 Lore |
固定功能槽位：
| 槽位 | 用途 |
|---|---|
10 | 待强化装备 |
13 | 使用强化券 |
16 | 强化券 |
强化转移界面
| 配置项 | 说明 |
|---|---|
gui.zy-title | 界面标题 |
gui.zy-fill-item | 填充物品材质 |
gui.zy-fill-name | 填充物品名称 |
gui.zy-zb1-item | 来源装备区域提示物品材质 |
gui.zy-zb1-name | 来源装备区域提示名称 |
gui.zy-zb2-item | 目标装备区域提示物品材质 |
gui.zy-zb2-name | 目标装备区域提示名称 |
gui.zy-button-item | 转移按钮材质 |
gui.zy-button-name | 转移按钮名称 |
gui.zy-button-lore | 转移按钮 Lore |
固定功能槽位：
| 槽位 | 用途 |
|---|---|
37 | 提供强化等级的来源装备 |
43 | 接收强化等级的目标装备 |
49 | 执行转移 |
0 至 17 | 展示转移所需材料，最多显示 18 项 |
gui.zy-button-lore 支持 %vault，表示当前转移关系配置的金币消耗。
消息配置
msg 下的字符串支持 & 颜色代码。
| 配置项 | 可用替换 | 触发场景 |
|---|---|---|
msg.强化成功 | %lv | 普通强化成功 |
msg.强化失败 | %lv | 普通强化或强化券失败 |
msg.装备破碎 | %lv | 普通强化失败并抽中 break |
msg.强化上限 | 无 | 装备达到方案强化上限 |
msg.材料不足 | 无 | 普通强化材料不足 |
msg.金币不足 | 无 | 普通强化金币不足 |
msg.强化石错误 | 无 | 强化石槽中的物品无法匹配配置 |
msg.保护符不足 | 无 | 已选择保护符，但背包中没有对应物品 |
msg.触发保护符 | 无 | 强化失败并消耗保护符 |
msg.没有权限 | 无 | 玩家缺少当前等级的 强化权限 |
msg.强化券错误 | 无 | 物品不是可用强化券，或强化券不适用于该方案 |
msg.强化券失败 | 无 | 强化券失败提示配置项 |
msg.强化券无效1 | 无 | 强化券目标等级超过装备强化上限 |
msg.强化券无效2 | 无 | 装备当前等级不低于强化券目标等级 |
msg.无法转移 | 无 | 来源等级超过目标装备强化上限 |
msg.转移材料不足 | 无 | 强化转移材料不足 |
msg.转移成功 | %lv | 强化转移成功 |
msg.转移金币不足 | 无 | 强化转移金币不足 |
msg.转移无效1 | 无 | 两件装备等级关系或强化组关系不满足要求 |
msg.强化石等级不匹配 | 无 | 强化石不适用于装备当前等级 |
msg.禁止强化功能物品 | 无 | 物品 Lore 命中禁止强化关键词 |
保底与数据存储
全局开关
yaml
guaranteed-enable: false启用后，插件会按“玩家 + 强化方案 ID”记录连续失败次数：
- 普通强化失败时，当前方案计数增加
1。 - 普通强化成功时，当前方案计数重置为
0。 - 当前失败次数达到本级
强化保底次数后，本次强化增加强化保底概率。 - 保底概率以加法加入最终成功率。
- 每个强化方案分别记录，不同方案之间不会共用失败次数。
保底的触发次数和加成概率需要在强化方案的具体等级下配置。删除对应字段或填写 0 表示该等级不使用保底加成。
YAML 存储
当 mysql.enable 为 false 时，保底数据保存在：
text
plugins/LyStrengthen2/data/玩家UUID.yml保存内容结构如下：
yaml
guaranteed:
强化方案2: 3YAML 数据保存使用临时文件和备份文件替换机制。同一玩家文件会串行读写；主文件损坏时，插件会尝试读取对应的 .bak 文件并恢复主文件。
MySQL 存储
yaml
mysql:
enable: false
databasename: mc2
username: mc2
password: mc1234
port: 3306
ip: 127.0.0.1| 配置项 | 默认值 | 说明 |
|---|---|---|
mysql.enable | false | 是否使用 MySQL 保存保底数据 |
mysql.databasename | mc2 | 数据库名称 |
mysql.username | mc2 | 数据库用户名 |
mysql.password | mc1234 | 数据库密码 |
mysql.port | 3306 | 数据库端口 |
mysql.ip | 127.0.0.1 | 数据库地址 |
启用后，插件会使用插件名称作为数据表名。表中保存玩家名称和序列化后的保底数据。
MySQL 存储需要同时满足以下条件：
- 安装
LyMySQLCore。 LyMySQLCore已成功连接数据库。guaranteed-enable设置为true。mysql.enable设置为true。- 数据库地址、端口、库名、用户名和密码正确。
- 修改存储方式后重启服务器。
只有保底功能会使用当前玩家数据存储。未启用 guaranteed-enable 时，数据库中的失败计数不会参与强化判定。
强化方案/
多方案结构
每个 YAML 文件可以包含多套顶级方案：
yaml
强化方案2:
强化上限: 10
适用物品:
- '牛马装备'
配置:
1:
概率: 50
消耗金币: 1000| 配置项 | 说明 |
|---|---|
| 顶级键 | 强化方案 ID，同时用于保底数据区分和强化券方案限制 |
强化上限 | 该方案允许达到的最高强化等级 |
适用物品 | 根据物品显示名判断是否使用该方案 |
lore-get-value | 从装备 Lore 中读取数值变量 |
配置 | 各个目标强化等级的规则 |
适用物品匹配
适用物品 根据装备显示名匹配方案：
| 写法 | 匹配方式 |
|---|---|
物品名 | 显示名包含该文本 |
contain@物品名 | 显示名包含该文本 |
equals@物品名 | 显示名与该文本完全相同 |
yaml
适用物品:
- 'contain@勇者长剑'
- 'equals@&6远古神剑'列表中的 & 会转换为 Minecraft 颜色代码。多个方案同时匹配同一件装备会造成识别不明确，应避免方案名称条件重叠。
Lore 数值读取
lore-get-value 可以从装备已有 Lore 的固定文本中提取数字，再通过 {v.变量ID} 用于强化 Lore 或 NBT 公式。
yaml
lore-get-value:
'个体值':
default-value: 1
lore-formula: '&7强化个体值: <value>'| 配置项 | 说明 |
|---|---|
| 变量节点名称 | 变量 ID，例如 个体值 对应 {v.个体值} |
default-value | 未找到 Lore 或无法解析数字时使用的默认值 |
lore-formula | 用 <value> 标记数字所在位置 |
<value> 可以位于文本中间或末尾。该功能按照固定 Lore 文本提取数值，适合格式稳定的属性行，不适合递归读取不断嵌套变化的强化文本。
等级与等级区间
配置 下的键表示强化完成后的目标等级：
yaml
配置:
1:
概率: 80
消耗金币: 100
3-9:
概率: 50
消耗金币: 1000| 写法 | 说明 |
|---|---|
1 | 仅配置强化到 1 级时的规则 |
3-9 | 3 至 9 级共用同一套规则，包含 3 和 9 |
使用区间配置时，插件会为区间中的每个等级生成对应规则，公式内的 {level} 仍会替换为实际目标等级。
强化上限范围内应提供可用的等级配置。强化、强化券或转移需要写入某个等级时，会读取该目标等级的数据。
等级配置项
| 配置项 | 类型 | 说明 |
|---|---|---|
概率 | 数字或公式字符串 | 当前目标等级的基础成功率 |
消耗金币 | 数字或公式字符串 | 当前目标等级的基础金币消耗 |
福星 | 数字 | 当前等级的福星计算系数 |
材料需求 | 字符串列表 | 当前等级需要消耗的物品和数量 |
强化失败 | 字符串列表 | 失败后的掉级、不变或破碎权重 |
设置NBT | 键值映射 | 强化完成后写入字符串 NBT |
强化内容 | 字符串列表 | 强化完成后写入装备 Lore 的内容 |
保护符 | 字符串列表 | 当前等级允许选择的保护符物品 |
命令 | 字符串列表 | 强化成功或转移写入该等级后执行的命令 |
失败命令 | 字符串列表 | 普通强化失败后执行的命令 |
强化权限 | 字符串 | 玩家强化到该等级所需的权限节点 |
强化保底次数 | 整数 | 触发本级保底加成所需的累计失败次数 |
强化保底概率 | 整数 | 达到保底次数后增加的成功率 |
强化识别字符 | 字符串 | 覆盖全局 Lore 插入定位行 |
删除LORE起始行定位 | 字符串 | 要清理区域的起始定位关键词 |
删除LORE结束行定位 | 字符串 | 要清理区域的结束定位关键词 |
替换名称 | 字符串 | 强化到该等级后直接替换整个显示名 |
替换物品 | 字符串 | 强化到该等级后直接替换为物品库中的物品 |
成功率和金币公式
概率 与 消耗金币 会先替换 PlaceholderAPI 变量和 {level}，再进行四则运算。
yaml
概率: '50+{level}*2'
消耗金币: '1000+{level}*500'启用保底后，概率 还可以读取 {guaranteed_now}：
yaml
概率: '40+{guaranteed_now}*2'{guaranteed_now} 是当前玩家在当前强化方案中的累计失败次数。
材料需求
基础格式：
yaml
材料需求:
- '测试物品#1'| 部分 | 说明 |
|---|---|
| 第一段 | 物品库中的物品标识 |
| 第二段 | 消耗数量，可以使用 {level}、PlaceholderAPI 变量和四则运算 |
| 第三段 | 可选条件表达式，条件为 true 时才需要该材料 |
带公式的数量：
yaml
材料需求:
- '强化矿石#{level}*2'带条件的材料：
yaml
材料需求:
- '高级核心#2#{level} >= 10'条件表达式支持：
| 类型 | 支持内容 |
|---|---|
| 数值比较 | >、<、>=、<=、==、!= |
| 逻辑组合 | &&、` |
| 字符串比较 | 使用单引号或双引号包裹字符串，并配合 ==、!= |
| 玩家变量 | PlaceholderAPI 变量 |
| 等级变量 | {level} |
| 布尔值 | true |
强化石的 need-item-rate 会乘到最终材料数量上。界面和实际扣除使用相同的公式与条件判断。
强化失败结果
yaml
强化失败:
- '-1#50'
- '0#45'
- 'break#5'| 结果值 | 说明 |
|---|---|
0 | 强化等级不变 |
| 负整数 | 在当前等级基础上扣除对应等级 |
break | 装备破碎并从强化槽移除 |
# 后的整数 | 当前结果的权重 |
结果按权重随机，不要求权重总和必须为 100。例如权重分别为 50、45、5 时，对应概率为 50%、45%、5%。
不要在失败结果中填写正数。失败后如果等级降至 0，插件会清除装备名称中的强化等级和插件写入的强化 Lore。
玩家已经选择有效保护符时，失败会消耗一个保护符，并跳过本次 强化失败 结果，不掉级也不破碎。
强化内容
强化内容 会写入装备 Lore，并先处理以下内容：
| 内容 | 说明 |
|---|---|
{level} | 当前强化等级 |
{v.变量ID} | lore-get-value 读取到的数值 |
| PlaceholderAPI 变量 | 当前玩家的变量值 |
| 公式边界 | 计算边界内的四则运算，并按 ~ 后格式输出 |
yaml
强化内容:
- '&c&l强化等级: &b&l{level}'
- '&e&l物理攻击: &b&l<{level}*10~%.0f>-<{level}*20~%.0f>'
- '&7个体成长: <{v.个体值}*{level}~%.2f>'每次重新写入强化等级前，插件会先移除带有全局 强化标识符 的旧强化 Lore，再写入当前目标等级的完整内容。
设置 NBT
设置NBT 会把配置值处理为字符串后写入物品 NBT。其变量和公式处理方式与 强化内容 相同。
yaml
设置NBT:
'属性': '物理攻击+<{level}*10~%.0f>'
'强化等级文本': '{level}'NBT 键为配置节点名称，NBT 值为计算后的字符串。该功能依赖插件内对应服务端版本的 NMS/NBT 适配。
保护符
yaml
保护符:
- '测试物品'
- '测试物品2'列表填写物品库中的物品标识。普通强化界面最多显示前三项。玩家选择后，插件会在强化前检查背包中是否至少存在一个对应物品；强化失败时才会扣除。
成功和失败命令
yaml
命令:
- '[console]bc %p 将 %item 强化至 %lv'
失败命令:
- '[console]bc %p 强化 %item 失败，当前等级 %lv'| 前缀 | 执行身份 |
|---|---|
[player] | 玩家本人 |
[op] | 临时以管理员身份让玩家执行，完成后恢复原权限状态 |
[console] | 服务器控制台 |
| 替换内容 | 说明 |
|---|---|
%p | 玩家名称 |
%lv | 操作完成后的等级或失败处理后的等级 |
%item | 装备显示名 |
普通强化成功和强化转移成功会执行 命令。普通强化失败会执行 失败命令。
强化权限
yaml
强化权限: 'vip1'该字段直接填写需要检查的权限节点。留空或删除时不限制。插件不会自动为方案生成固定格式的权限节点。
权限检查会用于普通强化和强化券直升。玩家缺少权限时无法强化到该目标等级。
保底等级配置
yaml
强化保底次数: 5
强化保底概率: 10当玩家在当前方案中的累计失败次数达到 5 时，强化到该等级会额外增加 10 点成功率。成功后累计次数清零，失败后继续增加。
这两个配置只有在全局 guaranteed-enable: true 时生效。
删除指定 Lore 区域
yaml
删除LORE起始行定位: '---------初始lore---------'
删除LORE结束行定位: '---------结束lore---------'当两个字段同时存在且装备 Lore 中能找到对应内容时，插件会删除起始行与结束行之间的全部 Lore，但保留起始行和结束行本身。
定位方式使用“包含关键词”判断。关键词过短或重复时可能删除错误区域，应使用唯一且稳定的定位文本。
替换名称
yaml
替换名称: '&a超级牛马装备'配置后，强化到该等级会直接把装备显示名替换为指定名称，不再按全局 强化名称 追加等级格式。由于标准强化等级识别依赖插件写入名称中的隐藏标记，替换名称适合用于切换装备形态或进入其他强化方案，不应当作普通等级名称格式使用。
替换物品
yaml
替换物品: '物品id'配置后，强化到该等级会直接返回从物品库获取的新物品，不再继续处理原物品的 Lore 和 NBT 写入。留空或删除时不生效。
强化道具.yml
该文件分为 强化券 和 强化石 两部分。两类物品都根据显示名包含配置节点名称进行识别。
强化券
yaml
强化券:
强化券1:
lv: 11
chance: 10
type: []| 配置项 | 说明 |
|---|---|
| 强化券节点名称 | 用于匹配强化券物品显示名 |
lv | 使用成功后直升到的目标强化等级 |
chance | 强化券成功率 |
type | 允许使用的强化方案 ID 列表，空列表表示不限制方案 |
限制强化方案：
yaml
强化券:
武器强化券:
lv: 10
chance: 100
type:
- '武器强化'
- '远古武器强化'强化券需要满足以下条件：
- 待强化物品能够匹配强化方案。
- 目标等级不超过方案的
强化上限。 - 装备当前等级低于强化券目标等级。
- 玩家拥有目标等级配置的
强化权限。 type为空，或包含当前强化方案 ID。
使用时会先消耗一张强化券，再按 chance 判定是否成功。强化券不会读取普通强化的金币、材料、强化石、保护符、失败掉级和保底配置。
强化石
yaml
强化石:
强化石1:
chance: 20
need-item-rate: 1.0
need-eco-rate: 1.0
type: '*'
lv: '-1'| 配置项 | 默认值 | 说明 |
|---|---|---|
| 强化石节点名称 | 无 | 用于匹配强化石物品显示名 |
chance | 无 | 成功率加成数值 |
need-item-rate | 1.0 | 材料需求数量倍率 |
need-eco-rate | 1.0 | 金币消耗倍率 |
type | 无 | + 为固定加法，* 为按基础成功率计算 |
lv | -1 | 允许使用的装备当前强化等级或等级范围 |
成功率计算方式：
type | 强化石加成 |
|---|---|
+ | 直接增加 chance |
* | 基础成功率 × chance × 0.01 |
例如基础成功率为 50，强化石 chance 为 20：
type: '+'时增加20点成功率。type: '*'时增加10点成功率。
等级限制：
lv 写法 | 说明 |
|---|---|
'-1' | 不限制当前强化等级 |
'5' | 仅当前强化等级为 5 时可用 |
'1-5' | 当前强化等级为 1 至 5 时可用，包含两端 |
lv 检查的是装备执行强化前的当前等级，不是强化完成后的目标等级。
消耗倍率会在展示和实际扣除时生效：
yaml
强化石:
节省强化石:
chance: 10
need-item-rate: 0.5
need-eco-rate: 0.8
type: '+'
lv: '1-10'该强化石会把材料数量乘以 0.5，金币消耗乘以 0.8。成功或失败都会消耗一个已放入的有效强化石。
强化转移.yml
强化转移会把左侧来源装备的强化等级转移到右侧目标装备。来源装备等级必须高于目标装备，转移后的等级不能超过目标方案的强化上限。
强化组
yaml
强化组:
f1:
- '垃圾装备'
- '拉宽装备'
f2:
- '牛马装备'
- '牛字装备'| 配置内容 | 说明 |
|---|---|
| 强化组节点名称 | 转移关系中使用的组 ID |
| 组内字符串 | 根据装备显示名包含关系判断所属强化组 |
组内文本支持 & 颜色代码。应避免同一件装备同时匹配多个强化组，否则最终识别结果可能不明确。
全局来源装备处理
yaml
转移时是否破碎装备: true| 值 | 转移成功后的来源装备处理 |
|---|---|
true | 来源装备消失 |
false | 保留来源装备，但清除其强化名称和插件写入的强化 Lore |
单条转移关系可以覆盖该全局设置。
转移关系
转移关系使用 来源组-目标组 命名，方向固定：
yaml
转移:
f1-f2:
min: 0
max: 4
转移时是否破碎装备: true
消耗金币: 100000
消耗物品:
- '测试物品#10'| 配置项 | 说明 |
|---|---|
f1-f2 | 允许从 f1 组转移到 f2 组 |
min | 转移时随机扣除强化等级的最小值 |
max | 转移时随机扣除强化等级的最大值 |
转移时是否破碎装备 | 覆盖全局来源装备处理方式 |
消耗金币 | 转移需要扣除的金币 |
消耗物品 | 转移需要扣除的物品列表 |
实际转移等级计算为：
text
来源装备等级 - min 到 max 之间的随机整数计算结果低于 1 时会调整为 1。
消耗物品 使用 物品标识#数量 格式：
yaml
消耗物品:
- '转移核心#10'
- '稳定水晶#2'强化转移需要同时满足：
- 两件装备都能匹配强化方案。
- 两件装备的数量都不大于
1。 - 两件装备均未命中禁止强化 Lore 关键词。
- 来源装备强化等级高于目标装备。
- 来源装备等级不超过目标装备方案的强化上限。
- 存在对应的
来源组-目标组转移关系。 - 玩家拥有足够的转移材料和金币。
- 随机损耗后的目标等级在目标方案中存在对应等级配置。
转移成功后，目标装备会按计算出的等级重新写入名称、Lore 和 NBT，并执行该目标等级配置中的 命令。