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

_ForgeUser8678767
- Join Date: 4/2/2012
- Posts: 269
- Member Details
#703 _ForgeUser8678767

View User Profile

Send Message

Posted Nov 20, 2012
@dwdminecraft

Running 65 plugins, do I really need to list them all? :P

Server specs:

Intel E3-1245 (4 core HT 3.3-3.7GHz)
16GB ram (DDR3 1333MHz)
Extreme SSD 120GB SATA III (85,000 IOPS 450MB/sec)
Rollback Post to Revision RollBack
_ForgeUser7479062
- Join Date: 9/1/2011
- Posts: 47
- Member Details
#702 _ForgeUser7479062

View User Profile

Send Message

Posted Nov 19, 2012
@YoFuzzy3

What other plugins you have because our config.yml file has over 30,000 lines and it never freezes. Also what are your server specs.

Rollback Post to Revision RollBack
_ForgeUser9935739
- Join Date: 12/6/2016
- Posts: 230
- Member Details
#701 _ForgeUser9935739

View User Profile

Send Message

Posted Nov 18, 2012
@YotsugiOnonoki

Make sure the group you're in has "permissions.build: true"

Rollback Post to Revision RollBack
_ForgeUser9935739
- Join Date: 12/6/2016
- Posts: 230
- Member Details
#700 _ForgeUser9935739

View User Profile

Send Message

Posted Nov 18, 2012
Can you add a command to check what group a player is in?

Rollback Post to Revision RollBack

_ForgeUser9935739

Join Date: 12/6/2016
Posts: 230
Member Details

#699 Posted Nov 18, 2012

@smokie23

  member:
    permissions:
      permissionexample: true
    worlds:
      creative:
        essentials.gamemode: true
        essentials.fly: true
        essentials.heal: true
        essentials.ptime: true

Last edited by _ForgeUser9935739: Nov 18, 2012

_ForgeUser8095440
- Join Date: 12/17/2011
- Posts: 57
- Member Details
#698 _ForgeUser8095440

View User Profile

Send Message

Posted Nov 18, 2012
Anyone know If I can do world specific permissions with this?

It says "Support for global and per-world permissions." but how do I do it?

Last edited by _ForgeUser8095440: Nov 18, 2012

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

View User Profile

Send Message

Posted Nov 15, 2012
With as little as 10 players on, reloading the plugin freezes the server for a couple seconds, even longer if there are more players online. Is that just because my permissions file is almost 2000 lines long?

Rollback Post to Revision RollBack
_ForgeUser7479062
- Join Date: 9/1/2011
- Posts: 47
- Member Details
#694 _ForgeUser7479062

View User Profile

Send Message

Posted Nov 15, 2012
@KoBrA1135

I second this! Works perfect!

Rollback Post to Revision RollBack
_ForgeUser8340210
- Join Date: 1/30/2012
- Posts: 128
- Member Details
#693 _ForgeUser8340210

View User Profile

Send Message

Posted Nov 13, 2012
The Plugin works perfect. No errors and no updates hopefully (If SpaceManiac wants) I found no issues, but its a little bit strange on commands might cause some small tick delays if there is 50+ players on, but as far working fine :3

Rollback Post to Revision RollBack
_ForgeUser7905108
- Join Date: 11/19/2011
- Posts: 40
- Member Details
#692 _ForgeUser7905108

View User Profile

Send Message

Posted Nov 13, 2012
I CANT BUILD SHIT.

Rollback Post to Revision RollBack
_ForgeUser9514535
- Join Date: 8/30/2012
- Posts: 6
- Member Details
#691 _ForgeUser9514535

View User Profile

Send Message

Posted Nov 12, 2012
Just as a note for everyone: This plugin works seamlessly with the new builds of Bukkit, including 1.4.2. You do not need to wait for SpaceManiac to update this!

Rollback Post to Revision RollBack
_ForgeUser8668117
- Join Date: 3/31/2012
- Posts: 108
- Member Details
#690 _ForgeUser8668117

View User Profile

Send Message

Posted Nov 11, 2012
@ebickels440

Er... no one will be able to help you if you don't post your config file properly. Use http://pastebin.com

Run your file in a YAML parser, your error is a syntax error. http://ess.khhq.net/yaml/

Last edited by _ForgeUser8668117: Nov 11, 2012

Rollback Post to Revision RollBack
_ForgeUser8668117
- Join Date: 3/31/2012
- Posts: 108
- Member Details
#689 _ForgeUser8668117

View User Profile

Send Message

Posted Nov 11, 2012
@XxBoonexX

No, it's very possible. I'm talking about all the permissions.whatever nodes.

