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 snowy007 snowy007 Apr 10, 2012 at 06:51 UTC - 0 likes

    @InsidiousDesign: Go

    Actually you are wrong about the indention.. At first i thought 4 spaces indention was wrong too. I fixed a lot of peoples configs back at the forum page and got ALL of them working. (except for 1 who refused to show his config as he is 100% sure it is not the problem, i don't agree with that though...) The last one however.. was literally over 9000 lines long with 4 spaces of indention each level. So before changing the indention on 9000 lines i tried to fix any other errors first. And it turned out (luckily) that it was working with 4 spaces indention too.

    Last edited Apr 10, 2012 by snowy007


  • Avatar of Themonkey180 Themonkey180 Apr 10, 2012 at 02:16 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.

  • Avatar of Switch0r Switch0r Apr 09, 2012 at 10:45 UTC - 0 likes

    Ok i changed to Group Manager.

  • Avatar of nonox97 nonox97 Apr 09, 2012 at 04:11 UTC - 0 likes

    1.2.5 :D

    On ne fait pas chier ceux qui font chier.

  • Avatar of InsidiousDesign InsidiousDesign Apr 09, 2012 at 00:37 UTC - 0 likes

    @beastzone: Go

    Yes, this is a bug. I just stopped using factions for this reason, and its really unneeded

  • Avatar of beastzone beastzone Apr 08, 2012 at 21:40 UTC - 0 likes

    for some reason when someone makes a faction it does this weird thing...i have simple prefix:

    factions and prefix mix up

    • faction_and_prefix_error.PNG
      picture of faction and prefix ...

    Check out my NEW temporary website for private services: Click Me!!! - Projects coming soon!

    command /HELP!!!:
    		message "Msg Beastzone With Your Problem =)"
    	#Anytime You need help, FOR SKRIPT ONLY
    		message ""
  • Avatar of ObsceneNameHere ObsceneNameHere Apr 08, 2012 at 02:47 UTC - 0 likes

    Im already switching over to bPermissions. This Author doesnt have a team to manage it so it will die out.

  • Avatar of InsidiousDesign InsidiousDesign Apr 08, 2012 at 00:21 UTC - 0 likes

    To everyone I seem to have found a fix. For every plugin, you must use their plugin.* node. You must use only two spaces instead of 4 for indents. You must name your starting group (Default group) to default. Prefix's must come from a 3rd party plugin (another plugin, i.e.- simpleprefix which gives you a node to add to the permissions). To promote a player you use /permissions player addgroup <player name> <group> THEN ALSO /permissions player removegroup <player name> <old group>. There must be NO blank lines in your config.yml. There must be no YML mistakes, double, triple and quadruple check. I hope this answers all of the questions that I have found so far because everything is working perfectly on my server. Best of luck -Wil

    # PermissionsBukkit configuration file
    # A permission node is a string like '', usually starting
    # with the name of the plugin. Refer to a plugin's documentation for what
    # permissions it cares about. Each node should be followed by true to grant
    # that permission or false to revoke it, as in ' true'.
    # Some plugins provide permission nodes that map to a group of permissions -
    # for example, PermissionsBukkit has 'permissions.*', which automatically
    # grants all admin permissions. You can also specify false for permissions
    # of this type.
    # Users inherit permissions from the groups they are a part of. If a user is
    # not specified here, or does not have a 'groups' node, they will be in the
    # group 'default'. Permissions for individual users may also be specified by
    # using a 'permissions' node with a list of permission nodes, which will
    # override their group permissions. World permissions may be assigned to
    # users with a 'worlds:' entry.
    # Groups can be assigned to players and all their permissions will also be
    # assigned to those players. Groups can also inherit permissions from other
    # groups. Like user permissions, groups may override the permissions of their
    # parent group(s). Unlike users, groups do NOT automatically inherit from
    # default. World permissions may be assigned to groups with a 'worlds:' entry.
        - default
        - admin
        - mod
        - member
        - trusted
        - member
        groups: []
          simpleprefix.default: true
          essentials.warp.tutorial: true
          essentials.warp: true
          essentials.spawn: true
          essentials.rules: true
          essentials.motd: true
          essentials.list: true
          essentials.helpop: true
          essentials.realname: true
          bukkit.broadcast.user: true
          essentials.home: true
          essentials.sethome: true
          essentials.afk: true
          essentials.kit: true
          essentials.list: true
          essentials.mail: true
          essentials.mail.send: true
          essentials.motd: true
          essentials.msg: true
          essentials.near: true
          essentials.realname: true
          essentials.rules: true
          essentials.spawn: true
          essentials.whois: true
          essentials.compass: true
          essentials.depth: true
          essentials.ignore: true
          essentials.suicide: true
          essentials.time: true
          essentials.tpa: true
          essentials.tpaccept: true
          essentials.tpahere: true
          essentials.tpdeny: true
          essentials.warp.list: true
          lockette.user.*: true
          lockette.user.create.*: true
          lockette.user.create.brewingstand: true
          lockette.user.create.chest: true
          lockette.user.create.custom: true
          lockette.user.create.dispenser: true
          lockette.user.create.door: true
          lockette.user.create.furnace: true
          lockette.user.create.trapdoor: true
          simpleprefix.member: true
          simpleprefix.default: false
          essentials.warp.reclaim: true
        - default
          simpleprefix.trusted: true
          simpleprefix.member: false
        - member
          permissions.*: true
          bukkit.*: true
          factions.*: true
          lockette.*: true
          vanish.*: true
          worldedit.*: true
          worldguard.*: true
          essentials.*: true
          simpleprefix.commands.*: true
          multiworld.*: true
          voxelport.*: true
          simpleprefix.admin: true
          simpleprefix.mod: false
          -essentials.backup: true
          -essentials.essentials: true
          -essentials.setspawn: true
          -essentials.reloadall: true
        - mod
          bukkit.command.ban: true
          bukkit.command.banip: true
          bukkit.command.banplayer: true
          bukkit.command.kick: true
          factions.kick: true
          factions.kick.any: true
          factions.kit.mod: true
          factions.mod: true
          factions.mod.any: true
          group.moderator: true
          simpleprefix.mod: true
          simpleprefix.trusted: false
*: true
          essentials.warp.*: true
          essentials.ban: true
          essentials.ban.notify: true
          essentials.banip: true
          essentials.broadcast: true
          essentials.clearinventory: true
          essentials.delwarp: true
          essentials.ext: true
          essentials.getpos: true
          essentials.helpop.recieve: true
          essentials.home.others: true
          essentials.invsee: true
          essentials.jails: true
          essentials.jump: true
          essentials.kick: true
          essentials.kick.notify: true
          essentials.kill: true
          essentials.mute: true
          essentials.nick.others: true
          essentials.realname: true
          essentials.setwarp: true
          essentials.spawner: true
          essentials.thunder: true
          essentials.time: true
          essentials.time.set: true
          essentials.ptime: true
          essentials.ptime.others: true
          essentials.togglejail: true
          essentials.tphere: true
          essentials.tppos: true
          essentials.tptoggle: true
          essentials.unban: true
          essentials.unbanip: true
          essentials.whois: true
            coolplugin.item: true
        - trusted
      build: '&cYou do not have permission to build here.'
    debug: false
  • Avatar of Switch0r Switch0r Apr 07, 2012 at 11:37 UTC - 0 likes

    Bump this new thread i made to fix the permissionsbukkit plugin :)

    Last edited Apr 07, 2012 by Switch0r
  • Avatar of Themonkey180 Themonkey180 Apr 06, 2012 at 00:44 UTC - 1 like

    2012-04-05 20:42:11 [INFO] [PermissionsBukkit] Enabling PermissionsBukkit v1.6 2012-04-05 20:42:11 [SEVERE] [PermissionsBukkit] Unable to load configuration! 2012-04-05 20:42:11 [INFO] [PermissionsBukkit] Enabled successfully, 0 players registered 2012-04-05 20:42:11 [INFO] [Vault][Permission] PermissionsBukkit hooked. 2012-04-05 20:42:11 [INFO] [Vault][Chat] iChat hooked.

    anyone know why this is happening.

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