Quests

Overview

The Quest Plugin is a module included in Vex Essentials, designed to allow server owners to create advanced, event-based quests for Minecraft Bedrock Edition.

This system tracks player actions in real time, supports multiple quest event types, and allows full customization through objectives, amounts, reward commands, and special arguments.

It is optimized for multiplayer servers and integrates seamlessly with other Vex Essentials features.

Quest Structure

Each quest is defined by the following components:

• Event Type – Determines which player action triggers progress
  
  

• Objective (optional) – A specific target such as an entity, block, item, or dimension (e.g. minecraft:zombie)
  
  

• Amount – The number of times the action must be completed
  
  

• Reward Command – A command executed when the quest is completed
  
  

• Special Arguments (optional) – Advanced modifiers that control quest behavior
  
  

Supported Event Types

The Quest Plugin supports the following event types:

• kill – Progresses when the player kills an entity
  
  

• destroy – Progresses when the player breaks a block
  
  

• build – Progresses when the player places a block
  
  

• interact – Progresses when the player interacts with a block or entity
  
  

• consume – Progresses when the player consumes an item
  
  

• use – Progresses when the player uses an item
  
  

• emote – Progresses when the player uses an emote
  
  

• shoot – Progresses when the player shoots a projectile
  
  

• dimension – Progresses when the player enters a specific dimension
  
  

• chat – Progresses when the player sends a chat message
  
  

• effect – Progresses when the player gains a specific effect
  
  

Objectives

Objectives allow quests to target specific elements.
Examples include:

• Entities: minecraft:zombie, minecraft:creeper
  
  

• Blocks: minecraft:stone, minecraft:oak_log
  
  

• Items: minecraft:apple, minecraft:bow
  
  

• Dimensions: overworld, nether, the_end
  
  

Objectives can be combined with an amount to define precise requirements.

Rewards

When a quest is completed, the plugin executes a reward command.
This allows full integration with:

• Vex Essentials commands
  
  

• Economy systems
  
  

• Permissions
  
  

• Items, effects, or server-wide events
  
  

Commands are executed automatically and can target the completing player.

Special Arguments

The Quest Plugin supports special arguments that modify how quests behave, add conditions, or introduce advanced logic. Here we provide the complete list of them.

Arguments are written using the following format:

<argument:value>

Multiple arguments can be combined in a single quest.

General Arguments

Tool Requirement:

Requires a specific item to complete the quest.
Applies to use, build, destroy, kill, and interact quests.
(Does not apply to consume or special-use items.)

<tool:diamond_sword>

Time Limit

Sets a time limit (in seconds) to complete the quest.
The timer starts once the first objective is completed.

<time:300>

Location Restriction

Defines a cuboid area where the quest must be completed.

<location:x1,y1,z1,x2,y2,z2>

Height Requirement

Requires the player to be above or below a certain Y-level.

<height:above:100>

Combat & Interaction Arguments

Kill Method

Requires a specific damage source or kill method.

<method:entityAttack>

Supported methods include:
entityAttack, projectile, fire, lava, fall, explosion, magic, wither, void, lightning, and many more.

Target Interaction Location

Only applies to interact quests.
Requires interaction at an exact location.

<targetLocation:x,y,z>

Nearby Entity Requirement

Requires being near a specific entity within a given radius.

<nearEntity:villager:5>

Riding Requirement

Requires the player to be riding a specific entity.

<riding:horse>

No Damage Condition

The player must not have taken recent damage.

<noDamage:true>

 Arguments Related to Effects & Attributes

Enchantment Requirement

Requires the used item to have a specific enchantment and level.

<enchant:sharpness:1>

Health Requirement

Requires the player to have a minimum or maximum amount of health.

<health:above:10>

Active Effect Requirement

Requires a specific potion effect to be active.

<effect:strength:1>

Hunger Requirement

Requires the player to have a specific hunger level.

<hunger:below:5>

Experience Level Requirement

Requires a minimum experience level.

<level:10>

Objective Amount Requirement

Requires the player to have at least a certain amount of the objective.

<objective:name:1000>

Player State Conditions

<underwater:true>

<sneaking:true>

<onFire:true>

<onAir:true>

Graphics Mode Requirement

Requires a specific graphics mode.

<graphicsMode:simple>

Supported modes:
simple, fancy, deferred, raytraced

Platform Requirement

Requires a specific device type.

<platform:mobile>

Supported platforms:
console, desktop, mobile

Tag Requirement

Requires the player to have a specific tag.

<tag:vip>

 Armor & Equipment Arguments

Equipment Requirement

Requires wearing a specific armor or equipment piece.

<wear:helmet:diamond_helmet>

Supported slots:
helmet, chestplate, leggings, boots, offhand

No Armor Condition

Requires the player to not wear any armor.

<noArmor:true>

 Environment Arguments

Moon Phase Requirement

Requires a specific moon phase.

<moonPhase:fullmoon>

Dimension Requirement

Requires being in a specific dimension.

<dimension:nether>

Weather Requirement

Requires a specific weather condition.

<weather:rain>

Time of Day Requirement

Requires a specific time of day.

<timeOfDay:day>

Biome Requirement

Requires being in a specific biome.

<biome:desert>

Block Requirement

Requires standing on a specific block.

<onBlock:grass>