WorldGuard Commands
ℹ️ Notice: The base command is /region, but you can also use /rg as a shortcut.
Commands
Define
/region define <id> [<owner1> [<owner2> [<owners...>]]]/region def <id> [<owner1> [<owner2> [<owners...>]]]/region d <id> [<owner1> [<owner2> [<owners...>]]]
This is the primary region definition command. It allows you to create a new protected region with the given ID and the given owners. You can specify groups by prefixing group names with g:. Special region creation restrictions are
not checked with this command (for that, use the claim command), and so this command is aimed for administrators'. The area of the region will be taken as your current WorldEdit region selection.
<example|title=Creating a region with two players and one group as the owner|text=/region define TownPlot g:TownMembers Aya Tetsu</example>
Redefine
/region redefine <id>/region update <id>/region move <id>
This command allows you to change the area for a defined protected region. The area of the region will be taken as your current WorldEdit region selection. You cannot limit, with permissions, the new land area size.
Claim
/region claim <id> [<owner1> [<owner2> [<owners...>]]]
<warning|text=This command is subject to be improved and changed in the near future. The command was written more than 11 months ago back in November to December 2010, predating Bukkit itself.</warning>
This command is similar to "define" except that it also does extra checks:
- If enabled in the configuration, the player must not have more regions than the maximum region limit.
- The new region cannot replace an existing region of the same name unless the player also owns that.
- The new region may not overlap with another region that the player must own.
- If enabled in the configuration, the region must overlap an existing region that the player owns.
- If enabled in the configuration, the volume of the region must not exceeded the maximum region limit specified.
Information
/region info [<world>] <id>
Lists information for a given region. The information shown is:
- Shape
- Priority
- Flag values
- Parent
- Owners
- Members
- Bounding box
<example|title=Lookup information about "TownPlot"|text=/region info townplot</example>
<example|title=Lookup information about a region in another world|text=/region info world_nether forbiddenlands</example>
List
/region list [<page> [<world>]]
Displays the list of regions. A page number can be provided to scroll through the list, and a world can also be specified to list the regions of a world.
<example|title=Listing the first page of regions|text=/region list</example>
<example|title=Listing the third page of regions for another world|text=/region list 3 world_nether</example>
Alternatively the list of regions can be filtered by user by using the prefix . to specify the .<user> as the first argument . Regions the user is an owner of are listed first, prefixed with a (+) symbol. The permission worldguard.region.list.own can be set to allow users to only list their own regions using .me or ..
<example|title=Listing the regions owned by Tetsu|text=/region list .Tetsu</example>
<example|title=Listing the regions owned by oneself|text=/region list .me</example>
Set flag
/region flag <id> <flag> [<value>]
Sets a flag for a region. If a value is not given, then the flag is cleared to its default unset set. See the flag list to see which flags you can set. It is important you understand how region priorities and parent-child relationships work out, so be sure to read the regions introduction.
<example|title=Setting the PvP flag|text=/region flag townplot pvp deny</example>
<example|title=Setting the greeting message flag|text=/region flag townplot greeting Welcome to the town plot, %name%!</example>
<example|title=Clearing the farewell message flag|text=/region flag townplot farewell</example>
Set priority
/region setpriority <id> <priority>/region priority <id> <priority>/region pri <id> <priority>
Sets the priority of a region. The priority is a numeric integer that can be negative as well as positive. For information on how priorities work out, see the regions introduction.
Set parent
/region setparent <child> <parent>/region parent <child> <parent>