Requirements & Results

Autorank has got quite a lot of requirements and results that can be used. Most are pretty self-explainable, some are a lot harder though. Here's a list of all requirements and results with their proper formatting, examples and side info.

Note: you can use the arrow keys to scroll to the right!

A list of requirements sorted by functionality:

Requirements

Basic requirements

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
time	Player needs x amount of time	%d %h %m	1d 1h 1m	Needs 1 day + 1 hour + 1m of play time
exp	Player needs experience level x	%level%	20	Needs level 20
money	Player needs x money	%money%	2000	Needs 2000 money	Vault required
world	Player needs to be in world x	%world_name%	world_nether	Needs to be in world 'world_nether'
gamemode	Player needs to be in a specific gamemode	%gamemode%	1	Needs to be in creative. 0 = survival, 1 = creative, 2 = adventure mode
has item	Player needs to have at least x amount of that item	material name;amount;name;false/true	BONE;4;Extra bones	Needs to have 4 bones. Autorank will also show the name 'Extra bones'.	Material name is the name of the item, see this. amount is the amount of that item. name (optional) is the name that will be displayed in /ar check. Last parameter is optional as well. If true, the name of the item must match for the requirement to be confirmed. When false, Autorank will only check if the item of the player matches the material name and amount.
location	Player needs to be at a specific location	x;y;z;world;radius	10;65;10;world_nether;5	Needs to be within 5 blocks of x=10,y=65 and z=10 in world 'world_nether'.
global time	Player has to be online for x amount of time on your global Minecraft server network	%d %h %m	60m	Needs to be online for a total of 60 minutes
total time	Player needs to be with the server for at least x amount of time	%d %h %m	50d 10h	Must have joined (for the first time) at least 50 days + 10 hours ago
in group	Player needs to be in a group/rank x	group name	TrumpSupporters	Needs to be in rank 'TrumpSupporters'
permission	Player needs to have a specific permission	%permission%	some.random.permission	Needs to have permission 'some.random.permission'
in biome	Player needs to be in a specific biome	%name of biome%	RIVER	Needs to be in RIVER biome.	Here's list of biomes.
active paths	Player needs to have at least x active paths	%number of active paths%	10	Needs to have 10 active paths.
active paths	Player needs to have a certain path active	%name of active path%	Cool Path	Needs to have 'Cool Path' as an active path.
completed paths	Player needs to have at least x completed paths	%number of completed paths%	10	Needs to have 10 completed paths.
completed paths	Player needs to have completed a certain path	%name of completed path%	Cool Path	Needs to have completed path 'Cool Path'.

Statz requirements

Plugin page: https://www.spigotmc.org/resources/statz.25969/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
blocks moved	Player has to move for at least x blocks	amount;move type	1000;5	Needs to move for at least a 1000 blocks by horse. 0=walk, 1=boat, 2=minecart, 3=pig, 4=pig in minecart, 5=horse	Statz required
players killed	Player needs to kill at least x players.	%players killed%	100	Needs to kill 100 players (can be any)	Statz required
mobs killed	Player needs to kill at least x mobs (of x type)	amount;mob type	500;spider	Needs to kill at least 500 spiders.	If no mob type is specified, any mob will count. Here is a list of mob types. You can also use WITHER_SKELETON, CHARGED_CREEPER, SPIDER_JOCKEY, CHICKEN_JOCKEY, KILLER_RABBIT and ELDER_GUARDIAN. Statz required.
blocks broken	Player needs to break at least x block (of x type).	material name;amount;name	GLASS;100	Needs to break 100 glass	material name is the material of the block to break. amount is the amount of that block. name is the name to show in /ar check. You can also only give an amount, and Autorank will check all total blocks. Statz required
blocks placed	Player needs to place at least x block (of x type).	material name;amount;name	GLASS;100	Needs to place 100 glass blocks	Statz required
votes	Player needs to vote at least x times	%votes%	200	Needs to vote 200 times	Statz required, Votifier required
damage taken	Player needs to take at least x damage	%damage%	200	Needs to take at least 200 ticks of damage	Statz required
fish caught	Player needs to catch at least x fish	%amount%	10	Needs to catch 10 fish	Statz required
items crafted	Player needs to craft at least x items	%amount%	1000	Needs to craft 1000 items	Statz required
times sheared	Player needs to shear x sheep	%amount%	2000	Needs to shear 2000 sheep	Statz required
food eaten	Player needs to eat specific kinds of food	amount;food type	10;BAKED_POTATO	Needs to eat 10 baked potatoes	Food type can be omitted. Types of food can be found here. Statz required
has advancement	Player needs to have x advancements	amount	10	Needs to have obtained at least 10 advancements
has advancement	Player needs to have advancement x	advancement JSON string; displayname	'minecraft:story/shiny_gear;Shiny gear'	Needs to have obtained advancement 'Shiny gear'	Advancements strings can be found here.

