Privileges
Privileges
Privileges seeks to be a familiar face for Permissions, and uses the Permissions 2.x format of lists of nodes for users. It offers inheritance, multi-world permissions, and promotion tracks.
This plugin is designed to implement Super perms (Bukkit Permissions). It does not provide an extensible API for permissions handler hooking, except in the form of getGroup().
by krinsdeath
Pages
- Configuration / groups.yml
- Configuration / config.yml
- Example Setup
- Commands
- Jenkins / Github 5.1. Use of the plugin builds from Jenkins is unofficial, unsupported and unapproved by BukkitDev Staff!
Features
- Multi-world compatible permissions management, with a familiar interface.
- Easy-to-use, powerful, and accurate inheritance.
- Promotion ladders and tracks through group ranks.
- Anti-build with permissions nodes
privileges.build
andprivileges.interact
. - Expanded anti-build permissions with
privileges.interact.[block id]
, to prevent interaction on a block-by-block basis. - Extremely powerful command system!
- Incredibly light-weight registration of players. Thousands of nodes can be applied in only a few millionths of a second.
- Plugin Metrics! Privileges reports the total number of groups and users registered in its config files to mcstats.org. This data is 100% anonymous and is only used for informational purposes. You can disable this in config.yml by changing
plugin.metrics: false
Commands
- /priv - Top level command. Does nothing.
- /priv check [player] [node] - Checks the specified node for the specified player. If player is omitted, checks your own nodes.
- /priv list [player] [page] - Lists the specified player's permissions nodes. If player is omitted, lists your own nodes. 7 nodes are listed per page.
- /priv reload - Saves Privileges' currently loaded configuration to disk and reloads all files.
- /priv save - Saves Privileges' currently loaded configuration to disk.
- /priv load - Unloads current configurations and loads from the disk - used to pick up external file changes.
- /priv backup [name] - Creates a configuration snapshot including users and groups, and saves it to a directory: privbackup/[name].
- /priv restore [name] - Restores the specified configuration snapshot.
- /priv version - Shows Privileges' current version and build numbers.
- /priv group [option] - Top level 'group' command
- * /priv group create [name] [rank] - Creates a group with the specified name and rank. If your current rank is equal to or lower than the rank you specify, the command will fail.
- * /priv group remove [name] [--safe] - Removes the specified group. If your rank is lower than the target group's rank, the command fails. If --safe is specified, the command will attempt to remove all references to the group from all users (and set them to your default group), and remove the group from all inheritance references as well.
- * /priv group set [player] [group] - Attempts to set the specified player's group to the specified group. If the target group's rank is equal to or higher than the command sender's rank, the command fails.
- * /priv group show [player] - Shows the sender the specified player's group.
- * /priv group list - Lists the available groups and their ranks.
- * /priv group perm - Top level 'group permission' command
- * * /priv group perm set [group] [node] [true|false] - Attempts to set the specified node to the specified value for the specified group. Fails if you don't have a higher rank setting than the target group.
- * * /priv group perm remove [group] [node] - Attempts to remove the node specified from the group. Fails if your rank is not higher than the target group.
- /priv user perm [option] - Top level 'user permission' command
- * /priv user perm remove [player] [node] - Removes the node specified from the target player.
- * /priv user perm set [player] [node] [true|false] - Sets the specified node to the value for the target player.
- * /priv user reset [player] - Resets the specified user to the default group and erases any individual permissions.
more commands will be added as I think of them
Permissions
- privileges.interact (defaults true) - Allows the player to interact with objects like buttons and switches
- privileges.build (defaults true) - Allows the player to break/place blocks
- Base commands
- * privileges.reload - /priv reload
- * privileges.save - /priv save
- * privileges.load - /priv load
- * privileges.backup - /priv backup [name]
- * privileges.restore - /priv restore [name]
- * privileges.version - /priv version
- * privileges.debug - /priv debug
- Administrative
- * privileges.promote - /promote [player]
- * privileges.demote - /demote [player]
- * privileges.check - /pc [player] [node]
- * privileges.list - /priv list [player] [page]
- * privileges.info - /priv info [player]
- Group base commands
- * privileges.group.create - /pgc [group] [rank]
- * privileges.group.remove - /pgr [group] [--safe]
- * privileges.group.set - /pgs [player] [group]
- * privileges.group.show - /pg show [player]
- * privileges.group.list - /pg list
- Group permissions commands
- * privileges.group.perm.set - /pgps [group] [node] [true|false]
- * privileges.group.perm.remove - /pgpr [group] [node]
- User permissions commands
- * privileges.user.perm.remove - /pupr [player] [node]
- * privileges.user.perm.set - /pups [player] [node] [true|false]
- * privileges.user.reset - /pur [player]
Special thanks
- gravypod - Small performance tweaks and optimizations. Thanks a bunch!
- Wolvereness - Massive improvement to node registration performance through templating. Keep on keepin' on!
I can't teach you how to 'cheat'. Read the documentation for the plugin and if you have a legitimate question about functionality (or an error), please let me know.
Otherwise I can't just do stuff for you. Being an administrator requires learning something about administrating.
@krinsdeath
Alright then, so how do I configure it to where I can cheat? Because I have no clue.
You probably aren't giving yourself actual permissions. Privileges doesn't do anything on its own. You have to configure it.
Being "owner" doesn't mean anything. It's just an arbitrary name for an arbitrary idea. The plugin is only as smart as you are.
Whenever I try to give myself things or cheat in-game, it says this:
I'm sorry, but you do not have permission to perform this command. Please contact the server administrator if you believe that this is in error.
What's weird is that I'M the owner. I put myself at the owner in the users.yml AND I put myself as OP. It didn't work. What do I do?
EDIT: I also have TooManyItems installed, and when I click on what I want to get or do, the same message pops up.
No worries, Talaysen. Everyone has off days. My lack of free time might be inconvenient, but try to remember that all developers have lives too!
Sorry for being pissy with you before, had bronchitis for a few weeks now, it's had me a bit out of my element. :\
I like your plugins, they're all well written, with a lack of unnecessary features, not as bulky as the other options that are out there.
Thanks for the update/response/your time.
Hello Talaysen,
I'm a pretty busy guy (full time job, full time student), so I do my best to update with new content and feature requests as I can. I have actually incorporated your request into my plugin (users can now be promoted and demoted when they are offline as of my latest commit) so that should solve any problems you have been having.
This project is totally open source, so if you have a feature request or bug report and can't get a hold of me, please feel free to write a pull request and I will bring it in as soon as possible!
I hope this isn't available anywhere, I've tried searching around a bit and can't seem to find anything.
When I try commands to promote/change rank for a user, if they're offline, nothing happens. I don't get an error message, just.. nothing.
Is there any way to promote/change rank of an offline user?
is this supported by Vault ? i have a auto promote plugin but when it promotes a player i get this
edited by krinsdeath: try not to post such huge stack traces in my comments, submit a ticket for this or use the paste page
@Omnitv
Try reading the post from krinsdeath a couple posts right below you.
As from me, no bug report, just a nice big compliment on your plugin .
What about prefix and suffix? Does Privileges support it?
@krinsdeath Thanks for the help :)
DisablingToe: This is not a chat plugin, and as such I have no intention of providing chat prefixes and suffixes. mChat, ChatSuite, SimplePrefix, ColorMe (and I'm certain several others) all provide the desired functionality.
Regarding the * node, this plugin doesn't do any fancy stuff or witchcraft to attach every node to *; as such, there is no * node. Instead, you can use plugin-author-defined templates (such as lwc.admin or vanish.*) to assign several nodes. You can also make use of Bukkit's permissions.yml.
UziTryhard: That is an issue with your chat plugin. If you're using ChatSuite, look in the config.yml for the value: op_fallback: true. Change it to false and that should correct this behavior.
Will prefix and suffix be added? Other than that, I love this plugin
hi whenever i op someone it shows them as owner and whenever i deop them the go back to there original rank help please thanks!
Just wondering, does this support the - '*' node? Thanks :)
Your group's rank has to be higher than the intended target's destination group rank, or you have to have the permission node: privileges.self.edit
As the console, you should be able to execute any command you wish.
The latest version of Privileges fixes the issue where Rcon commands are not treated as console commands.
It is a automatic donating system! & when I try to add someone to a group in comes up with
That users rank is to high
It is happening to everyone? Any Idea how to fix this?
I don't know what Buycraft is. If it supports super permissions (bukkit permissions), then yes, it should support this plugin.
/priv group set [user] [group] - Set the specified user to the specified group.
/pgs [user] [group] - Same as above, just a "short" version
/promote [user] - Promotes the user to the next higher rank group
/demote [user] - Demotes the user to the next lowest rank group
Hi Jeff,
Me again ahah but with another question.
Does buycraft support this plugin & how do you give and remove a group from a player. As the command list aren't that clear.
Thanyou
Cpb40