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 |
worldguard.chest-protection.override |
Bypass Chest Protection and open protected chests. |
worldguard.god.override-regions |
Allows keeping invincibility when inside regions with |
worldguard.auto-invincible |
Automatically receive invincibility when joininng if the config option |
worldguard.override.potions |
Allows using potions/effects that are blocked with the |
worldguard.override.lighter |
Allows using flint and steel or fireballs when |
worldguard.override.infinite-stack |
Bypasses the |
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 |
worldguard.god.other |
Be able to use |
worldguard.heal |
Be able to use |
worldguard.heal.other |
Be able to use |
worldguard.slay |
Be able to use |
worldguard.slay.other |
Be able to use |
worldguard.locate |
Be able to use |
worldguard.stack |
Be able to use |
worldguard.stack.illegitimate |
Be able to make stack sizes with |
worldguard.fire-toggle.stop |
Be able to use |
worldguard.halt-activity |
Be able to use |
worldguard.reload |
Be able to use |
worldguard.report |
Be able to use |
worldguard.profile |
Be able to use |
worldguard.report.pastebin |
Be able to have a report or profile submitted to a pastebin service. |
worldguard.flushstates |
Be able to use |
worldguard.running |
Be able to use |
worldguard.debug.event |
Be able to use the event testing commands under |
Regions¶
Permission |
Explanation |
|---|---|
worldguard.region.wand |
Be able to use the Region Wand. |
worldguard.region.load |
Be able to use |
worldguard.region.save |
Be able to use |
worldguard.region.migratedb |
Be able to use |
worldguard.region.migrateuuid |
Be able to use |
worldguard.region.migrateheights |
Be able to use |
worldguard.region.define |
Be able to use |
worldguard.region.claim |
Be able to use |
worldguard.region.unlimited |
Bypass claiming limits. |
worldguard.region.list |
Be able to use |
worldguard.region.list.own |
Be able to use |
Per-Region Permissions¶
The following permissions 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 |
worldguard.region.remove.* |
Be able to use |
worldguard.region.setpriority.* |
Be able to use |
worldguard.region.setparent.* |
Be able to use |
worldguard.region.select.* |
Be able to use |
worldguard.region.info.* |
Be able to use |
worldguard.region.teleport.* |
Be able to use |
worldguard.region.teleportcenter.* |
Be able to use |
worldguard.region.addmember.* |
Be able to use |
worldguard.region.addowner.* |
Be able to use |
worldguard.region.removemember.* |
Be able to use |
worldguard.region.removeowner.* |
Be able to use |
worldguard.region.locationoverride.* |
Bypasses the |
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.