Factions requirements

Plugin page: https://www.spigotmc.org/resources/factions.1900/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
faction power	Player's faction needs to have at least x faction power	%faction power%	10	Needs to have 10 faction power.	Factions required

WorldGuard requirements

Plugin page: https://dev.bukkit.org/projects/worldguard

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
worldguard region	Player must be in a specific WorldGuard region	%name of region%	TestRegion	Needs to be in region 'TestRegion'	WorldGuard required

mcMMO requirements

Plugin page: https://www.spigotmc.org/resources/official-mcmmo-original-author-returns.64348/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
mcmmo skill level	Player needs to have at least x level in a certain skill	level;skill	100;mining	Needs to have level 100 in mining	mcMMO required
mcmmo power level	Players needs to have power level x (power level = accumulated skill level)	%power level%	100	Needs to have power level 100	mcMMO required

AcidIsland / aSkyBlock requirements

Plugin page: https://www.spigotmc.org/resources/acidisland.581/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
acidisland level	Player needs to have at least an island level of x	level	10	Needs to have an island level of 10	AcidIsland required
askyblock level	Player needs to have at least an island level of x	level	10	Needs to have an island level of 10	Askyblock required

Essentials(X) requirements

Plugin page: https://www.spigotmc.org/resources/essentialsx.9089/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
essentials geoip location	Player needs to be in a specific (real world) location	%country%	Netherlands	Needs to be in the Netherlands	Essentials(X) GeoIP required

Jobs requirements

Plugin page: https://www.spigotmc.org/resources/jobs-reborn.4216/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
jobs current points	Player needs x points in their current job in Jobs	points	100	Needs to have 100 points	Jobs required
jobs total points	Player needs a total of x points in Jobs	points	1000	Needs to have 1000 points	Jobs required
jobs level	Player needs to have level x in a job from Jobs	level;job name	100;mining	Needs to have at least level 100 in job 'mining'.	Jobs required
jobs experience	Player needs to have x experience in a job from Jobs	xp;job name	100;mining	Needs to have at least 100 xp experience in job 'mining'.	Jobs required

GriefPrevention requirements

Plugin page: https://www.spigotmc.org/resources/griefprevention.1884/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
grief prevention claims	Player needs to have x claims in GriefPrevention	amount	24	Needs to have at least 24 claims in GriefPrevention.	GriefPrevention required
grief prevention claimed blocks	Player needs to have claimed x blocks in GriefPrevention	amount	2500	Needs to have at least 2500 claimed blocks in GriefPrevention.	GriefPrevention required
grief prevention remaining blocks	Player needs to have x blocks left to claim in GriefPrevention	amount	50	Needs to have at least 50 blocks that can still be claimed with GriefPrevention.	GriefPrevention required
grief prevention bonus blocks	Player needs to have x bonus blocks to claim in GriefPrevention	amount	60	Needs to have at least 60 bonus blocks to claim in GriefPrevention.	GriefPrevention required

RPGme requirements

Plugin page: https://www.spigotmc.org/resources/rpgme.7857/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
rpgme skill level	Player needs to have at least level x in a skill of RPGme	level;skill name	10;mining	Needs to have at least level 10 in mining	RPGme required
rpgme combat level	Player needs to have at least a combat level of x of RPGme	combat level	40	Needs to have at least combat level 40	RPGme required

BattleLevels requirements

