Autorank v2.1

Autorank Logo


Autorank v3.5.1

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 Garrett11991 Garrett11991 Jun 26, 2015 at 01:45 UTC - 0 likes

    Great Plugin. Works Great

    Last edited Jun 26, 2015 by Garrett11991
  • Avatar of Myrmidous Myrmidous Jun 21, 2015 at 05:53 UTC - 0 likes

    @Myrmidous: Go

    Resolved. Details:

    CAUSE: Upgrading from v3.3 directly to v3.5.1 with a configuration file that includes the following (not inclusive) will cause strange behavior of AutoRank:

    • "mobs killed:" requirement with the "zombie" monster type
    • More than one "blocks moved:" requirement on the same rank.

    EFFECT: Ranks with the above requirements will either not be able to use the "/ar check" command (mobs killed) or receive a display error when viewing goals (more than one 'blocks moved').


    • Downgrade to original version (in our case, v3.3) and then slowly try newer versions until you encounter the error(s) again.
    • Wipe AutoRank completely and start fresh with the new install. This means removing all player data, Stats entries and MySQL tables.

    And as always, report the problem and solution to the developer in case there's an easy fix.



    Staff member, Octopia (

  • Avatar of matedgo matedgo Jun 20, 2015 at 12:24 UTC - 0 likes

    @Staartvin: Go

    Yeah, i do.

  • Avatar of FrankTamer99 FrankTamer99 Jun 20, 2015 at 10:06 UTC - 0 likes

    Hello there,

    I wanted to ask a question and also to report something that it doesnt have in yet. First of all is it compatible with SkyWars? And now my problem, I have a problem with the rankup requirements for players killed. Because i can't set a setting just kills instead of different players kills. i tried to kill my second account 10 times but it doesnt give me the completion i tested with 10 different players and it worked? Can you please help

  • Avatar of Staartvin Staartvin Jun 18, 2015 at 14:13 UTC - 0 likes

    @Green_Foxxx: Go

    You are running Stats 3.0 and also Autorank 3.4. Autorank 3.4 only supports Stats 2, you'll have to downgrade to Stats 2.0

  • Avatar of Staartvin Staartvin Jun 18, 2015 at 14:11 UTC - 0 likes

    @matedgo: Go

    Are you running your server in offline mode?

  • Avatar of Green_Foxxx Green_Foxxx Jun 17, 2015 at 20:27 UTC - 0 likes

    Hello I have the autorank plugin installed on my server with stats but right now it says that it is disabled and to check the server.log whenever I do an autorank command! Please help me with this! :(


  • Avatar of Myrmidous Myrmidous Jun 16, 2015 at 17:58 UTC - 0 likes

    <<reply 2585687>>

    Reposting here, in case anyone else runs into the same problem. When a player with the error types /ar check, the console displays the following:

    [INFO] Playername has played for 4 days 15 hours 25 minutes and is in Scrapper. Requirements to be ranked up:
    7:39:54 PM CONSOLE: WARN]: Unexpected exception while parsing console command "ar check playername"
    7:39:54 PM CONSOLE: exception executing command 'ar' in plugin Autorank v3.5.1
    7:39:54 PM CONSOLE: java.lang.IllegalArgumentException No enum constant org.bukkit.entity.EntityType.NULL

    Not every rank gets this, but certain ones always show this message until the player ranks up out of that position. Then everything functions normally again.

    Staartvin I haven't used Hotmail in forever, how odd you got that address. Please check your PM, thank you.

  • Avatar of matedgo matedgo Jun 16, 2015 at 08:41 UTC - 0 likes

    @Staartvin: Go

    Sometimes it happens that Autorank check mojang online UUID, if that name is found it will change UUID in config and it'll start count new time. To name which doesn't exsist in Mojang will say "Could not find name of account with uuid: 'UUID'" and time wont count anymore.

  • Avatar of Staartvin Staartvin Jun 15, 2015 at 19:05 UTC - 1 like

    @Myrmidous: Go

    I've send you an e-mail to your private hotmail account. Check that one.

    As for the error: whenever the 'internal error occured' message comes up, immediately look into the console. The console will have a message spitted out, that always happens whenever you get that message in game.


Date created
Dec 05, 2011
Last update
Mar 16, 2015
Development stage
AOL License
Curse link
Recent files