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"