Requirements
Last updated
Last updated
There is a large list of requirements you can use. Use the sidebar on the right 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
Check the experience level of a player
Requirement name: exp
Check how much money a player has
Requirement name: money
This requirement requires Vault to be installed (and an economy plugin)
Check whether a player is in a specific worl
Requirement name: world
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.)
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
For a list of materials, see this link.
Check whether a player is in a s
Requirement name: location
Syntax of the requirement: x; y; z; world; radius
Check how much time a player has spent across multiple servers (without being AFK).
Requirement name: global time
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
Check whether a player is in a specific permission group
Requirement name: in group
Check whether a player has a specific permission
Requirement name: 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
Check whether a player has completed a specific path or has completed a number of paths
Requirement name: completed paths
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
Check how many players a player has killed
Requirement name: players killed
Check how many mobs (of a specific type) a player has killed.
Requirement name: mobs killed
For a list of mobs, see this link.
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
For a list of materials, see this link.
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
For a list of materials, see this link.
Check how many times a player has voted
Requirement name: votes
Statz and a compatible voting plugin is required.
Check how much damage a player has taken
Requirement name: damage taken
Check how much fish a player has caught
Requirement name: fish caught
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.
Check how many sheep a player has shorn
Requirement name: times sheared
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.
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.
Check how many animals a player has bred.
Requirement name: animals bred
Check how many slices of cake a player has eaten.
Requirement name: cake slices eaten
Check how many items a player has enchanted
Requirement name: items enchanted
Check how many plants a player has potted
Requirement name: plants potted
Check how many times a player has died.
Requirement name: times died
Check how many times a player has traded with a villager
Requirement name: traded with villagers
Check how many times a player has thrown a specific item.
Requirement name: item thrown
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
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
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.
Check the power level of a player (= sum of skill levels)
Requirement name: mcmmo power level
To use these requirements, you'll need this plugin.
Check the island level of a player (using AcidIsland).
Requirement name: acidisland level
Check the island level of a player (using aSkyBlock).
Requirement name: askyblock level
You'll need either Essentials or EssentialsX for these requirements.
Check the real life location of a player
Requirement name: essentials geoip location
Jobs is required!
Check the points that a player currently has
Requirement name: jobs current points
Check the total points that a player has accumulated over time.
Requirement name: jobs total points
Check the level of a specific job of a player
Requirement name: jobs level
Check the experience a player has for a specific job
Requirement name: jobs experience
You'll need GriefPrevention to use these requirements.
Check how many claims a player has
Requirement name: grief prevention claims
Check how many claimed blocks a player has
Requirement name: grief prevention claimed blocks
Check how many blocks a player can still claim
Requirement name: grief prevention remaining blocks
Check how many bonus claim blocks a player has
Requirement name: grief prevention bonus blocks
To use these requirements, you'll need this plugin.
Check the level of a particular skill
Requirement name: rpgme skill level
Check the combat level of a player
Requirement name: rpgme combat level
To use these requirements, you'll need BattleLevels.
Check the kill death ratio (kdr) of a player
Requirement name: battlelevels kdr
Check how many kills a player has
Requirement name: battlelevels kills
Check what the current killstreak of a player is
Requirement name: battlelevels killstreak
Check the highest killstreak achieved by a player
Requirement name: battlelevels top killstreak
Check the level of a player
Requirement name: battlelevels levels
Check the score of a player
Requirement name: battlelevels score
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
Check how many completed quests a player has
Requirement name: quests completed quests
Check whether a player has completed a specific quest
Requirement name: quests complete quest
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.
To use these requirements, you need SavageFactions.
Check the power of a player's faction
Requirement name: savagefactions faction power
You need PlayerPoints for these requirements.
Check the player points of a player.
Requirement name: playerpoints points
You need UHCStats for this.
Check how many kills a player has
Requirement name: uhcstats kills
Check how many times a player has died
Requirement name: uhcstats deaths
Check how many wins a player has
Requirement name: uhcstats wins
Towny is required for these requirements.
Check whether a player is part of a town
Requirement name: towny has town
Check whether a player is part of a nation
Requirement name: towny has nation
Check whether a player is a mayor or a town
Requirement name: towny is mayor
Check whether a player is king of a nation
Requirement name: towny is king
Check how many town blocks a player has
Requirement name: towny town blocks
You will need McRPG for these requirements.
Check the level of a particular skill
Requirement name: mcrpg skill level
Check the power level of a player (= sum of all skill levels)
Requirement name: mcrpg power level
You will need AureliumSkills for these requirements.
Check the level of a particular skill
Requirement name: aurelium skills skill level
Check the level of a stat of a player
Requirement name: aurelium skills stat level
Check the xp level of a skill
Requirement name: aurelium skills xp
Check the amount of mana a player has
Requirement name: aurelium skills mana
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
Example usage
Explanation
20
Need at least level 20 of exp.
Example usage
Explanation
150
Need at least 150 money (in your currency)
Example usage
Explanation
world_nether
Should be in world_nether
Example usage
Explanation
1
Player needs to be in creative
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
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')
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
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
Example usage
Explanation
1d 2h
Must have joined the server 1d and 2h ago.
1m
Must have joined the server 1 minute ago.
Example usage
Explanation
Citizen
Player must be in the permission group 'Citizen'
Example usage
Explanation
some.permission
Player needs the some.permission permission
Example usage
Explanation
10
Needs to have at least 10 active paths
Cool Path
Needs to have 'Cool Path' as an active path
Example usage
Explanation
10
Needs to have at least 10 completed paths
Cool Path
Needs to have completed path 'Cool Path'
Example usage
Explanation
1000
Needs to travel at least 1000 blocks
Example usage
Explanation
200
Needs to kill at least 200 players
Example usage
Explanation
1000
Needs to kill a 1000 mobs (of any type)
10;SPIDER
Needs to kill 10 spiders
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
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')
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
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')
Example usage
Explanation
200
Needs to vote at least 200 times
Example usage
Explanation
500
Needs to take at least 500 damage
Example usage
Explanation
10
Needs to catch at least 10 fish
Example usage
Explanation
10
Needs to craft at least 10 items
ANVIL;2
Needs to craft 2 anvils
Example usage
Explanation
50
Needs to shear at least 50 sheep
Example usage
Explanation
20
Needs to consume 20 food items
20;BAKED_POTATO
Needs to consume 20 baked potatoes
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)
Example usage
Explanation
10
Needs to breed 10 animals
Example usage
Explanation
10
Needs to eat 10 slices of cake
Example usage
Explanation
10
Needs to enchant 10 items
Example usage
Explanation
10
Needs to pot 10 plants
Example usage
Explanation
10
Needs to die 10 times
Example usage
Explanation
10
Needs to trade 10 times with villagers
Example usage
Explanation
EGG;100
Needs to throw 100 eggs
Example usage
Explanation
10
Needs to have 10 faction power
Example usage
Explanation
TestRegion
Needs to be in TestRegion
Example usage
Explanation
100;mining
Needs to have level 100 in Mining
Example usage
Explanation
450
Needs to have a power level of 450
Example usage
Explanation
20
Needs to have an island level of 20
Example usage
Explanation
20
Needs to have an island level of 20
Example usage
Explanation
Netherlands
Player should be playing from the Netherlands
Example usage
Explanation
120
Needs to have 120 points
Example usage
Explanation
120
Needs to have a total of 120 points
Example usage
Explanation
100;mining
Needs to have level 100 in the mining job.
Example usage
Explanation
120;mining
Needs to have 120 exp in the mining job
Example usage
Explanation
24
Needs to have 24 claims
Example usage
Explanation
100
Needs to have 100 claimed blocks
Example usage
Explanation
55
Needs to have 55 remaining blocks
Example usage
Explanation
10
Needs to have 10 bonus claim blocks
Example usage
Explanation
20;mining
Needs to have level 20 in mining
Example usage
Explanation
20
Needs to have combat level 20
Example usage
Explanation
3
Needs to have a kdr of 3
Example usage
Explanation
100
Needs to have 100 kills
Example usage
Explanation
5
Needs to have a killstreak of at least 5
Example usage
Explanation
10
Needs to have a best killstreak of at least 10
Example usage
Explanation
100
Needs to have a level of 100
Example usage
Explanation
10
Needs to have a score of 10
Example usage
Explanation
10
Needs to have 10 active quests
Example usage
Explanation
10
Needs to have 10 completed quests
Example usage
Explanation
Kill Mother Teresa
Needs to complete Kill Mother Teresa
Example usage
Explanation
100
Needs to have 100 quest points
Example usage
Explanation
10
Needs to have a faction with 10 power
Example usage
Explanation
50
Needs to have a 50 player points
Example usage
Explanation
50
Needs to have a 50 kills
Example usage
Explanation
50
Needs to have a 50 deaths
Example usage
Explanation
100
Needs to have a 100 wins
Example usage
Explanation
true
Player needs to have a town
Example usage
Explanation
true
Player needs to have a nation
Example usage
Explanation
true
Player needs to be a mayor
Example usage
Explanation
true
Player needs to be a king
Example usage
Explanation
75
Needs to have 75 town blocks
Example usage
Explanation
100;mining
Needs to have level 100 in mining
Example usage
Explanation
250
Needs to have power level 250
Example usage
Explanation
fishing;100
Needs to have level 100 in 'fishing'
Example usage
Explanation
strength;100
Needs to have level 100 in the stat 'strength'
Example usage
Explanation
sorcery;100
Needs to have 100 XP in 'sorcery'
Example usage
Explanation
250
Needs to have 250 mana