PermissionsBukkit

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.

Features:

  • 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 "permissions.build" node (defaults to allowing anyone to build).

Downloads:
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)

http://i.imgur.com/NOZPK.png

Other Important Information:
Commands
Configuration
FAQ

Changelog:
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

http://api.mcstats.org/signature/PermissionsBukkit.png

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Mizar6 Mizar6 Aug 27, 2016 at 17:53 UTC - 0 likes

    @Mizar6: Go

    Looked at the code, "default" group is hard coded in three places in the main file, for my purposes I just changed it there and complied it with Eclipse following the directions for a blank Spigot plugin. Works fine in 1.10.2

  • Avatar of Mizar6 Mizar6 Aug 21, 2016 at 21:27 UTC - 0 likes

    @Adamon69: Go

    Players are in the group "default" when they join, I had a friend make a plugin to move them into the group I wanted them to start in. But it could be we're just missing the point. Need to look at the code a bit, perhaps the first group in the configure file is the default group regardless of what it is called. Might be easier to just test.

  • Avatar of Adamon69 Adamon69 Aug 10, 2016 at 18:53 UTC - 1 like

    What would be the best way for players to have permissions when they first login, would i need to add everything from user to default, or do I need to get/make a plugin to add them to a group when they log on for the first time?

  • Avatar of softvelvet softvelvet Aug 02, 2016 at 14:46 UTC - 1 like

    @Chevels: Go

    Yes, I have no issues with it working, so far on 1.10

  • Avatar of Chevels Chevels Jul 15, 2016 at 15:43 UTC - 0 likes

    Hello, Does it work for 1.10?

    My server: "Sur les Ruines d' Heavy-Craft" Aka "Heavy-Craft Reloaded", since March 2011!

  • Avatar of SimplisticBeing SimplisticBeing Jun 17, 2016 at 07:42 UTC - 0 likes

    Finally updated everything to 1.9.4. So far everything is working as it should, but am receiving these errors. I've deleted the config.yml file and started from scratch, this still (and even though all permissions and groups work as they should) shows these errors. Please let me know if it matters and if it can be fixed another way. Thanks.

     Permission node 'groups' in D:\_Server Minecraft\1.9.4\plugins\PermissionsBukkit\config.yml is invalid
    java.lang.IllegalArgumentException: 'default' key contained unknown value
            at org.bukkit.permissions.Permission.loadPermission(Permission.java:294) ~[spigot.jar:git-Spigot-798f32d-0cd0397]
            at org.bukkit.permissions.Permission.loadPermissions(Permission.java:233) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at org.bukkit.craftbukkit.v1_9_R2.CraftServer.loadCustomPermissions(CraftServer.java:797) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at org.bukkit.craftbukkit.v1_9_R2.CraftServer.enablePlugins(CraftServer.java:333) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.MinecraftServer.t(MinecraftServer.java:416) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.MinecraftServer.l(MinecraftServer.java:381) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.MinecraftServer.a(MinecraftServer.java:336) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.DedicatedServer.init(DedicatedServer.java:268) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.MinecraftServer.run(MinecraftServer.java:532) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at java.lang.Thread.run(Unknown Source) [?:1.8.0_91]
    [03:13:08 ERROR]: Permission node 'debug' in D:\_Server Minecraft\1.9.4\plugins\PermissionsBukkit\config.yml is invalid
    java.lang.ClassCastException: java.lang.Boolean cannot be cast to java.util.Map
            at org.bukkit.permissions.Permission.loadPermissions(Permission.java:233) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at org.bukkit.craftbukkit.v1_9_R2.CraftServer.loadCustomPermissions(CraftServer.java:797) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at org.bukkit.craftbukkit.v1_9_R2.CraftServer.enablePlugins(CraftServer.java:333) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.MinecraftServer.t(MinecraftServer.java:416) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.MinecraftServer.l(MinecraftServer.java:381) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.MinecraftServer.a(MinecraftServer.java:336) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.DedicatedServer.init(DedicatedServer.java:268) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at net.minecraft.server.v1_9_R2.MinecraftServer.run(MinecraftServer.java:532) [spigot.jar:git-Spigot-798f32d-0cd0397]
            at java.lang.Thread.run(Unknown Source) [?:1.8.0_91]
    
  • Avatar of spetznack spetznack Jun 12, 2016 at 12:07 UTC - 0 likes

    @zsuzsu: Go

    Use the permission nodes here: http://wiki.sk89q.com/wiki/WorldEdit/Permissions

    To give permissions you can either use the ingame /perm command or you can edit your /plugins/PermissionsBukkit/config.yml file. See http://dev.bukkit.org/bukkit-plugins/permbukkit/pages/configuration/ for an example on how this can be done :)

  • Avatar of spetznack spetznack Jun 12, 2016 at 11:45 UTC - 0 likes

    @KamoMc15: Go

    See the info page here: http://dev.bukkit.org/bukkit-plugins/permbukkit/pages/configuration/ Copy that into your /plugins/PermissionsBukkit/config.yml and you can then change the groupname "admin" and "user" to whatever you want and you can add as many groups as you want as well - just use the example in the link above as a template :)

    All players who join will by default be in the group called "default", you can check a player's group useing /perm player groups [playername or UUID]. To set a player to a specific group and only that group, use: /perm player setgroup [playername or UUID] [groupname]

    To add a group to a player use: /perm player addgroup [playername or UUID] [groupname]

    That's the basics of groups..

  • Avatar of zsuzsu zsuzsu Apr 05, 2016 at 19:28 UTC - 0 likes

    how do I use worldedit nodes

  • Avatar of KamoMc15 KamoMc15 Mar 31, 2016 at 05:56 UTC - 0 likes

    How can i add/create a new group

I'm a poll!

  1. Choice:

  1. Results
  2. 36 comments

Facts

Date created
Aug 25, 2011
Categories
Last update
Mar 02, 2016
Development stage
Release
Language
  • enUS
License
MIT License
Curse link
PermissionsBukkit
Reverse relationships
22
Downloads
922,781
Recent files

Authors