Skip to main content

Consume item

saturn:consume_item

Decreases the count of the item stack in the context.

A trigger matches published server signals. It can be used in trigger rules or triggered abilities; registration itself does not perform any action. See the trigger lifecycle.

JSON fields​

FieldTypeRequiredDefaultDescription
typeResource IDyes—saturn:consume_item
playerVanilla predicatenoomittedVanilla player predicate; in a player model node it is a player UUID parameter.
itemVanilla predicatenoomittedVanilla ItemPredicate that filters the item in this event.

The parameters reuse the Codec of the corresponding Minecraft 26.1.2 criterion, but the signal is published by Saturn and does not create or grant vanilla advancements. Vanilla player / entity / item predicates and Saturn EntityCondition / ItemCondition are different formats.

Omitting an optional range of the vanilla criterion, or writing an empty range object, means no extra restriction is added for that range; the player predicate still follows the criterion's vanilla format.

JSON example​

{
"type": "saturn:consume_item"
}

This is a value to embed in the corresponding field, not a standalone loadable data pack file. The example: references in the examples must be replaced with defined entries.

Java entry point​

net.minecraft.advancements.criterion.ConsumeItemTrigger.TriggerInstance. This page is based on the Codec in the current 26.1.2 source.