consume (task type)

Since v3.9

Consume a specific item.

Options

Key	Description	Type	Required	Default	Notes
amount	The number of items to consume.	Integer	Yes	-	-
item	The specific item to obtain.	Material, or ItemStack	Yes	-	Accepts standard item definition. Please see this list (1.13+) or this list (1.8-1.12) for material names.
data	The data code for the item.	Integer	No	0	This field is not used in Minecraft versions 1.13+, nor is it compatible with ItemStack definitions.
exact-match	Whether the item should exactly match what is defined.	Boolean	No	true	-
worlds	Worlds which should count towards the progress.	List of world names	No	-	-

Examples

Consume 8 of BEEF:

beef:
  type: "consume"
  item: BEEF                            # name of item (can be id or minecraft name)
  amount: 8                             # amount of item consumed
  data: 0                               # (OPTIONAL) data code
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"

Consume 8 of a specific item:

beef:
  type: "consume"
  item:                                 # SPECIFIC item with name and lore
    name: "&cSpecial Beef"
    type: "RAW_BEEF"
    lore:
     - "&7This is a special type of beef"
  amount: 8                             # amount of item consumed
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"

Consume 8 of quest item special_beef:

beef:
  type: "consume"
  item:                                 # USING quest-item
    quest-item: "special_beef"
  amount: 8                             # amount of item needed
  remove-items-when-complete: false     # (OPTIONAL) take the items away from the player on completion - default: false
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"