Quests

Guide on setting up and using variables

Internal Quest Types (36)

block-break - Break blocks
block-place - Place blocks
chat - Say something in chat
chat-stripped - Saying something in chat but stripped of colour codes (since v3.0.6)
right-click - Right click anything
left-click - Left click anything
right-click-block - Right click a block
left-click-block - Left click a block
consume - Consume a consumable
craft - Craft items
damage-player - Deal damage to players
enchant - Enchant an item using an enchant table
enchant-anvil - Enchant an item using an anvil (since v3.10)
enchant-all - Enchant an item using an enchantment table OR anvil (since v3.10)
execute-command - Execute a command in chat
fish - Fishing
gain-experience - Gain experience
item-break - Have an item break e.g pickaxe, sword
fly - Fly
glide - Glide
sneak - Sneaking (Shifting)
walk - Walking
sprint - Sprinting
swim - Swimming
move - Whenever you move a block regardless of how
kill-mob - Kill mobs
kill-player - Kill players
login - Login
milk - Milk a cow
playtime - Time played measured in seconds. Must enable in settings.yml. (since v3.10)
throw-projectile - When a player throws any projectile (egg, snowball, etc..). (since v3.10)
regenerate - Regenerate health
ride-mob - Ride a mob
shear - Shear a sheep
smelt - Smelt an item in a furnace
tame - Tame a pet (Ocelot/Wolf)

External Quest Type (94+)

