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!

Basic requirements

Online time

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

Experience level

Check the experience level of a player

Requirement name: exp

Example usage

Explanation

20

Need at least level 20 of exp.

Money

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)

World

Check whether a player is in a specific worl

Requirement name: world

Example usage

Explanation

world_nether

Should be in world_nether

Gamemode

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

Obtained an item

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')

Location

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

Time across several servers

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

Time since joining the server

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.

Be in a permission group

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'

Have a permission

Check whether a player has a specific permission

Requirement name: permission

Example usage

Explanation

some.permission

Player needs the some.permission permission

Be in a biome

Check whether a player is in a specific biome

Requirement name: in biome

Here's a list of biomes you can use.

Have active (Autorank) paths

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

Have completed (Autorank) paths

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'

Statistic-based requirements

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/

Distance travelled

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

Players killed

Check how many players a player has killed

Requirement name: players killed

Example usage

Explanation

200

Needs to kill at least 200 players

Mobs 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.

Example usage

Explanation

1000

Needs to kill a 1000 mobs (of any type)

10;SPIDER

Needs to kill 10 spiders

Blocks placed

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')

Blocks broken

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')

Votes

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

Damage taken

Check how much damage a player has taken

Requirement name: damage taken

Example usage

Explanation

500

Needs to take at least 500 damage

Fish caught

Check how much fish a player has caught

Requirement name: fish caught

Example usage

Explanation

10

Needs to catch at least 10 fish

Items crafted

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

Sheep shorn

Check how many sheep a player has shorn

Requirement name: times sheared

Example usage

Explanation

50

Needs to shear at least 50 sheep

Food consumed

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

Advancement obtained

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)

Animals bred

Check how many animals a player has bred.

Requirement name: animals bred

Example usage

Explanation

10

Needs to breed 10 animals

Cake slices eaten

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

Number of items enchanted

Check how many items a player has enchanted

Requirement name: items enchanted

Example usage

Explanation

10

Needs to enchant 10 items

Number of potted plants

Check how many plants a player has potted

Requirement name: plants potted

Example usage

Explanation

10

Needs to pot 10 plants

Number of deaths

Check how many times a player has died.

Requirement name: times died

Example usage

Explanation

10

Needs to die 10 times

Trades with villagers

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

Items thrown

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

Factions requirements

To use these requirements, you need a Factions plugin, like this one.

Faction power

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

WorldGuard requirements

To use these requirements, you need the WorldGuard plugin, like this one.

Be in a worldguard region

Check whether a player is in a specific worldguard region

Requirement name: worldguard region

Example usage

Explanation

TestRegion

Needs to be in TestRegion

mcMMO requirements

To use these requirements, you'll need mcMMO.

Have a particular skill level

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

Have a power level

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

AcidIsland / aSkyBlock requirements

To use these requirements, you'll need this plugin.

Island level (AcidIsland)

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

Island level (aSkyBlock)

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

Essentials(X) requirements

You'll need either Essentials or EssentialsX for these requirements.

Geo location

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 requirements

Jobs is required!

Current points

Check the points that a player currently has

Requirement name: jobs current points

Example usage

Explanation

120

Needs to have 120 points

Total 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

Level of a specific job

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.

Experience of a 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

GriefPrevention requirements

You'll need GriefPrevention to use these requirements.

Number of claims

Check how many claims a player has

Requirement name: grief prevention claims

Example usage

Explanation

24

Needs to have 24 claims

Number of claimed blocks

Check how many claimed blocks a player has

Requirement name: grief prevention claimed blocks

Example usage

Explanation

100

Needs to have 100 claimed blocks

Number of remaining claim 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

Number of bonus claim 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

RPGme

To use these requirements, you'll need this plugin.

Skill level

Check the level of a particular skill

Requirement name: rpgme skill level

Example usage

Explanation

20;mining

Needs to have level 20 in mining

Combat level

Check the combat level of a player

Requirement name: rpgme combat level

Example usage

Explanation

20

Needs to have combat level 20

BattleLevels requirements

To use these requirements, you'll need BattleLevels.

Kill death ratio

Check the kill death ratio (kdr) of a player

Requirement name: battlelevels kdr

