Minecraft/Bukkit/Privileges

From Multiplay Wiki

Jump to: navigation, search

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
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox