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!
A region can be assigned a parent, which causes it to:
- Inherit its owners
- Inherit its members
- Inherit its flags, yet override it as well if defined
- Override the owners and members of its parent so that the owners and members of a child do not need to be in the parent to be able to build
/region setparent child parent
However, there are some cases where priorities are needed. Priorities are numbers (negatives are possible) assigned to a region to determine its rank. A higher number is a higher priority, and a higher priority will override any flags of lower priorities if the higher priority region has a flag defined. This is often needed when two region overlap partially or one region encases another completely.
/region setpriority NoBuild 100
Regions of the same priority
In some cases, you may have two (or more) regions with the same priority that overlap. A player will need to have build permissions in all of the overlapping regions to build in that location.
There is also the obvious problem of when overlapping regions with the same priority both have the same flag, but set to different values. The results depend on the type of flag:
- State flags have three states, NONE, ALLOW, and DENY, with precedence in that order (lowest to high). If region A has ALLOW and region B has DENY, then region B's DENY will take precedence.
- Other flags may conflict. If you set a greeting message in both region A and B, then either may take precedence.
Because you often cannot control which flags will take precedence, it is recommended to avoid this situation. Conflicts can be resolved by adjusting region priorities, or by redefining regions so they do not overlap.
Flags have default values. For example, what if you're in an area where there's no region or no defined region has that flag set? WorldGuard checks the "global region" in that case, and if it's not there, it then checks its built-in value (for example, PvP is enabled by default).
You can change the global region by changing the region named
__global__ (two underscores on both sides).
/region flag __global__ pvp deny