Example usage

Explanation

3

Needs to have a kdr of 3

Number of kills

Check how many kills a player has

Requirement name: battlelevels kills

Example usage

Explanation

100

Needs to have 100 kills

Killstreak

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

Best killstreak

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

Level

Check the level of a player

Requirement name: battlelevels levels

Example usage

Explanation

100

Needs to have a level of 100

Score

Check the score of a player

Requirement name: battlelevels score

Example usage

Explanation

10

Needs to have a score of 10

Quests (by PikaMug) requirements

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

Quests requirements

To use these requirements, you'll need this Quests plugin or this one.

Number of active quests

Check how many active quests a player has

Requirement name: quests active quests

Example usage

Explanation

10

Needs to have 10 active quests

Number of completed quests

Check how many completed quests a player has

Requirement name: quests completed quests

Example usage

Explanation

10

Needs to have 10 completed quests

Completed a specific 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

Number of quest points

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

SavageFactions requirements

To use these requirements, you need SavageFactions.

Faction power

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

PlayerPoints requirements

You need PlayerPoints for these requirements.

Points

Check the player points of a player.

Requirement name: playerpoints points

Example usage

Explanation

50

Needs to have a 50 player points

UHCStats requirements

You need UHCStats for this.

Number of kills

Check how many kills a player has

Requirement name: uhcstats kills

Example usage

Explanation

50

Needs to have a 50 kills

Number of deaths

Check how many times a player has died

Requirement name: uhcstats deaths

Example usage

Explanation

50

Needs to have a 50 deaths

Number of wins

Check how many wins a player has

Requirement name: uhcstats wins

Example usage

Explanation

100

Needs to have a 100 wins

Towny requirements

Towny is required for these requirements.

Has a town

Check whether a player is part of a town

Requirement name: towny has town

Example usage

Explanation

true

Player needs to have a town

Has a nation

Check whether a player is part of a nation

Requirement name: towny has nation

Example usage

Explanation

true

Player needs to have a nation

Is a mayor of a town

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

Is a king of a nation

Check whether a player is king of a nation

Requirement name: towny is king

Example usage

Explanation

true

Player needs to be a king

Number of town blocks

Check how many town blocks a player has

Requirement name: towny town blocks

Example usage

Explanation

75

Needs to have 75 town blocks

McRPG requirements

You will need McRPG for these requirements.

Level of a particular skill

Check the level of a particular skill

Requirement name: mcrpg skill level

Example usage

Explanation

100;mining

Needs to have level 100 in mining

Power level

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

Contents
Basic requirements
Online time
Experience level
Money
World
Gamemode
Obtained an item
Location
Time across several servers
Time since joining the server
Be in a permission group
Have a permission
Be in a biome
Have active (Autorank) paths
Have completed (Autorank) paths
Statistic-based requirements
Distance travelled
Players killed
Mobs killed
Blocks placed
Blocks broken
Votes
Damage taken
Fish caught
Items crafted
Sheep shorn
Food consumed
Advancement obtained
Animals bred
Cake slices eaten
Number of items enchanted
Number of potted plants
Number of deaths
Trades with villagers
Items thrown
Factions requirements
Faction power
WorldGuard requirements
Be in a worldguard region
mcMMO requirements
Have a particular skill level
Have a power level
AcidIsland / aSkyBlock requirements
Island level (AcidIsland)
Island level (aSkyBlock)
Essentials(X) requirements
Geo location
Jobs requirements
Current points
Total points
Level of a specific job
Experience of a job
GriefPrevention requirements
Number of claims
Number of claimed blocks
Number of remaining claim blocks
Number of bonus claim blocks
RPGme
Skill level
Combat level
BattleLevels requirements
Kill death ratio
Number of kills
Killstreak
Best killstreak
Level
Score
Quests requirements
Number of active quests
Number of completed quests
Completed a specific quests
Number of quest points
SavageFactions requirements
Faction power
PlayerPoints requirements
Points
UHCStats requirements
Number of kills
Number of deaths
Number of wins
Towny requirements
Has a town
Has a nation
Is a mayor of a town
Is a king of a nation
Number of town blocks
McRPG requirements
Level of a particular skill
Power level