zPermissions — A Superperms plugin for Bukkit
zPermissions is primarily an SQL database-backed Superperms (aka Bukkit permissions) implementation. It also supports flat-file storage. Notable features are: multi-world support, ranks with multiple tracks/ladders, group inheritance of arbitrary depth (within reason), and optional region-specific permissions using WorldGuard regions or Residence residences.
There is no built-in build protection (I rely on other plugins for that). zPermissions focuses on permissions and only permissions.
I aim to keep zPermissions a simple, yet feature-rich, Superperms provider.
Please post bugs and/or feature requests as dev.bukkit.org tickets.
A variety of storage options, from SQL to flat-file. Uses Bukkit database to store permissions (i.e. settings in bukkit.yml). Should work with most databases supported by Avaje Ebean — I've specifically tested with PostgreSQL, MySQL, and H2. The default Bukkit database, SQLite, is not supported. zPermissions will automatically fall back to flat-file storage if it is used.
Group inheritance. Groups may inherit permissions from a single parent group.
Players may be members of more than one group. The order of which group permissions are applied is well defined and based on group weight (which is configurable, of course).
Multi-world support. Permissions granted to players and groups may be associated with a specific world.
Optional region support. Permissions may also be associated with WorldGuard regions or Residence residences.
Multiple promotion tracks! Using permissions, you can also limit who can promote/demote others and which tracks they may use.
Short-term temporary permissions. Give a player a permission node that lasts anywhere from a few seconds to a few minutes.
Temporary group assignments. Assign a group to a player and have their membership expire after 1 day... a few months... or a year! Whatever duration you want.
API. zPermissions offers a comprehensive read-only API that other plugins can use. (Though I would recommend coding against Vault instead.)
Metadata support. Players and groups may have arbitrary metadata associated with them. Metadata values may be strings, integers, reals (floating point), and booleans. Metadata may be queried via the native API or Vault Chat API.
Automatic group permissions. With the advent of Superperms/Bukkit permissions, the recommended way of testing group membership is by using permissions. zPermissions can automatically set a permission based on the group's name for each group. By default, this configurable permission is
group.<groupname>(compatible out-of-the-box with WorldEdit and WorldGuard!).
Re-assignable default group. The default group (the group assigned to players who have not been explicitly placed into any groups) is named
default. This may be changed.
Groups are "universal" — across all worlds. There are no plans to introduce world-specific groups.
However, players and groups may have world-specific and/or region-specific permissions. These permissions are only in effect when the player is in that particular world and/or region.
There are 4 "levels" of permissions: universal, world-specific, region-specific, and finally region- and world-specific. The most general permissions are applied first, with player permissions overriding group permissions at the same level:
- Universal group permissions
- Universal player permissions
- World-specific group permissions
- World-specific player permissions
- Region-specific group permissions
- Region-specific player permissions
- Region- and world-specific group permissions
- Region- and world-specific player permissions
Players may be members of multiple groups. Groups may be assigned a weight — a higher weight means the group is applied later so it overrides earlier groups. Groups with the same weight are applied alphabetically.
Installation & Usage
Put zPermissions.jar in your server's
plugins directory. Start up your server. This will create the file
config.yml in your server's
plugins/zPermissions directory. You may want to edit this file to set your default group and default track. You may also want to create your tracks.
/permissions to get started. (
/p may also work, if those aliases are available.)
The permission nodes in the
unset sub-commands may be specified as:
- <permission> — An unqualified permission node applies to all worlds and all regions.
- <world>:<permission> — To make a permission world-specific, prefix it with the world name followed by a colon.
- <region>/<permission> — To make a permission region-specific, prefix it with the region name followed by a slash.
- <region>/<world>:<permission> — You may also make a permission both region- and world-specific by combining the two qualifiers. For now, the region qualifier must always come first.
The rank commands are
/unsetrank and will normally broadcast changes to all admins. The rank commands have an option
-q to operate silently, e.g. when being called by automated processes. They will, however, still log their actions to the server log for security audit purposes. Opposite of
-q, they will also take
-Q which causes the rank commands to broadcast changes to all users.
- Detailed Command Usage
- Customizing Table Names
- Vault Support
- For Plugin Developers
- Schema Updates
License & Source
zPermissions is released under the Apache License, Version 2.0.
Sources may be found on GitHub:
Development builds of this project can be acquired at the provided continuous integration server.
These builds have not been approved by the BukkitDev staff. Use them at your own risk.
- zPermissions (Requires ToHPluginUtils.jar)
- zPermissions-standlone (includes ToHPluginUtils, like the version distributed on dev.bukkit.org)
- More extensive unit tests, especially on the service interface.
- Better organized docs.
This version will upgrade your config.yml to add the new option: region-managers
- Catch when a command has been given too many arguments and complain accordingly. (ToHPluginUtils)
- Upgrade WorldGuard and WorldEdit dependencies to latest. Check for null RegionManager.
- Reorganize code.
- Minor optimization to in-memory handling of metadata.
- Abstract out region support.
- Add region support for Residence.
- Minor change to region plugin detection to allow removal of softdepend on WorldGuard, Residence.
- Remove track case-sensitivity. (This affects all rank-related commands like promote, demote, etc.)
- Add track-related methods to ZPermissionsService. (For Vault, etc.)
- Add aliases to set/unset Vault-related metadata. See the aliases section in the commands doc.
- Add hidden option to turn off optimization when setting PermissionAttachment permissions. The new option is optimize-set-permissions (defaults to true) and is only required to be false for certain non-CraftBukkit implementations of the Bukkit API, like MCPC+.
The new region-managers option
zPermissions will use the first region plugin it detects for its region support. The default order is WorldGuard then Residence. If you happen to have both WorldGuard and Residence installed and prefer Residence, simply change the order using the region-managers option.
An upcoming version of Vault (most likely 1.2.26) will allow better control over what is considered a player's "primary group." See the Vault support doc for details. Note the new aliases make this somewhat more convenient.
|File Name||Release Type||Game Version||Downloads||Date|
- Admin Tools, Anti-Griefing Tools, Informational, Teleportation, and World Editing and Management
- 191,804 Monthly Downloads
- Admin Tools, Chat Related, Teleportation, Economy, and General
- 150,652 Monthly Downloads
- Admin Tools, World Editing and Management, Fixes, General, and Anti-Griefing Tools
- 86,134 Monthly Downloads
- World Editing and Management and Admin Tools
- 62,756 Monthly Downloads
- Admin Tools, Developer Tools, Mechanics, and Economy
- 60,623 Monthly Downloads