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

_ForgeUser8710160
- Join Date: 4/8/2012
- Posts: 11
- Member Details
#641 _ForgeUser8710160

View User Profile

Send Message

Posted Sep 13, 2012
@arkan01d

I figured it out! I had a tab on a blank line.

Rollback Post to Revision RollBack
_ForgeUser8710160
- Join Date: 4/8/2012
- Posts: 11
- Member Details
#640 _ForgeUser8710160

View User Profile

Send Message

Posted Sep 13, 2012
I want to let users claim land using mychunks addon. I was told to do that I had to use permissionsbukkit. So I wrote my config.yml as this: https://docs.google.com/document/d/1dwGXm671O6ocgd-Ypzo3e2heX_9GJyO7iEUt-Lw9_yE/edit

But I get this error every time: https://docs.google.com/document/d/1Q9DSxO7Y5c7q8Kco4Bjusdr5vkm1y5iJq2wOYG95maU/edit

Can someone please explain why this is happening? Sorry for the repost, but I wanted to make sure I could give as much info as possible

Rollback Post to Revision RollBack
_ForgeUser9599472
- Join Date: 9/10/2012
- Posts: 45
- Member Details
#639 _ForgeUser9599472

View User Profile

Send Message

Posted Sep 13, 2012
How can I get region buyers to build?

I have my permissions set up so that by default no one can build or destroy blocks. But I want players to be able to build/destroy blocks on regions that they have bought. How can I do this?

Rollback Post to Revision RollBack
_ForgeUser8710160
- Join Date: 4/8/2012
- Posts: 11
- Member Details
#638 _ForgeUser8710160

View User Profile

Send Message

Posted Sep 12, 2012
Installed permissionsbukkit which loaded successfully. Changed the default group to build true, which worked. Then added the line 'mychunk.claim: true' to default group and am getting a loading error from permissionsbukkit. 14:53:27 [INFO] [PermissionsBukkit] Enabling PermissionsBukkit v2.0 14:53:27 [SEVERE] [PermissionsBukkit] Failed to load configuration org.bukkit.configuration.InvalidConfigurationException: while scanning for the next token found character '\t' that cannot start any token in "<string>", line 36, column 1: mychunk.claim: true

I have mychunk installed and copy/pasted the command from their permissions commands.

Rollback Post to Revision RollBack
_ForgeUser9590357
- Join Date: 9/8/2012
- Posts: 15
- Member Details
#637 _ForgeUser9590357

View User Profile

Send Message

Posted Sep 11, 2012
is there a permission i can add into a group to allow the fly ability? i want it on for the moderator group.

Rollback Post to Revision RollBack
_ForgeUser7308370
- Join Date: 8/1/2011
- Posts: 310
- Member Details
#636 _ForgeUser7308370

View User Profile

Send Message

Posted Sep 8, 2012
I lolled way harder than I should have.

Good to see this plugin finally updated.

Rollback Post to Revision RollBack
_ForgeUser8678767
- Join Date: 4/2/2012
- Posts: 269
- Member Details
#635 _ForgeUser8678767

View User Profile

Send Message

Posted Sep 7, 2012
PermissionsBukkit rises from the graves!
It's most definitely my favourite permissions plugin :)

Last edited by _ForgeUser8678767: Sep 7, 2012

Rollback Post to Revision RollBack
_ForgeUser9571615
- Join Date: 9/5/2012
- Posts: 1
- Member Details
#634 _ForgeUser9571615

View User Profile

Send Message

Posted Sep 7, 2012
i configured perms like this http://pastebin.com/dewzKYYn but when i type perms reload in cmd it changes it in to this http://pastebin.com/RyhaZddN but the group paysan only has essentials perm the group citoyen 0 perm and the group modo 0 perm the only way to have the good perm is to be admin/modo and be op.Help me plz i don't know what to do.

Rollback Post to Revision RollBack
_ForgeUser7488350
- Join Date: 9/3/2011
- Posts: 108
- Member Details
#631 _ForgeUser7488350

View User Profile

Send Message

Posted Sep 6, 2012
EDIT: apologies this comment is now void, it was something I was doing wrong.

Last edited by _ForgeUser7488350: Sep 7, 2012

Rollback Post to Revision RollBack
_ForgeUser4929065
- Join Date: 8/31/2010
- Posts: 26
- Member Details
#630 _ForgeUser4929065

View User Profile

Send Message

Posted Sep 6, 2012
@brinaq

fixed http://pastebin.com/LS0KhChv

the problem was one of your permissions on your user didn't have a true or false haven't tested it but parser says its good to go

Also another note remove the permissions.example permissions from yourself.

Last edited by _ForgeUser4929065: Sep 6, 2012

