Entity types

For this type of quest you must specify an entity, with the line : required: <type>

It is not mandatory to specify an entity. Simply remove this line from your quest to take into account all entities involved in the quest type. For example, a KILL quest will include all killed entities if none are specified. All types of entities are listed on this page.

Here are some additional parameters to use for quests that require an entity.

Summary

1. Multiple requirements

2. Coloured sheep

Multiple requirements

It is possible to assign multiple items/entities to a same quest. Thus, all items/entities in the list will count towards the quest's progress. However, it is not possible to specify a required number for each attribute in the list.

To add multiple items/entities to a quest, the syntax is as follows:

required:
  - ZOMBIE
  - CREEPER
  - ...

Coloured sheep

For SHEAR quests, if the player has to shear sheep, you can specify a wool colour. To specify a colour, you simply add the line sheep_color: <COLOR> below entity_type.

The available colours are listed on this page, in the Enum Constant section.

Examples

Basic quest :

1:
    name: "Too many zombies"
    menu_item: ZOMBIE_HEAD
    description:
      - "&cKill &65 &czombies."
      - "&aWin &b500 &aTokens."
    quest_type: KILL
    required: ZOMBIE
    required_amount: 5
    reward:
      reward_type: POINTS
      amount: 500

Quest with coloured sheep :

1:
    name: "&2Shear 3 purple sheeps."
    menu_item: PURPLE_WOOL
    description:
      - "&6Reward:"
      - "&7A \"hello\" message from the server :)"
    quest_type: SHEAR
    required: SHEEP
    sheep_color: PURPLE
    required_amount: 3
    reward:
      reward_type: COMMAND
      commands:
        - "say Hello"