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 mattataki mattataki Aug 14, 2014 at 00:34 UTC - 0 likes

    @AxelDios: Go

    @Eiffelrose: Go

    The plugin actually adds rank that is configured in the config file but adds a world sub setting to the permissions. So it looks like this:

      [player name]:
        - [Whatever rank the player was before]
          [world name]:
            - [promoted rank name]

    The world sub setting is determined by the world the player is in at the time of the command.

    Last edited Aug 14, 2014 by mattataki
  • Avatar of AxelDios AxelDios Aug 12, 2014 at 03:29 UTC - 0 likes

    @Eiffelrose: Go

    It's not an issue with Multiverse, it's an issue with Vault, I'm thinking about dropping Vault all together because another person is also having a demotion issue.

  • Avatar of Eiffelrose Eiffelrose Aug 11, 2014 at 16:25 UTC - 1 like

    Can you make it more compatible with multiverse? Players are losing ranks in the different worlds I have...

  • 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


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