Automatically promote a player's rank

Using either time played or players using a secret phrase.


How to install RankBot

1) Add RankBot to your plugins folder, start your server or /reload your plugins

2) Edit the config.yml file in the RankBot Folder.

3) Reload or restart again for your changes to take effect.

Example Secret Phrase Setting


Phrase0: rank me

FromGroup0: guest

ToGroup0: nomad

Example Timed Hours Played Settings


Hours0: 8

FromGroup0: nomad

ToGroup0: citizen


/rankbot {secret_phrase) - Used for secret phrase promotions.

/rb time - Used by a player to show their time until their last log off, doesn't count current time since logging back on. Requires rankbot.time permission, which is defaulted to false.

/rb time {playername) - Used by admins to either list a player's time since last log off, or lists all players if no name is supplied. Requires rankbot.admin permission, which is defaulted to op.


rankbot.time - Allows the use of the player time command, which reports back to the player their play time since the last logout (not counting current time).

rankbot.admin - Allows the use of admin commands, the only current admin command is the admin version of "/rb time"


RankBot requires Vault and a supported permissions plugin.

Visit the Vault Webpage to see the current list of supported permissions plugins


To make RankBot more efficient the ranking isn't done the moment the time requirement is met, this would require a timed event that would check all player times vs. all the RankBot Times. Instead, a player isn't ranked until the next logon.

The playertime.db file in the RankBot Folder contains the playtime of players (in minutes) since the file was written to disk, this file is only written from memory to the disk file on server stops or plugin reloads.

There are up to 30 Secret Phrases and 30 Timed Hours Played Automatic Ranks

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

  • Avatar of AxelDios AxelDios Jan 17, 2014 at 04:28 UTC - 0 likes

    @Mixon87: Go

    Still can't duplicate your problem, sounds critical, so I would try another plugin.

  • Avatar of Mixon87 Mixon87 Jan 17, 2014 at 01:42 UTC - 0 likes

    10 days passed, tell me u will fix it please or I shall know for sure - wait or find another pl.



  • Avatar of AxelDios AxelDios Jan 07, 2014 at 08:35 UTC - 0 likes

    @Mixon87: Go

    I'm not sure, because I still can't duplicate the problem.

    But I've had a couple of other people in the past report the same issue,

    I'm running a long term test on two servers, trying to duplicate the issue, with a copy that constantly writes to a log file tracking the issue, which really makes the servers almost totally unplayable.

    I've seen lots of issues with the Bukkit Dev Builds in general, but that's the point, they are dev builds, not really build for normal use.

  • Avatar of Mixon87 Mixon87 Jan 04, 2014 at 08:48 UTC - 0 likes

    So you think that's it's bukkits problem or vault? I am using beta and latest vault

  • Avatar of Mixon87 Mixon87 Jan 04, 2014 at 08:44 UTC - 0 likes

    Any update?

  • Avatar of AxelDios AxelDios Dec 26, 2013 at 09:29 UTC - 0 likes

    @Mixon87: Go

    Already has a check of the old rank before setting the new rank, it appears to be a certain combination of permissions plugin, versions of Vault, and mostly spigot instead of Craft Bukkit that causes the problem.

    Last edited Dec 26, 2013 by AxelDios
  • Avatar of Mixon87 Mixon87 Dec 26, 2013 at 07:36 UTC - 0 likes

    As a solution how to fix promotion bug: add permission that will disallow promote rank which is have this permission.

  • Avatar of AxelDios AxelDios Dec 19, 2013 at 04:45 UTC - 0 likes

    @Mixon87: Go

    I will, but you are looking at at least two weeks for the next update.

  • Avatar of Mixon87 Mixon87 Dec 18, 2013 at 22:48 UTC - 0 likes

    Please post ur new version as soon as possible :) we are still waiting

  • Avatar of AxelDios AxelDios Dec 06, 2013 at 09:59 UTC - 0 likes

    @Mixon87: Go

    Yes, you can mix secret phrases and timed rankings.

    No, you can't use factions of hours, to make RankBot very lite on servers, it only checks for a players hours on the next logon. So even if the player plays for the allotted time, they wouldn't rank in a fraction of an hour.


Date created
Jun 26, 2012
Last update
Jan 21, 2014
Development stage
MIT License
Curse link
Recent files