Rollback Post to Revision RollBack
_ForgeUser7437840
- Join Date: 8/24/2011
- Posts: 8
- Member Details
#629 _ForgeUser7437840

View User Profile

Send Message

Posted Sep 5, 2012
@brinaq

Looks like you have your groups set up a little erroneously for one- your Moderator group inherits from 'user' but you have no 'user' group on there. (you have default, Moderator, and VIP)

Rollback Post to Revision RollBack
_ForgeUser8264104
- Join Date: 1/15/2012
- Posts: 88
- Member Details
#628 _ForgeUser8264104

View User Profile

Send Message

Posted Sep 5, 2012
Nobody has acces to any of the commands but the perms are all right!

Here's my config: https://docs.google.com/document/pub?id=1iWUN9IIM8KPmTRp0szy-dGRKO9LvKBsOdI5508Kodps

I tried debug, nothing. I reinstalled it, nothing. Please check that my config is formatted correctly! Thanks, I really need help, because last time I had this problem, I just made sure to add : true after every node, but now it already has true. I have backed up my config, and added the new one, nothing!

Last edited by _ForgeUser8264104: Sep 5, 2012

Rollback Post to Revision RollBack
_ForgeUser7606831
- Join Date: 9/25/2011
- Posts: 17
- Member Details
#626 _ForgeUser7606831

View User Profile

Send Message

Posted Sep 3, 2012
Update pleaseeee?

Rollback Post to Revision RollBack
_ForgeUser7631822
- Join Date: 10/1/2011
- Posts: 41
- Member Details
#625 _ForgeUser7631822

View User Profile

Send Message

Posted Sep 3, 2012
update :D ?

Rollback Post to Revision RollBack
_ForgeUser6844596
- Join Date: 5/19/2011
- Posts: 4
- Member Details
#624 _ForgeUser6844596

View User Profile

Send Message

Posted Sep 2, 2012
I realize that I'm probably doing something horribly wrong, but after I've set up my config.yml file, it works fine, no errors. However, when I try to add someone to a group, or view the groups list, this is what it gives me:

