Promote players with Kills, Signs, Passwords, Time, Exp, Items, Money and more!
Tired of promoting every player by hand? No Problem! Just use CommandRank :)

It allows the players to promote themselves (With configurable conditions) or even promotes them automatically (for example after a specific time).

Example usage on a PvP-Server: Players need kills to get a better rank. With every promotion they get some rewards and a better title.


  • Different ways to promote players if they meet the conditions
  • Permissions support
  • Economy support (needs Vault)
  • Everything is configurable
  • You can add infinite different "RankUps"
  • Possible conditions:
    • Player needs money
    • Player needs kills (CommandRank is able to count kills)
    • Player needs specific "onlineTime" (CommandRank is able to count the time a player is online)
    • Player needs specific items in his inventory
    • Player needs "Points" (PlayerPoints)
    • Player needs to enter a password
    • Player needs XP
  • Possible ways to execute a rankup:
    • "RankUp"-Sign
    • Acceptrules command (executes one specific "RankUp")
    • Declinerules command (executes one specific "RankUp" (default is prisoner))
    • RankUp command (executes the next possible "RankUp"
    • AutoRankUp (If enabled, a schedule checks players data every x seconds and executes a "RankUp" if possible)
    • Password (Player is able to enter a password. If it's the right one a "RankUp" will be executed)
  • Possible actions:
    • Commands executed by console
    • Commands executed by player
    • Items given to player (Enchantments or things like colored wool are possible)
  • CommandRank contains an "RankUpEvent" which allows other developers to work with


  • /AcceptRules | Ranks the players to the given group (default: user)
  • /DeclineRules | Ranks the players to the given group aswell (default: prisoner *evil* )
  • /Password <pw> | Allows the player to enter a password
  • /RankUp | Executes the next possible "RankUp"
  • /cr | Shows "onlineTime" or kills to the player
  • /cra | Admincommand to check onlineTime/kills of a player or to promote somebody


  • CommandRank.Admin | Allows to execute admincommands and to create a "RankUp" sign & contains "CommandRank.User" permission
    • CommandRank.createSign | Allows to create a "RankUp" sign
    • CommandRank.AdminCommand | Allows to use the admincommands
  • CommandRank.User | Basic permissions
    • CommandRank.useSign | Allows to use a "RankUp" sign
    • CommandRank.AcceptRules | Allows to use the AcceptRules command
    • CommandRank.DeclineRules | Allows to use the DeclineRules command
    • CommandRank.Password | Allows to enter a password
    • CommandRank.UserCommand | Allows to use the /cr command
    • CommandRank.RankUpCommand | Allows to use the /rankup command
  • CommandRank.RankUp.<name of rankup> | Allows to use the named "RankUp"
  • CommandRank.isGroup.<name of rankup to group> | Prevents from getting AutoRankUp to <name of rankup to group> (You should give the permission to every group to prevent from getting the same "RankUp" multiple times.)
  • CommandRank.exclude.* | contains:
    • | Excludes from "AutoRankUp"s
    • CommandRank.exclude.sign | Excludes from sign-"RankUp"s
    • CommandRank.exclude.command | Excludes from command-"RankUp"s
  • Advanced guide with permissions

  • Add FAQ to description

Got any ideas? Post them here: Forum

Found a bug? Create a ticket: Tickets

CommandRank is not working? Your config probably contains some mistakes. Check out your server.log or create a new ticket!

API | Setup guide | Tips & Tricks | Modifications

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

  • Avatar of xYourFreindx xYourFreindx Apr 20, 2014 at 14:17 UTC - 0 likes

    @kollinkoko: Go

    Yeah, just turn the read rules off. And or give all the players the Donottoreadrules permission node and for the lowest command rank, just make sure they already fit the requirements for it.

    Looking to be the apprentice for a plugin owner.
    I'd like to test for bugs and or pick up on some java experience.
    Please PM me if you'd be willing.

  • Avatar of kollinkoko kollinkoko Apr 19, 2014 at 20:04 UTC - 0 likes

    Can I make it they don't have to accept the rules and they start as the default and they have to type /rankup to rankup? If so, how?

  • Avatar of xYourFreindx xYourFreindx Apr 16, 2014 at 18:58 UTC - 0 likes

    @fogfrog007ti: Go

    Thank you, but I am well aware of that. I have however decided not to incorporate that as a part of my server long before now, as it seems to be quite a nuisance to many players and results in the lowering of overall enjoyment of the server.

  • Avatar of fogfrog007ti fogfrog007ti Apr 16, 2014 at 09:55 UTC - 0 likes

    Hi, I have a problem after accepting the rules, I'm using /rankup for the next rank but all I get is a message "you can not use RankUp at the moment!" ? I'm using the Essentials pac + GM, did I miss something ?

    Fixed it, it was 1st that I accidentally started a rankup with a big letter. 2cond that I gave ranks positions like visitorI, visitorII didn't liked the big letters :/

    xYourFreindx-> if you are using essentials you can give them a timeout (after 2 min.) to prevent them from gathering too much online time. :)

    Last edited Apr 16, 2014 by fogfrog007ti
  • Avatar of xYourFreindx xYourFreindx Apr 15, 2014 at 23:21 UTC - 0 likes

    @DarkWolfInsanity: Go

    Make sure that, in your config, you have the pages set to 1 (or however many /rules (page) pages you have. Doing /rules over And over again does not force the plugin to think you've read them all. You have to actually "/rules" "/rules 2" "/rules 3" "/rules 4" etc.

  • Avatar of xYourFreindx xYourFreindx Apr 15, 2014 at 23:18 UTC - 0 likes

    Does commandrank's system for determining playtime account for the time a player has spent just sitting there? Or sitting in an AFK machine? You can see where this would be a problem if a player were to get in an AFK machine or even just stand at spawn all day long, and then never have to worry about ACTUAL play time as part of any requirnement for ranking up. If it has not, the plugin OnTime has developed a great anti-AFK system that would be great if adopted into here. Even if it just hooks into it, or even essentials. That would be a lot better than without. If it already takes care of this issue, then wonderful. That eases my and, I'm sure, many other server owners' minds/tensions.

    Last edited Apr 16, 2014 by xYourFreindx
  • Avatar of DarkWolfInsanity DarkWolfInsanity Apr 05, 2014 at 22:46 UTC - 0 likes

    Our users are having problems using /acceptrules. No matter time how many times we use /rules, they aren't able to use /acceptrules, only giving the error "You must read the rules first!"

  • Avatar of levisn1 levisn1 Apr 05, 2014 at 21:47 UTC - 0 likes

    I have this error on /cr kills

    This server is running CraftBukkit version git-Spigot-1356 (MC: 1.7.5) (Implementing API version 1.7.5-R0.1-SNAPSHOT)

  • Avatar of digimbyte digimbyte Apr 04, 2014 at 04:07 UTC - 0 likes

    @TheBOB147: Go

    Tried using OnTime first, it proved to be VERY unstable as it would wipe player data.

    we're running a mod pack called HEXXIT. I discovered that Command Rank is able to read large numbers, it just took some slight calculations, but its all good now.

    sept a new issue which is a bug I'll be making a ticket for

  • Avatar of digimbyte digimbyte Apr 04, 2014 at 04:05 UTC - 0 likes

    @navbarry: Go

    You'll be surprised, we're a good server that has a dedicated community at its core.

    I've fixed the time, but i did reduce it slightly.

    Now I'm facing a NEW issue, when players ranked up they are able to spam /rules /acceptrules to get the starter kit all over again, I fixed that by removing the permission nodes, but now its spamming everyone with &cYou are not allowed to do this!

    I need to know how this permission structure is supposed to work because im trying to null previous ranks, but its all for naught

    Last edited Apr 04, 2014 by digimbyte


Date created
Jan 26, 2012
Last update
Jan 02, 2014
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • R: v3.2.1 for CB 1.7.2-R0.2 Jan 02, 2014
  • R: v3.2.0 for CB 1.6.4-R2.0 Nov 12, 2013
  • R: v3.1.9 for 1.6.4 Oct 22, 2013
  • R: v3.1.8 for 1.6.2 Jul 13, 2013
  • R: v3.1.7 for 1.6.1 Jul 07, 2013



Optional dependency