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

_ForgeUser7914167
- Join Date: 11/20/2011
- Posts: 19
- Member Details
#103 _ForgeUser7914167

View User Profile

Send Message

Posted Dec 14, 2011
@Pythexx

Please change your message '&2DU MÅ IKKE BYGGE HER. FAT DET.' to another one,because ymls don't like this Å very much :) Check it also here: Click

Only copy and paste it into the box and it will show you the problems in this file.

@Skaales

You have to change the groups name to default.Then it will work,if they join they will added to the specified group.I think you can change this in the permissions.yml on your root.

Rollback Post to Revision RollBack
_ForgeUser6922010
- Join Date: 5/29/2011
- Posts: 67
- Member Details
#102 _ForgeUser6922010

View User Profile

Send Message

Posted Dec 13, 2011
@Encarton

the dev build for this plugin?

if so what is the link i cant find it

Rollback Post to Revision RollBack
_ForgeUser6922010
- Join Date: 5/29/2011
- Posts: 67
- Member Details
#101 _ForgeUser6922010

View User Profile

Send Message

Posted Dec 13, 2011
@frelling

to set a negative permission for essentials the node has to look like this

"-essentials.whatever: true"

this will override the .*

Rollback Post to Revision RollBack
Forge_User_40295477
- Join Date: 11/14/2011
- Posts: 1
- Member Details
#100 Forge_User_40295477

View User Profile

Send Message

Posted Dec 12, 2011
I keep getting this error while enabling PermissionsBukkit:

http://pastebin.com/U0p8wuWN

Heres my config file:

http://pastebin.com/rczUqrRd

Please help me, i relly like PB.

Last edited by Forge_User_40295477: Dec 12, 2011

Rollback Post to Revision RollBack
AdmiralSock
- Location: Scituate
- Join Date: 2/7/2008
- Posts: 2
- Member Details
#99 AdmiralSock

View User Profile

Send Message

Posted Dec 10, 2011
The Dev Build links are working for me.

Rollback Post to Revision RollBack
_ForgeUser7933350
- Join Date: 11/23/2011
- Posts: 7
- Member Details
#98 _ForgeUser7933350

View User Profile

Send Message

Posted Dec 10, 2011
How do i make is so when player <insert name here> joins but is not in a group, they get added to a specific group. Get what i mean?

Also, can you please make shorten version of command to add ppl to group?

/perm player setgroup <payer> <group> is too long.

something like this maybe, idk /perm group <player> <group>

Thanks

Rollback Post to Revision RollBack
Forge_User_23557759
- Join Date: 11/19/2011
- Posts: 17
- Member Details
#97 Forge_User_23557759

View User Profile

Send Message

Posted Dec 10, 2011
Updated for the version 1.0.0? Thank you

Rollback Post to Revision RollBack
_ForgeUser6902965
- Join Date: 5/27/2011
- Posts: 7
- Member Details
#96 _ForgeUser6902965

View User Profile

Send Message

Posted Dec 10, 2011
@frelling

thank you so much, even though I dint get half your explaination :P

Rollback Post to Revision RollBack
mrfrelling
- Join Date: 10/18/2008
- Posts: 70
- Member Details
#95 mrfrelling

View User Profile

Send Message

Posted Dec 9, 2011
@timetoslide

This is because Essentials does not define parent permissions for essentials.*, but rather performs an internal check. In your case, even though your player has essentials.item set to false, he also inherits essentials.* from the admin group. Because Essentials does not have a parent permission that defines what essentials.* means, it is added in its raw form.

When Essentials evaluates user permissions, it first breaks the permission being checked into its constituent nodes (i.e. 'essentials' and 'item') and then checks each to determine if there is a '.*' version registered with SuperPerms. Since you have essentials.* defined in the admin group, the check always passes and never gets an opportunity to check the actual value of essentials.item.

Your best solution is to either explicitly declare each Essentials permission, or create a parent permission in the root permissions.yml file that mimics what Essentials should have done in the first place. Granted, I'll give them some slack because they also have their own permissions system and this may have been the easiest approach to maintain maximum capabilities. Yet more fodder for the Essentials Love/Hate debate.

Rollback Post to Revision RollBack
mrfrelling
- Join Date: 10/18/2008
- Posts: 70
- Member Details
#94 mrfrelling

View User Profile

Send Message

Posted Dec 9, 2011
Anyone that is experiencing problems with parent permissions - defined by plugins or in the root permissions.yml file - not applying correctly, may want to read this forum post PB Parent Permissions Fix.

