# Item quest

For this type of quest you must specify an item, with the line :\
**required\_item:** _\<TYPE>_\
\
It is not mandatory to specify an item. Simply remove this line from your quest to take into account all items involved in the quest type. For example, a `BREAK` quest will include all broken blocks if none are specified.\
\
All types of items are listed on [**this page**](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html). By activating the tooltips in-game (F3+H), you can also see the item IDs directly. In some cases, however, the IDs shown in-game may differ from those used by the server.

### Custom items

For quests that require an item, you can specify a custom item.&#x20;

You must then specify in **`required_item`** the type **`CUSTOM_ITEM`**. \
Then, below, you must specify the name of the item and its description.

`required_item: CUSTOM_ITEM` \
`custom_item:` \
`type: COBBLESTONE` \
`name: "&c&lThe Saint Cobblestone"` \
`lore:` \
&#x20;  `- "&cWoaaaaaaaw..."`

#### Examples

{% code title="Basic item quest :" %}
```
1:
    name: "&aStone"
    menu_item: STONE
    description:
      - "&bMine 32 stones."
      - "&bWin &c500$&b."
    quest_type: BREAK
    required_item: STONE
    required_amount: 32
    reward:
      reward_type: MONEY
      amount: 500
```
{% endcode %}

{% code title="Item quest with custom item :" %}
```
1:
    name: "&d&lBeautiful flower"
    menu_item: ALLIUM
    description:
      - "&eGet one &dbeautiful flower&e."
      - "&eWin &b&n32 diamond blocks."
    quest_type: GET
    required_item: CUSTOM_ITEM
    custom_item:
      type: ALLIUM
      name: "&dBeautiful Flower"
      lore:
        - "&dThis flower is"
        - "&dvery useful..."
    required_amount: 1
    reward:
      reward_type: COMMAND
      commands:
        - "give %player% diamond_block 32"
```
{% endcode %}

### Potions

For quests that require a potion, you can specify the type and whether it should be upgraded or expanded. To do this, you can add a `potion` section to your quest setup, like this:

```
1:
    name: "&aSpeeeed..."
    menu_item: POTION
    description:
        - "&eGet a speed potion level 1."
        - "&eWin &b5 EXP levels&e."
    quest_type: PICKUP
    required_item: POTION
    potion:
      type: SPEED
      upgraded: false
      extended: false
    required_amount: 1
    reward:
      reward_type: EXP_LEVELS
      amount: 5
2:
    name: "&cSpeeeed... But extended."
    menu_item: POTION
    description:
      - "&eGet a speed potion level 2."
      - "&eWin &b5 EXP levels&e."
    quest_type: GET
    required_item:
      - POTION
      - SPLASH_POTION
      - LINGERING_POTION
    potion:
      type: SPEED
      upgraded: false
      extended: true
    required_amount: 1
    reward:
      reward_type: EXP_LEVELS
      amount: 5
```

Please note that a potion cannot be both extended and upgraded.&#x20;

For a list of potion types, you can visit [this link](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionType.html).
