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 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 - 0 likes

    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?

  • Avatar of Ironic8b49 Ironic8b49 Aug 01, 2014 at 14:45 UTC - 0 likes

    Been waiting for you to fix the UUID code myself, Essentials chat stopped working and Essentials told me it was this plugin

  • 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.

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