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. 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.

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.