进阶配方（变量 / 段 / 套装组合）
把变量、段、词缀、套装、动作组合起来的复杂实战配方。基础概念见各自章节。
配方 1：随机数值武器（多变量联动）
每件武器随机滚伤害区间，并在 Lore 显示：
yaml
random_blade:
type: weapon
material: iron_sword
display_name: "<gold>{quality_word} 之刃</gold>"
lore:
- ""
- "<gray>伤害：<red>{min_dmg} - {max_dmg}</red></gray>"
- "<gray>暴击：<yellow>{crit}%</yellow></gray>"
variables:
min_dmg: "12 - 18" # 每件随机
max_dmg: "24 - 32"
crit: "5 - 15"
quality_word: "试炼"
providers:
ap:
value: '{"attack_damage":18}'变量只影响显示；真正的属性数值在
providers.ap。要让显示与属性一致，需自己保持两者协调，或用随机生成的容量 / 词缀机制。变量机制见 变量。
配方 2：品质前缀 + 随机词缀 + 后缀（三段叠加）
yaml
epic_blade:
type: weapon
material: netherite_sword
tier: EPIC
display_name: "<white>裁决</white>"
sections:
- quality_prefix_pool # 按 tier 加品质前缀（史诗）
- weapon_affix_pool # 随机抽一个武器词缀（带前后缀）
affixes:
- guardian_affix # 固定追加"守护"后缀
lore:
- ""
- "<gray>三重词缀加持</gray>"
providers:
ap:
value: '{"attack_damage":30,"crit_rate":0.15}'
options:
unbreakable: true
glow: true渲染顺序：品质前缀 + 词缀前缀 → 物品名 → 词缀后缀 + 守护后缀，Lore 段累积每个段 / 词缀的描述行。段机制见 段，词缀见 词缀，显示顺序见 品质与显示。
配方 3：品质池嵌套（不同品质给不同词缀池）
sections/ 里配两级池：
yaml
# 品质池：按 tier 路由到子池
quality_damage_pool:
type: quality_pool
legendary: dmg_pool_legendary
epic: dmg_pool_epic
rare: dmg_pool_rare
# 各品质子池（weight_join）
dmg_pool_rare:
type: weight_join
amount: 1
values:
- "3::<gray>+8 伤害</gray>"
- "2::<gray>+10 伤害</gray>"
dmg_pool_legendary:
type: weight_join
amount: 1
values:
- "3::<gold>+25 伤害</gold>"
- "1::<gold>+35 伤害</gold>"物品引用 quality_damage_pool，随机生成时按物品 tier 选对应子池抽取。随机生成见 随机生成。
配方 4：套装 + 事件技能链
套装集齐后，受击自动反击、击杀自动加血：
yaml
# sets/guardian.yml
guardian_set:
display_name: "<aqua>守护者</aqua>"
icon: SHIELD
belonging_pieces:
- "guardian" # guardian_xxx 都算
lore:
- "<gray>守护者的传承</gray>"
bonuses:
- pieces: 2
name: "坚壁"
attributes:
防御: 20
- pieces: 4
name: "<aqua>守护壁垒</aqua>"
lore:
- "<aqua>累计 +50 防御</aqua>"
- "<gray>受击反击 / 击杀回血</gray>"
attributes:
防御: 30 # 4 件累计 +50
effects:
DAMAGE_RESISTANCE: 0
abilities:
- trigger: on_hit # 受击自动触发
cooldown: 4s
actions:
- {handler: "qinhskills:cast", payload: "守护反击"}
- trigger: on_kill # 击杀自动触发
cooldown: 2s
actions:
- {handler: "qinhskills:cast", payload: "战意回血"}事件型 abilities 穿满件数后自动触发（与手持物品无关）。套装机制见 套装，技能交给 QinhSkills。
配方 5：星级强化显示
用 star 变量驱动名尾 [+N]（支持星级的类型：weapon/armor/projectile/shield/gem）：
yaml
upgradable_sword:
type: weapon
material: diamond_sword
display_name: "<gold>精炼之刃</gold>"
variables:
star: "3" # 名尾显示 [+3]
providers:
ap:
value: '{"attack_damage":20}'强化系统可通过 层 API / 变量 API 在运行时改 star。
配方 6：限制 + 绑定 + 触发组合（高端装备）
yaml
boss_drop_blade:
type: weapon
material: netherite_sword
tier: LEGENDARY
display_name: "<gradient:#FFD700:#FF4500>灭世</gradient>"
providers:
ap:
value: '{"attack_damage":40,"crit_rate":0.25}'
options:
unbreakable: true
glow: true
bind_on_acquire: true # 拾取即绑定，防交易
restrictions:
- "level:40" # 40 级才能用
- "permission:rank.vip" # VIP 专属
actions:
triggers:
shift_left_click:
trigger: { atom: shift_left_click }
cooldown: 8s
consume:
- "level:3"
refs:
- handler: qi:title
payload: "<dark_red>灭世一击</dark_red>||||5||30||10"
- handler: qinhskills:cast
payload: '{"skill":"apocalypse","level":3}'