`MxtResources`：整份消耗

MxtResources 只有一个方法，但它管的是多项目一起付这件事：整份 Cost 数组先按顺序统一模拟，全部通过后再逐条实扣。实扣失败只输出 WARN，后续费用与业务继续，不回滚、不取消。单个 Cost 用 MxtCosts。

方法

方法	参数	返回值	说明
`consume(entity, costs)`	活着的实体、`Cost[]`	`ResultWithData<Map<Identifier, Double>>`	重复目标诊断后按数组原序模拟和实扣，不合并、不重排。模拟失败不扣，实扣失败只 WARN 并继续。

costs 就是统一的 Cost 数组：五种写法都能直接写，旧的 {"id": ..., "amount": ...} 简写仍然有效（读作 mxt:resource）。付款者必须是活着的实体（不需要是玩家，但需要玩家背包的 mxt:item 与需要玩家的 mxt:js 对非玩家付款者就是付不出）。无法解码的条目使本次调用失败，不会被静默丢掉。

const result = MxtResources.consume(player, [
  { id: 'mxt:spirit_power', amount: 10 },
  { type: 'mxt:aura', aura: 'mxt:fire_aura', amount: 'level + 2' }
])

if (result.isSuccess()) {
  console.info(`已扣除: ${result.getData()}`)
} else {
  console.warn(`付不出: ${result.failedResource()}`)
}

返回值提供 isSuccess()、isFailure()、failure()、failedResource() 与 getData()。客户端、非法公式或模拟失败时 isSuccess() 为 false。模拟通过且实扣尝试结束即返回成功，不保证全额收齐；getData() 只汇总已知实际数值支出，不包含物品、池灵气或脚本内部未知扣量。

API 参考

`MxtResources`：整份消耗

方法

相关

MxtResources：整份消耗 ​

方法 ​

相关 ​

`MxtResources`：整份消耗

方法

相关