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 Jul 30, 2014 at 06:39 UTC - 0 likes

    @Eiffelrose: Go

    PM me your RankBot Settings, and also the name of permissions plugin you are using and it's version number, and the version number of Vault that you are using, and the version of CraftBukkit.

    And I'll take a look at the problem.

  • Avatar of Eiffelrose Eiffelrose Jul 30, 2014 at 05:42 UTC - 0 likes

    My staff ranks are getting demoted :/ Idk how to fix this because in the config files I dont even have them listed. My ranks that are on the list are Default Noble_Miner Meowster and Time Keeper. I have about 10 other ranks but I dont want rankbot to interfere with those ranks. Any idea on how to fix this?

  • Avatar of AxelDios AxelDios Jul 10, 2014 at 08:05 UTC - 0 likes

    Come and try out ChairStairs and some of my other plugsins like BlastFurnace, BoomStick, ProtectionStones, ExtraRecipes, RubySlippers, and SuperSmelter on AuthentiCity (acmc.game.nfoservers.com) 1.7.2 Survival Server.

  • Avatar of AxelDios AxelDios May 07, 2014 at 03:18 UTC - 0 likes

    @werte12345: Go

    Yes, all time is counted, doesn't matter if they are AFK or not, the only thing that is counted is log on time and log off time.

  • Avatar of werte12345 werte12345 May 06, 2014 at 14:27 UTC - 0 likes

    Now I'm confused:

    "All time is counted, whether they are AFK or not, " "I'm not counting AFK time, so the time will probably appear differently then the other plugins time."

    I think I got your first comment wrong - you dont count afk-time, is that right? That would explain it, definitly.

    Maybe I lock the /onlinetime command to avoid stupid questions :D

  • Avatar of AxelDios AxelDios May 06, 2014 at 03:20 UTC - 0 likes

    @werte12345: Go

    Just the time commands above, since it won't calculate the time currently on until they log off (log off time minus log on time equals current new time to add to the database).

    I'm not counting AFK time, so the time will probably appear differently then the other plugins time.

  • Avatar of werte12345 werte12345 May 05, 2014 at 19:59 UTC - 0 likes

    Well I knew that part already. But i try to ask in another way:

    1. is there a way / command to see the actual time a player has untill the next promotion?

    2. how can it be that a timepromote after 10 hours promote a user with 6 hours onlinetime and another user with 11 and more hours onlinetime according to the timecount of glizer-plugin?

    The result is that a lot of guys ask why they're not promoted yet. get on nreves :D

  • Avatar of AxelDios AxelDios May 05, 2014 at 05:43 UTC - 0 likes

    @werte12345: Go

    All time is counted, whether they are AFK or not, the database doesn't show their current time, it only shows the last time the database was written to, which is during the server start or plugins /reload.

    The current time is held in memory until that time, for performance reasons.

    So looking at the file will not show you their current time, and promotion only happens on logon, the time is checked at that point to avoid having an event running in the background checking constantly for anyone who should be promoted.

  • Avatar of werte12345 werte12345 May 04, 2014 at 09:36 UTC - 0 likes


    we got a problem with your server. We also use Glizer which have the Command /onlinetime

    Normally, after ten hours and a relog, the time-promote works perfect. But sometimes, there're persons with more then 11 hours and no promote. I checked the last Example in Details: GLizer told he spend 11 hours on the server. The DB-File told: USER-XY,493 which is 8.2 hours. Why is it that way?

    What time on server counts for the plugin? Is AFK-Time counted out from the plugin? Is there any command where you see how much time is left untill the promote? if not can you insert it?

    to explain a bit more detail: users start as guest on the server. with a password-promote, they're moved to guest. then with a time-promote, they're promoted to member. my guess: depending on how quick they're on the first password-promote, they need longer untill they get promoted via time. but really help me out in detail here. i have to understand it because it dont want it to call it a bug anymore :D

  • 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.


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