Autorank v2.1

Autorank Logo


Autorank v3.4

Autorank started as a Bukkit plugin, but has been copied over to Spigot as Bukkit's future is uncertain. Click here if you want to visit the Spigot page.

Autorank is an automatic ranking plugin that allows you to set rank-ups that have requirements. You can create requirements that make certain a player has at least x amount of money or x minutes played.

An example:

A player starts out as Guest. When he has played for more than 10 minutes and broke at least 10 iron ore, he will be ranked up to Member where he can do a lot of other things. Then, when he has played for a couple of days and earned 1000 money, he will be promoted to Trusted; a group that allows him to do cool stuff. This can go on for as many ranks as you like. The possibilities are endless! It's up to you!


  • keeps track of how long players are online and stores it in data.yml
  • an unlimited amount of automated ranks with configurable required play times
  • permission node that excludes a certain player from being ranked up
  • permission nodes for every command
  • configurable leaderboard for most time played
  • support for either global or world specific ranks
  • can execute commands after changing rank
  • can perform effects on a player at a certain location
  • seemless mysql integration
  • a lot of special requirements
  • mega customisable
  • can interact as a group on different servers in the same server network. (Keeps track of time on the whole server network)

Autorank can check:

  • votes
  • time played
  • experience
  • money
  • worlds
  • gamemode
  • items
  • blocks
  • inventory
  • broken specific blocks
  • placed specific blocks
  • location
  • damage taken
  • specific mobs killed
  • faction power
  • players killed
  • total time on server
  • total time on your server network
  • WorldGuard regions
  • movement (by boat, foot, horse, cart or piggy)
  • mcMMO skills
  • permissions
  • amount of items crafted
  • times sheep sheared
  • fish caught
  • More to come - just ask!

A wiki is also handy if you need help with Autorank. While you're there check for answers on frequently asked questions, check this.

Developers API:
Fear not, Autorank has a well documented API. You can find a tutorial on it here.

The tutorial can be found here.

YouTube Tutorial:

Other plugins Autorank works with:
This is a list of plugins that are recognised by Autorank:

Permissions & Commands:
Permissions and commands can be found on the wiki. Click here to go to the wiki.

Click here

Source code is included in the download and available on

Before commenting, please read this:

Dev builds:

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Click here to go download dev builds.

I do not support dev builds. I may redirect you to a dev build to help test a new feature or check if a bug you reported is fixed, but use on a production server is highly discouraged. Those builds also do not provide the security that BukkitDev offers.


This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to (These stats can only be seen by the Autorank development team, and will never be shared with anybody else).

  • A unique identifier
  • The server's version of Java
  • Whether the server is in offline or online mode
  • The plugin's version
  • The server's version
  • The OS version/name and architecture
  • The core count for the CPU
  • The number of players online
  • The Metrics version
  • Whether you use the MySQL system of Autorank

    If you wish to disable this feature, you can do so by opt-ing out, which you can do in the config file under /plugins/PluginMetrics/


This plugin has a built-in auto-updater, which connects to BukkitDev to check for updates. If you, for some reason, wish to disable this process, you can do so by disabling 'auto-updating' and 'version checking' in the advanced config.


When you need Autorank to import time from other plugins you can use these converters:


Autorank is using an advanced UUID system (for Minecraft 1.8) which is complex, but nevertheless explainable: When someone tries to perform a command that requires a player name, such as /ar check <playername>, Autorank will look up the UUID of that player via the Mojang website. I will not go into detail on how it does that, as that's too complex, but if you're interested you can look it up at Github.