I seem to be unable to make any of the base bukkit commands work, like /plugin /version /gamerule, etc.

Rollback Post to Revision RollBack
_ForgeUser9844162
- Join Date: 10/20/2012
- Posts: 30
- Member Details
#688 _ForgeUser9844162

View User Profile

Send Message

Posted Nov 10, 2012
Pls, update to 1.4.2!

Rollback Post to Revision RollBack
_ForgeUser9955792
- Join Date: 11/10/2012
- Posts: 2
- Member Details
#687 _ForgeUser9955792

View User Profile

Send Message

Posted Nov 10, 2012
need some help with my server.

====== Begin .yml ======

users: ebickels440: permissions: permissions.*: true groups: - Owner raclsou permissions: permissions.*: true groups: - Admin Maisara permissions: permissions.*: true groups: - Admin groups: default: permissions: permissions.build: false craftbook.*: true essentials.afk: true essentials.back: true essentials.back.ondeath: true essentials.balance: true essentials.balance.others: true essentials.balancetop: true essentials.chat.color: true essentials.chat.shout: true essentials.chat.question: true essentials.compass: true essentials.depth: true essentials.home: true essentials.ignore: true essentials.kit: true essentials.kits.tools: true essentials.mail: true essentials.mail.send: true essentials.me: true essentials.msg: true essentials.nick: true essentials.pay: true essentials.ping: true essentials.powertool: true essentials.protect: true essentials.sethome: true essentials.signs.use.*: true essentials.signs.create.disposal: true essentials.signs.create.mail: true essentials.signs.create.protection: true essentials.signs.create.trade: true essentials.signs.break.disposal: true essentials.signs.break.mail: true essentials.signs.break.protection: true essentials.signs.break.trade: true essentials.suicide: true essentials.time: true essentials.tpa: true essentials.tpaccept: true essentials.tpahere: true essentials.tpdeny: true essentials.warp: true essentials.warp.list: true essentials.worth: true essentials.spawn: true essentials.rules: true essentials.list: true essentials.help: true herochat.leave.*: true herochat.join.*: true herochat.leave.*: true herochat.speak.*: true lockette.user.create.*: true mbr.user.*: true reporter.report: true turnstile.open: true welcomerulezz.rules: true WirelessRedstone.basics: true Moderator: Permissions: essentials.*: true herochat.mute: true herochat.join.*: true herochat.leave.*: true herochat.speak.*: true herochat.kick.*: true herochat.ban.*: true herochat.mute.*: true Punish.*: true rageban.*: true reporter.*: true turnstile.*: true inheritance: - default

admin: permissions: permissions.*: true commandspy.*: true craftbook.*: true herochat.*: true lockette.*: true mbr.*: true punish.*: true rageban.*: true reporter.*: true turnstile.*: true wirelessredstone.*: true Owner: permissions: permissions.*: true inheritance: - Admin messages: build: '&cYou do not have permission to build here.'

debug: false

====== End .yml ======

====== Begin Error ======

ERROR:

while scanning a simple key in "<unicode string>", line 36, column 5: raclsou ^ could not found expected ':' in "<unicode string>", line 37, column 20: permissions: ^

====== End Error ======

i cant figure it out

Rollback Post to Revision RollBack
_ForgeUser9287600
- Join Date: 7/25/2012
- Posts: 5
- Member Details
#686 _ForgeUser9287600

View User Profile

Send Message

Posted Nov 8, 2012
Hi. I'm really new to all of this and I'm trying to set permissions for a plugin on my server. I just got this plugin and was wondering if anyone could plz help me and explain how to use this. Thx :)

Rollback Post to Revision RollBack
_ForgeUser8299791
- Join Date: 1/22/2012
- Posts: 39
- Member Details
#685 _ForgeUser8299791

View User Profile

Send Message

Posted Nov 4, 2012
works without problem

Rollback Post to Revision RollBack
_ForgeUser9401908
- Join Date: 8/13/2012
- Posts: 406
- Member Details
#684 _ForgeUser9401908

View User Profile

Send Message

Posted Nov 4, 2012
Pls. UpDate to 1.4.2

Rollback Post to Revision RollBack
_ForgeUser7553320
- Join Date: 9/15/2011
- Posts: 83
- Member Details
#683 _ForgeUser7553320

View User Profile

Send Message

Posted Nov 4, 2012
btw does this by some chance work on 1.4 or are we still waiting on a new version?

Rollback Post to Revision RollBack
_ForgeUser7553320
- Join Date: 9/15/2011
- Posts: 83
- Member Details
#682 _ForgeUser7553320

View User Profile

Send Message

Posted Nov 4, 2012
a llist of permission nodes would be impossible, because its different depending what mods you add.

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