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

_ForgeUser7568317

Join Date: 9/18/2011
Posts: 64
Member Details

#431 Posted Apr 22, 2012

can you guys build in that grouped permission nodes like so:

groups:
  user:
    permissions:
      commandbook:
        who: true
        motd: true
        rules: true
        time.check: true
        spawn: false
      bukkit.command:
        tell: true
        kill: true
        me: true
        save.perform: true
        list: true
        version: true
        plugins: true
    worlds:
      CreaSky:
        worldedit:
          wand: true
          history.undo: true
          region:
            set: true
            replace: true
          selection:
            outset: true
            inset: true
            expand: true
            contract: true
            pos: true
            hpos: true
          navigation:
            unstuck: true
            ascend: true
            descend: true
            thru: true

stay that way after permissions reload. It currently does know how to handle it if I enter it like so, but it displays an error and edits everything back to normal nodes. I find this way would increase readability of the permissions file

vasvadum
- Location: Garfield
- Join Date: 11/8/2010
- Posts: 86
- Member Details
#430 vasvadum

View User Profile

Send Message

Posted Apr 21, 2012
http://ft.trillian.im/vasvadum/676xBvcdT-TI9vfKhRit.jpg
I finally found out why my permissions are so screwed up, permissionsbukkit doesn't work right. :/

Last edited by vasvadum: Apr 21, 2012

Rollback Post to Revision RollBack
_ForgeUser8036318
- Join Date: 12/7/2011
- Posts: 21
- Member Details
#429 _ForgeUser8036318

View User Profile

Send Message

Posted Apr 21, 2012
@SpaceManiac

Good day,

I am writing in reference to MCMA and Perms Bukkit.

I'd like to use world specific permissions.

Is there something in the works so I can do something like:

World1.node.* World1.node2.* World2.node1.*

Rollback Post to Revision RollBack
_ForgeUser7629212
- Join Date: 9/30/2011
- Posts: 95
- Member Details
#428 _ForgeUser7629212

View User Profile

Send Message

Posted Apr 19, 2012
@woodendinosaur

I changed the nested parent/children and that remedied the error.

Rollback Post to Revision RollBack
_ForgeUser7629212
- Join Date: 9/30/2011
- Posts: 95
- Member Details
#427 _ForgeUser7629212

View User Profile

Send Message

Posted Apr 19, 2012
does anyone else here have issues using permissions.yml in the root folder using bukkit 1.2.5-r-1? If someone does use this file successfully, could you post a link to a pastebin of yours as a reference? I have had it working in the past, but I don't know if it is not working due to plugin not updated or user error. The error in question i am receiving is... permission node 'blah.blah' in server config is invalid java.lang.stackoverflow .... then the spam relative to PermissibleBase. Thanks in advance.

Edit: I may have found the problem if anyone can confirm or deny. Is it legal to have parents listed as children in other parent nodes? Because I do. I am thinking that is the error.

Last edited by _ForgeUser7629212: Apr 19, 2012

Rollback Post to Revision RollBack
_ForgeUser8764972
- Join Date: 4/18/2012
- Posts: 6
- Member Details
#426 _ForgeUser8764972

View User Profile

Send Message

Posted Apr 19, 2012
We are suppose to post our problems here for support right?

Rollback Post to Revision RollBack

_ForgeUser8764972

Join Date: 4/18/2012
Posts: 6
Member Details

#425 Posted Apr 18, 2012

Sorry that post didn't work as planned, lol.

