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 ComeAtMeBro67 ComeAtMeBro67 Jan 27, 2015 at 03:22 UTC - 0 likes

    Hello, I cannot have it where the users have to have all of the requirements before they rankup, and have it show which ones they have and not? EG: they get to level 10, but then die and reset, but in autorank it counts as completing. Is there anyway to fix this? If stats change? I primarily need this because I want them to only rankup if they meet all requirements AND walk through a portal, it works somewhat, but they can walk in the portal first then meet all requirements after, which they get teleported wherever they meet up the rest of the requirements, I want it to only allow them to be ranked up while they are standing in a certain region.

  • Avatar of zachrywilsn zachrywilsn Jan 26, 2015 at 23:29 UTC - 1 like

    @Serrrgio: Go I get same issues with the UUID's. I had more luck with this build.

    1. 320 Jan 17, 2015 8:48:08 PM

    I know he states they are Dev, but I feel this build may be in better state than the release at least for spigot itself. Spigot is part bukkit but its not 100% same code so maybe UUIDs are handled different in spigot. Give the Dev time to get this to his new release. I think we would rather he devote his time to the new full release than fix bugs in the older versions. Then again Im not the Dev.

    [ZachryWilsn]: Server Website: KronicZombies YouTube: ZachryDoesMinecraft

  • Avatar of Wolfy262 Wolfy262 Jan 26, 2015 at 18:03 UTC - 0 likes


    Is there an upcoming feature where Pex is compatible with this?

  • Avatar of Serrrgio Serrrgio Jan 26, 2015 at 07:44 UTC - 0 likes

    Spigot 1.8, Autorank v3.4 Error don't work?

  • Avatar of Marco305 Marco305 Jan 23, 2015 at 20:56 UTC - 0 likes

    You should add an option for offline servers where it's not needed to lookup for the uuid by the mojang api because it's causing tons of errors and making the server lagging until it crashes.

  • Avatar of p0seidon1 p0seidon1 Jan 23, 2015 at 16:39 UTC - 0 likes

    Does this plugin work with bukkit 1.8?

  • Avatar of Retrinity Retrinity Jan 22, 2015 at 22:25 UTC - 0 likes

    Any reason when I get this errors? (I think they work on /ar check but I don't know)

  • Avatar of raum raum Jan 22, 2015 at 03:56 UTC - 0 likes

    This may have already been answered - I didn't go through all 350+ pages of comments. :P I see a Converter for LogBlock - is there any for OnTime?


  • Avatar of misa0152 misa0152 Jan 19, 2015 at 22:23 UTC - 0 likes

    @Staartvin: Go

    Group manager

  • Avatar of Staartvin Staartvin Jan 19, 2015 at 20:08 UTC - 0 likes

    @Slaand: Go

    Does Autorank correctly connect to the database?


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