inventory (task type)

Since v1.4

Obtain a set of items.

Options

Key Description Type Required Default Notes
amount The number of items to obtain. 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 -
remove-items-when-complete Whether the items should be taken from the player when complete. Boolean No false If allow-partial-completion is true, then this will also be set to true.
allow-partial-completion Whether any number of items counts towards the task progress. Boolean No true Setting to true will force remove-items-when-complete to true as well. If a player obtains any matching item, it will be immediately taken away from them and added towards the quest progress.
worlds Worlds which should count towards the progress. List of world names No - -

Examples

Obtain 8 of BEEF:

beef:
  type: "inventory"
  item: BEEF                           # name of item (can be id or minecraft name)
  amount: 8                             # amount of item needed
  data: 0                               # (OPTIONAL) data code
  remove-items-when-complete: false     # (OPTIONAL) take the items away from the player on completion - default: false
  allow-partial-completion: false       # (OPTIONAL) allow partial deliveries - default: true
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"

Obtain 8 of a specific item:

beef:
  type: "inventory"
  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 needed
  data: 0                               # (OPTIONAL) data code
  remove-items-when-complete: false     # (OPTIONAL) take the items away from the player on completion - default: false
  allow-partial-completion: false       # (OPTIONAL) allow partial deliveries - default: true
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"

Obtain 8 of quest item special_beef:

beef:
  type: "inventory"
  item:                                 # USING quest-item
    quest-item: "specialbeef"
  amount: 8                             # amount of item needed
  data: 0                               # (OPTIONAL) data code
  remove-items-when-complete: false     # (OPTIONAL) take the items away from the player on completion - default: false
  allow-partial-completion: false       # (OPTIONAL) allow partial deliveries - default: true
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"

Back to top

This wiki serves as a manual for Quests however there is no guarantee that the information is up-to-date or complete. As per the license, this software provides absolutely no warranty, nor are the maintainers liable for any damages. Please see the license text for more information.