groups:
    default:
        permissions:
            permissions.build: true
            ultimatearena.player: true
            towny.claimed.build: true
            towny.claimed.alltown.block.*: true
            iConomy.list: true
            iConomy.payment: true
            iConomy.rank: true
            ChestShop.shop.buy: true
            ChestShop.shop.sell: true
    admin:
        permissions:
            worldedit.*: true
            iConomy.access: true
            ChestShop.admin : true
        inheritance:
        - mod
    mod:
        permissions:
            spectate.use: true
            towny.admin: true
            ultimatearena.admin: true
            Punishment.*: true
            worldguard.*: true
            iConomy.admin.*: true
            iConomy.bank.*: true
        inheritance:
        - member
    member:
        permissions:
            permissions.build: true
            essentials.setspawn: true
            essentials.spawn: true
            essentials.tempban.exempt: true
            essentials.kick.exempt: true
            essentials.ban.exempt: true
            essentials.mute.exempt: true
            essentials.ban: true
            essentials.ban.notify: true
            essentials.ban.offline: true
            essentials.banip: true
            essentials.kick: true
            essentials.kick.notify: true
            essentials.kill: true
            essentials.mute: true
            essentials.tempban: true
            essentials.tempban.offline: true
            essentials.unban: true
            essentials.unbanip: true
        inheritance:
        - helper 
    helper:
        permissions:
            permissions.build: true
            essentials.mail: true
            essentials.mail.send: true
            essentials.me: true
            essentials.msg: true
            essentials.tp: true
            essentials.essentials: true
            ChestShop.shop.create: true
        inheritance:
        - default
messages:
    build: '&cYou do not have permission to build here.'
debug: false

_ForgeUser8764972
- Join Date: 4/18/2012
- Posts: 6
- Member Details
#424 _ForgeUser8764972

View User Profile

Send Message

Posted Apr 18, 2012
Hello,

I installed Permissionsbukkit and set up my config.yml file and every time I use this command

/permissions player addgroup <playername> <group>

to set a player into a group and I get this error

org.bukkit.command.CommandException: Unhandled exception executing command 'permissions' in plugin PermissionsBukkit v1.6 at org.bukkit.command.PluginCommand.execute(PluginCommand.java:42) at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:166) at org.bukkit.craftbukkit.CraftServer.dispatchCommand(CraftServer.java:473) at net.minecraft.server.NetServerHandler.handleCommand(NetServerHandler.java:821) at net.minecraft.server.NetServerHandler.chat(NetServerHandler.java:781) at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:764) at net.minecraft.server.Packet3Chat.handle(Packet3Chat.java:34) at net.minecraft.server.NetworkManager.b(NetworkManager.java:229) at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:113) at net.minecraft.server.NetworkListenThread.a(NetworkListenThread.java:78) at net.minecraft.server.MinecraftServer.w(MinecraftServer.java:551) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:449) at net.minecraft.server.ThreadServerApplication.run(SourceFile:492) Caused by: java.lang.NullPointerException at com.platymuus.bukkit.permissions.PermissionsCommand.createPlayerNode(PermissionsCommand.java:400) at com.platymuus.bukkit.permissions.PermissionsCommand.playerCommand(PermissionsCommand.java:301) at com.platymuus.bukkit.permissions.PermissionsCommand.onCommand(PermissionsCommand.java:152) at org.bukkit.command.PluginCommand.execute(PluginCommand.java:40) ... 12 more

This is how I have my config set.

[code]groups: default: permissions: permissions.build: true ultimatearena.player: true towny.claimed.build: true towny.claimed.alltown.block.*: true iConomy.list: true iConomy.payment: true iConomy.rank: true ChestShop.shop.buy: true ChestShop.shop.sell: true admin: permissions: worldedit.*: true iConomy.access: true ChestShop.admin : true inheritance: - mod mod: permissions: spectate.use: true towny.admin: true ultimatearena.admin: true Punishment.*: true worldguard.*: true iConomy.admin.*: true iConomy.bank.*: true inheritance: - member member: permissions: permissions.build: true essentials.setspawn: true essentials.spawn: true essentials.tempban.exempt: true essentials.kick.exempt: true essentials.ban.exempt: true essentials.mute.exempt: true essentials.ban: true essentials.ban.notify: true essentials.ban.offline: true essentials.banip: true essentials.kick: true essentials.kick.notify: true essentials.kill: true essentials.mute: true essentials.tempban: true essentials.tempban.offline: true essentials.unban: true essentials.unbanip: true inheritance: - helper helper: permissions: permissions.build: true essentials.mail: true essentials.mail.send: true essentials.me: true essentials.msg: true essentials.tp: true essentials.essentials: true ChestShop.shop.create: true inheritance: - default messages: build: '&cYou do not have permission to build here.' debug: false[/code]