ChestShop
- chestshop_create - Placing/creating a chest shop.
- chestshop_buy - Buying items from a player's chest shop.
- chestshop_sell - Selling items to another player via a chest shop.
- chestshop_spend - Spending money at a chest shop.
- chestshop_profit - Making money from a chest shop.
- chestshop_destroy - Destroying a chest shop.
AdvancedEnchantments
- advancedenchantments_enchant - Adding a custom enchant to an item.
ASkyBlock
- askyblock_create_island - Creating an island.
- askyblock_create_warp - When a player creates a warp.
AuctionHouse by Kludge
- auctionhouse_kludge_list - Listing an item on the auction house.
- auctionhouse_kludge_list_singular - Listing an item on the auction house.
- auctionhouse_kludge_buy - Buying an item from the auction house.
- auctionhouse_kludge_buy_singular - Buying an item from the auction house.
- auctionhouse_kludge_sell - Successfully selling an item on the auction house.
- auctionhouse_kludge_sell_singular - Successfully selling an item on the auction house.
- auctionhouse_kludge_profit - Making x money from selling.
- auctionhouse_kludge_spend - Spending x money on the auction house.
AutoSell
- autosell_break - Alternative to block_break when autosell is applied (autosell breaks the normal quest).
BedWars1058
- bedwars1058_break_beds - Breaking the beds of other teams.
- bedwars1058_kill_players - Killing opponents.
- bedwars1058_play_games - Playing BedWars games.
- bedwars1058_buy_items - Buying items from the shop.
- bedwars1058_buy_upgrades - Buying team upgrades from the shop.
Benzimmer's KOTH
- koth_capture - Capture for X seconds (time in seconds is progress).
- koth_win_cap - Win the capture of a point.
BuildBattle by Tigerpanzer
- buildbattle_join - Join a game.
- buildbattle_play - Triggered for every player when a game starts.
- buildbattle_finish - Triggered for every player when a game finishes.
ChatReaction
- chatreaction_win - Winning chat reaction games (repeat/unscramble).
Citizens
- citizens_click - Clicking a citizens NPC.
- citizens_damage - Damaging a citizens NPC.
- citizens_kill - Killing a citizens NPC.
Clans
- clans_create - Creating a clan.
- clans_join - Joining a clan..
ClueScrolls
- cluescrolls_complete_clue - Complete a clue.
- cluescrolls_complete_scroll - Complete a scroll.
CrateReloaded
- cratereloaded_open - Opening a crate.
CratesPlus
- cratesplus_open - Opening a crate.
CrazyCrates
- crazycrates_open - Opening a crate.
CrazyEnvoy
- crazyenvoy_open_envoy - Opening an envoy crate/drop.
- crazyenvoy_use_flare - Using a flare to start an envoy.
DiscordMinecraft
- discordminecraft_link - Link your Discord account to Minecraft.
FactionsUUID
- ~~factionsuuid_kill_enemy~~ - Disabled due to name issues
Jobs
- jobs_join - Joining a job.
- jobs_gain_exp - Gaining experience from working.
- jobs_level_up - Leveling up.
Lands
- lands_join - Join a land.
- lands_leave - Leave a land.
- lands_create - Create a land.
- lands_disband - Disband a land.
- lands_invited - Be invited to a land.
- lands_claim_chunk - Claim a chunk for your land.
LobbyPresents
- lobbypresents_find - Find a lobby present.
MoneyHunters
- moneyhunters_level_up - Leveling up.
- moneyhunters_gain_exp - Gaining experience from working.
MythicMobs
- mythicmobs_kill_mob - Killing a MythicMobs mob.
PlaceholderAPI
- placeholderapi_match_placeholder - Value must match the variable
- placeholderapi_integer_placeholder - Placeholder will be set to progress.
PlotSquared
- plotsquared_claim - Claim a PlotSquared plot.
- plotsquared_visit - Visit a player's plot.
- plotsquared_trust_player - Trust another player.
- plotsquared_become_trusted - Become a trusted player (must be online).
- plotsquared_rate - Rate a player's plot.
- plotsquared_teleport - Teleport to a player's plot.
ProCosmetics
- procosmetics_spend - Spend X amount on cosmetics.
- procosmetics_buy_treasure - Buying treasures from ProCosmetics.
- procosmetics_open_treasure - Opening treasures from ProCosmetics.
- procosmetics_buy_cosmetic - Buying cosmetics from ProCosmetics.
ShopGui+
- shopguiplus_buy - When you purchase an item from the shop. The progress will be the amount purchased.
- shopguiplus_buy_singular - When you purchase an item from the shop. The progress will always be 1 per transaction.
- shopguiplus_spend - When you purchase an item from the shop. The progress will be however much it cost the player.
- shopguiplus_sell - When you sell an item to the shop. The progress will be the amount sold.
- shopguiplus_sell_singular - When you sell an item to the shop. The progress will always be 1 per transaction.
- shopguiplus_profit - When you sell an item to the shop. The progress will be however much the player gained.
Shopkeepers
- skopkeepers_trade - Trade an item with a shopkeeper.
- skopkeepers_open - Open a shopkeeper's GUI.
SkillAPI
- skillapi_damage - Damage someone with a skill.
- skillapi_combo - Get an x hit combo (combo length is progress).
- skillapi_upgrade - Upgrade a skill.
- skillapi_unlock - Unlock a skill.
- skillapi_loose_mana - When you loose mana for any reason.
- skillapi_reach_level - When you reach x level (level is the progress).
- skillapi_change_class - When you change your class.
Subside KoTH (King of The Hill)
- koth_win_cap - Win a KoTH and be the capping player.
- koth_capture - Capture a KoTH for X seconds (increments on time).
StrikePractice
- strikepractice_host_events - Hosting an event for others to play.
- strikepractice_play_games - Playing matches.
- strikepractice_play_bot_games - Playing matches against the bot.
- strikepractice_win_games - Winning matches.
- strikepractice_win_bot_games - Winning matches against the bot.
- strikepractice_lose_games - Losing matches.
SuperiorSkyblock2
- superiorskyblock2_create - Creating an island.
- superiorskyblock2_join - Joining a player's island.
- superiorskyblock2_upgrade - Purchasing an island upgrade.
TokenEnchant
- tokenenchant_gain - Gain tokens.
- tokenenchant_enchant - Enchant an item.
uSkyBlock
- uskyblock_invite - Inviting someone to your island.
- uskyblock_invited - Being invited to an island.
- uskyblock_join - Joining an island.
- uskyblock_island_chat - Talking in the island chat.
Votifier
- votifier_vote - Just... vote lol

