Autorank v2.1

Autorank Logo


Autorank v3.2

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 spyperson spyperson Aug 20, 2014 at 18:17 UTC - 0 likes

    @Staartvin: Go

    Same error, even when switching cases. Does it help if I add that deleting "data.yml" fixes the error during the session? Same thing with switching cases, it just doesn't permanently fix it.

    Last edited Aug 21, 2014 by spyperson

  • Avatar of GonzoDark GonzoDark Aug 20, 2014 at 01:59 UTC - 0 likes

    @GonzoDark: Go

    It could also be cool if you supported "Eggs thrown".

    Last edited Aug 20, 2014 by GonzoDark
  • Avatar of GonzoDark GonzoDark Aug 19, 2014 at 19:28 UTC - 0 likes

    I encountered a strange problem when testing stats variables, the "times sheared" requirement is not working, it will show up on my list as: "Play for at least 0 minutes. (Done)"

  • Avatar of Staartvin Staartvin Aug 19, 2014 at 17:04 UTC - 0 likes

    @sinder33: Go

    You can change it in the settings config.

    @spyperson: Go

    So Autorank can't seem to find the group Prisoner. Could you try to use 'prisoner' for both configs?

    @YarharALC: Go

    What error are you encountering?

  • Avatar of BlockBert BlockBert Aug 19, 2014 at 10:04 UTC - 0 likes

    Hey guys, I have some trouble with your plugin. It should rank up a player after he played 5h to a member and then after 10d to a trusted. But it always says "meets all the requirements for rank member but has no rankup.". The clue is that the players get into that permission group. but then they can't get further permissions because autorank stops ranking then. So what I use on my server: OnTime, PermissionsBukkit and Autorank. Ontime saves all the player times into a MySQL Database and Autorank gets their time (That actually works!) and then they get into the members group, but Autorank doesn't rank them correctly so it says they are still default. How to fix it?

  • Avatar of GonzoDark GonzoDark Aug 19, 2014 at 00:34 UTC - 0 likes

    @TheBlizen: Go

    It works fine for me. It does not count down. But it does say (Done) when I have killed the required amount.

  • Avatar of YarharALC YarharALC Aug 18, 2014 at 10:01 UTC - 0 likes

    @SXRWahrheit: Go

    WHAT? PEX breaks it for me! How the hell did you get PEX to work?

  • Avatar of SXRWahrheit SXRWahrheit Aug 15, 2014 at 19:33 UTC - 0 likes

    Switching to PEX took some time but solved my problem.
    I run and our Minecraft server at - feel free to visit.

  • Avatar of TheBlizen TheBlizen Aug 15, 2014 at 18:51 UTC - 0 likes

    I ment mobs killed Option isnt working it seems

  • Avatar of TheBlizen TheBlizen Aug 15, 2014 at 18:47 UTC - 0 likes

    I am running spigot server 1.7.10 have autorank latest update and stats and vault plugins. But the mod kill and for example value: 1;spider Is not working its not counting down or saying its done at all .


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