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:
node1.node2will also provide access to both
- There is no "deny" permission.
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:
With these permissions:
- default has worldedit.selection
- admins has all permissions
- anothergroup has worldedit.navigation and worldedit.tool.tree
There's one user defined:
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.
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
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.