20:33:25 [SEVERE] org.bukkit.command.CommandException Unhandled exception execu
ting command 'permissions' in plugin PermissionsBukkit v1.6
20:33:25 [SEVERE] at org.bukkit.command.PluginCommand.execute(PluginComman
d.java:42)
20:33:25 [SEVERE] at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCo
mmandMap.java:168
20:33:25 [SEVERE] at org.bukkit.craftbukkit.CraftServer.dispatchCommand(Cr
aftServer.java:492
20:33:25 [SEVERE] at org.bukkit.craftbukkit.CraftServer.dispatchServerComm
and(CraftServer.java:488
20:33:25 [SEVERE] at net.minecraft.server.DedicatedServer.ah(DedicatedServ
er.java:248
20:33:25 [SEVERE] at net.minecraft.server.DedicatedServer.q(DedicatedServe
r.java:213)
20:33:25 [SEVERE] at net.minecraft.server.MinecraftServer.p(MinecraftServe
r.java:474)
20:33:25 [SEVERE] at net.minecraft.server.MinecraftServer.run(MinecraftSer
ver.java:406
20:33:25 [SEVERE] at net.minecraft.server.ThreadServerApplication.run(Sour
ceFile:539)
20:33:25 [SEVERE] Caused by: java.lang.NullPointerException
20:33:25 [SEVERE] at com.platymuus.bukkit.permissions.PermissionsCommand.g
roupCommand(PermissionsCommand.java:167
20:33:25 [SEVERE] at com.platymuus.bukkit.permissions.PermissionsCommand.o
nCommand(PermissionsCommand.java:146
20:33:25 [SEVERE] at org.bukkit.command.PluginCommand.execute(PluginComman
d.java:40)
20:33:25 [SEVERE] ... 8 more
20:33:25 [SEVERE] Encountered an unexpected exception CommandException
org.bukkit.command.CommandException Unhandled exception executing command 'perm
issions' in plugin PermissionsBukkit v1.6
   at org.bukkit.command.PluginCommand.execute(PluginCommand.java:42)
   at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:16
8)
   at org.bukkit.craftbukkit.CraftServer.dispatchCommand(CraftServer.java:4
92)
   at org.bukkit.craftbukkit.CraftServer.dispatchServerCommand(CraftServer.
java:488)
   at net.minecraft.server.DedicatedServer.ah(DedicatedServer.java:248)
   at net.minecraft.server.DedicatedServer.q(DedicatedServer.java:213)
   at net.minecraft.server.MinecraftServer.p(MinecraftServer.java:474)
   at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:406)
   at net.minecraft.server.ThreadServerApplication.run(SourceFile:539)
Caused by: java.lang.NullPointerException
   at com.platymuus.bukkit.permissions.PermissionsCommand.groupCommand(Perm
issionsCommand.java:167
   at com.platymuus.bukkit.permissions.PermissionsCommand.onCommand(Permiss
ionsCommand.java:146
   at org.bukkit.command.PluginCommand.execute(PluginCommand.java:40)
   ... 8 more
20:33:25 [SEVERE] This crash report has been saved to: C:\Minecraft\Server\Bukkit\.\crash-reports\crash-2012-09-02_20.33.25-
server.txt

My config.yml file is as follows:

users:
   ClassiestMedic:
   permissions:
   vanish.standard true
   vanish.op true
   vanish.*: true
   groups:
   - admin
groups:
   admin:
   permissions:
   punish.*: true
   inheritance:
   - member
   member:
   permissions:
   permissions.build true
   inheritance:
   - newbie
   newbie:
   permissions:
   permissions.build false
   inheritance:
   - default
messages:
   build: '&cYou do not have permission to do this!'

The only plugins I have installed are:
Punishmental
VanishNoPacket
and of course,
PermissionsBukkit

Last edited by _ForgeUser6844596: Sep 2, 2012

Rollback Post to Revision RollBack
_ForgeUser8965365
- Join Date: 5/31/2012
- Posts: 4
- Member Details
#623 _ForgeUser8965365

View User Profile

Send Message

Posted Sep 1, 2012
When ever I reload server the console says "[SEVERE] [PermisssionsBukkit] Unable to load configuration!" Can you fix this?

Last edited by _ForgeUser8965365: Sep 1, 2012

Rollback Post to Revision RollBack
_ForgeUser6850069
- Join Date: 5/20/2011
- Posts: 31
- Member Details
#622 _ForgeUser6850069

View User Profile

Send Message

Posted Aug 31, 2012
World permissions broken or am I doing something wrong? Everything works fine except for the world permissions, I've tried about everything... :/

Got more permissions but nothing warp/teleport related

groups: default: permissions: permissions.build: true essentials.signs.use.warp: true worlds: world_the_end: essentials.warp.spawn: true essentials.spawn: true
Rollback Post to Revision RollBack

_ForgeUser9477323

Join Date: 8/27/2012
Posts: 2
Member Details

#621 Posted Aug 27, 2012

Can we not have a default user config? I mean it just seems natural that you could?

Not quite sure in java, but in C you would use a switch statement to do what this does more or less and default would be one of the cases...

2012-08-27 21:18:42 [SEVERE] Permission node 'groups' in permissions.yml is invalid
java.lang.IllegalArgumentException: 'default' key contained unknown value
	at org.bukkit.permissions.Permission.loadPermission(Permission.java:269)
	at org.bukkit.permissions.Permission.loadPermissions(Permission.java:218)
	at org.bukkit.craftbukkit.CraftServer.loadCustomPermissions(CraftServer.java:603)
	at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:251)
	at net.minecraft.server.MinecraftServer.i(MinecraftServer.java:292)
	at net.minecraft.server.MinecraftServer.d(MinecraftServer.java:271)
	at net.minecraft.server.MinecraftServer.a(MinecraftServer.java:221)
	at net.minecraft.server.DedicatedServer.init(DedicatedServer.java:140)
	at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:376)
	at net.minecraft.server.ThreadServerApplication.run(SourceFile:539)

Using the file:

users:
    Ritgar:
        permissions:
            hsp.sethome: true
            hsp.home: true
        groups:
        - default
groups:
    default:
        permissions:
            permissions.build: true
            hsp.sethome: true
            hsp.home: true

_ForgeUser8280694
- Join Date: 1/19/2012
- Posts: 11
- Member Details
#620 _ForgeUser8280694

View User Profile

Send Message

Posted Aug 27, 2012
@Ritgar

Is 'default' a username or a group?

Because if it's a group do it like this:

users: Ritgar: permissions: hsp.sethome: true hsp.home: true groups: default: permissions: permissions.build: true hsp.sethome: true hsp.home: true

User permissions work under users. and group permissions work under groups. If you have a user named default, tell him I said hi. And then just make a separate group for default.
Rollback Post to Revision RollBack
_ForgeUser8513879
- Join Date: 3/1/2012
- Posts: 23
- Member Details
#619 _ForgeUser8513879

View User Profile

Send Message

Posted Aug 27, 2012
@Ritgar

Just use GroupManager for the permissions

Rollback Post to Revision RollBack
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

905,978
License

MIT License

Bukkit

PermissionsBukkit

Bukkit Plugins