Minecraft/Bukkit/Privileges
From Multiplay Wiki
Hello! I'm krinsdeath, the author of Privileges.
Privileges is an easy-to-use, familiar, and powerful Permissions (or, in Bukkit, group) management system. It can be used to easily assign permissions for popular plugins to any user or group that you want.
Contents |
config.yml
The config.yml contains two small, but very useful, settings.
default_group
The default group setting determines the "group" that new players who join your server are set into. This value is case sensitive and should match a corresponding group name in your groups.yml file.
debug
If debug is set to true (by default, it is false), Privileges will log tons of useful information that might help you troubleshoot permissions errors or oversights. This should only be used if you're quite familiar with navigating the server.log file, but it is useful nonetheless.
groups.yml
The groups.yml file contains a listing of each group, its rank, and all of its permissions (both global and per world). This file can be rather large, but can be made more tidy by combining it with your permissions.yml file.
Each entry prefixed with '- ' is a 'list' item. Each value in each list should correspond to a permissions node, such as 'privileges.build' or 'commandbook.spawn.set'. If a node has a - in front of it (-privileges.build), that means the permission is revoked instead of added (ie -privileges.build means that the player with that node can't build). The nodes of each list are calculated from top to bottom; if you place 'privileges.build' right after '-privileges.build' then the user will be able to build, even though you specifically said he couldn't earlier.
World nodes also override global nodes. The ordering of the keys doesn't matter, but the node order within each list does.
The default groups.yml file is as follows:
# Group ranks determine the order they are promoted in. # Lowest rank is 1, highest rank is 2,147,483,647. # Visit https://github.com/krinsdeath/Privileges/wiki for help with configuration # World nodes override global nodes for that group # Inherited groups are calculated first. Each group in the tree overrides any nodes # from the previous group. In the example config, default -> user (overrides default) -> admin (overrides user) groups: default: rank: 1 permissions: - -privileges.build worlds: world: - -example.basic.node2 world_nether: - -example.basic.node1 inheritance: [] user: rank: 2 permissions: - privileges.build - privileges.interact - privileges.check inheritance: - default admin: rank: 3 permissions: - privileges.* inheritance: - user
users.yml
By default, users.yml doesn't have anything in it. But the following depicts its format.
users:
krinsdeath:
group: admin
worlds: {}
randomUser:
group: user
worlds: {}
defaultGuy:
group: default
worlds:
world:
- example.world.node
world_nether:
- other.example.node