`block-place`

Triggered: When a player places a block.

Variable: The block's material.

`chat`

Triggered: When a player sends a message in chat.

Variable: The message sent (lower case)

`chat-stripped`

Triggered: When a player sends a message in chat - stripped from colour codes.

Variable: The message sent (lower case)

`right-click`

Triggered: Whenever a player right clicks.

Variable: none.

`left-click`

Triggered: Whenever a player left clicks.

Variable: none.

`right-click-block`

Triggered: Whenever a player right clicks a block.

Variable: The block's material.

`left-click-block`

Triggered: Whenever a player left clicks a block.

Variable: The block's material.

`consume`

Triggered: Whenever a player consumes (eats) something.

Variable: The item's material.

`craft`

Triggered: Whenever a player crafts an item.

Variable: The crafted item's material.

`damage-player`

Triggered: When a player deals damage to another player.

Variable: none.

`enchant`

Triggered: When a player enchants an item using an enchantment table.

Variables:

root: The name of the enchantment (see here)
item: The material of the enchanted item (e.g diamond_sword)
level: The level of the enchantment
cost: The level cost of enchanting

`enchant-anvil`

Triggered: When a player enchants an item using an anvil.

Variables:

root: The name of the enchantment (see here)
item: The material of the enchanted item, upper case (e.g DIAMOND_SWORD)
level: The level of the enchantment

`enchant-all`

Triggered: When a player enchants an item using an enchantment table OR an anvil.

Variables:

root: The name of the enchantment (see here)
level: The level of the enchantment

`execute-command`

Triggered: When a player issues a server command (cannot be bungee).

Variable:: The command executed (must be lower case).

`fish`

Triggered: When a player catches an item from fishing.

Variable: The item caught from fishing.

`gain-experience`

Triggered: When a player gains exp.

Variable: none.

`item-break`

Triggered: When the item a player is using breaks.

Variable: The item's material.

`fly`

Triggered: When a player flies.
Extra Info: Progression is measured in blocks flown.

Variable: none.

`glide`

Triggered: When a player glides.
Extra Info: Progression is measured in blocks glided.

Variable: none.

`sneak`

Triggered: When a player moves a block sneaking.
Extra Info: Progression is measured in blocks snuck.

Variable: none.

`walk`

Triggered: When a player walks a block.
Extra Info: Progression is measured in blocks walked.

Variable: none.

`sprint`

Triggered: When a player sprints a block.
Extra Info: Progression is measured in blocks walked.

Variable: none.

`swim`

Triggered: When a player swims a block.
Extra Info: Progression is measured in blocks walked.

Variable: none.

`move`

Triggered: When a player moves (basically just counting every other movement quest in one).
Extra Info: Progression is measured in blocks walked.

Variable: none.

`kill-mob`

Triggered: When a player kills a mob.

Variable: The type of mob.

`kill-player`

Triggered: When a player kills another player.

Variable: The name of the killed player.

`login`

Triggered: When a player logs into the server.

Variable: none.

`milk`

Triggered: When a player milks a cow.

Variable: none.

`playtime`

Triggered: Progressed 1 for every second a user is online (done in 5 second chunks, you must enable this in the settings.yml)

Variable: none.

`throw-projectile`

Triggered: When a player throws/shoots a projectile

Variable: The projectile thrown (see here).

`regenerate`

Triggered: When a player regenerates health.

Variable: The reason for regaining health (see here).

`ride-mob`

Triggered: When a player rides a mob.

Variable: The type of entity.

`shear`

Triggered: When a player shears a sheep.

Variable: none.

`smelt`

Triggered: When a player smelts an item in a furnace.

Variable: The material of the item received from smelting (e.g, iron_ingot).

