Objective Types

The objective field on a quest decides what it tracks. Most objectives take a target-type (a mob, block, or item) and a target-amount. Leave target-type out and it counts anything for that action, for example a BREAK quest with no type counts any block broken.

Tip

target-type can be a single value or a list. If it is a list, any one match counts, there is no way to split the amount across values.

The catalog

Item based

Objective	Counts when the player	Notes
BREAK	breaks a block	Use the block’s own material, e.g. DIAMOND_ORE, not DIAMOND.
PLACE	places a block
CRAFT	crafts an item	Checks the result, not the ingredients. Shift-craft is estimated from the smallest ingredient stack.
PICKUP	picks an item off the ground
CONSUME	eats or drinks something	Food, potions, and milk buckets.
GET menu-checked	has an amount in their inventory	Read when the menu opens, never takes items away.
COOK	takes a smelted item out of a furnace	Counted on removal from the output slot.
ENCHANT	enchants on an enchanting table
FISH	catches something on a rod	Junk and treasure count too, not just fish.
FARM	harvests a fully grown crop	Tall plants (sugar cane, cactus, bamboo) only count above the base block.
LAUNCH	throws or shoots an item	Snowballs, eggs, arrows, tridents, fireworks, xp bottles.

Entity based

Objective	Counts when the player	Notes
KILL	kills a mob, animal, or player	Use PLAYER as the type for PvP kill quests.
BREED	breeds two animals
TAME	tames a wild animal
SHEAR	shears a sheep, mooshroom, or snow golem	Sheep quests can lock to a wool colour with sheep-color.

Global

These need no target-type.

Objective	Counts when the player	Notes
EXP_POINTS	earns experience points
EXP_LEVELS	earns experience levels
PLAYER_DEATH	dies	A cheap troll-quest option.
CARVE_PUMPKIN	carves a pumpkin	Detected as a shears right-click on a pumpkin, main hand only.
MILK_COW	fills a bucket with milk
WALK_DISTANCE	walks or sprints a distance	Ground only, no flying, gliding, or vehicles.
PLAYTIME	stays online for a duration	target-amount is in minutes.
DEAL_DAMAGE	deals damage to entities	Total damage across hits.

Advanced

Objective	Counts when the player	Notes
VILLAGER_TRADE	trades with a villager	Optionally locked to a profession and/or level. Detected as a result-slot click, so a shift-click bulk trade counts as one.
LOCATION menu-checked	stands at set coordinates	Optional radius, checked when the menu opens.
PLACEHOLDER menu-checked	matches a PlaceholderAPI value	Compares a placeholder against a target with an operator. Needs PlaceholderAPI.

Integrations

These parse but are not active in this build yet. They land with the plugin integrations in a later update.

Objective	Will need	Status
CRATE_OPEN	ExcellentCrates	not yet
MYTHIC_MOB_KILL	MythicMobs	not yet
ELITE_MOB_KILL	EliteMobs	not yet
VOTE	a supported vote plugin	not yet

Menu-checked objectives

A few objectives have no live event to hook, so the plugin checks them when the player opens their menu, not in the background:

• GET mirrors the live inventory count and never removes items.
• LOCATION completes if the menu is opened while inside the radius, in the right world.
• PLACEHOLDER resolves the placeholder and runs the compare on menu open.

This is by design. Tell your players to reopen the board to tick these forward.

PlaceholderAPI

A PLACEHOLDER quest only works if PlaceholderAPI is installed. Without it, that quest sits inert, it does not error and it does not block the rest of the board.

Item match extras

For item-based objectives, matching by plain material covers most cases. Finer matching (potion type, custom name and lore, ignore-NBT, custom model data, custom head textures, and third-party item plugins like Oraxen or ItemsAdder) is planned for a later update and is not active yet.

Ready to build one? Head to Creating Quests.