Need help? Ask on the forum, ask a fellow user or developer (join us on IRC), or contact sk89q.
Contribute to the wiki, edit this page! Register an account, or login with Facebook first.
HEY! Do you integrate (or want to) a plugin into yours? Do you help work on WE/WG/etc.? Please subscribe to our mailing list!
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.