If someone can help me, that would be great!

Rollback Post to Revision RollBack
_ForgeUser1642005
- Join Date: 11/16/2008
- Posts: 341
- Member Details
#423 _ForgeUser1642005

View User Profile

Send Message

Posted Apr 17, 2012
anychance of a update so I dont get errors spamming my log

2012-04-17 16:39:55 [SEVERE] java.lang.NullPointerException
2012-04-17 16:39:55 [SEVERE] at net.milkbowl.vault.permission.plugins.Permission_PermissionsBukkit.playerInGroup(Permission_PermissionsBukkit.java:160)
2012-04-17 16:39:55 [SEVERE] at net.milkbowl.vault.permission.Permission.playerInGroup(Permission.java:426)
2012-04-17 16:39:55 [SEVERE] at com.sectorgamer.sharkiller.AutoAnnouncer.AnnouncerPerm.group(AnnouncerPerm.java:37)
2012-04-17 16:39:55 [SEVERE] at com.sectorgamer.sharkiller.AutoAnnouncer.Announcer$printAnnounce.run(Announcer.java:260)
2012-04-17 16:39:55 [SEVERE] at org.bukkit.craftbukkit.scheduler.CraftWorker.run(CraftWorker.java:34)
2012-04-17 16:39:55 [SEVERE] at java.lang.Thread.run(Thread.java:722)

Last edited by _ForgeUser1642005: Apr 17, 2012

Rollback Post to Revision RollBack
_ForgeUser7611920
- Join Date: 9/26/2011
- Posts: 2
- Member Details
#422 _ForgeUser7611920

View User Profile

Send Message

Posted Apr 16, 2012
Hello!! I have a world that I want players to be able to interact in (as in, use switches and pressure plates) but not be able to edit the blocks (break, place). I saw a pull request for permissions.interact and permissions.entity but those don't seem to work. Is there a dev build I can use until that is approved? Or is there another node with this function I don't know about?

Rollback Post to Revision RollBack
_ForgeUser2578965
- Join Date: 5/15/2009
- Posts: 72
- Member Details
#421 _ForgeUser2578965

View User Profile

Send Message

Posted Apr 15, 2012
Hi, is there a possibility to transfer the files from a permissionsplugin like PEX to PermissionsBukkit?

Rollback Post to Revision RollBack
_ForgeUser8690462
- Join Date: 4/4/2012
- Posts: 2
- Member Details
#420 _ForgeUser8690462

View User Profile

Send Message

Posted Apr 14, 2012
yello! I still cant get permissions to work for my mac! It dosent give me the file so i tried it with essentials but it still dosent work! Ive tried to decode it with notepad but i cant get the right code!(does anybody know the code?) Sorry, im stil a noob! Thx

Rollback Post to Revision RollBack
_ForgeUser7625588
- Join Date: 9/29/2011
- Posts: 2
- Member Details
#419 _ForgeUser7625588

View User Profile

Send Message

Posted Apr 12, 2012
wow, that code inserted well and i love the edit facilities sorry about the mess below

Rollback Post to Revision RollBack
_ForgeUser7625588
- Join Date: 9/29/2011
- Posts: 2
- Member Details
#418 _ForgeUser7625588

View User Profile

Send Message

Posted Apr 12, 2012
I would really like to see an addition made to permissionbukkit, to assist with setting up multiworld permissions I would like to see inheritance added to the world nodes, to assist in keeping groups of worlds having the same permissions without having to duplicate all the indervidual permissions

