Got a question that the wiki doesn't answer? Ask on the forum (preferred), or join us on IRC.

CreeperHost
About the ads

WEPIF/Configuration permissions

From EngineHub.org Wiki
Jump to: navigation, search

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.
Warning: This is pretty complicated. You may want to use one of the other systems.

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.

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.

Examples

Example: Giving sk89q only the worldedit.reload and worldedit permissions
permissions:
    users:
        sk89q:
            permissions:
                - worldedit 
                - worldedit.reload
Example: Giving sk89q the worldedit.reload and worldedit permissions and giving tetsu only the worldedit permission
permissions:
    users:
        sk89q:
            permissions:
                - worldedit
                - worldedit.reload
        tetsu:
            permissions:
                - worldedit
Example: Making an administrators group with WorldEdit and putting some people in it
permissions:
    groups:
        admins:
            permissions:
                - worldedit.reload
                - worldedit
    users:
        sk89q:
            groups:
                - admins
        tetsu:
            groups:
                - admins
        jon:
            groups:
                - admins

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.


Namespaces

Variants
Actions