Quest Types

zQuests provides over 35 different quest types to track various player activities. This page documents all available quest types and their specific configuration options.

Block Quests

BLOCK_BREAK

Track when players break specific blocks.

quests:
  - type: BLOCK_BREAK
    name: "stone-miner"
    display-name: "Stone Miner"
    description: "Break 500 stone blocks"
    thumbnail: STONE
    goal: 500
    actions:
      - material: STONE
      - material: COBBLESTONE
      - tag: LOGS  # Use Bukkit tags

Actions format:

material - Bukkit Material
tag - Bukkit Tag (e.g., LOGS, PLANKS, WOOL)

BLOCK_PLACE

Track when players place specific blocks.

quests:
  - type: BLOCK_PLACE
    name: "builder"
    display-name: "Builder"
    description: "Place 500 blocks"
    thumbnail: BRICKS
    goal: 500
    actions:
      - material: STONE_BRICKS
      - material: BRICKS
      - tag: PLANKS

Entity Quests

ENTITY_KILL

Track when players kill specific entities.

quests:
  - type: ENTITY_KILL
    name: "skeleton-hunter"
    display-name: "Skeleton Hunter"
    description: "Kill 50 skeletons"
    thumbnail: BONE
    goal: 50
    actions:
      - entity: SKELETON
      - entity: STRAY

Actions format:

entity - Bukkit EntityType

ENTITY_DAMAGE

Track total damage dealt to entities. No specific entity type required.

quests:
  - type: ENTITY_DAMAGE
    name: "damage-dealer"
    display-name: "Damage Dealer"
    description: "Deal 1000 damage to entities"
    thumbnail: IRON_SWORD
    goal: 1000

TAME

Track when players tame animals.

quests:
  - type: TAME
    name: "animal-tamer"
    display-name: "Animal Tamer"
    description: "Tame 10 horses"
    thumbnail: SADDLE
    goal: 10
    actions:
      - entity: HORSE
      - entity: DONKEY
      - entity: MULE

SHEAR

Track when players shear entities.

quests:
  - type: SHEAR
    name: "wool-collector"
    display-name: "Wool Collector"
    description: "Shear 50 sheep"
    thumbnail: SHEARS
    goal: 50
    actions:
      - entity: SHEEP

BREED

Track when players breed animals.

quests:
  - type: BREED
    name: "animal-breeder"
    display-name: "Animal Breeder"
    description: "Breed 20 cows"
    thumbnail: WHEAT
    goal: 20
    actions:
      - entity: COW
      - entity: SHEEP
      - entity: PIG

Actions format:

entity - Bukkit EntityType

MILK

Track when players milk animals (cows, goats, or mooshrooms).

quests:
  - type: MILK
    name: "milk-collector"
    display-name: "Milk Collector"
    description: "Milk 10 cows"
    thumbnail: MILK_BUCKET
    goal: 10
    actions:
      - entity: COW
      - entity: GOAT
      - entity: MOOSHROOM

Actions format:

entity - Bukkit EntityType (only COW, GOAT, and MOOSHROOM are supported)

Gathering Quests

FARMING

Track when players harvest crops.

quests:
  - type: FARMING
    name: "wheat-farmer"
    display-name: "Wheat Farmer"
    description: "Harvest 500 wheat"
    thumbnail: WHEAT
    goal: 500
    actions:
      - material: WHEAT

FISHING

Track when players catch fish.

quests:
  - type: FISHING
    name: "fisherman"
    display-name: "Fisherman"
    description: "Catch 20 cod"
    thumbnail: COD
    goal: 20
    actions:
      - material: COD
      - material: SALMON

BUCKET_FILL

Track when players fill buckets (water, lava, milk, etc.).

quests:
  - type: BUCKET_FILL
    name: "water-collector"
    display-name: "Water Collector"
    description: "Fill 10 water buckets"
    thumbnail: WATER_BUCKET
    goal: 10
    actions:
      - material: WATER_BUCKET
      - material: LAVA_BUCKET

Actions format:

material - Bukkit Material (the resulting bucket type, e.g., WATER_BUCKET, LAVA_BUCKET, POWDER_SNOW_BUCKET)
tag - Bukkit Tag

Crafting Quests

CRAFT

Track when players craft items.

quests:
  - type: CRAFT
    name: "chest-crafter"
    display-name: "Chest Crafter"
    description: "Craft 16 chests"
    thumbnail: CHEST
    goal: 16
    actions:
      - material: CHEST

SMELT

Track when players smelt items in furnaces.

quests:
  - type: SMELT
    name: "iron-smelter"
    display-name: "Iron Smelter"
    description: "Smelt 64 iron ingots"
    thumbnail: IRON_INGOT
    goal: 64
    actions:
      - material: IRON_INGOT