example NOTE, this Does not work , so dont try using it

groups: default: permissions: permissions.build: false fuzcoms.map: true

timekeeper: permissions: fuzcoms.day: true fuzcoms.fine: true fuzcoms.night: true fuzcoms.storm: true worlds: Conquest: worldedit.navigation.jumpto: true Private: inheritance: - timekeeper inheritance: - default

as you can see I have the timekeepers listed as being inherited to the private world I would do it myself, but im not quite up to doing it (only been programing java for about 4 months)

Rollback Post to Revision RollBack
_ForgeUser8349767
- Join Date: 1/31/2012
- Posts: 9
- Member Details
#417 _ForgeUser8349767

View User Profile

Send Message

Posted Apr 11, 2012
Some one please take this project over, I'd like to see bug fixes if possible, also I'm OCD and want to be 100% without a doubt there are no bugs on 1.2.5

Rollback Post to Revision RollBack
_ForgeUser7443346
- Join Date: 8/25/2011
- Posts: 62
- Member Details
#416 _ForgeUser7443346

View User Profile

Send Message

Posted Apr 11, 2012
lol its compatible with all versions been using it since cb 1060 u never have to up date it unless u want a minor fix

Rollback Post to Revision RollBack
_ForgeUser6846057
- Join Date: 5/19/2011
- Posts: 45
- Member Details
#415 _ForgeUser6846057

View User Profile

Send Message

Posted Apr 11, 2012
Is this compatible with 1.2.5?

Rollback Post to Revision RollBack
_ForgeUser6990026
- Join Date: 6/9/2011
- Posts: 7
- Member Details
#414 _ForgeUser6990026

View User Profile

Send Message

Posted Apr 11, 2012
Hello, I am having an error changing my players' groups. Am I doing it wrong or is it the plugin's fault? I do /permissions setgroup Bob Builder, and it returns this error: 09:23:20 [WARNING] Unexpected exception while parsing console command 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 6) at org.bukkit.craftbukkit.CraftServer.dispatchCommand(CraftServer.java:4 73) at org.bukkit.craftbukkit.CraftServer.dispatchServerCommand(CraftServer. java:469) at net.minecraft.server.MinecraftServer.b(MinecraftServer.java:596) at net.minecraft.server.MinecraftServer.w(MinecraftServer.java:565) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:449) at net.minecraft.server.ThreadServerApplication.run(SourceFile:492) Caused by: java.lang.NullPointerException at com.platymuus.bukkit.permissions.PermissionsCommand.createPlayerNode( PermissionsCommand.java:400) at com.platymuus.bukkit.permissions.PermissionsCommand.playerCommand(Per missionsCommand.java:286) at com.platymuus.bukkit.permissions.PermissionsCommand.onCommand(Permiss ionsCommand.java:152) at org.bukkit.command.PluginCommand.execute(PluginCommand.java:40) ... 7 more Thanks for your help. If it means anything, I ran this command from the console. Edit: Nevermind, I fixed the problem. I was missing the users: section in the config.yml

Last edited by _ForgeUser6990026: Apr 11, 2012

Rollback Post to Revision RollBack
Themonkey180
- Join Date: 11/10/2011
- Posts: 23
- Member Details
#413 Themonkey180

View User Profile

Send Message

Posted Apr 11, 2012
2012-04-09 21:56:43 [WARNING] [PermissionsBukkit] In group admin: bukkit.command.unban.ip is non-boolean (+3 more). How do I use this kind of Permissions. If it is non-Boolean. Any ideas?

Rollback Post to Revision RollBack
_ForgeUser7531268
- Join Date: 9/11/2011
- Posts: 147
- Member Details
#412 _ForgeUser7531268

View User Profile

Send Message

Posted Apr 10, 2012
@snowy007

that's the problem. I actually have to ADD them to default before they can use the commands and i have no clue why :/

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