Region Commands¶
For a list of other (non-region protection related) commands, see the Commands page. Permissions for these commands is detailed on the Permissions page.
Some of these commands may run in the background and then later return results. The list of active background commands can be viewed with /wg running
. There is a hard limit to the number of running and queued commands.
Either /region
or /rg
can be used for commands. Some sub-commands have multiple aliases (for example, /rg d
can be used a shortcut to /rg define
).
Tip
You can use most of these commands from console, but you may need to specify the -w
flag (when available).
Creating and Removing Regions¶
Define¶
/rg define [-n] [-g] <id> <owner1> [<owner2>] [... <ownerN>]
/rg create (...)
/rg d (...)
Creates a new region with a given ID and an optional list of owners. Your current WorldEdit selection is used for the area of the region.
Region IDs are case-insensitive. Only one region can exist with a given name (per-world).
-g
will create a new “global” region (not the same as the Global Region) that has no physical space, which is useful for creating template regions (see Priority and Inheritance)-n
will store the given owner names as names, rather than converting them to UUIDs
Example: Creating a new “shop” region with “sk89q” and “wizjany” as owners
/rg define shop sk89q wizjany
Remove¶
/rg remove [-w <world>] [-f] [-u] <id>
/rg rem (...)
/rg delete (...)
/rg del (...)
Removes a region.
If the specified region has child regions, then either -u
or -f
must be specified. Both options cannot be specified together.
-w <world>
can be specified to run this command for a different world or from console-u
changes child regions of the specified region to have no parent-f
removes child regions of the specified region
Redefine¶
/rg redefine [-g]
/rg update (...)
/rg move (...)
Changes the physical area associated with an existing region and replaces it with your current WorldEdit selection.
-g
will create a new “global” region (not the same as the Global Region) that has no physical space, which is useful for creating template regions (see Priority and Inheritance)
Editing Memberships¶
Add Member¶
/rg addmember [-w <world>] [-n] <id> <members...>
/rg addmem (...)
/rg am (...)
Adds any number of members to a region. Using g:<member>
will add a permission group instead of a player.
-w <world>
can be specified to run this command for a different world or from console-n
tells WorldGuard to add players as names instead of UUIDs. Players added as names only will lose their membership if they change their Minecraft name.
Example: Adding the “builder” group and the player “sk89q” as members of a “spawn” region of the “lobby” world.
/rg addmember -w lobby spawn g:builder sk89q
Add Owner¶
/rg addowner [-w <world>] [-n] <id> <owners...>
/rg ao (...)
Adds any number of owners to a region. Using g:<owner>
will add a permission group instead of a player.
-w <world>
can be specified to run this command for a different world or from console-n
tells WorldGuard to add players as names instead of UUIDs. Players added as names only will lose their ownership if they change their Minecraft name.
Example: Adding the “admins” group and the player “eduardo” as members of a “spawn” region of the “lobby” world.
/rg addowner -w lobby spawn g:admins eduardo
Remove Member¶
/rg removemember [-w <world>] [-n] [-a] <id> <members...>
/rg remmember (...)
/rg remmem (...)
/rg rm (...)
Removes any number of members from a region. As in the add command, use g:<member>
to specify a permission group.
-w <world>
can be specified to run this command for a different world or from console-n
will remove a player who was added by name instead of UUID.-a
will remove all members from the region, ignoring the <members…> argument
Remove Owner¶
/rg removeowner [-w <world>] [-n] [-a] <id> <owners...>
/rg ro (...)
Removes any number of owners from a region. As in the add command, use g:<owner>
to specify a permission group.
-w <world>
can be specified to run this command for a different world or from console-n
will remove a player who was added by name instead of UUID.-a
will remove all owners from the region, ignoring the <owners…> argument
Getting Information¶
Select¶
/rg select <id>
/rg sel (...)
/rg s (...)
Replaces your current WorldEdit selection with the area of an existing region.
Information¶
/rg info [-u] [-s] [-w <world>] [<id>]
/rg i (...)
Displays information about a specified region, or if no region is specified, the region that you are currently in. If you are in several regions, then a list will shown instead.
-w <world>
can be specified to run this command for a different world or from console-s
causes the command to select the region (see/rg select
)-u
causes UUIDs to be shown rather than player’s last seen names
Example: Showing information about the Global Region
/rg info __global__
List¶
/rg list [-n] [-p <player>] [-w <world>] [<page>]
Lists the regions that have been created. A number can be provided to show a certain page.
If a player does have permission to list all regions but has permission to list his or her own (ones the player is a member or owner of), then the command will automatically only list the player’s own regions.
-w <world>
can be specified to run this command for a different world or from console-n
causes the command to search only by name rather than UUID and name-p <player>
can be specified to filter on regions that the given player is a member or owner of
Example: Listing regions that “sk89q” is a member or owner of
/rg list -p sk89q
Setting Region Options¶
Flag¶
/rg flag <id> <flag> [-w <world>] [-g <group>] [-e] [<value>]
Sets a flag on a region (see Region Flags for more information).
To unset a flag, don’t specify a value.
To set a flag to a blank value, use -e
. This is useful for setting flags like greeting
to a blank message to override the flag set in a different, larger, and lower priority region. If -e
is specified in addition to a value, the value is discarded.
-w <world>
can be specified to run this command for a different world or from console-g <group>
specifies the region group (see Region Flags)-e
sets an empty value
Example: Setting the pvp
flag of “mall” to “deny” with region group “nonmembers”
/rg flag mall pvp -g nonmembers deny
Example: Unsetting the greeting
flag on “mall”
/rg flag mall greeting
Example: Setting the greeting
flag to an empty value
/rg flag mall greeting -e
Priority¶
/rg setpriority [-w <world>] <id> <priority>
/rg priority (...)
/rg pri (...)
Sets the priority of a region. See Priority and Inheritance for more information.
The default priority of a region is 0.
-w <world>
can be specified to run this command for a different world or from console
Parent¶
/rg setparent [-w <world>] <id> [<parent>]
/rg parent (...)
/rg par (...)
Sets the parent of a region. See Priority and Inheritance for more information.
To unset a parent priority, specify no parent.
-w <world>
can be specified to run this command for a different world or from console
Example: Setting the parent of “plot1” to “mall”
/rg setparent plot1 mall
Example: Removing the parent of “plot1”
/rg setparent plot1
Miscellaneous Commands¶
Teleport¶
/rg teleport [-s] <id>
Teleports yourself to the location specified by either the spawn
or teleport
flags.
-s
selects the spawn flag rather than the teleport flag
Note
It is currently not possible to teleport to a region that does not have either of these flags set. Issue WORLDGUARD-2671 to fix this is pending.
Management Commands¶
Load¶
/rg load [-w <world>]
/rg reload (...)
Reloads the region data from file or database. If recent changes were made in-game to the region data, this may cause data loss.
The load operation occurs in the background and will not pause the server. If the command is used before a previous load has completed, the new load will be queued. There is a limit to the maximum number of operations that can be queued.
-w <world>
can be specified to run this command for a different world or from console
Save¶
/rg save [-w <world>]
/rg write (...)
Saves the region data to disk.
Tip
Region data is saved automatically soon after any changes are made, so this command does not need to be called explicitly.
The save operation occurs in the background and will not pause the server. If the command is used before a previous save has completed, the new save will be queued. There is a limit to the maximum number of operations that can be queued.
-w <world>
can be specified to run this command for a different world or from console
Migrate Database¶
/rg migratedb <from> <to>
Migrates from one type of storage driver (see Storage Drivers) to another.
Valid choices for “from” and “to” are:
yaml
mysql
Migration does not automatically enable the target storage driver – that must be done in the Configuration.
Warning
Be sure to make a backup before running migration.
Warning
This command does not run in the background and will pause the entire server. If your server software has server pause detection, this may kill the server during migration and abort the migration process. If migration is aborted or fails, you may need to empty the target storage before re-running migration.
Migrate UUID¶
/rg migrateuuid
Converts player names in the region data to Mojang UUIDs.
Names that have no corresponding UUIDs will either be removed or left remaining depending on the Configuration (the setting is keep-names-that-lack-uuids
).
Warning
Be sure to make a backup before running migration.
Warning
This command does not run in the background and will pause the entire server. If your server software has server pause detection, this may kill the server during migration and abort the migration process.