Plugin page: https://www.spigotmc.org/resources/battlelevels.2218/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
battlelevels kdr	Player needs have a kill-death/ratio in BattleLevels of X	kdr	20	Needs to have a KDR of 20	BattleLevels required
battlelevels kills	Player needs have X number of kills in BattleLevels	kills	150	Needs to have 150 kills	BattleLevels required
battlelevels killstreak	Player needs have a BattleLevels killstreak of X	killstreak	5	Needs to have a killstreak of 5 in BattleLevels	BattleLevels required
battlelevels top killstreak	Player needs have a killstreak that was at least as high as X in BattleLevels	killstreak	10	Needs to have had a killstreak of at least 10	BattleLevels required
battlelevels level	Player needs have level X in BattleLevels	level	24	Needs to have level 24	BattleLevels required
battlelevels score	Player needs have a score X in BattleLevels	score	60	Needs to have a score of 60	BattleLevels required

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 (by LMBishop) requirements

Plugin page: https://www.spigotmc.org/resources/%E2%96%B6-quests-%E2%97%80-set-up-goals-for-players.23696/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
quests fatpigsarefat 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 fatpigsarefat 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 fatpigsarefat 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

SavageFactions requirements

Plugin page: https://www.spigotmc.org/resources/savagefactions-the-ultimate-factions-experience-abandoned.52891/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
savagefactions faction power	Player's faction needs to have at least x faction power	%faction power%	10	Needs to have 10 faction power.	SavageFactions required

PlayerPoints requirements

Plugin page: https://dev.bukkit.org/projects/playerpoints

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
playerpoints points	Player needs at least x player points	%player points%	50	Needs to have 50 player points.	PlayerPoints required

UHCStats requirements

Plugin page: https://www.spigotmc.org/resources/uhcstats-uhccore-addon.73351/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
uhcstats kills	Player needs at least x kills using UHCStats	%kills%	50	Needs to have 50 kills.	UHCStats required
uhcstats deaths	Player needs at least x deaths using UHCStats	%deaths%	80	Needs to have 80 deaths.	UHCStats required
uhcstats wins	Player needs at least x wins using UHCStats	%wins%	7	Needs to have 7 wins.	UHCStats required

Towny requirements

Plugin page: https://www.spigotmc.org/resources/towny-advanced.72694/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
towny has town	Player needs be part of a town	%true/false%	true	Needs to be part of a town	Towny required
towny has nation	Player needs be part of a nation	%true/false%	true	Needs to be part of a nation	Towny required
towny is mayor	Player needs be mayor of a town	%true/false%	true	Needs to be mayor of a town	Towny required
towny is king	Player needs be king of a nation	%true/false%	true	Needs to be king of a nation	Towny required
towny town blocks	Player needs to have at least x town blocks	%number of town blocks%	34	Needs to have at least 34 town blocks	Towny required

McRPG requirements

Plugin page: https://www.spigotmc.org/resources/mcrpg.63020/

Name of requirement	Explanation	Format	Example	Explanation of example	Extra info
mcrpg skill level	Player needs to have at least x level in a certain skill	level;skill	100;mining	Needs to have level 100 in mining	McRPG required
mcrpg power level	Players needs to have power level x (power level = accumulated skill level)	%power level%	100	Needs to have power level 100	McRPG required

Results

Name of result	Explanation	Format	Example	Explanation of example	Extra info
message	Send a message to the player	message	Good job!	Send 'Good job!' to the player	When you're using quotation marks (' or '), do type double quotation marks for a single one.
command	Perform a command (as the console)	command	kill &p	Kills the player
effect	Show a particle effect at the player's position	effect name; effect data	STEP_SOUND;8	Makes a sound of flowing water (id:8)	A list of particle effects can be found here.
tp	Teleport the player	x;y;z;world;yaw;pitch	0;0;0;world_nether	Move the player to 0;0;0 on world_nether	Yaw and pitch are optional.
firework	Launch firework at the player's location	target;power;type;R;G;B	player;2;STAR;164;23;23	Spawn 'BALL' firework with power 2 at player with reddish color	Different types here. RGB color codes here.
money	Give money to the player	amount	2050	Give player 2050 money.	Requires Vault and an economy plugin.