MxtResources: Whole Cost Arrays

MxtResources has a single method, but it is the one that pays several entries together: the whole Cost array is simulated in order before any real deduction. Real failures only log WARN, and later fees and business effects continue without rollback or cancellation. For a single Cost, use MxtCosts.

Methods

Method	Parameters	Return value	Description
consume(entity, costs)	a living entity, Cost[]	ResultWithData<Map<Identifier, Double>>	Diagnoses duplicate targets, then simulates and deducts in array order without merging or reordering. Simulation refusals deduct nothing; real failures only warn and continue.

costs is the unified Cost array: all five shapes can be written directly, and the older {"id": ..., "amount": ...} shorthand still works (it is read as mxt:resource). The payer has to be a living entity — it does not have to be a player, but mxt:item (which needs a player's inventory) and mxt:js (which needs a player) are simply unpayable for a non-player payer. An entry that cannot be decoded fails the call rather than being dropped silently.

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(`Deducted: ${result.getData()}`)
} else {
  console.warn(`Could not pay: ${result.failedResource()}`)
}

The result provides isSuccess(), isFailure(), failure(), failedResource() and getData(). Client calls, invalid formulas and simulation refusals return isSuccess() == false. Once simulation passes and real attempts finish, success is returned without promising full collection. getData() totals only known actual resource spending; it excludes items, pool aura and unknown amounts inside scripts.

Related

• A single Cost and its five shapes: MxtCosts and Shared Data Types.
• Which channel a cost is charged to (the payer, the aura pool underfoot, a block's own stock): Shared Data Types.
• The values behind it: MxtValues and resource.
• KubeJS API Reference.