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

About the ads

WorldGuard/Regions/Commands

From SK's Wiki
Jump to: navigation, search

These are the region commands.

Tip: The base command is /region, but you can also use /rg as a shortcut.

Contents

Commands

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: This command is subject to be improved and changed in the near future. The command was written more than 3 years ago, in November to December 2010, predating Bukkit itself.

This command is similar to "define" except that it also does extra checks:

  1. If enabled in the configuration, the player must not have more regions than the maximum region limit.
  2. The new region cannot replace an existing region of the same name unless the player also owns that.
  3. The new region may not overlap with another region that the player must own.
  4. If enabled in the configuration, the region must overlap an existing region that the player owns.
  5. If enabled in the configuration, the volume of the region must not exceeded the maximum region limit specified.

Information

  • /region info [-s] [<world>] [<id>]

Lists information for a given region. The information shown is:

  • Shape
  • Priority
  • Flag values
  • Parent
  • Owners
  • Members
  • Bounding box

Empty fields will be left out.

The -s flag makes this command select the region in addition to showing information on it. This requires select permissions as usual.

If you don't specify an id, the highest-priority region at your current location will be used.

Example: Lookup information about "TownPlot"
/region info townplot
Example: Lookup information about a region in another world
/region info world_nether forbiddenlands

Select

  • /region select [<id>]

This command selects the region.

If you don't specify an id, the highest-priority region at your current location will be used.

Example: Select "TownPlot"
/region select townplot

List

  • /region list [<page>] [-w <world>] [-p <player>]

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: Listing the first page of regions
/region list
Example: Listing the third page of regions for another world
/region list 3 -w world_nether

Alternatively the list of regions can be filtered by user by using the flag -p 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.

Example: Listing the regions owned by Tetsu
/region list -p Tetsu

The index shown here can be used in most region commands (exceptions: claim, remove, redefine) in place of a region id. Simply write #<index>.

Example: Region by index
/region teleport #5

Set flag

  • /region flag <id> <flag> [-g <groupname>] [-w <worldname>] [<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: Setting the PvP flag
/region flag townplot pvp deny
Example: Setting the PvP flag with a specific world
/region flag townplot pvp -w duduworld deny
Example: Setting the greeting message flag
/region flag townplot greeting Welcome to the town plot, %name%!
Example: Clearing the farewell message flag
/region flag townplot farewell

Set priority

  • /region setpriority <id> -w <worldname> <priority>
  • /region priority <id> -w <worldname> <priority>
  • /region pri <id> -w <worldname> <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>
  • /region par <child> <parent>

Sets the parent of a region. You must specify the name of an existing region. For information on how parents and children work out, see the regions introduction.

Remove

  • /region remove <id> -w <worldname>
  • /region rem <id> -w <worldname>
  • /region delete <id> -w <worldname>
  • /region del <id> -w <worldname>

Removes a region.

Teleport

  • /region teleport [-s] <id>
  • /region tp [-s] <id>

Teleports to the point specified by the region's teleport flag.

If you specify the -s flag, you will be teleported to the spawn point instead.

Management

  • /region load [-w <world>]
  • /region save [-w <world>]

Loads or saves the current regions from/to the database (e.g. regions.yml file).

Note that unsaved changes will be lost when loading, although all inbuilt WorldGuard commands which modify regions will automatically save changes.

Permissions

Please see the permissions page.



Namespaces

Variants
Actions