SMITHING

Track when players use the smithing table.

quests:
  - type: SMITHING
    name: "netherite-smith"
    display-name: "Netherite Smith"
    description: "Upgrade to netherite armor"
    thumbnail: NETHERITE_CHESTPLATE
    goal: 4
    actions:
      - material: NETHERITE_HELMET
      - material: NETHERITE_CHESTPLATE
      - material: NETHERITE_LEGGINGS
      - material: NETHERITE_BOOTS

Enchanting & Brewing Quests

ENCHANT

Track when players enchant items.

quests:
  - type: ENCHANT
    name: "enchanter"
    display-name: "Enchanter"
    description: "Apply Sharpness enchantment 5 times"
    thumbnail: ENCHANTED_BOOK
    goal: 5
    actions:
      - enchantment: SHARPNESS

Additional action options:

enchantment - Required enchantment type
material - Specific item material
minimum-level - Minimum enchantment level
minimum-cost - Minimum XP cost

BREW

Track when players brew potions.

quests:
  - type: BREW
    name: "potion-brewer"
    display-name: "Potion Brewer"
    description: "Brew 10 speed potions"
    thumbnail: POTION
    goal: 10
    actions:
      - potion-type: SWIFTNESS

Action options:

potion-type - Bukkit PotionType
potion-material - POTION or SPLASH_POTION
ingredient - Required ingredient material

Item Quests

ITEM_BREAK

Track when players break items (use them until durability runs out).

quests:
  - type: ITEM_BREAK
    name: "tool-destroyer"
    display-name: "Tool Destroyer"
    description: "Break 3 pickaxes"
    thumbnail: WOODEN_PICKAXE
    goal: 3
    actions:
      - material: WOODEN_PICKAXE
      - material: STONE_PICKAXE
      - material: IRON_PICKAXE

ITEM_MENDING

Track durability recovered through Mending or anvils.

quests:
  - type: ITEM_MENDING
    name: "repair-master"
    display-name: "Repair Master"
    description: "Recover 1000 durability"
    thumbnail: ANVIL
    goal: 1000
    actions:
      - material: DIAMOND_PICKAXE

ITEM_CONSUME

Track when players eat or consume items.

quests:
  - type: ITEM_CONSUME
    name: "food-lover"
    display-name: "Food Lover"
    description: "Eat 20 golden apples"
    thumbnail: GOLDEN_APPLE
    goal: 20
    actions:
      - material: GOLDEN_APPLE
      - material: ENCHANTED_GOLDEN_APPLE

Exploration Quests

CUBOID

Track when players enter a specific area.

quests:
  - type: CUBOID
    name: "explore-spawn"
    display-name: "Visit Spawn"
    description: "Find the spawn area"
    thumbnail: COMPASS
    goal: 1
    actions:
      - cuboid: "world,100,50,100,200,100,200"

Cuboid format: world,x1,y1,z1,x2,y2,z2

LOOK_AT_BLOCK

Track when players look at a block in a specific area.

quests:
  - type: LOOK_AT_BLOCK
    name: "observe-monument"
    display-name: "Observe the Monument"
    description: "Look at the ancient monument"
    thumbnail: SPYGLASS
    goal: 1
    actions:
      - cuboid: "world,100,60,100,110,70,110"

Configure detection distance in config.yml with look-at-distance-block.

LOOK_AT_ENTITY

Track when players look at an entity in a specific area.

quests:
  - type: LOOK_AT_ENTITY
    name: "find-villager"
    display-name: "Find the Elder"
    description: "Look at the village elder"
    thumbnail: EMERALD
    goal: 1
    actions:
      - cuboid: "world,100,60,100,110,70,110"

Configure detection distance in config.yml with look-at-distance-entity.

Economy Quests

SELL

Track items sold through a shop. Works with zShop.

quests:
  - type: SELL
    name: "merchant"
    display-name: "Merchant"
    description: "Sell 64 iron ingots"
    thumbnail: IRON_INGOT
    goal: 64
    actions:
      - material: IRON_INGOT

PURCHASE

Track items bought through a shop. Works with zShop.

quests:
  - type: PURCHASE
    name: "buyer"
    display-name: "Buyer"
    description: "Buy 32 diamonds"
    thumbnail: DIAMOND
    goal: 32
    actions:
      - material: DIAMOND

Progression Quests

EXPERIENCE_GAIN

Track experience points gained.

quests:
  - type: EXPERIENCE_GAIN
    name: "xp-collector"
    display-name: "XP Collector"
    description: "Gain 1000 experience points"
    thumbnail: EXPERIENCE_BOTTLE
    goal: 1000

JOB_LEVEL