`tame`

Triggered: When a player tames a mob.

Variable: The type of entity tamed.

External Quests

ChestShop - `chestshop_create`

Triggered: When a player creates a chest shop.

Variable: none.

ChestShop - `chestshop_buy`

Triggered: When a player makes a purchase from a chest shop.

Variable: The owner of the chest shop's name.

ChestShop - `chestshop_sell`

Triggered: When a player sells something from their chest shop.

Variable: The name of the client.

ChestShop - `chestshop_spend`

Triggered: When a player makes a purchase from a chest shop - the cost is the progress.

Variable: The owner of the chest shop's name.

ChestShop - `chestshop_profit`

Triggered: When a player sells something from their chest shop - the cost is the progress.

Variable: The name of the client.

AdvancedEnchantments - `advancedenchantments_enchant`

Triggered: When a player enchants any item..

Variable: The level of the enchant (yes I know you want the enchant, but that's not made available in the public API so I physically can't).

ASkyBlock - `askyblock_create_island`

Triggered: When you create a skyblock island.

Variable: The name of the schematic of the island.

ASkyBlock - `askyblock_create_warp`

Triggered: When you create an island warp.

Variable: none.

AuctionHouse by Kludgemonkey - `auctionhouse_list`

Triggered: When a player lists an item on the auction house (progressed by the amount of said item).

Variable: The material of the item being listed.

AuctionHouse by Kludgemonkey - `auctionhouse_list_singular`

Triggered: When a player lists an item on the auction house (only progressed by 1)

Variable: The material of the item being listed.

AuctionHouse by Kludgemonkey - `auctionhouse_buy`

Triggered: When a player buys an item on the auction house (progressed by the amount of said item bought).

Variable: The material of the purchased item.

AuctionHouse by Kludgemonkey - `auctionhouse_buy_singular`

Triggered: When a player buys an item on the auction house (only progressed by 1)

Variable: The material of the purchased item.

AuctionHouse by Kludgemonkey - `auctionhouse_sell`

Triggered: When a player successfully sells an item on the auction house (progressed by the amount of said item sold).

Variable: The material of the sold item.

AuctionHouse by Kludgemonkey - `auctionhouse_sell_singular`

Triggered: When a player successfully sells an item on the auction house (only progressed by 1).

Variable: The material of the sold item.

AuctionHouse by Kludgemonkey - `auctionhouse_profit`

Triggered: When a listed item is sold - the amount of money you make from it is the progress.

Variable: The material of the sold item.

AuctionHouse by Kludgemonkey - `auctionhouse_spend`

Triggered: When you purchase an item from the auction house - the amount of money spent is the progress.

Variable: The material of the item purchased.

AutoSell - `autosell_break`

Triggered: When you break a block whilst autosell is enabled.

Variable: The material of the block broken.

BedWars1058 - `bedwars1058_break_beds`

Triggered: When a player breaks a team's bed.

Variable: The team of the broken bed.

BedWars1058 - `bedwars1058_kill_players`

Triggered: When a player kills an enemy player.

Variable: The cause of death (UNKNOWN, EXPLOSION, VOID, PVP, PLAYER_SHOOT)

BedWars1058 - `bedwars1058_buy_items`

Triggered: When a player purchases an item.

Variable: none.

BedWars1058 - `bedwars1058_buy_upgrades`

Triggered: When a player buys a team upgrade.

Variable: none.

Benzimmer's KOTH - `koth_capture`

Triggered: When a player captures a point for x time (the amount of time captured in seconds is the progress).

Variable: The name of the KOTH.

Benzimmer's KOTH - `koth_win_cap`

Triggered: When a player wins the capture for a KOTH.

Variable: The name of the KOTH

BuildBattle by Tiger - `buildbattle_join`

Triggered: When a player joins a BuildBattle game.

Variable: The name of the map.

BuildBattle by Tiger - `buildbattle_play`

