离渊系列插件Wiki

强化道具 ​

强化道具包括强化券、强化石和保护符。强化券与强化石配置在 强化道具.yml，保护符则按强化等级配置在对应的强化方案文件中。

插件通过物品显示名识别强化券和强化石。物品显示名只要包含配置节点名称，即会被识别为对应道具。配置节点名称应避免重复或互相包含，以免匹配到错误道具。

强化券 ​

强化券用于将装备直接提升到指定强化等级。玩家需要通过 /qh qhq 或 /qh2 qhq 打开强化券界面，将装备与强化券分别放入对应槽位后点击按钮。

yaml
强化券:
  强化券1:
    lv: 11
    chance: 10
    type: []
字段类型说明
强化券1字符串强化券识别名称。物品显示名包含该名称时即会被识别
lv整数强化券成功后直达的目标强化等级
chance整数强化券成功率，判定范围为 100
type字符串列表限制可使用的强化方案 ID。空列表表示全部强化方案均可使用

限制强化方案 ​

type 填写强化方案文件中的顶层方案 ID，不是装备名称。

yaml
强化券:
  强化券1:
    lv: 11
    chance: 10
    type:
      - 强化方案1
      - 强化方案2

此配置表示该强化券只能用于 强化方案1 和 强化方案2。

使用条件 ​

强化券必须同时满足以下条件：

  • 放入的装备能够匹配一个强化方案。
  • 装备当前强化等级低于强化券的目标等级。
  • 强化券目标等级不超过装备所属方案的 强化上限。
  • 强化券 type 为空，或其中包含装备所属的强化方案 ID。
  • 玩家拥有目标等级配置的 强化权限；目标等级未配置权限时不限制。
  • 目标强化等级必须在强化方案中存在对应等级配置。
  • 装备数量必须为 1。
  • 装备 Lore 不能命中 禁止强化功能Lore关键词。

判定结果 ​

点击强化券界面按钮后，插件会先消耗 1 张强化券，再按照 chance 进行成功判定。

结果处理方式
成功装备直接更新为 lv 指定的强化等级，并执行目标等级的成功命令
失败装备强化等级保持不变，仅消耗本次使用的强化券

强化券使用自己的 chance 独立判定，不会计算普通强化的基础成功率、强化石加成、福星加成或保底加成，也不会扣除目标等级配置的强化材料与金币。

强化石 ​

强化石用于普通强化界面，可以调整本次强化的成功率、材料数量和金币消耗。玩家将强化石放入强化界面的强化石槽后，界面会重新计算本次强化数据。

yaml
强化石:
  强化石1:
    chance: 20
    need-item-rate: 1.0
    need-eco-rate: 1.0
    type: '*'
    lv: '-1'
字段类型说明
强化石1字符串强化石识别名称。物品显示名包含该名称时即会被识别
chance整数强化石提供的成功率加成数值
need-item-rate小数本次强化材料数量倍率，默认 1.0
need-eco-rate小数本次强化金币消耗倍率，默认 1.0
type字符串成功率加成方式，支持 + 或 *
lv字符串强化石允许使用的装备当前强化等级，-1 表示不限制

成功率加成方式 ​

type计算方式chance: 20 的效果
+基础成功率直接增加 chance基础成功率为 50 时，增加 20，得到 70
*先计算 基础成功率 × chance ÷ 100，再把结果加到基础成功率基础成功率为 50 时，增加 10，得到 60

强化石只负责产生强化石成功率加成。最终成功率还可能包含保底加成与福星加成，具体取决于主配置和当前强化等级配置。

材料与金币倍率 ​

need-item-rate 会乘到本次所有有效材料的需求数量上，结果按整数数量处理。

yaml
强化石:
  节省材料强化石:
    chance: 0
    need-item-rate: 0.5
    need-eco-rate: 1.0
    type: '+'
    lv: '-1'

当某项材料原本需要 10 个时，使用此强化石后需要 5 个。