Rollback Post to Revision RollBack
_ForgeUser6902965
- Join Date: 5/27/2011
- Posts: 7
- Member Details
#93 _ForgeUser6902965

View User Profile

Send Message

Posted Dec 9, 2011
can someone tell me why 1337lucas can still spawn items? http://pastebin.com/wQbksfhx using CB#1566... Essentials Dev build

Last edited by _ForgeUser6902965: Dec 9, 2011

Rollback Post to Revision RollBack
_ForgeUser6875936
- Join Date: 5/23/2011
- Posts: 14
- Member Details
#92 _ForgeUser6875936

View User Profile

Send Message

Posted Dec 8, 2011
I'm still having troubles with the plugin. It's not giving new players a node when they join, and that's not even considering that it wont set them to the default group...

Rollback Post to Revision RollBack
_ForgeUser8022768
- Join Date: 12/5/2011
- Posts: 1
- Member Details
#91 _ForgeUser8022768

View User Profile

Send Message

Posted Dec 5, 2011
Hi, Im having issues with The permissions. All my nodes are correct and stuff, Console aggrees with me :) just when a player logs in, The server lags then there permissions dont work, The message im getting is 'Failed to run [player_join] to permissionsbukkit' or somthing. Please help, Its only been a problem since 1.0 upgrade. Im using Cb 1550 i think, its the newest build anyway. Released only >3 days ago

Last edited by _ForgeUser8022768: Dec 5, 2011

Rollback Post to Revision RollBack
_ForgeUser7112283
- Join Date: 7/1/2011
- Posts: 4
- Member Details
#90 _ForgeUser7112283

View User Profile

Send Message

Posted Dec 4, 2011
@dragontailxx

I use a plugin called setrankpb, and with it i can use this node to allow my moderators to rank players up, without them being able to make people higher classes.

setrankpb.rank.rank-goes-here: true

not sure what you do to rank people up, but this works or me..

Rollback Post to Revision RollBack
Hanse00
- Location: Dublin
- Join Date: 2/25/2010
- Posts: 2
- Member Details
#89 Hanse00

View User Profile

Send Message

Posted Dec 4, 2011
I think there should be separate nodes for building and interacting (eg. using doors, buttons and such)

I have a default rank on my server, for people that aren't "white listed" (not allowed to build) but I'd like them to be able to get out of the damn spawn building without having to have someone else come and let them out.

Rollback Post to Revision RollBack
_ForgeUser7263500
- Join Date: 7/25/2011
- Posts: 7
- Member Details
#88 _ForgeUser7263500

View User Profile

Send Message

Posted Dec 3, 2011
Is it just me or is the link to the new dev build not working

Rollback Post to Revision RollBack
_ForgeUser7966073
- Join Date: 11/29/2011
- Posts: 1
- Member Details
#87 _ForgeUser7966073

View User Profile

Send Message

Posted Nov 28, 2011
Is there any way using PermissionsBukkit alone to enable a group to only be able to set a user to a certain group. For example, my server uses a default group called newbie that has the build permission set to false, for them to be capable of building, one of my moderators or admins has to put them to the builder class, can I force it so moderators can ONLY elevate them to the builder class to avoid a moderator elevating themselves to admin randomly and editing the server's more specific functions?

Rollback Post to Revision RollBack
_ForgeUser6913417
- Join Date: 5/28/2011
- Posts: 26
- Member Details
#86 _ForgeUser6913417

View User Profile

Send Message

Posted Nov 28, 2011
@Liger_XT5

Im using CB 1337 and when you say they need to be indented once more, do you mean like below?

groups: Default: permissions: essentials.afk: true essentials.back: true essentials.back.*: true essentials.help: true essentials.home: true

and so on? Or does it also need a dash (-) like the example below?

groups: Default: permissions: - essentials.afk: true - essentials.back: true - essentials.back.*: true - essentials.help: true - essentials.home: true

regards Dave

Last edited by _ForgeUser6913417: Nov 28, 2011

Rollback Post to Revision RollBack
LigerXT5
- Location: USA
- Join Date: 5/21/2008
- Posts: 686
- Member Details
#85 LigerXT5

View User Profile

Send Message

Posted Nov 28, 2011
@groveham

What CB build are you using?

Also, all the permissions need to be indented once more from the permissions line. As so: Name/Group-Name: permissions: Plugin.subnode: true

The leaving error is a normal MC error, usually means the player's client crashed or a normal network issue reared it's ugly head. No fixes for either. Just log back into the server again.

