Requirements
There is a large list of requirements you can use. Use the sidebar on the left to navigate quickly between requirements.
All requirements can also be used as prerequisites!
Check how much time a player has spent online on the server (without being AFK).
Requirement name: time
Example usage | Explanation |
1d 2h | Play at least 1 day and 2 hours |
1m | Play at least 1 minute |
1h 2m | Play at least 1 hour and 2 minutes |
1d 2h 3m | Play at least 1 day, 2 hours and 3 minutes |
Check the experience level of a player
Requirement name: exp
Example usage | Explanation |
20 | Need at least level 20 of exp. |
Check how much money a player has
Requirement name: money
This requirement requires Vault to be installed (and an economy plugin)
Example usage | Explanation |
150 | Need at least 150 money (in your currency) |
Check whether a player is in a specific worl
Requirement name: world
Example usage | Explanation |
world_nether | Should be in world_nether |
Check whether a player is in a specific gamemode (survival, creative, spectator)
Requirement name: gamemode
For a list of gamemodes, see this link. Use the numeric values (so 0, 1, 2, etc.)
Example usage | Explanation |
1 | Player needs to be in creative |
Check whether a player has a specific item or multiple of it.
Requirement name: has item
Syntax of the requirement: material; amount; display name; match display name
Parameter | Explanation |
Material (string) | Name of material |
Amount (integer) | Amount of the item |
Display name (string) | Name to show to the user in the requirement |
Match display name (boolean) | Whether the name of the item should match the display name |
For a list of materials, see this link.
Example usage | Explanation |
BONE;4 | Need to have at least 4 bones |
BONE;4;More bones | Need to have at least 4 bones (it will show the player 'More bones') |
BONE;4;More bones;true | Need to have at least 4 bones (that are named 'More bones') |
Check whether a player is in a s
Requirement name: location
Syntax of the requirement: x; y; z; world; radius
Parameter | Explanation |
X | X coordinate of the location |
Y | Y coordinate of the location |
Z | Z coordinate of the location |
world | World of the location |
Radius | How close the player should be to the exact location (in blocks) |
Example usage | Explanation |
10;65;10;world_nether;5 | Needs to be within 5 blocks of location 10 (x), 65 (y), 10 (z) on world_nether |
Check how much time a player has spent across multiple servers (without being AFK).
Requirement name: global time
Example usage | Explanation |
1d 2h | Play at least 1 day and 2 hours |
1m | Play at least 1 minute |
1h 2m | Play at least 1 hour and 2 minutes |
1d 2h 3m | Play at least 1 day, 2 hours and 3 minutes |
Check how much time has passed since the player has first joined the server. Note that a player does not need to be online for this time to increment.
Requirement name: total time
Example usage | Explanation |
1d 2h | Must have joined the server 1d and 2h ago. |
1m | Must have joined the server 1 minute ago. |
Check whether a player is in a specific permission group
Requirement name: in group
Example usage | Explanation |
Citizen | Player must be in the permission group 'Citizen' |
Check whether a player has a specific permission
Requirement name: permission
Example usage | Explanation |
some.permission | Player needs the some.permission permission |
Check whether a player is in a specific biome
Requirement name: in biome
Here's a list of biomes you can use.
Check whether a player has a specific path as active or has a number of active paths
Requirement name: active paths
Example usage | Explanation |
10 | Needs to have at least 10 active paths |
Cool Path | Needs to have 'Cool Path' as an active path |
Check whether a player has completed a specific path or has completed a number of paths
Requirement name: completed paths
Example usage | Explanation |
10 | Needs to have at least 10 completed paths |
Cool Path | Needs to have completed path 'Cool Path' |
Most requirements use the statistics provided by Minecraft, but some may require Statz to be installed. It can be found here: https://www.spigotmc.org/resources/statz.25969/
Check whether a player has moved a certain number of blocks
Requirement name: blocks moved
Example usage | Explanation |
1000 | Needs to travel at least 1000 blocks |
Check how many players a player has killed
Requirement name: players killed
Example usage | Explanation |
200 | Needs to kill at least 200 players |
Check how many mobs (of a specific type) a player has killed.
Requirement name: mobs killed
For a list of mobs, see this link.
Example usage | Explanation |
1000 | Needs to kill a 1000 mobs (of any type) |
10;SPIDER | Needs to kill 10 spiders |
Check whether a player has placed a specific type of block (or how many blocks in total he's placed)
Requirement name: blocks placed
Syntax of the requirement: material; amount; display name
Parameter | Explanation |
Material (string) | Name of material |
Amount (integer) | Amount of the item |
Display name (string) | Name to show to the user in the requirement |
For a list of materials, see this link.
Example usage | Explanation |
4 | Place at least 4 blocks |
GLASS;4 | Need to place at least 4 glass |
GLASS;4;shiny things | Need to place at least 4 glass (it will show the player 'shiny things') |
Check whether a player has broken a specific type of block (or how many blocks in total he's broken)
Requirement name: blocks broken
Syntax of the requirement: material; amount; display name
Parameter | Explanation |
Material (string) | Name of material |
Amount (integer) | Amount of the item |
Display name (string) | Name to show to the user in the requirement |
For a list of materials, see this link.
Example usage | Explanation |
4 | Break at least 4 blocks |
GLASS;4 | Need to break at least 4 glass |
GLASS;4;shiny things | Need to break at least 4 glass (it will show the player 'shiny things') |
Check how many times a player has voted
Requirement name: votes
Statz and a compatible voting plugin is required.
Example usage | Explanation |
200 | Needs to vote at least 200 times |
Check how much damage a player has taken
Requirement name: damage taken
Example usage | Explanation |
500 | Needs to take at least 500 damage |
Check how much fish a player has caught
Requirement name: fish caught
Example usage | Explanation |
10 | Needs to catch at least 10 fish |
Check how much items a player has crafted or how much of a specific item a player has crafted
Requirement name: items crafted
A list of material names that you can use is provided here.
Example usage | Explanation |
10 | Needs to craft at least 10 items |
ANVIL;2 | Needs to craft 2 anvils |
Check how many sheep a player has shorn
Requirement name: times sheared
Example usage | Explanation |
50 | Needs to shear at least 50 sheep |
Check how much food a player has consumed or a specific type of food
Requirement name: food eaten
For a list of materials (and consumables), click here.
Example usage | Explanation |
20 | Needs to consume 20 food items |
20;BAKED_POTATO | Needs to consume 20 baked potatoes |
Check how many advancement a player has obtained or whether a player has obtained a specific advancement.
Requirement name: has advancement
Advancement strings can be found here. Look at the namespaced ids.
Example usage | Explanation |
10 | Needs to obtain 10 advancements |
minecraft:story/shiny_gear;Shiny gear | Needs to obtain the advancement ('shiny gear' is shown to the player) |
Check how many animals a player has bred.
Requirement name: animals bred
Example usage | Explanation |
10 | Needs to breed 10 animals |
Check how many slices of cake a player has eaten.
Requirement name: cake slices eaten
Example usage | Explanation |
10 | Needs to eat 10 slices of cake |
Check how many items a player has enchanted
Requirement name: items enchanted
Example usage | Explanation |
10 | Needs to enchant 10 items |
Check how many plants a player has potted
Requirement name: plants potted
Example usage | Explanation |
10 | Needs to pot 10 plants |
Check how many times a player has died.
Requirement name: times died
Example usage | Explanation |
10 | Needs to die 10 times |
Check how many times a player has traded with a villager
Requirement name: traded with villagers
Example usage | Explanation |
10 | Needs to trade 10 times with villagers |
Check how many times a player has thrown a specific item.
Requirement name: item thrown
Example usage | Explanation |
EGG;100 | Needs to throw 100 eggs |
To use these requirements, you need a Factions plugin, like this one.
Check how much power a faction of a player has (if he has any). If a player does not have a faction, this will return zero.
Requirement name: faction power
Example usage | Explanation |
10 | Needs to have 10 faction power |
To use these requirements, you need the WorldGuard plugin, like this one.
Check whether a player is in a specific worldguard region
Requirement name: worldguard region
Example usage | Explanation |
TestRegion | Needs to be in TestRegion |
To use these requirements, you'll need mcMMO.
Check the level of a particular skill of a player
Requirement name: mcmmo skill level
For a list of skills, see this page.
Example usage | Explanation |
100;mining | Needs to have level 100 in Mining |
Check the power level of a player (= sum of skill levels)
Requirement name: mcmmo power level
Example usage | Explanation |
450 | Needs to have a power level of 450 |
To use these requirements, you'll need this plugin.
Check the island level of a player (using AcidIsland).
Requirement name: acidisland level
Example usage | Explanation |
20 | Needs to have an island level of 20 |
Check the island level of a player (using aSkyBlock).
Requirement name: askyblock level
Example usage | Explanation |
20 | Needs to have an island level of 20 |
You'll need either Essentials or EssentialsX for these requirements.
Check the real life location of a player
Requirement name: essentials geoip location
Example usage | Explanation |
Netherlands | Player should be playing from the Netherlands |
Jobs is required!
Check the points that a player currently has
Requirement name: jobs current points
Example usage | Explanation |
120 | Needs to have 120 points |
Check the total points that a player has accumulated over time.
Requirement name: jobs total points
Example usage | Explanation |
120 | Needs to have a total of 120 points |
Check the level of a specific job of a player
Requirement name: jobs level
Example usage | Explanation |
100;mining | Needs to have level 100 in the mining job. |
Check the experience a player has for a specific job
Requirement name: jobs experience
Example usage | Explanation |
120;mining | Needs to have 120 exp in the mining job |
You'll need GriefPrevention to use these requirements.
Check how many claims a player has
Requirement name: grief prevention claims
Example usage | Explanation |
24 | Needs to have 24 claims |
Check how many claimed blocks a player has
Requirement name: grief prevention claimed blocks
Example usage | Explanation |
100 | Needs to have 100 claimed blocks |
Check how many blocks a player can still claim
Requirement name: grief prevention remaining blocks
Example usage | Explanation |
55 | Needs to have 55 remaining blocks |
Check how many bonus claim blocks a player has
Requirement name: grief prevention bonus blocks
Example usage | Explanation |
10 | Needs to have 10 bonus claim blocks |
To use these requirements, you'll need this plugin.
Check the level of a particular skill
Requirement name: rpgme skill level
Example usage | Explanation |
20;mining | Needs to have level 20 in mining |
Check the combat level of a player
Requirement name: rpgme combat level
Example usage | Explanation |
20 | Needs to have combat level 20 |
To use these requirements, you'll need BattleLevels.
Check the kill death ratio (kdr) of a player
Requirement name: battlelevels kdr
Example usage | Explanation |
3 | Needs to have a kdr of 3 |
Check how many kills a player has
Requirement name: battlelevels kills
Example usage | Explanation |
100 | Needs to have 100 kills |
Check what the current killstreak of a player is
Requirement name: battlelevels killstreak
Example usage | Explanation |
5 | Needs to have a killstreak of at least 5 |
Check the highest killstreak achieved by a player
Requirement name: battlelevels top killstreak
Example usage | Explanation |
10 | Needs to have a best killstreak of at least 10 |
Check the level of a player
Requirement name: battlelevels levels
Example usage | Explanation |
100 | Needs to have a level of 100 |
Check the score of a player
Requirement name: battlelevels score
Example usage | Explanation |
10 | Needs to have a score of 10 |
Plugin page: https://www.spigotmc.org/resources/quests.3711/
Name of requirement | Explanation | Format | Example | Explanation of example | Extra info |
quests quest points | Player needs to have at least X quest points in Quests | points | 100 | Needs to have at least 100 quest points | Quests required |
quests complete quest | Player needs to complete a quest in Quests | questname | "Kill Mother Theresa" | Needs to complete the quest "Kill Mother Theresa" | Quests required |
quests active quests | Player needs to have at least X active quests in Quests | numberofquests | 5 | Needs to have at least 5 active quests | Quests required |
quests completed quests | Player needs to have at least X completed quests in Quests | quests | 100 | Needs to have at least 100 completed quests | Quests required |
To use these requirements, you'll need this Quests plugin or this one.
Check how many active quests a player has
Requirement name: quests active quests
Example usage | Explanation |
10 | Needs to have 10 active quests |
Check how many completed quests a player has
Requirement name: quests completed quests
Example usage | Explanation |
10 | Needs to have 10 completed quests |
Check whether a player has completed a specific quest
Requirement name: quests complete quest
Example usage | Explanation |
Kill Mother Teresa | Needs to complete Kill Mother Teresa |
Check how many quest points a player has.
Requirement name: quests quest points
This requirement can only be used when you use this specific Quests plugin.
Example usage | Explanation |
100 | Needs to have 100 quest points |
To use these requirements, you need SavageFactions.
Check the power of a player's faction
Requirement name: savagefactions faction power
Example usage | Explanation |
10 | Needs to have a faction with 10 power |
You need PlayerPoints for these requirements.
Check the player points of a player.
Requirement name: playerpoints points
Example usage | Explanation |
50 | Needs to have a 50 player points |
You need UHCStats for this.
Check how many kills a player has
Requirement name: uhcstats kills
Example usage | Explanation |
50 | Needs to have a 50 kills |
Check how many times a player has died
Requirement name: uhcstats deaths
Example usage | Explanation |
50 | Needs to have a 50 deaths |
Check how many wins a player has
Requirement name: uhcstats wins
Example usage | Explanation |
100 | Needs to have a 100 wins |
Towny is required for these requirements.
Check whether a player is part of a town
Requirement name: towny has town
Example usage | Explanation |
true | Player needs to have a town |
Check whether a player is part of a nation
Requirement name: towny has nation
Example usage | Explanation |
true | Player needs to have a nation |
Check whether a player is a mayor or a town
Requirement name: towny is mayor
Example usage | Explanation |
true | Player needs to be a mayor |
Check whether a player is king of a nation
Requirement name: towny is king
Example usage | Explanation |
true | Player needs to be a king |
Check how many town blocks a player has
Requirement name: towny town blocks
Example usage | Explanation |
75 | Needs to have 75 town blocks |
You will need McRPG for these requirements.
Check the level of a particular skill
Requirement name: mcrpg skill level
Example usage | Explanation |
100;mining | Needs to have level 100 in mining |
Check the power level of a player (= sum of all skill levels)
Requirement name: mcrpg power level
Example usage | Explanation |
250 | Needs to have power level 250 |