Track job levels. Works with zJobs.

quests:
  - type: JOB_LEVEL
    name: "miner-level"
    display-name: "Expert Miner"
    description: "Reach level 50 in the Miner job"
    thumbnail: IRON_PICKAXE
    goal: 50
    actions:
      - job: miner

JOB_PRESTIGE

Track job prestige levels. Works with zJobs.

quests:
  - type: JOB_PRESTIGE
    name: "miner-prestige"
    display-name: "Prestige Miner"
    description: "Reach prestige 1 in the Miner job"
    thumbnail: DIAMOND_PICKAXE
    goal: 1
    actions:
      - job: miner

Special Quests

VOTE

Track player votes. Requires manual progress via command.

quests:
  - type: VOTE
    name: "voter"
    display-name: "Voter"
    description: "Vote 10 times"
    thumbnail: PAPER
    goal: 10
    actions: []

Use /zquests add-progress <player> voter 1 to track votes.

COMMAND

Track when players execute specific commands.

quests:
  - type: COMMAND
    name: "home-user"
    display-name: "Home User"
    description: "Use the home command"
    thumbnail: RED_BED
    goal: 1
    actions:
      - commands:
          - "home"
          - "homes"
          - "sethome"

INVENTORY_OPEN

Track when players open specific zMenu inventories.

quests:
  - type: INVENTORY_OPEN
    name: "shop-visitor"
    display-name: "Shop Visitor"
    description: "Open the shop menu"
    thumbnail: EMERALD
    goal: 1
    actions:
      - inventories:
          - "shop"
          - "shop_categories"

INVENTORY_CONTENT

Track item delivery to NPCs. Requires API or command to trigger.

quests:
  - type: INVENTORY_CONTENT
    name: "wood-delivery"
    display-name: "Wood Delivery"
    description: "Deliver 500 oak logs to the Lumberjack"
    thumbnail: OAK_LOG
    goal: 500
    actions:
      - tag: OAK_LOGS
        citizen-name: lumberjack

Use /zquests progress-inventory <player> lumberjack to check and consume items.

CUSTOM

Custom quest type for API integration.

quests:
  - type: CUSTOM
    name: "talk-to-npc"
    display-name: "Meet the Guide"
    description: "Talk to the village guide"
    thumbnail: VILLAGER_SPAWN_EGG
    goal: 1
    actions:
      - data: "citizen:guide"

API usage:

QuestsPlugin plugin = (QuestsPlugin) Bukkit.getPluginManager().getPlugin("zQuests");
plugin.getQuestManager().handleQuests(player.getUniqueId(), QuestType.CUSTOM, 1, "citizen:guide");

ISLAND

Track island creation. Works with SuperiorSkyBlock2.

quests:
  - type: ISLAND
    name: "island-owner"
    display-name: "Island Owner"
    description: "Create your island"
    thumbnail: GRASS_BLOCK
    goal: 1

HATCHING

Track egg usage (throwing eggs).

quests:
  - type: HATCHING
    name: "egg-thrower"
    display-name: "Egg Thrower"
    description: "Throw 16 eggs"
    thumbnail: EGG
    goal: 16

RESURRECT

Track resurrections using Totem of Undying.

quests:
  - type: RESURRECT
    name: "survivor"
    display-name: "Survivor"
    description: "Use a Totem of Undying 3 times"
    thumbnail: TOTEM_OF_UNDYING
    goal: 3

PLAYER_KILL

Track when players kill other players.

quests:
  - type: PLAYER_KILL
    name: "pvp-warrior"
    display-name: "PvP Warrior"
    description: "Kill 10 players"
    thumbnail: DIAMOND_SWORD
    goal: 10

No actions required — all player kills are counted.

ADVANCEMENT

Track when players unlock specific Minecraft advancements.

quests:
  - type: ADVANCEMENT
    name: "adventurer"
    display-name: "Adventurer"
    description: "Get the 'Stone Age' advancement"
    thumbnail: CRAFTING_TABLE
    goal: 1
    actions:
      - advancements:
          - "minecraft:story/mine_stone"
          - "minecraft:story/upgrade_tools"

Actions format:

advancements - List of Minecraft advancement keys (e.g., minecraft:story/mine_stone, minecraft:nether/find_fortress)

Quest Type Reference

