PermissionsBukkit

Table of Contents

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)

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

Comments

cowchicken21
- Join Date: 1/15/2018
- Posts: 1
- Member Details
#1082 cowchicken21

View User Profile

Send Message

Posted Jan 15, 2018
But, Is possible set prefix?

Rollback Post to Revision RollBack
_ForgeUser25870517
- Join Date: 6/25/2016
- Posts: 1
- Member Details
#1081 _ForgeUser25870517

View User Profile

Send Message

Posted Feb 8, 2017
Hi, is prefixes a thing in this plugin?

Rollback Post to Revision RollBack
_ForgeUser12025173
- Join Date: 8/13/2013
- Posts: 63
- Member Details
#1080 _ForgeUser12025173

View User Profile

Send Message

Posted Nov 28, 2016
Hi, does it work in 1.11? Thank you for your work on this great and very usefull plugin!

Rollback Post to Revision RollBack
Forge_User_18246922
- Join Date: 6/15/2016
- Posts: 3
- Member Details
#1079 Forge_User_18246922

View User Profile

Send Message

Posted Sep 30, 2016
how i can crate a new group

Rollback Post to Revision RollBack
TrivalentClanMizar
- Join Date: 12/11/2012
- Posts: 11
- Member Details
#1078 TrivalentClanMizar

View User Profile

Send Message

Posted Aug 27, 2016
@Mizar6

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

Rollback Post to Revision RollBack
TrivalentClanMizar
- Join Date: 12/11/2012
- Posts: 11
- Member Details
#1077 TrivalentClanMizar

View User Profile

Send Message

Posted Aug 21, 2016
@Adamon69

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.

Rollback Post to Revision RollBack
Tarluin
- Location: College Station
- Join Date: 10/12/2010
- Posts: 60
- Member Details
#1076 Tarluin

View User Profile

Send Message

Posted Aug 10, 2016
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?

Rollback Post to Revision RollBack
Xanadar
- Location: Ponderay
- Join Date: 10/3/2007
- Posts: 113
- Member Details
#1075 Xanadar

View User Profile

Send Message

Posted Aug 2, 2016
@Chevels

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

Rollback Post to Revision RollBack
_ForgeUser12025173
- Join Date: 8/13/2013
- Posts: 63
- Member Details
#1074 _ForgeUser12025173

View User Profile

Send Message

Posted Jul 15, 2016
Hello, Does it work for 1.10?

Rollback Post to Revision RollBack

_ForgeUser8613887

Join Date: 3/20/2012
Posts: 1
Member Details

#1073 Posted Jun 17, 2016

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]

_ForgeUser9936133
- Join Date: 11/6/2012
- Posts: 131
- Member Details
#1072 _ForgeUser9936133

View User Profile

Send Message

Posted Jun 12, 2016
@zsuzsu

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

Rollback Post to Revision RollBack
_ForgeUser9936133
- Join Date: 11/6/2012
- Posts: 131
- Member Details
#1071 _ForgeUser9936133

View User Profile

Send Message

Posted Jun 12, 2016
@KamoMc15

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..

Rollback Post to Revision RollBack
_ForgeUser24299356
- Join Date: 4/2/2016
- Posts: 3
- Member Details
#1070 _ForgeUser24299356

View User Profile

Send Message

Posted Apr 5, 2016
how do I use worldedit nodes

Rollback Post to Revision RollBack
_ForgeUser24269106
- Join Date: 3/31/2016
- Posts: 1
- Member Details
#1069 _ForgeUser24269106

View User Profile

Send Message

Posted Mar 30, 2016
How can i add/create a new group

Rollback Post to Revision RollBack
Xanadar
- Location: Ponderay
- Join Date: 10/3/2007
- Posts: 113
- Member Details
#1068 Xanadar

View User Profile

Send Message

Posted Mar 29, 2016
@ElectronicDragon115

Works great for 1.9.

Rollback Post to Revision RollBack
_ForgeUser24239346
- Join Date: 3/28/2016
- Posts: 1
- Member Details
#1067 _ForgeUser24239346

View User Profile

Send Message

Posted Mar 28, 2016
Minecraft 1.9?

Rollback Post to Revision RollBack
_ForgeUser21584793
- Join Date: 8/28/2015
- Posts: 4
- Member Details
#1066 _ForgeUser21584793

View User Profile

Send Message

Posted Mar 28, 2016
How do i set perms for commands?

Rollback Post to Revision RollBack
_ForgeUser23790816
- Join Date: 2/21/2016
- Posts: 5
- Member Details
#1065 _ForgeUser23790816

View User Profile

Send Message

Posted Mar 21, 2016
How do I make prefixes?

Rollback Post to Revision RollBack
_ForgeUser9936133
- Join Date: 11/6/2012
- Posts: 131
- Member Details
#1064 _ForgeUser9936133

View User Profile

Send Message

Posted Mar 6, 2016
@Kalle801

This is how I do it in my config, this works -

  default:
   permissions:
   permission.node false\true
   worlds:
   worldname:
   permission:node: false\true

I think the config is read from top to bottom- so I think it will work for you if you set someone to have that permission as true under "permissions:", then have it as false under "<worldname:>"

Rollback Post to Revision RollBack

Xanadar

Location: Ponderay
Join Date: 10/3/2007
Posts: 113
Member Details

#1063 Posted Mar 1, 2016

Seems to be having issues with 1.9 spigot/bukkit?

[00:16:40] [Server thread/INFO]: [PermissionsBukkit] Enabling PermissionsBukkit v2.4
[00:16:40] [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(PermissionsPlugin.java:53) ~[?:?]
	at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:291) ~[spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:340) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:405) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at org.bukkit.craftbukkit.v1_9_R1.CraftServer.loadPlugin(CraftServer.java:361) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at org.bukkit.craftbukkit.v1_9_R1.CraftServer.enablePlugins(CraftServer.java:321) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at net.minecraft.server.v1_9_R1.MinecraftServer.t(MinecraftServer.java:411) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at net.minecraft.server.v1_9_R1.MinecraftServer.l(MinecraftServer.java:376) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at net.minecraft.server.v1_9_R1.MinecraftServer.a(MinecraftServer.java:331) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at net.minecraft.server.v1_9_R1.DedicatedServer.init(DedicatedServer.java:269) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at net.minecraft.server.v1_9_R1.MinecraftServer.run(MinecraftServer.java:522) [spigot_1.9_latest.jar:git-Spigot-ee4e41a-ea28c1e]
	at java.lang.Thread.run(Unknown Source) [?:1.8.0_73]

Last edited by Xanadar: Mar 1, 2016

To post a comment, please login or register a new account.

Project ID

31046
Created

Aug 24, 2011
Last Released File

Mar 1, 2016
Total Downloads

900,565
License

MIT License

Bukkit

PermissionsBukkit

Bukkit Plugins