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.

Custom items

For quests that require an item, you can specify a custom item.

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: - "&cWoaaaaaaaw..."

Examples

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

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"

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.

For a list of potion types, you can visit this link.