Autorank is using a specific part of the Mojang website (called, which is very secure. Autorank makes sure there are no traces of lookup left behind so that any player is completely anonymous. If you feel like Autorank might have a problem, please do ask. I'm glad to fix any problems that occur during runtime.

I cannot, however, ensure that Mojang is storing the lookups anonymously. But as you probably already have a Mojang account (because you play Minecraft), I can assume you trust Mojang to store their data nice and secure so no hacker can access it. If you feel like Autorank is harming you in any way, please do not hesitate to ask us and we'll try to answer your questions as adequately as we feel is possible.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Retrinity Retrinity Mar 02, 2015 at 16:55 UTC - 0 likes

    A player keep complaining about a problem/bug. So Its most likely the Stats but I want to check both plugins . He collect his stats with /ar track # and get the amount of killed mobs. Still he claim this often resets.


    Last edited Mar 02, 2015 by Retrinity
  • Avatar of GodsDead GodsDead Feb 25, 2015 at 17:18 UTC - 0 likes

    Im using the Development version you recomended, Im getting these Errors after updating to the latest spigot 1.8, any Eta on when an updated stable release will be?

    [18:09:29] [Craft Scheduler Thread - 11/WARN]: Exception in thread "Craft Scheduler Thread - 11" 
    [18:09:29] [Craft Scheduler Thread - 11/WARN]: org.apache.commons.lang.UnhandledException: Plugin Autorank v3.4-Dev-316 generated an exception while executing task 226
    	at java.util.concurrent.ThreadPoolExecutor.runWorker(
    	at java.util.concurrent.ThreadPoolExecutor$
    Caused by: java.lang.IllegalArgumentException: PartialName cannot be null
    	at org.apache.commons.lang.Validate.notNull(
    	at org.bukkit.craftbukkit.v1_8_R1.CraftServer.matchPlayer(
    	at org.anjocaido.groupmanager.dataholder.worlds.WorldsHolder.getWorldDataByPlayerName(
    	at org.anjocaido.groupmanager.dataholder.worlds.WorldsHolder.getWorldPermissionsByPlayerName(
    	at net.milkbowl.vault.permission.plugins.Permission_GroupManager.playerHas(
    	at net.milkbowl.vault.permission.Permission.has(
    	at net.milkbowl.vault.permission.Permission.playerHas(
    	at me.armar.plugins.autorank.leaderboard.Leaderboard.getSortedPlaytimes(
    	at me.armar.plugins.autorank.leaderboard.Leaderboard.updateLeaderboard(
    	at me.armar.plugins.autorank.leaderboard.Leaderboard$
    	... 3 more
  • Avatar of Ironic8b49 Ironic8b49 Feb 24, 2015 at 20:33 UTC - 0 likes

    @Staartvin: Go

    I am using autorank to keep track of my time,just was looking for a way to give back the time players have already put in, guess if there a way to read the time in essentials or one of the plugins I have then I can manually add to players.

  • Avatar of Staartvin Staartvin Feb 24, 2015 at 16:04 UTC - 0 likes

    @frizzbee30: Go

    Autorank doesn't keep track of time per world unfortunately. You will not be able to do this, sorry..

  • Avatar of frizzbee30 frizzbee30 Feb 24, 2015 at 13:33 UTC - 0 likes

    @Staartvin: Go

    Hi, basically what we want to do is award our players in one world, ranks based on time spent in that world only.

    Currently the system would look at total server time and award the rank, regardless of world. We would still wish to see total time on the server, but discern between time spent in each world to award ranks.

    rough example below using a groupmanager type format

    creative 100hrs 'creative champion' rank

    survival 60hrs dedicated survivor rank

    Total time on server 160 hours (could even be by definition 'server champion etc)

    Currently it can only look at the Total time on the server? (in all worlds)

    a bit like 'multiworldmoney' but with hours stored for each world :)

    Hope that explains :)

  • Avatar of Staartvin Staartvin Feb 24, 2015 at 12:12 UTC - 1 like

    @frizzbee30: Go

    I'm not sure what you mean. Could you elaborate?

  • Avatar of Staartvin Staartvin Feb 22, 2015 at 15:20 UTC - 0 likes

    @Ironic8b49: Go

    None of those store playtime. Autorank stores playtime however, you can use that?

  • Avatar of frizzbee30 frizzbee30 Feb 21, 2015 at 14:48 UTC - 1 like

    probably impossible, but is there any way to add in the stored time data to measure time spent in a defined world, as well as total? ( we want to award roles on time spent in survival alone, not other worlds as well. We still need a total time, but also a time per world) :)

  • Avatar of Ironic8b49 Ironic8b49 Feb 20, 2015 at 12:16 UTC - 0 likes

    @Staartvin: Go Didn't want to hear that, I run many plugins any of these store time and allows you to check? These are the only ones I have had since beginning of server. Vault, WorldGuard, WorldEdit, mcMMO

  • Avatar of Staartvin Staartvin Feb 19, 2015 at 15:59 UTC - 0 likes

    @Ironic8b49: Go

    Essentials does not allow other plugins to check the time it stores. Autorank cannot use that time I believe.


Date created
Dec 05, 2011
Last update
Dec 12, 2014
Development stage
AOL License
Curse link
Recent files