Triggered: When a player is in a game and it starts.

Variable: The name of the map.

BuildBattle by Tiger - `buildbattle_finish`

Triggered: When a player is in a game when it finishes.

Variable: The name of the map.

ChatReaction - `chatreaction_win`

Triggered: When a player wins a ChatReaction competition.

Variable: none.

Citizens - `citizens_click`

Triggered: When a player click a citizens NPC.

Variable: The name of the NPC.

Citizens - `citizens_damage`

Triggered: When a player damages a citizens NPC (normally requires Sentinel).

Variable: The name of the NPC.

Citizens - `citizens_kill`

Triggered: When a player kills a citizens NPC (normally requires Sentinel).

Variable: The name of the NPC.

Clans - `clans_create`

Triggered: When a player creates a clan.

Variable: none.

Clans - `clans_join`

Triggered: When a player joins a clan.

Variable: none.

ClueScrolls - `cluescrolls_complete_clue`

Triggered: When a player completes a clue.

Variable: The type of clue.

ClueScrolls - `cluescrolls_complete_scroll`

Triggered: When a player completes a scroll.

Variable: The tier type.

CrateReloaded - `cratereloaded_open`

Triggered: When a player opens a CrateReloaded crate.

Variable: The name of the crate opened.

CratesPlus - `cratesplus_open`

Triggered: When a player opens a CratesPlus crate.

Variable: The name of the crate opened.

CrazyCrates - `crazycrates_open`

Triggered: When a player opens a CrazyCrates crate.

Variable: The name of the crate opened.

CrazyEnvoy - `crazyenvoy_open_envoy`

Triggered: When a player opens an envoy crate.

Variable: The name of the tier of crate.

CrazyEnvoy - `crazyenvoy_use_flare`

Triggered: When a player uses an envoy flare to start an envoy.

Variable: none.

DiscordMinecraft - `discordminecraft_link` (probably broken)

Triggered: When a links their discord account.

Variable: none.

FactionsUUID - `factions_kill_enemy`

Triggered: When a player kills another person from an enemy faction.

Variable: none.

Jobs - `jobs_join`

Triggered: When a player joins a job.

Variable: The name of the job.

Jobs - `jobs_gain_exp`

Triggered: When a player gains experience (progress is the exp gained).

Variable: The name of the player's job.

Jobs - `jobs_level_up`

Triggered: When a player levels up (progress is set to this level).

Variable: The name of the player's job.

Lands - `lands_join`

Triggered: When a player joins a land.

Variable: none.

Lands - `lands_leave`

Triggered: When a player leaves a land.

Variable: none.

Lands - `lands_create`

Triggered: When a player creates a land.

Variable: none.

Lands - `lands_disband`

Triggered: When a player disbands their land.

Variable: none.

Lands - `lands_invited`

Triggered: When a player is invited to a land.

Variable: none.

Lands - `lands_claim_chunk`

Triggered: When a player claims a chunk for their land.

Variable: none.

LobbyPresents by Poompk - `lobbypresents_find`

Triggered: When a player finds a present.

Variable: The ID of the present.

MoneyHunters - `moneyhunters_level_up`

Triggered: When a player levels up (the progress is set to their level).

Variable: The name of their job.

MoneyHunters - `moneyhunters_gain_exp`

Triggered: When a player tames a mob (the progress is increased by the given xp).

Variable: The name of their job.

MythicMobs - `mythicmobs_kill_mob`

Triggered: When a player kills a MythicMobs mob.

Variable: The name of the type of mob.

PlaceholderAPI - `placeholderapi_match_<PLACEHOLDER>`

Description: When the placeholder is resolved for the player, it will progress if the variable is the same as what the placeholder resolves to. E.g if the type was as placeholderapi_match_essentials_flying and the variable was true, if the player was flying the quest would progress.

PlaceholderAPI - `placeholderapi_integer_<PLACEHOLDER>`

