PermissionsBukkit - the Official Default Groups Plugin
Current Version: v2.3
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 Version:
PermissionsBukkit v2.3 (jar) (details)
Previous Beta Version (for older than 1.7.6):
PermissionsBukkit v2.2 beta (details)

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

Other Important Information:


Thursday 6 February 2013 (2.2)

  • Big performance improvements to situations where permissions are calculated (player join, player change world, /perm command use).
  • Fixed anti-build message not showing up.
  • Better preserve order of permission settings.
  • Fixed potential problems with permission refreshing happening to a wrong player with a similar name.
  • Added more helpful handling of invalid configuration files.
  • Fixed some error spam in metrics if configuration was invalid.
  • Added /perm dump -file command to create a text file listing permission info.

Saturday 25 May 2013 (2.1)

  • Added tab-completion - hit tab to bring up a list of possibilities on almost all `/perm` command arguments
  • Added crash prevention and a warning for groups that inherit themselves
  • Added information on how many logged-in users (including console) have a permission to the `/perm info` command
  • Marginally improved performance of the included antibuild
  • More advanced plugin metrics added to MCStats

Friday 7 September 2012 (2.0)

  • Fixed a case-sensitivity issue with setting per-world permissions that could cause some permissions to fail to apply.
  • Added /perm setrank <player> <group> subcommand (alias rank) with per-group permissions (permissions.setrank and permissions.setrank.<group>)
  • Added plugin metrics via (disableable in plugins/PluginMetrics/config.yml)

Wednesday 29 February 2012 (1.6)

  • Fixed some massive issues that were caused due to having uploaded a buggy, in-development version instead of 1.5.
  • Note: If your configuration was messed up as a result of this issue, the new build should gradually correct it as needed.

Saturday 25 February 2012 (1.5)

  • Revamped to be compatible with R5.
  • Fixed issues with permissions not carrying properly on world change.
  • Many internal improvements for performance and stability.
  • SuperpermsBridge: in honor of R5 removing deprecated code, SuperpermsBridge is officially gone!

Monday 18 July 2011 (1.1/1.2)

  • Fix BukkitContrib incompatibility issues.
  • Improved the output of the /perm check command.
  • Fixed issues when 'users:' is not specified in the config file.
  • Fixed the /permissions reload command.
  • SuperpermsBridge: improve wildcard handling; in addition to 'superpermbridge.*' and 'superpermbridge.pluginname', now supported are 'superpermbridge.plugin.*', 'superpermbridge.plugin.subnode.*', and so on.

Monday 18 July 2011 (1.0/1.1)

  • SuperpermsBridge: adding the special 'superpermbridge.*' and 'superpermbridge.pluginname' nodes (see #2 in the FAQ for details).

Sunday 17 July 2011 (1.0/1.0)

  • Initial release of PermissionsBukkit v1.0 and SuperpermsBridge v1.0.

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

  • Avatar of Joakimbeijer Joakimbeijer Jul 30, 2014 at 11:40 UTC - 0 likes

    Update please!! I need UUID support, or else i will use another plugin! When this is fixed, i will donate! :)

  • Avatar of UltiByte UltiByte Jul 25, 2014 at 08:24 UTC - 1 like

    As the "Official Default Groups Plugin", it is surprising that your (very useful and very nice) plugin hasn't yet updated to handle UUIDs. The below image shows an example of this, for displaying all players in a group on my server I have named "regular":

    PermissionsBukkit UUID Bug

    It ofc isn't a plugin breaking bug, but it's an annoyance which could possibly be fixed by just altering a few lines of code. I haven't needed to alter my plugins to use UUIDs yet, so I don't know how much work it is. But nonetheless this is just to draw your attention to the issue :P

  • Avatar of DarkValaMorgoth DarkValaMorgoth Jul 23, 2014 at 01:30 UTC - 1 like

    @mal67: Go

    The GitHub build of permsbukkit fixes that but breaks any plugin running commands automatically in permissions. I moving to permex.

  • Avatar of Willbbz Willbbz Jul 21, 2014 at 14:53 UTC - 0 likes

    @BukkitLover: Go

                permissions.example: true
            - Group1
            - Group2
                permissions.whatever: false
                permissions.whatever: true

    Join us on BFAK:Willbbz,63244,e638c3cd306af697dbd1cb680f7dbb564e1fcb9a5ac8789bf769cea186e2184c

  • Avatar of DarkValaMorgoth DarkValaMorgoth Jul 18, 2014 at 14:58 UTC - 1 like

    2.3 Release does not works with essentials chat formatING for groups.

    I used the GITHUB build to fix this but no plugins would talk to it. Command vlocks will not run permissions commands anymore. I switched back to the release build and I am having the same issue now!

    Please help.

    Last edited Jul 18, 2014 by DarkValaMorgoth: Update
  • Avatar of degumaster degumaster Jul 17, 2014 at 22:58 UTC - 0 likes

    @fabien91: Go

    THIS! The current version is using a TON of resources getting stuck on "Player join event"

    Last edited Jul 17, 2014 by degumaster
  • Avatar of fabien91 fabien91 Jul 15, 2014 at 10:52 UTC - 0 likes
    I have a problem with premissionsbukkit 2.3, I have enter the command /timings on and /timings paste and here is the resultat :
    Pct Total Pct Tick Total Avg PerTick Count Event

    0.57% 135.91% 0.136 s 67.9547 ms 0 0.00k

    0.44% 104.60% 0.105 s 52.3022 ms 0 0.00k
    Last edited Jul 15, 2014 by fabien91
  • Avatar of FlOppythp FlOppythp Jul 04, 2014 at 13:37 UTC - 0 likes

    @PandawanFr: Go

    The version 2.1 works really fine, i am downloading the 2.2 to see if it can be better.

    A question if i use 2.2 for example and later i want to go on version 1.7.9 or 1.8, and download the 2.3, does the permissions and players are going to be converted automaticly with all their permissions to the new UUID system ?

    Because i am a bit afraid now if it does not work properly i can't imagine the disaster for my server and my players.

    Beside i would like to use 1.7.9 but this version is completly bugued, massive lags, no skin shown etc. So i keep my server on 1.7.2 as long as i can.

    THanks for a future answer UUID is a pure sh..

    Magestia Private Server. The freedom has never been so real.

  • Avatar of PandawanFr PandawanFr Jun 29, 2014 at 14:54 UTC - 0 likes

    Which version is for 1.6? Is it the 1.7.2 BETA ? or the 1.5.2 BETA ?

  • Avatar of iamnoobplzhelp iamnoobplzhelp Jun 28, 2014 at 19:02 UTC - 0 likes

    <<reply 2246054>>

    PermissionsBukkit now uses UUID instead of username. This is because Mojang may let you change your Minecraft username in the future.

    There are two solutions you can try, either make the changes directly in the config file, and the next time they log in, it will change to their UUID. Or you can give permissions directly to their UUID. You can use this tool to convert their username to UUID:

    Ex: /perm player addgroup [long UUID string] [group you want to add them to]

I'm a poll!

  1. Choice:

  1. Results
  2. 31 comments


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