Bukkit

PowerRanks is a plugin that adds ranks to your server.

For every rank, you can set a prefix so other players can see what rank you have.
You can also set the ChatColor and NameColor for every rank.
Questions? Read the FAQ first before asking it!

It is:

• Fast - PowerRanks is optimized for speed, the changes you make can be seen directly.
• Easy to use - Permissions can be set up using commands or in the configuration files.
• Changeable - There are numerous customization options available that can be changed to suit your server.
• Free - available for download and usage at no cost.

The standard ranks in the plugin are: Member, Moderator, Admin, and Owner. And these can be changed/deleted to your liking.
The plugin can handle unlimited ranks.

PowerRanks has an auto-updater for the plugin, by default it only checks for an update. Optionally automatic update downloading can be enabled. The configuration files can also be updated directly. See 'config.yml' for more info. 

PowerRanks now has a Discord server for support.

This way support will be quicker.

https://discord.gg/rAgBHMB

1. Download the .jar
2. Drag and drop the .jar in your plugins folder of your server
3. Restart/Reload your server.

• /pr help
  • Description: Shows the menu
    Permission: powerranks.cmd.help
    Default: everyone
• /pr createrank <rankName>
  • Description: Create a new rank
    Permission: powerranks.cmd.create
    Default: op
• /pr deleterank <rankName>
  • Description: Delete a rank
    Permission: powerranks.cmd.create
    Default: op
• /pr set <playerName> <rankName>
  • Description: Set someone's rank
    Permission: powerranks.cmd.set
    Default: op
• /pr setown <rankName>
  • Description: Set your own rank
    Permission: powerranks.cmd.set
    Default: op
• /pr promote <playerName>
  • Description: Promote a player to the next rank
    Permission: powerranks.cmd.set
    Default: op
• /pr demote <playerName>
  • Description: Demote a player to the previous rank
    Permission: powerranks.cmd.set
    Default: op
• /pr check <playerName>
  • Description: Check someone's rank
    Permission: powerranks.cmd.check
    Default: everyone
• /pr listranks
  • Description: List all ranks
    Permission: powerranks.cmd.list
    Default: op
• /pr listpermissions <rank>
  • Description: List all permissions of a rank
    Permission: powerranks.cmd.list
    Default: op
• /pr reload [config/plugin/all]
  • Description: Reload PowerRanks
    Permission: powerranks.cmd.reload
    Default: op
• /pr addperm <rank> <permission>
  • Description: Add a permission to a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr delperm <rank> <permission>
  • Description: Remove a permission from a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr addplayerperm <player> <permission>
  • Description: Add a permission to aplayer
    Permission: powerranks.cmd.set
    Default: op
• /pr delplayerperm <player> <permission>
  • Description: Remove a permission from aplayer
    Permission: powerranks.cmd.set
    Default: op
• /pr setprefix <rank> <prefix>
  • Description: Change the prefix of a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr setsuffix <rank> <suffix>
  • Description: Change the suffix of a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr setchatcolor <rank> <color>
  • Description: Change the chat color of a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr setnamecolor <rank> <color>
  • Description: Change the name color of a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr addinheritance <rank> <inheritance>
  • Description: Add a inheritance to a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr delinheritance <rank> <inheritance>
  • Description: Remove a inheritance from a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr enablebuild <rank>
  • Description: Enable building on a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr disablebuild <rank>
  • Description: Disable building on a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr renamerank <from_rank> <to_rank>
  • Description: Rename a rank
    Permission: powerranks.cmd.set
    Default: op
• /pr setdefaultrank <rank>
  • Description: Rename a rank
    Permission: powerranks.cmd.set
    Default: op

• /pr forceupdateconfigversion
  • Description: Update the version variable in all configuration files
    Permission: powerranks.cmd.admin
    Default: op

• /pr gui

• Description: Show the commands GUI
  Permission: powerranks.cmd.admin
  Default: op

• /pr rankup

