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 Ironic8b49 Ironic8b49 Jan 12, 2015 at 06:08 UTC - 0 likes

    I tried to update my server from spigot 1.8 build #4 to Spigot 1.8 built #19 and PermissionsBukkit is the only plugin I use that gave me an error at boot. Is there a update coming soon?

    18:05:02] [Server thread/ERROR]: Error occurred while enabling PermissionsBukkit v2.4 (Is it up to date?) java.lang.NoSuchMethodError: org.bukkit.Server.getOnlinePlayers()[Lorg/bukkit/entity/Player; at com.platymuus.bukkit.permissions.PermissionsPlugin.onEnable( [?:?] at [craftbukkit.jar:git-Spigot-59b08be-0899683] at [craftbukkit.jar:git-Spigot-59b08be-0899683] at org.bukkit.plugin.SimplePluginManager.enablePlugin( [craftbukkit.jar:git-Spigot-59b08be-0899683] at org.bukkit.craftbukkit.v1_8_R1.CraftServer.loadPlugin( [craftbukkit.jar:git-Spigot-59b08be-0899683] at org.bukkit.craftbukkit.v1_8_R1.CraftServer.enablePlugins( [craftbukkit.jar:git-Spigot-59b08be-0899683] at net.minecraft.server.v1_8_R1.MinecraftServer.q( [craftbukkit.jar:git-Spigot-59b08be-0899683] at net.minecraft.server.v1_8_R1.MinecraftServer.k( [craftbukkit.jar:git-Spigot-59b08be-0899683] at net.minecraft.server.v1_8_R1.MinecraftServer.a( [craftbukkit.jar:git-Spigot-59b08be-0899683] at net.minecraft.server.v1_8_R1.DedicatedServer.init( [craftbukkit.jar:git-Spigot-59b08be-0899683] at [craftbukkit.jar:git-Spigot-59b08be-0899683] at [?:1.7.0_65]

    Last edited Jan 12, 2015 by Ironic8b49
  • Avatar of spetznack spetznack Jan 07, 2015 at 20:01 UTC - 0 likes

    Seems to work using Spigot 1.8  (git-Spigot-b8f6402-a646500) :)

    Last edited Jan 08, 2015 by spetznack
  • Avatar of willrocks77 willrocks77 Jan 03, 2015 at 05:03 UTC - 0 likes

    Hello, im a server owner and i like using this plugin but my prefix just stays at default.. i don't know what to do plzzzzzzz help me

  • Avatar of miki88mouse miki88mouse Nov 22, 2014 at 09:55 UTC - 0 likes

    So this plugin support the bungee cord? whil many people use now more servers and that future wil be nice to use one SQL AND MYSQL support so that all server will be used that database and synchronized at the same time when you add players in sme ranks example i added player in my "HUB server or in console" to rank Admin then system will be automaticaly added their in all other server automaicaly with database. (SQL and MySQL) support. This will be make a plugin very very useful and pro. Thanks

  • Avatar of NinjaSplat NinjaSplat Nov 16, 2014 at 18:25 UTC - 0 likes

    Will this plugin be ported over to Sponge? I need this plugin for my server. Hope you do!

  • Avatar of DaWe35 DaWe35 Oct 28, 2014 at 19:39 UTC - 0 likes

    I sended a security problem in a pm.

  • Avatar of S0N0FAS0N S0N0FAS0N Oct 22, 2014 at 02:34 UTC - 0 likes

    @Nypana: Go

    • Depends on what you are using, try {name} or {username} like in the following examples:
    • /perm setrank {name} VIP
    • or
    • /perm setrank {username} VIP
    • This should work in most cases (educated guess).
    Last edited Oct 22, 2014 by S0N0FAS0N
  • 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?

I'm a poll!

  1. Choice:

  1. Results
  2. 35 comments


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