Permissions¶
By default, no one can use WorldGuard. In order for yourself, moderators, and players to use WorldGuard, you must provide the proper permissions. One way is to provide op to moderators and administrators (unless disabled in the configuration), but providing the permission nodes on this page (through a permissions plugin) is the more flexible.
You can give the worldguard.* permission to give yourself and other administrators full access to WorldGuard.
Moderator¶
| Permission | Explanation |
|---|---|
| worldguard.notify | Receive notification with the ‘notify’ blacklist action and the ‘notify’ region flags. |
| worldguard.region.bypass.<world> | Bypass region protection for a given world, except for PvP deny flags. |
| worldguard.region.toggle-bypass | Allows using the /rg bypass command to toggle the above behavior (still requires the bypass permission). |
| worldguard.chest-protection.override | Bypass Chest Protection and open protected chests. |
Warning
If you are op or have all permissions, you will implicitly have these protection bypass permissions and it will appear that protection does not work.
Commands¶
See the Commands page for an explanation of some of these commands.
| Permission | Explanation |
|---|---|
| worldguard.god | Be able to use /god (and /ungod). |
| worldguard.god.other | Be able to use /god (and /ungod) on others. |
| worldguard.heal | Be able to use /heal. |
| worldguard.heal.other | Be able to use /heal on others. |
| worldguard.slay | Be able to use /slay. |
| worldguard.slay.other | Be able to use /slay on others. |
| worldguard.locate | Be able to use /locate. |
| worldguard.stack | Be able to use /stack. |
| worldguard.stack.illegitimate | Be able to make stack sizes with /stack that exceed normal limits (i.e. 64 buckets in one stack). |
| worldguard.fire-toggle.stop | Be able to use /stopfire and /allowfire. |
| worldguard.halt-activity | Be able to use /stoplag. |
| worldguard.reload | Be able to use /wg reload. |
| worldguard.report | Be able to use /wg report. |
| worldguard.profile | Be able to use /wg profile. |
| worldguard.report.pastebin | Be able to have a report or profile submitted to a pastebin service. |
| worldguard.flushstates | Be able to use /wg flushstates. |
| worldguard.running | Be able to use /wg running. |
| worldguard.debug.event | Be able to use the event testing commands under /wg debug. Those commands are used to simulate an action so you can trace down, for example, which plugin is blocking player versus player combat. However, this essentially allows a moderator to impersonate another player. |
Regions¶
| Permission | Explanation |
|---|---|
| worldguard.region.wand | Be able to use the Region Wand. |
| worldguard.region.load | Be able to use /rg load. |
| worldguard.region.save | Be able to use /rg save. |
| worldguard.region.migratedb | Be able to use /rg migratedb. |
| worldguard.region.migrateuuid | Be able to use /rg migrateuuid. |
| worldguard.region.define | Be able to use /rg define. |
| worldguard.region.claim | Be able to use /rg claim. |
| worldguard.region.unlimited | Bypass claiming limits. |
| worldguard.region.list | Be able to use /rg list. |
| worldguard.region.list.own | Be able to use /rg list and have it show one own’s regions. |
Per-Region Commands¶
The following commands support a base permission (such as worldguard.region.redefine), but also allow you to use specific permissions that only apply if a player is an owner or member of a region (note that an owner is also a member):
worldguard.region.redefine.own.<region name>worldguard.region.redefine.member.<region name>worldguard.region.redefine.<region name>
Permissions systems that support wildcard permissions can be used to grant permissions to all regions in any given category, e.g.:
worldguard.region.redefine.own.*
| Permission | Explanation |
|---|---|
| worldguard.region.redefine.* | Be able to use /rg redefine. |
| worldguard.region.remove.* | Be able to use /rg remove. |
| worldguard.region.setpriority.* | Be able to use /rg setpriority. |
| worldguard.region.setparent.* | Be able to use /rg setparent. |
| worldguard.region.select.* | Be able to use /rg select. |
| worldguard.region.info.* | Be able to use /rg info and /rg flags. |
| worldguard.region.teleport.* | Be able to use /rg teleport. |
| worldguard.region.addmember.* | Be able to use /rg addmember. |
| worldguard.region.addowner.* | Be able to use /rg addowner. |
| worldguard.region.removemember.* | Be able to use /rg removemember. |
| worldguard.region.removeowner.* | Be able to use /rg removeowner. |
Example: Letting players look up information on only regions that they own
Use the own.* form of the permission:
worldguard.region.info.own.*
Example: Allowing every player to use /rg teleport city
The region name can be specified in the permission:
worldguard.region.teleport.city.*
Flag Command¶
The /rg flag command has the basic permission:
worldguard.region.flag.*
However, rather than providing that encompassing permission, you can provide the combination of the following two:
To determine which regions can have their flag changed by the player, any of the following permissions can be given (and they work like the permissions in the previous section):
worldguard.region.flag.regions.own.<region name>worldguard.region.flag.regions.member.<region name>worldguard.region.flag.regions.<region name>
However, to determine which types of flags can be set by the player, permissions of the following patterns can be given:
worldguard.region.flag.flags.<flag name>.<flag value>.own.<region name>worldguard.region.flag.flags.<flag name>.<flag value>.member.<region name>worldguard.region.flag.flags.<flag name>.<flag value>.<region name>
Examples for
<flag value>areallow,deny,unset(if no value is specified), etc. More complex values are also checked, however, special characters such as,,., whitespaces, etc. are omitted.
Example: Letting players be able to only change flags on regions that they own, and limit the flags that they can change to use and chest-access
You would need to provide the following permissions:
worldguard.region.flag.regions.own.*
worldguard.region.flag.flags.use.*
worldguard.region.flag.flags.chest-access.*
