词条改造：重铸与洗炼

两种操作

• 重铸 reforge：可替换词条 ID、tier 和数值。
• 洗炼 refine：保留词条 ID 和 tier，只重新抽该词条数值。

正式默认规则关闭，必须逐物品启用。

1. 材料物品

reforge_stone:
  item: { material: FIRE_CHARGE, name: '<gold>重铸石' }
  instance: stackable
  tags: [affix-material]

refine_stone:
  item: { material: AMETHYST_SHARD, name: '<aqua>洗炼石' }
  instance: stackable
  tags: [affix-material]

locking_wax:
  item: { material: HONEYCOMB, name: '<yellow>锁定蜡' }
  instance: stackable
  tags: [affix-material]

2. 完整规则

gameplay/affix-modification/rules.yml：

defaults:
  reforge:
    enabled: false
  refine:
    enabled: false

items:
  example_blade:
    reforge:
      enabled: true
      scope: all-unlocked
      cost:
        item: { id: reforge_stone, amount-per-affix: 2 }
        currency: { type: vault, amount-per-affix: '100.00' }
      locks:
        max: 1
        cost:
          item: { id: locking_wax, amount-per-affix: 1 }
      pity:
        revision: 1
        guarantee-on-attempt: 5
        tiers: [1]
    refine:
      enabled: true
      scope: single
      cost:
        item: { id: refine_stone, amount-per-affix: 1 }
        currency: { type: playerpoints, amount-per-affix: '10' }

3. 字段解释

• scope: single：一次只改玩家选择的一条。
• scope: all-unlocked：一次改整件装备所有未锁词条。
• amount-per-affix：按本次实际目标词条数乘算。
• currency.type：只能是 vault 或 playerpoints；一次操作最多一种外部货币。
• Vault 金额用带引号十进制字符串，PlayerPoints 通常是整数串。
• locks.max：本次最多锁几条；锁定词条不被重铸。
• pity.revision：保底规则版本，改变算法语义时递增，避免旧计数误用。
• guarantee-on-attempt：达到指定尝试次数触发保底。
• tiers：保底适用 tier。

保底比较需要词条随机值中的 pity-direction，见 品质、词条与方案。

4. 启用与验证

/si reload modification
/si reload modification-gui
/si give 玩家名 reforge_stone 20
/si give 玩家名 locking_wax 5
/si give 玩家名 example_blade 1 epic identified

玩家执行 /si modify，放入装备，选择重铸或洗炼、目标/锁定项，检查预览费用后确认。

5. 经济安全

提交前会再次检查目标装备完整事实、规则指纹、材料、provider 身份和余额。外部扣费明确失败时本地改造回滚；若外部系统返回不确定结果，相关 provider 会被冻结并保留审计现场，防止玩家重试造成二次扣费。此时查看 /si health，修复 provider 后通过成功重载恢复，不要删除装备数据。

6. 常见错误

• 没安装 Vault 经济实现却配置 vault。
• 同一次操作同时写 Vault 和 PlayerPoints。
• 金额没加引号或小数精度超 provider 能力。
• all-unlocked 的候选工作量过大，被编译期上限拒绝。
• 装备未鉴定、词条状态损坏或定义已过期。
• 锁定数超过 max，或锁材不足。
• GUI 显示旧候选后物品被移动；提交会返回冲突，这是正常保护。