Autorank v2.1

Autorank Logo


Autorank v3.3

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 Sinnerkills Sinnerkills Oct 31, 2014 at 08:41 UTC - 0 likes

    Is there a way I can change how they rank up, I mean the command, people have to do /ar check to rank up is there a way I can just change it to /rankup ?

    Also, what's the right way to have a firework on rank up?

    It was working well the first time I ranked up for testing but when I needed to test it a second time it says

    meets all the requirements for rank B but has no (new) rankup.

    I need help. :)

    Last edited Oct 31, 2014 by Sinnerkills

    I'm just trying to learn!

  • Avatar of TopTodd TopTodd Oct 30, 2014 at 18:49 UTC - 0 likes

    Hey, im having a couple errors with the plugin, i'm not sure if it is the way i have configured it or whether it doesn't support ranking up in multiple worlds. This is my advancedconfig.yml -

    and once people are reaching the time played they are not be ranked up in any world but instead they're receiving this message when they do "/ar check", nor does the "ar complete 1" command work.


  • Avatar of vr6z vr6z Oct 29, 2014 at 20:39 UTC - 0 likes

    Hey Staartvin! Sadly I really want autorank but when i put in the file in the plugins folder it doesn't automatically extract like the other plugins do.. when I tried doing it manually it didn't even read it as a plugin so idk what to do :( I've tried different versions of it to for the update but it just doesn't want to work :(

  • Avatar of Staartvin Staartvin Oct 29, 2014 at 06:06 UTC - 0 likes

    @Turbotailz: Go

    I'll message you on Skype for more info ;)

  • Avatar of Turbotailz Turbotailz Oct 28, 2014 at 22:00 UTC - 0 likes

    @Staartvin: Go

    Okay that's fine. No rush!

    BTW I have just started getting errors again today, along the lines of this:

  • Avatar of Staartvin Staartvin Oct 27, 2014 at 14:58 UTC - 0 likes

    @MajikalBlood: Go

    Great to hear!

  • Avatar of Staartvin Staartvin Oct 27, 2014 at 14:54 UTC - 0 likes

    @Turbotailz: Go

    No, there is no real way of checking the player's permissions when they're offline. I'm trying to find a workaround, but it seems surprisingly difficult.

  • Avatar of MajikalBlood MajikalBlood Oct 27, 2014 at 13:53 UTC - 0 likes

    @Staartvin: Go

    So far this has worked, thank you Staartvin

  • Avatar of Turbotailz Turbotailz Oct 27, 2014 at 11:17 UTC - 0 likes

    Just curious, did you end up fixing the leaderboard.exempt permission for those who are offline?

  • Avatar of aligc aligc Oct 26, 2014 at 14:18 UTC - 0 likes

    @Staartvin: Go

    Haha yeah I would but i have about 5000 player names to convert...


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