WEPIF/Configuration permissions

The main features of these permissions are:

• You can give each user permissions.
• You can create a number of groups and give each group permissions.
• You can assign groups to a user and they will receive the group's permissions.
• Everyone is in the default group.

Configuration permissions is hierarchy-aware:

• Providing node1.node2 will also provide access to both node1.node2.node3 and node1.node2.node4
• There is no "deny" permission.

[edit] Usage

Permissions are stored in the wepif.yml file. An example excerpt is below.

permissions:
    groups:
        default:
            permissions:
                - worldedit.selection
        admins:
            permissions:
                - '*'
        anothergroup:
            permissions:
                - worldedit.navigation
                - worldedit.tool.tree
    users:
        sk89q:
            groups:
                - admins
                - anothergroup
            permissions:
                - commandbook.time
                - commandbook.motd

From that snippet, we can see that there are 3 groups:

• default
• admins
• anothergroup

With these permissions:

• default has worldedit.selection
• admins has all permissions
• anothergroup has worldedit.navigation and worldedit.tool.tree

There's one user defined:

• sk89q

That user is in two groups: admins and anothergroup (and remember that everyone is also in default). In addition to the permissions that sk89q gets from those three groups, he also has commandbook.time and commandbook.motd.

[edit] Examples

permissions:
    users:
        sk89q:
            permissions:
                - worldedit 
                - worldedit.reload

permissions:
    users:
        sk89q:
            permissions:
                - worldedit
                - worldedit.reload
        tetsu:
            permissions:
                - worldedit

permissions:
    groups:
        admins:
            permissions:
                - worldedit.reload
                - worldedit
    users:
        sk89q:
            groups:
                - admins
        tetsu:
            groups:
                - admins
        jon:
            groups:
                - admins

[edit] Format

The file is written in the YAML format and you must follow these guidelines:

• Do not use tabs. You MUST use spaces or Bukkit will complain. If you use an editor like Notepad++ (recommended for Windows users), you must configure it to "replace tabs with spaces." In Notepad++, this can be changed in Settings > Preferences > Language Menu.
• Don't get rid of the indents. They are indented so some entries are in categories (like "max-blocks-changed" is in the "limits" category.
• If you want to check the format of this file before putting it into WorldEdit, paste it into http://yaml-online-parser.appspot.com/ and see if it gives "ERROR:".
• Lines starting with # are comments and so they are ignored.