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

1. Configuration / groups.yml
2. Configuration / config.yml
3. Example Setup
4. Commands
5. 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 and privileges.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!