need-eco-rate 会乘到本次强化的金币消耗上，结果按整数金币处理。

yaml
强化石:
  金币折扣强化石:
    chance: 0
    need-item-rate: 1.0
    need-eco-rate: 0.8
    type: '+'
    lv: '-1'

当本次强化原本需要 1000 金币时，使用此强化石后需要 800 金币。

倍率会同时用于界面展示、资源检查和实际扣除。

等级限制 ​

lv 检查的是装备进行本次强化前的当前等级，不是即将到达的目标等级。

写法说明
'-1'不限制当前强化等级
'5'仅当前强化等级为 5 时可用
'1-5'当前强化等级在 1 至 5 之间时可用，包含 1 和 5

建议将 lv 使用引号包裹，避免 YAML 将内容解析成非预期类型。

消耗规则 ​

普通强化开始后，插件会扣除本次所需材料与金币。强化石有效时还会消耗强化石槽中的 1 个强化石，无论本次强化成功还是失败。

强化石不会限制强化方案。配置中的 type 仅表示成功率采用加法还是按基础成功率计算比例加成。

保护符 ​

保护符不配置在 强化道具.yml。每个强化等级可以在强化方案的 保护符 列表中填写该等级允许选择的保护符物品名称。

yaml
配置:
  1:
    保护符:
      - 测试物品
      - 测试物品2

保护符物品通过插件支持的物品获取方式读取。强化界面最多展示当前目标等级配置中的前 3 个保护符。

选择状态 ​

玩家点击强化界面中的保护符后，插件会为界面内的保护符图标添加附魔效果，并追加 config.yml 中的 保护符使用lore。

yaml
保护符使用lore:
  - ' '
  - '§a已选择该保护符 √'

再次点击当前已选择的保护符可以取消选择。切换到其他保护符时，插件会更新选择状态。

背包扣除 ​

保护符只在界面中用于选择，实际物品必须存在于玩家背包内。执行强化前，插件会检查背包中是否至少存在 1 个已选择的保护符。

情况处理方式
强化成功不消耗保护符
强化失败且已选择保护符从玩家背包扣除 1 个保护符，装备等级不变且不会破碎
强化失败且未选择保护符按当前等级的 强化失败 权重配置执行掉级、不变或破碎结果
已选择但背包中没有对应保护符取消本次强化，并发送 msg.保护符不足

保护符触发后不会再抽取该等级的 强化失败 结果，因此可以同时防止掉级与装备破碎。

完整配置结构 ​

yaml
强化券:
  强化券1:
    lv: 11
    chance: 10
    type: []

  指定方案强化券:
    lv: 5
    chance: 100
    type:
      - 强化方案2

强化石:
  强化石1:
    chance: 20
    need-item-rate: 1.0
    need-eco-rate: 1.0
    type: '*'
    lv: '-1'

  低级强化石:
    chance: 10
    need-item-rate: 0.8
    need-eco-rate: 0.9
    type: '+'
    lv: '0-5'

配置注意事项 ​

  • 强化券和强化石均通过显示名包含关系识别，不检查物品材质、Lore 或 NBT。
  • 道具配置节点名称需要与实际物品显示名中的识别文字一致，颜色符可使用 &。
  • 不要让多个强化券或强化石名称互相包含，否则可能优先匹配到非预期配置。
  • 强化券的 type 必须填写强化方案 ID，留空列表才表示全部方案可用。
  • 强化石的 type 只能填写 + 或 *，不能填写强化方案 ID。
  • 强化石的 lv 应填写单个等级、等级范围或 -1。
  • 保护符名称必须能够通过插件当前启用的物品来源正确取得。
  • 普通强化、强化券和强化转移都会检查装备是否命中 禁止强化功能Lore关键词。
  • 修改 强化道具.yml、保护符配置或相关主配置后，可使用 /qh reload 或 /qh2 reload 重新加载。重载操作仅限服务器管理员使用。