• Description: Buy a rank (Requires Vault)
  Permission: powerranks.cmd.rankup
  Default: everyone

• /pr stats

• Description: Show stats about PowerRanks
  Permission: powerranks.cmd.admin
  Default: op

• /pr addbuyablerank <rank> <buyable_rank>
  • Description: Add a rank to the buyable list of a rank
  • Permission: powerranks.cmd.admin
  • Default: op
• • Description: Remove a rank from the buyable list of a rank
  • Permission: powerranks.cmd.admin
  • Default: op/pr delbuyablerank <rank> <buyable_rank>
• /pr setcost <rank> <cost>
  • Description: Set the buy cost of a rank
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr addsubrank <player> <rank>
  • Description: Add a sub rank to a player
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr delsubrank <player> <rank>
  • Description: Remove a sub rank from a player
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr listsubranks <player>
  • Description: List all subranks of a player
  • Permission: powerranks.cmd.list
  • Default: op
• /pr enablesubrankprefix <player> <rank>
  • Description: Show the subranks prefix
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr disablesubrankprefix <player> <rank>
  • Description: Stop showing the subranks prefix
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr enablesubranksuffix <player> <rank>
  • Description: Show the subranks suffix
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr disablesubranksuffix <player> <rank>
  • Description: Stop showing the subranks suffix
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr enablesubrankpermissions <player> <rank>
  • Description: Use the subranks permissions
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr disablesubrankpermissions <player> <rank>
  • Description: Stop using the subranks permissions
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr createusertag <tag> <text>
  • Description: Create a new user tag
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr editusertag <tag> <text>
  • Description: Edit a user tag
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr removeusertag <tag>
  • Description: Delete a user tag
  • Permission: powerranks.cmd.admin
  • Default: op
• /pr setusertag [player] <tag>
  • Description: Assign a user tag
  • Permission: powerranks.cmd.usertag
  • Default: true
• /pr listusertags
  • Description: List all user tags
  • Permission: powerranks.cmd.usertag
  • Default: true

How to use signs?
On the first line of the sign write "[PowerRanks]"
On the second line of the sign write the command.
On the third line of the sign can the rank name be placed.

Available commands: promote, demote, check, set, gui, rankup.
The commands: promote, demote, check, gui do not require a rank name on the third line.
The command: set does require a rank name on the third line.

Q The permission(s) I just added do not work!
A Make sure to do /pr reload to apply the changes.

 

Q I made a change to Ranks.yml and now PowerRanks does not start.
A Since Ranks.yml is a YAML configuration, spaces and the general layout of the file is important, what you could do is paste your config in http://www.yamllint.com to see if you have errors, any errors are highlighted there.

 

Q I updated PowerRanks to a newer version and now I get a warning message in the console complaining about a version mismatch
A This is normal because a configuration file (like: config.yml, Ranks.yml and Players.yml) Can have changes in different version. The best solution right now is to create a backup of the PowerRanks directory and let PowerRanks create a new one, then adding your necessary changes back.

 

Q How do I add permissions?
A Permission can be added to a rank in two ways:
     1. Inside the Ranks.yml file under the permissions tag inside the rank you want to edit. Basic YAML knowledge is required here.
     2. Using the /pr addperm <rankname> <permission> and /pr delperm <rankname> <permission> commands. This is the easiest way.

 

Q How can I add a new rank?
A Ranks can be added in two ways:
     1. Inside the Ranks.yml copy a existing rank and paste it again, the you can change the new rank. Basic YAML knowledge is required here.
     2. Using the /pr createrank <rankname> and /pr deleterank <rankname> commands. This is the easiest way.

 

Q I cannot change the player rank (/pr set <playername> <rankname>) it says that the rank is not found.
A Make sure that the rank you're trying to apply exists and that you made no spelling mistake, rank names are case-sensitive!

 

Q How do I know what permission I need to use for a specific command?
A Go to the plugin-page of that command, there should be a list of permissions for each command.

The comments section has been disabled in favor of Discord to ensure the best and fastest support.