PermissionsBukkit - the Official Default Groups Plugin
Current Version: v2.0 (beta v2.2)
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.0 (jar) (details)
Beta Version:
PermissionsBukkit v2.2 beta (details)
Old Versions:
PermissionsBukkit v1.6 (jar) (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 MCTylerPVP MCTylerPVP Apr 04, 2014 at 10:55 UTC - 0 likes

    @DarkJambon: Go

    I've never used Hero chat either...Thats part of Factions so it would be in the Faction Json file in MStore...Let me know if you figure it out, I might set that up!

    MC Client WebPage

  • Avatar of MCTylerPVP MCTylerPVP Apr 03, 2014 at 09:10 UTC - 0 likes

    I stand with Ironhippy, I have been using this system for 8 months now please don't abandon it!

  • Avatar of Ironhippy Ironhippy Mar 31, 2014 at 22:13 UTC - 1 like

    Hello SpaceManiac, this plugin has proven to be a very stable plugin for many servers throughout the Bukkit community. As you may know, the UUID system in Bukkit & Minecraft has the potential of breaking this plugin in the 1.8.1 release. I am hoping that this is updated in time for that implementation. I wish you good luck and take as much time needed to recreate this plugin for the coming changes!

    Valdaycraft Owner/Developer/manager. :)

  • Avatar of DarkJambon DarkJambon Mar 13, 2014 at 14:10 UTC - 0 likes

    Hello everyone !

    My question is: is there any way to have in game chat colored groups using this perm' plug' ?

    For example:


    default: beiing gray

    admin: beiing red


    I also have HeroChat installed, but I do not know how to set what I want using it

    Thank you for your answers ! :D

    Last edited Mar 13, 2014 by DarkJambon
  • Avatar of astrauss11 astrauss11 Mar 09, 2014 at 17:57 UTC - 0 likes

    Please help, i'm on version 2.2 and  CraftBukkit 1.7.2-R0.3 and astrauss has no permissions without OP.

        - admin
        - permissions.*: true
        - worldedit.*: true
        - bukkit.*: true
        - ipcheck.*: true
        - OpenInv.*: true
        - teleport.*: true
        - user

        - default
      build: '&cYou do not have permission to do this.'

    It does say:
    [INFO]: [PermissionsBukkit] Debug: Calculated permissions on astrauss:
    0 values

    Last edited Mar 09, 2014 by astrauss11: More info
  • Avatar of armorking87 armorking87 Mar 09, 2014 at 12:58 UTC - 0 likes

    Hi guys, I have a problem with perms. My default players can't use bukkit commands like tell, me, help, give. I wrote in config.yml "bukkit.command.tell: true" but it doesn't work, How it can be fixed?

  • Avatar of UXRO UXRO Mar 08, 2014 at 17:56 UTC - 0 likes

    Hey guys. I would need some one to tell me what is wrong. I was looking around to post a problem but idk where to find form for it. Any way i have no bug report or anything but this is now happening for few days.

    So random player lose all permissions he had and can't even use /help or any other command. Then he has to close his minecraft and re-open it.. Any one know how to fix that? Because it keeps happening to players even that i just update this to latest build.

  • Avatar of Skyost Skyost Feb 09, 2014 at 16:48 UTC - 0 likes

    @crazybarracks: Go

    PasteBin isn't for noobs...

  • Avatar of crazybarracks crazybarracks Jan 23, 2014 at 13:54 UTC - 0 likes

    hi, i use pex and i cant use anything without op so i put this plugin and doesnt work please help These are the permissionsEX groups: default: default: true options: rank: '1000' permissions: - Member: prefix: '&0(&8M&7ember&0)&7 ' permissions: - modifyworld. - builder - modifyworld.chak - essentials.warps.* - essentials.warp.list - essentials.warp - essentials.tpdeny - essentials.tpahere - essentials.tpaccept - essentials.tpa - - essentials.whois - essentials.suicide - essentials.recipe - essentials.msg - essentials.mail.send - essentials.mail - essentials.list - essentials.helpop -[pluginname] - - essentials.afk - '''*''' options: rank: '900' worlds: 'true': permissions: - VIP: prefix: '&0(&eVIP&0)&7 ' permissions: - essentials.nick - essentials.gamemode - - modifyworld.* options: rank: '800' Moderator: prefix: '&0(&1Moderator&0)&7 ' permissions: - -modifyworld.mobtarget.* - modifyworld.* options: rank: '100' Admins: prefix: '&0(&4Admins&0)&7 ' permissions: - essentials.keepxp - essentials.worlds.<worldname> - essentials.back.ondeat - essentials.back - essentials.time.set - essentials.time - - essentials.spawnmob.[mob] - essentials.spawnmob - essentials.burn - essentials.nick.color - essentials.nick - essentials.heal - essentials.god - essentials.give - essentials.gamemode - - - -modifyworld.mobtarget.* - modifyworld.* - permissions.* options: rank: '2' CREADOR: options: rank: '1' prefix: '&0(&1CREA&4DOR&0)&7 ' permissions: - bukkit.command.gamemode - bukkit.command.enchant - - bukkit.command.clear - bukkit.command.time.set - bukkit.command.plugins - heads.version - heads.nick - heads.reload - heads.give - heads.addnamed - heads.addown - modifyworld.* - permissions.* - modifyworld.mobtarget.* - '''*''' worlds: 'true': permissions: - salvascott2002: worlds: VIP: permissions: - rank users: AnotherPlayer: group: - default YourPlayerName: group: - Admins and these the permissionsbukkit

    1. PermissionsBukkit configuration file
    2. A permission node is a string like '', usually starting
    3. with the name of the plugin. Refer to a plugin's documentation for what
    4. permissions it cares about. Each node should be followed by true to grant
    5. that permission or false to revoke it, as in ' true'.
    6. Some plugins provide permission nodes that map to a group of permissions -
    7. for example, PermissionsBukkit has 'permissions.*', which automatically
    8. grants all admin permissions. You can also specify false for permissions
    9. of this type.
    10. Users inherit permissions from the groups they are a part of. If a user is
    11. not specified here, or does not have a 'groups' node, they will be in the
    12. group 'default'. Permissions for individual users may also be specified by
    13. using a 'permissions' node with a list of permission nodes, which will
    14. override their group permissions. World permissions may be assigned to
    15. users with a 'worlds:' entry.
    16. Groups can be assigned to players and all their permissions will also be
    17. assigned to those players. Groups can also inherit permissions from other
    18. groups. Like user permissions, groups may override the permissions of their
    19. parent group(s). Unlike users, groups do NOT automatically inherit from
    20. default. World permissions may be assigned to groups with a 'worlds:' entry.
    21. The cannot-build message is configurable. If it is left blank, no message
    22. will be displayed to the player if PermissionsBukkit prevents them from
    23. building, digging, or interacting with a block. Use '&' characters to
    24. signify color codes.

    users: ConspiracyWizard: permissions: permissions.example: true groups: - admin groups: default: permissions: false admin: permissions: permissions.*: true inheritance: - user user: permissions: true worlds: creative: coolplugin.item: true inheritance: - default messages: build: '&cYou do not have permission to build here.'

    debug: false

  • Avatar of mrtnt200 mrtnt200 Jan 22, 2014 at 14:51 UTC - 0 likes

    @NobleStrike: Go


    I am sorry if you dont like how this plugin was uploaded for version 1.5.2 but the reason it hasent been updated is becuase there is no reason to... it works fine with all versions of minecraft at this moment. we will update this plugin when there is a need for it.


I'm a poll!

  1. Choice:

  1. Results
  2. 29 comments


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