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 JJLangan123 JJLangan123 Apr 14, 2012 at 19:57 UTC - 0 likes

    yello! I still cant get permissions to work for my mac! It dosent give me the file so i tried it with essentials but it still dosent work! Ive tried to decode it with notepad but i cant get the right code!(does anybody know the code?) Sorry, im stil a noob! Thx

  • Avatar of EweLoon EweLoon Apr 12, 2012 at 09:24 UTC - 0 likes

    wow, that code inserted well and i love the edit facilities sorry about the mess below

  • Avatar of EweLoon EweLoon Apr 12, 2012 at 09:19 UTC - 0 likes

    I would really like to see an addition made to permissionbukkit, to assist with setting up multiworld permissions I would like to see inheritance added to the world nodes, to assist in keeping groups of worlds having the same permissions without having to duplicate all the indervidual permissions

    example NOTE, this Does not work , so dont try using it

    groups: default: permissions: false true

    timekeeper: permissions: true fuzcoms.fine: true fuzcoms.night: true fuzcoms.storm: true worlds: Conquest: worldedit.navigation.jumpto: true Private: inheritance: - timekeeper inheritance: - default

    as you can see I have the timekeepers listed as being inherited to the private world I would do it myself, but im not quite up to doing it (only been programing java for about 4 months)

  • Avatar of ThePiggy351 ThePiggy351 Apr 11, 2012 at 22:32 UTC - 0 likes
    Some one please take this project over, I'd like to see bug fixes if possible, also I'm OCD and want to be 100% without a doubt there are no bugs on 1.2.5
  • Avatar of cocoson cocoson Apr 11, 2012 at 21:33 UTC - 0 likes

    lol its compatible with all versions been using it since cb 1060 u never have to up date it unless u want a minor fix

    Coco's Sig

  • Avatar of lanuk lanuk Apr 11, 2012 at 19:39 UTC - 2 likes

    Is this compatible with 1.2.5?

  • Avatar of benny95346 benny95346 Apr 11, 2012 at 15:28 UTC - 0 likes

    Hello, I am having an error changing my players' groups. Am I doing it wrong or is it the plugin's fault? I do /permissions setgroup Bob Builder, and it returns this error: 09:23:20 [WARNING] Unexpected exception while parsing console command org.bukkit.command.CommandException: Unhandled exception executing command 'perm issions' in plugin PermissionsBukkit v1.6 at org.bukkit.command.PluginCommand.execute( at org.bukkit.command.SimpleCommandMap.dispatch( 6) at org.bukkit.craftbukkit.CraftServer.dispatchCommand( 73) at org.bukkit.craftbukkit.CraftServer.dispatchServerCommand(CraftServer. java:469) at net.minecraft.server.MinecraftServer.b( at net.minecraft.server.MinecraftServer.w( at at Caused by: java.lang.NullPointerException at com.platymuus.bukkit.permissions.PermissionsCommand.createPlayerNode( at com.platymuus.bukkit.permissions.PermissionsCommand.playerCommand(Per at com.platymuus.bukkit.permissions.PermissionsCommand.onCommand(Permiss at org.bukkit.command.PluginCommand.execute( ... 7 more Thanks for your help. If it means anything, I ran this command from the console. Edit: Nevermind, I fixed the problem. I was missing the users: section in the config.yml

    Last edited Apr 11, 2012 by benny95346

    Smi'zel Übenstak

  • Avatar of Themonkey180 Themonkey180 Apr 11, 2012 at 13:24 UTC - 0 likes

    2012-04-09 21:56:43 [WARNING] [PermissionsBukkit] In group admin: bukkit.command.unban.ip is non-boolean (+3 more). How do I use this kind of Permissions. If it is non-Boolean. Any ideas?

  • Avatar of FiddyCraft FiddyCraft Apr 11, 2012 at 06:45 UTC - 0 likes

    @snowy007: Go

    that's the problem. I actually have to ADD them to default before they can use the commands and i have no clue why :/

  • Avatar of RobCheerio RobCheerio Apr 10, 2012 at 22:07 UTC - 0 likes


    If you make a mistake and break the config file, then reload the plugin it completely wipes the config.

I'm a poll!

  1. Choice:

  1. Results
  2. 36 comments


Date created
Aug 25, 2011
Last update
Mar 02, 2016
Development stage
  • enUS
MIT License
Curse link
Reverse relationships
Recent files