PermissionsBukkit
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
-
SpaceManiac Owner
-
View User Profile
-
Send Message
Posted Mar 23, 2012@FoxyFullmoon
I encountered this whenever I do /permissions reload from chat box or from console. It seems that the command runs in main thread and lags the hell out of everyone (usually kicks everyone from server due to no response/hang). No issues with 1 person online, but when you have more than 10 permissionsbukkit really takes a while to do anything if you issue a /permissions command.
Sometimes, this becomes so bad that it wipes the config.yml file to zero byte, and when that happens, you get no permissions to do anything. Like what you experienced perhaps.
Restore the config.yml from my backup and it works again :)
-
View User Profile
-
Send Message
Posted Mar 23, 2012@Llamageddon
You can do something like this as a work around;
-
View User Profile
-
Send Message
Posted Mar 23, 2012when a write a commande this message aparer
a internal error as ocur
-
View User Profile
-
Send Message
Posted Mar 21, 2012I have what might turn out to be a stupid question but is there any way to change the name of the default group from "default"? In this example I would like it to be called "peasant".
I can make a group called peasant and delete default but of course new players just start in "default" group with no permissions assigned. I can add the node "group.default: true" but of course that just makes the group appear as "default" rather than "peasant" when I use /permissions player groups. Is it just not possible with permissionsbukkit? I ask because other permissions programs I used could do this fine. I will probably still use permissionsbukkit as I like it but it is the only thing that is really getting on my nerves.
-
View User Profile
-
Send Message
Posted Mar 21, 2012@asdfasdfadf
OK, I just did a very quick check. I was correct. If you want PermissionsBukkit to work with CB 1.2.3, you cannot be using the permissions.yml file in the folder. Everything... and I mean everything must go into the config.yml in the PB's folder within plugins.
I only tested this with /rules and /motd, but it was quick enough. When just the permission referencing a custom rule permissions.yml file was used with various children permissions, it did not work. When I explicitly gave it permission in a group, it did. Likewise, I also temporarily disabled rules in default, but granted access to it in player, and it worked via inheritance as admin. Before adding them into just the config.yml file, none of the commands worked.
Also, asdfasdfadf, at least in commandbook, I have a feeling everything is defaulted to false. You may want to deop yourself and check to make sure on your server. But... if you want to configure it, I think you will need to do every command you want allowed at least once as you move up the inheritance tree. That is still functional.
-
View User Profile
-
Send Message
Posted Mar 21, 2012I added these permissions to the config.yml:
essentials.*: false
essentials.motd: true
But players are not able to use the /motd command. How do you make it so you can disable all commands but keep some true? I don't want to configure each command.
I fixed the inheritance since i was editing default:
user:
permissions:
permissions.build: true
inheritance:
- default
-
View User Profile
-
Send Message
Posted Mar 20, 2012so correct me if I'm wrong - because I thought I had permissions working and it wasn't - well, it sort of is on a few things. Note, this is all reference to CB 1.2.3.
All the people having success: Are you putting every permission in the PermissionBukkit's config.yml file?
For those of you banging your head against the wall, are you using the permissions.yml file in the root of the server (as I am) and then using those predefined groups?
Aside from all the syntax errors, I'm thinking the underlying problem may be using the permissions.yml file to simplify all the groups. I'm yet to actually do any methodical testing on it, though. I put all of commandbook in the permissions.yml file as groups, and naturally, as admin, I can't even run commands given to default (inheritance set). The other mods seem to be working slightly better, but they aren't all necessarily contained entirely in that file. You might just have to suck it up and type everything out multiple times.
-
View User Profile
-
Send Message
Posted Mar 20, 2012@MinecraftHerpyDerp
Make sure that all ur permissions are corrected.
Use
users: RobeOK: permissions: permissions.example: true groups: - admin groups: default: permissions: permissions.build: false ChestShop.shop.player: true jobs.join.*: true jobs.leave.*: true monsterhunt.usercmd.hunt: true monsterhunt.usercmd.huntscore: true monsterhunt.usercmd.huntstatus: true monsterhunt.usercmd.hunttele: true prefixer.self: true prefixer.remove: true authme.unregister: true authme.changepassword: true authme.login: true authme.register: true
Use all permissions with this example: plugin.permission: true <
-admin: permissions: permissions.*: true inheritance: - user user: permissions: permissions.build: true worlds: creative: coolplugin.item: true inheritance: - default messages: build: '&cNevar seit buuveet!.'debug: false
-
View User Profile
-
Send Message
Posted Mar 20, 2012Doesn't work at all (1.2.3-R0.2):
-
View User Profile
-
Send Message
Posted Mar 20, 2012@NitroSmily
permissions.example: true <-correct
permissions.example true <-incorrect
-
View User Profile
-
Send Message
Posted Mar 19, 2012I don't run any errors when I use PermissionsBukkit 1.6 on Bukkit 1.2.3 R0 2, but when I log into the server I can't place or break a single block. I've opped myself, same problem. I removed all permissions in the file, same problem. When I remove the plugin completely, everything is fine. Some say it's working for them, but it's not for me... This is the last plugin holding me back from the server update. If anyone could help me figure out how I could fix this or the creator could just update, it would make me and all of my members happy. I have people that want to join my server that have been waiting weeks to play! How does it feel knowing you have so many people dependent on you? We're all waiting.
-
View User Profile
-
Send Message
Posted Mar 19, 2012No :D
-
View User Profile
-
Send Message
Posted Mar 19, 2012@NitroSmily
Did you even read how to set up your permissions? At all? Just a bit?
-
View User Profile
-
Send Message
Posted Mar 19, 2012Heey Permission
I need help with this, would you mind help me?
Ok I got to worlds using multiworld and I got one world with creative and one with survival.
So I need that the people that are in creative map could use some World edit commands, but it says allways when I start the server: Can't load Permission or what ever so I need help from you guys to check if somethings is wrong
Thanks for listening
---------------------------------------------------------------------------------------------------------------------------------
users:
SpinXWesc:
permissions:
permissions.example true
groups:
- admin
Plantronics97:
permissions:
permissions.example true
groups:
- default
Plantronics97:
permissions:
permissions.example true
groups:
- default
Plantronics97:
permissions:
permissions.example true
groups:
- default
Mossy151:
permissions:
permissions.example true
groups:
- default
groups:
default:
permissions:
permissions.build true
Worlds:
Creative:
- worldedit.history.undo
- worldedit.region.walls
- worldedit.region.replace
- worldedit.region.set
- worldedit.region.move
- worldedit.butcher worldedit.butcher.lightning
- essentials.sethome
- essentials.balance
- essentials.home
- essentials.mail
- essentials.mail.send
- essentials.list
- essentials.help
- essentials.tpa
- essentials.tpaccept
- essentials.tpahere
- essentials.tpdeny
Survival:
- essentials.sethome
- essentials.balance
- essentials.home
- essentials.mail
- essentials.mail.send
- essentials.list
- essentials.help
- essentials.tpa
- essentials.tpaccept
- essentials.tpahere
- essentials.tpdeny
- essentials.sell
- lwc.protect
inheritance:
- default
admin:
permissions:
permissions.*: true
inheritance:
Creative:
- '*'
Survival:
- '*'
-
View User Profile
-
Send Message
Posted Mar 18, 2012No problems for me on 1.2 with permissionbukkit 1.6....
-
View User Profile
-
Send Message
Posted Mar 18, 2012Strange, my server doesn't appear to be having any issues with permissions at all.. o_0
-
View User Profile
-
Send Message
Posted Mar 18, 2012when u update to 1.2 let us know, this is retarded, u shouldnt make people wait, i can bet that 60% of all craftbukkit servers use PB, frankly im not proud of the fact that u dont take the time to even use the beta to update/test, this is the opnly pluggin holding me back, people want 1.2 so why cant i give it to them?
-
View User Profile
-
Send Message
Posted Mar 18, 2012@cesal11
I'm almost positive it has to deal with line endings. Give vi a try with the basics. It will probably feel very unfamiliar. I never seem to have luck with typical windows programs.
Press i to enter insert mode, so you can move stuff around, etc. Press Esc to exit the insert/editing mode. While not in an editing mode, type: ":w" (without quotes) to write the file/save. To exit, type ":q"
Also, I'm getting a message saying 0 players registered. Within the game, typing in /perms group players user does in fact show four people. The bug may be that the message system output is incorrectly calculating it now. The permissions system seems to be working as desired.
-
View User Profile
-
Send Message
Posted Mar 18, 2012Ok i really need some help with this. Every time i edit the config file it pops up with an internal error... i use notepad+ + i made sure not to use tabs i lined up the permission nodes i added with the default permission nodes and no luck. No matter what i do i cant fix it! can anybody help?
-
View User Profile
-
Send Message
Posted Mar 17, 2012I've been having incredible difficulty getting it to just load the config file. It says config reloaded on your screen, but the server log tells a different story. I deleted a lot of "trash," trimming it down to 14 lines and knocked it down to just myself as a user and two groups - default and admin. permissions.build, permissions.*, the build message, and debug.
Interesting thing that worked: it's two spaces before everything. not four. I also started using vi to edit it instead of nano. There might be a line-ending difference messing things up. I seem to remember that being one of the things I tried in the past to get it to work. I also presently don't have any inheritance statements, though I doubt that's the issue.
This is with CB 1.2.3-R0.2.
Granted, now I have to add in the remaining #00 lines of the permissions file, but for those of you with trouble, this might make the difference.
Start small with something you know works. Back it up. Reload the config. Start from your backup and let it grow larger. Repeat until you have all your permissions. But ALWAYS back it up. If its wrong, it erases your entire file. I was skeptical as well, but I don't think an update might actually be necessary for this to continue functioning. Maybe I'll think differently once I have all the permissions loaded and get to truly test it out, but I'm optimistic.