Type	Tracks	Actions Required
`BLOCK_BREAK`	Breaking blocks	`material` or `tag`
`BLOCK_PLACE`	Placing blocks	`material` or `tag`
`ENTITY_KILL`	Killing entities	`entity`
`ENTITY_DAMAGE`	Damage dealt	None
`TAME`	Taming animals	`entity`
`SHEAR`	Shearing entities	`entity`
`BREED`	Breeding animals	`entity`
`MILK`	Milking animals	`entity`
`FARMING`	Harvesting crops	`material`
`FISHING`	Catching fish	`material`
`BUCKET_FILL`	Filling buckets	`material`
`CRAFT`	Crafting items	`material`
`SMELT`	Smelting items	`material`
`SMITHING`	Using smithing table	`material`
`ENCHANT`	Enchanting items	`enchantment`
`BREW`	Brewing potions	`potion-type`
`ITEM_BREAK`	Breaking items	`material`
`ITEM_MENDING`	Repairing items	`material`
`ITEM_CONSUME`	Consuming items	`material`
`CUBOID`	Entering area	`cuboid`
`LOOK_AT_BLOCK`	Looking at blocks	`cuboid`
`LOOK_AT_ENTITY`	Looking at entities	`cuboid`
`SELL`	Selling items	`material`
`PURCHASE`	Buying items	`material`
`EXPERIENCE_GAIN`	Gaining XP	None
`JOB_LEVEL`	Job levels	`job`
`JOB_PRESTIGE`	Job prestige	`job`
`VOTE`	Voting	None (manual)
`COMMAND`	Running commands	`commands`
`INVENTORY_OPEN`	Opening menus	`inventories`
`INVENTORY_CONTENT`	Item delivery	`tag`/`material`, `citizen-name`
`CUSTOM`	Custom logic	`data`
`ISLAND`	Island creation	None
`HATCHING`	Throwing eggs	None
`RESURRECT`	Using totems	None
`PLAYER_KILL`	Killing players	None
`ADVANCEMENT`	Unlocking advancements	`advancements`

Block QuestsCopy Anchor Link

BLOCK_BREAKCopy Anchor Link

BLOCK_PLACECopy Anchor Link

Entity QuestsCopy Anchor Link

ENTITY_KILLCopy Anchor Link

ENTITY_DAMAGECopy Anchor Link

TAMECopy Anchor Link

SHEARCopy Anchor Link

BREEDCopy Anchor Link

MILKCopy Anchor Link

Gathering QuestsCopy Anchor Link

FARMINGCopy Anchor Link

FISHINGCopy Anchor Link

BUCKET_FILLCopy Anchor Link

Crafting QuestsCopy Anchor Link

CRAFTCopy Anchor Link

SMELTCopy Anchor Link

SMITHINGCopy Anchor Link

Enchanting & Brewing QuestsCopy Anchor Link

ENCHANTCopy Anchor Link

BREWCopy Anchor Link

Item QuestsCopy Anchor Link

ITEM_BREAKCopy Anchor Link

ITEM_MENDINGCopy Anchor Link

ITEM_CONSUMECopy Anchor Link

Exploration QuestsCopy Anchor Link

CUBOIDCopy Anchor Link

LOOK_AT_BLOCKCopy Anchor Link

LOOK_AT_ENTITYCopy Anchor Link

Economy QuestsCopy Anchor Link

SELLCopy Anchor Link

PURCHASECopy Anchor Link

Progression QuestsCopy Anchor Link

EXPERIENCE_GAINCopy Anchor Link

JOB_LEVELCopy Anchor Link

JOB_PRESTIGECopy Anchor Link

Special QuestsCopy Anchor Link

VOTECopy Anchor Link

COMMANDCopy Anchor Link

INVENTORY_OPENCopy Anchor Link

INVENTORY_CONTENTCopy Anchor Link

CUSTOMCopy Anchor Link

ISLANDCopy Anchor Link

HATCHINGCopy Anchor Link

RESURRECTCopy Anchor Link

PLAYER_KILLCopy Anchor Link

ADVANCEMENTCopy Anchor Link

Quest Type ReferenceCopy Anchor Link

On this page

Block Quests

BLOCK_BREAK

BLOCK_PLACE

Entity Quests

ENTITY_KILL

ENTITY_DAMAGE

TAME

SHEAR

BREED

MILK

Gathering Quests

FARMING

FISHING

BUCKET_FILL

Crafting Quests

CRAFT

SMELT

SMITHING

Enchanting & Brewing Quests

ENCHANT

BREW

Item Quests

ITEM_BREAK

ITEM_MENDING

ITEM_CONSUME

Exploration Quests

CUBOID

LOOK_AT_BLOCK

LOOK_AT_ENTITY

Economy Quests

SELL

PURCHASE

Progression Quests

EXPERIENCE_GAIN

JOB_LEVEL

JOB_PRESTIGE

Special Quests

VOTE

COMMAND

INVENTORY_OPEN

INVENTORY_CONTENT

CUSTOM

ISLAND

HATCHING

RESURRECT

PLAYER_KILL

ADVANCEMENT

Quest Type Reference