PermissionsBukkit - the Official Default Groups Plugin
Current Version: v2.3 (beta v2.4)
Find PermissionsBukkit on the forums!

It's been a long time coming, but with the accomplishment of build 1000 Bukkit has finally accomplished a built-in Permissions system (codenamed Superperms). For more info on how they work, and how to integrate them with your plugin, see the official Permissions FAQ. Keep in mind that you should rarely, if ever, have to hook this plugin directly; instead keep things in the realm of checking player.hasPermission("yourplugin.node"). The FAQ thread has more info on how to use Superperms with things like chat prefixes/suffixes.


  • Storage of users and groups in plugins/PermissionsBukkit/config.yml.
  • Both users and groups can be assigned individual permissions and parent groups to inherit permissions from.
  • Support for global and per-world permissions.
  • Reload configuration from file without reloading the plugin.
  • Ability to check if a player has a specific permission node.
  • Ability to dump all permissions a player has and the plugins that set them.
  • Ability to print plugin, description, and default for a given permission node.
  • Ability to modify the permissions of groups and users and the groups of a user in-game.
  • Built-in antibuild via the "" node (defaults to allowing anyone to build).

Current Beta Version:
PermissionsBukkit v2.4 beta (details)
Current Version:
PermissionsBukkit v2.3 (jar) (details)
Previous Beta Version (for older than 1.7.6):
PermissionsBukkit v2.2 beta (details)

Other Important Information:

For changelog information, known caveats, and other release notes, see the entries on the files page.

Plugin Metrics
PermissionsBukkit gathers some information about your usage via PluginMetrics. The information is available here, and you can disable metrics on your server by changing 'opt-out' to true in plugins/PluginMetrics/config.yml. You can view your own stats with the /perm about command.
PermissionsBukkit collects this information about your specific usage:

  • The number of groups, users, worlds, permissions, and permission roots (first parts) in your configuration.
  • Whether you use per-user permissions, per-world permissions, group inheritance, and API features.
  • Whether anti-build is enabled, assigned to the default group, and has a message.
  • Whether debug mode or custom permissions (permissions.yml file) are in use.
  • Whether the example user "ConspiracyWizard" is in your configuration (this is not a real person).

Additionally, some information is collected by PluginMetrics by default:

  • Java version
  • Operating system
  • Authentication mode (online/offline)
  • System architecture (32/64-bit) and core count
  • Game version
  • Server location

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

  • Avatar of miki88mouse miki88mouse Nov 22, 2014 at 09:55 UTC - 0 likes

    So this plugin support the bungee cord? whil many people use now more servers and that future wil be nice to use one SQL AND MYSQL support so that all server will be used that database and synchronized at the same time when you add players in sme ranks example i added player in my "HUB server or in console" to rank Admin then system will be automaticaly added their in all other server automaicaly with database. (SQL and MySQL) support. This will be make a plugin very very useful and pro. Thanks

  • Avatar of NinjaSplat NinjaSplat Nov 16, 2014 at 18:25 UTC - 0 likes

    Will this plugin be ported over to Sponge? I need this plugin for my server. Hope you do!

  • Avatar of DaWe35 DaWe35 Oct 28, 2014 at 19:39 UTC - 0 likes

    I sended a security problem in a pm.

  • Avatar of S0N0FAS0N S0N0FAS0N Oct 22, 2014 at 02:34 UTC - 0 likes

    @Nypana: Go

    • Depends on what you are using, try {name} or {username} like in the following examples:
    • /perm setrank {name} VIP
    • or
    • /perm setrank {username} VIP
    • This should work in most cases (educated guess).
    Last edited Oct 22, 2014 by S0N0FAS0N
  • Avatar of Mizar6 Mizar6 Sep 01, 2014 at 10:38 UTC - 0 likes

    I just switched to PermissionsBukkit on my server and now my WorldGuard Regions don't work with regards to groups. The players can't get into rank (group) specific shops.

    Last edited Sep 01, 2014 by Mizar6
  • Avatar of Mizar6 Mizar6 Aug 28, 2014 at 23:28 UTC - 0 likes

    If you have a plugin that does anything with groups, say a rankup plugin, and it does not work, it's probably because the author used Vault's playerAddGroup(Player player, String group) method which will always fail since PermissionBukkit does not support groups on a per world basis so Vault nulls all calls to playerAddGroup(Player player, String group). The author needs to use playerAddGroup(String world, OfflinePlayer player, String group) and set the world to null. I wanted to switch to PermissionsBukkit but several plugins dealing with groups were failing so I looked at the open source ones and then the source of Vault.

  • Avatar of JugadorNinja JugadorNinja Aug 19, 2014 at 17:29 UTC - 0 likes

    does this support time based group? if i want to set a player in a group for an amount of time?

  • Avatar of Seam0nkey Seam0nkey Aug 06, 2014 at 19:36 UTC - 0 likes

    Whoa...didn't realize it was SpaceManiac who wrote this. GG SM.

  • Avatar of Nypana Nypana Aug 06, 2014 at 15:42 UTC - 1 like

    Please I need help !

    I love your plugin but I have a problem ! I will open my RP server soon. I want to use "Bossshop" to buy rank. Then i have to set a command to buy "VIP rank". BUT i think, i have to use "/perm setrank <playername> VIP" and I don't know how it can set the playername automatically... Sorry for my english I'm french.

    For exemple : "Mister" want to be VIP. He have to click on bossshops item and click on "BUY VIP". The command executed will be /perm setrank Mister VIP.

    My question is : How can the playername will be set automatically "/perm setrank (HERE) VIP"

    I tried /perm setrank <playername> VIP but it doesnt work...

    Sorry for my bad english again and thanks for reading !

  • Avatar of altair123ezio altair123ezio Aug 05, 2014 at 07:30 UTC - 0 likes

    how can i do a group as default? i need put default:true or something?

I'm a poll!

  1. Choice:

  1. Results
  2. 34 comments


Date created
Aug 25, 2011
Last update
Aug 04, 2014
Development stage
  • enUS
MIT License
Curse link
Recent files