Rollback Post to Revision RollBack

_ForgeUser6913417

Join Date: 5/28/2011
Posts: 26
Member Details

#84 Posted Nov 27, 2011

I have this error in my log when ever a player leaves the server, also players cannot access commands yet admins (who are opp'ed) can. I will paste my config file below the error. I hope someone can help. I was using permissions x3 but its inactive now =/ Also im running cb 1337. I thought the problem may be because users are not automatically added to the config file when they join for the first time, is there anyway to do this?

2011-11-27 18:32:27 [INFO] Connection reset 2011-11-27 18:32:27 [SEVERE] java.net.SocketException: Socket closed 2011-11-27 18:32:27 [INFO] tomgleave lost connection: disconnect.quitting 2011-11-27 18:32:27 [SEVERE] at java.net.SocketOutputStream.socketWrite(Unknown Source) 2011-11-27 18:32:27 [SEVERE] at java.net.SocketOutputStream.write(Unknown Source) 2011-11-27 18:32:27 [SEVERE] at java.io.BufferedOutputStream.flushBuffer(Unknown Source) 2011-11-27 18:32:27 [SEVERE] at java.io.BufferedOutputStream.flush(Unknown Source) 2011-11-27 18:32:27 [SEVERE] at java.io.DataOutputStream.flush(Unknown Source) 2011-11-27 18:32:27 [SEVERE] at net.minecraft.server.NetworkWriterThread.run(SourceFile:104)

CONFIG FILE:

users:
    Groveham:
        permissions:
            permissions.example: true
        groups:
        - admin
    joeypunkrock:
        permissions:
        groups:
        - Admin
    Browneyelaaa:
        permissions:
        groups:
        - Admin
groups:
    Default:
        permissions:
        essentials.afk: true
        essentials.back: true
        essentials.back.*: true
        essentials.help: true
        essentials.home: true
        essentials.list: true
        essentials.me: true
        essentials.msg: true
        essentials.pay: true
        essentials.rules: true
        essentials.spawn: true
        essentials.seen: true
        essentials.top: true
        essentials.tpa: true
        essentials.tpaccept: true
        essentials.tpdeny: true
        essentials.tpahere: true
        essentials.warp: true
        essentials.warp.list: true
        essentials.balance: true
        essentials.balancetop: true
        essentials.pay: true
        essentials.delhome: true
        lockette.user.create.*: true
        ChestShop.shop.buy: true
        ChestShop.shop.sell: true
        ChestShop.shop.create: true
        uhome.own.warp: true
        uhome.own.set: true
        uhome.own.delete: true
        uhome.own.list: true
        mcmmo.ability.*: true
        mcmmo.item.*: true
        mcmmo.skills.*: true
        mcmmo.commands.party: true
        mcmmo.chat.partychat: true
    permissions.build: true
    Moderator:
        permissions:
        essentials.ban: true
        essentials.banip: true
        essentials.tempban: true
        essentials.jail: true
        essentials.jails: true
        essentials.kick: true
        essentials.kick.notify: true
        essentials.togglejail: true
        essentials.tp: true
        essentials.unban: true
        essentials.unbanip: true
        worldedit.wand: true
        worldedit.expand: true
        worldedit.selection.*: true
        worldguard.region.addmember.*: true
        worldguard.region.addowner.*: true
        worldguard.region.define: true
        worldguard.region.info.*: true
        worldguard.region.redefine.*: true
        worldguard.region.redefine.member.*: true
        worldguard.region.redefine.own.*: true
        worldguard.region.removeowner.*: true
        worldguard.region.removemember.*: true
        worldguard.region.setparent.*: true
        worldguard.region.setpriority.*: true
        worldguard.region.remove.*: true
        inheritance:
        - Normal User
    Admin:
        permissions:
        permissions.*: true
        lockette.*: true
        essentials.backup: true
        essentials.essentials: true
        essentials.setspawn: true
        essentials.reloadall: true
        essentials.plugin: true
        essentials.*: true
        worldedit.*: true
        worldguard.*: true
        ChestShop.*: true
        logblock.tools.tool: true
        logblock.tools.toolblock: true
        milkadmin.*: true
        uhome.*: true
        uhome.admin.reload: true
        vanish.*: true
        permissions.build: true
        inheritance:
        - Moderator
messages:
    build: '&cYou do not have permission to build here.'

Last edited by _ForgeUser6913417: Nov 27, 2011

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

902,703
License

MIT License

Bukkit

PermissionsBukkit

Bukkit Plugins