Description: Resolves the placeholder for the player and sets the progress of the quest to the value of the placeholder (the resolved value must be an integer, e.g 342653476). An example would be the type as placeholderapi_integer_gemseconomy_balance_default with the variable none and the required progress 10000. When they get 10000 gems it will be completed.

Variable: none.

PlotSquared - `plotsquared_claim`

Triggered: When a player claims their plot.

Variable: none.

PlotSquared - `plotsquared_visit`

Triggered: When a player visits another player's plot.

Variable: The owner of the plot's username or none if not found.

PlotSquared - `plotsquared_trust_player`

Triggered: When a player trusts another player.

Variable: none.

PlotSquared - `plotsquared_become_trusted`

Triggered: When a player becomes trusted on another player's plot.

Variable: none.

PlotSquared - `plotsquared_rate`

Triggered: When a player rates another player's plot.

Variable: none.

PlotSquared - `plotsquared_teleport`

Triggered: When a player teleports to a plot.

Variable: The owner of the plot's username or none if not found.

ProCosmetics - `procosmetics_spend`

Triggered: When a player spends coins on a cosmetic or treasure chest (the progress is the amount spent).

Variable: treasure-chest or cosmetic depending on what was bought.

ProCosmetics - `procosmetics_buy_treasure`

Triggered: When a player buys a treasure.

Variable: The name of the treasure.

ProCosmetics - `procosmetics_open_treasure`

Triggered: When a player opens a treasure.

Variable: The name of the treasure.

ProCosmetics - `procosmetics_buy_cosmetic`

Triggered: When a player buys a cosmetic.

Variable: The type of cosmetic.

ShopGuiPlus - `shopguiplus_buy`

Triggered: When a player purchases an item from the shop. The progress will be the amount of items purchased

Variables:

root: The item that was purchased (e.g iron_sword:0)
shop: The ID of the shop the item was purchased from (e.g foodstuffs)
item-id: The ID of the item in the shop (e.g 2, 6, or 8)

ShopGuiPlus - `shopguiplus_buy_singular`

Triggered: When a player purchases an item from the shop. The progress will always be 1

Variables:

root: The item that was purchased (e.g iron_sword:0)
shop: The ID of the shop the item was purchased from (e.g foodstuffs)
item-id: The ID of the item in the shop (e.g 2, 6, or 8)

ShopGuiPlus - `shopguiplus_spend`

Triggered: When a player purchases an item from the shop. The progress will be the amount it cost the user rounded up to the nearest real number (2.4 -> 3)

Variables:

root: The item that was purchased (e.g iron_sword:0)
shop: The ID of the shop the item was purchased from (e.g foodstuffs)
item-id: The ID of the item in the shop (e.g 2, 6, or 8)

ShopGuiPlus - `shopguiplus_sell`

Triggered: When a player sells an item to the shop. The progress will be the amount of items sold.

Variables:

root: The item that was purchased (e.g iron_sword:0)
shop: The ID of the shop the item was purchased from (e.g foodstuffs)
item-id: The ID of the item in the shop (e.g 2, 6, or 8)

ShopGuiPlus - `shopguiplus_sell_singular`

Triggered: When a player sells an item to the shop. The progress will always be 1.

Variables:

root: The item that was purchased (e.g iron_sword:0)
shop: The ID of the shop the item was purchased from (e.g foodstuffs)
item-id: The ID of the item in the shop (e.g 2, 6, or 8)

ShopGuiPlus - `shopguiplus_profit`

Triggered: When a player sells an item to the shop. The progress will be the amount it cost the user rounded up to the nearest real number (2.4 -> 3)

Variables:

root: The item that was purchased (e.g iron_sword:0)
shop: The ID of the shop the item was purchased from (e.g foodstuffs)
item-id: The ID of the item in the shop (e.g 2, 6, or 8)

Shopkeepers - `shopkeepers_trade`

Triggered: When a player trades with a shopkeeper.

Variable: The UUID of the shopkeeper.