Commands
Worlds
Commands for this always beginning with /worlds
(you can also use /ws
which is shorter).
List
Command | Permission | Example | Short example | Example description |
---|---|---|---|---|
/worlds list |
worlds.list |
/worlds list |
/ws ls |
Show the names of all worlds on the server |
Create
Command | Short example | Example description |
---|---|---|
/worlds create <worldname> |
/ws cr mycoolworld |
Create a world with the name mycoolworld
|
/worlds create <worldname> <type> |
/ws cr mycoolworld NETHER |
Create a world with the name mycoolworld and the type NETHER (can be NORMAL , FLAT or NETHER ). |
Removing, (un)loading and teleporting
Command | Short example | Example description |
---|---|---|
/worlds remove <worldname> |
/ws rm mycoolworld |
Remove the world with the name mycoolworld
|
/worlds load <worldname> |
/ws ld mycoolworld |
Load the world with the name mycoolworld
|
/worlds unload <worldname> |
/ws uld mycoolworld |
Unload the world with the name mycoolworld
|
/worlds teleport <worldname> |
/ws tp mycoolworld |
Teleport into the world with the name mycoolworld
|
Copy and rename
Command | Short example | Example description |
---|---|---|
/worlds copy <from> <to> |
/ws cp theoldworld anotherworld |
Copy the world theoldworld to the world anotherworld
|
/worlds rename <from> <to> |
/ws rn theoldworld thenewworld |
Rename the world theoldworld to the world thenewworld
|
Set flags
Command | Short example | Example description |
---|---|---|
/worlds set |
/ws st |
List all flags in a world |
/worlds set permission <permissionstring> |
/ws st permission you.arecool |
Only players with the permission you.arecool are allowed to join the world |
/worlds set gamemode <gamemodename> |
/ws st gamemode creative |
Set the gamemode of a world to creative (possible values are survival , creative , adventure or spectator ) |
/worlds set build <value> |
/ws st build true |
Allow building in this world by setting the value to true
|
/worlds set pvp <value> |
/ws st pvp true |
Disable PvP in this world by setting the value to false
|
/worlds set damage <value> |
/ws st damage true |
Enable damage in this world by setting the value to true
|
/worlds set interact <value> |
/ws st interact false |
Disable interaction (opening chests, ...) in this world by setting the value to false
|
/worlds set explode <value> |
/ws st explode false |
Disable explosions in this world by setting the value to false
|
/worlds set drop <value> |
/ws st drop true |
Disable dropping items in this world by setting the value to false
|
/worlds set hunger <value> |
/ws st hunger true |
Enable hunger in this world by setting the value to true
|
/worlds set fly <value> |
/ws st fly true |
Allow flying in this world by setting the value to true
|
Unset flags
Command | Short example | Example description |
---|---|---|
/worlds unset permission |
/ws ust permission |
Remove the permission for this world so everybody can join |
/worlds unset gamemode |
/ws ust gamemode |
Remove the gamemode for this world so it's not changed when joining the world |
/worlds unset build |
/ws ust build |
Don't allow or forbid building in this world like the plugin wasn't there |
/worlds unset pvp |
/ws ust pvp |
Don't allow or forbid PvP in this world like the plugin wasn't there |
/worlds unset damage |
/ws ust damage |
Don't allow or forbid damage in this world like the plugin wasn't there |
/worlds unset interact |
/ws ust interact |
Don't allow or forbid interaction in this world like the plugin wasn't there |
/worlds unset explode |
/ws ust explode |
Don't allow or forbid explosions in this world like the plugin wasn't there |
/worlds unset drop |
/ws ust drop |
Don't allow or forbid dropping items in this world like the plugin wasn't there |
/worlds unset hunger |
/ws ust hunger |
Don't enable or disable hunger in this world like the plugin wasn't there |
/worlds unset fly |
/ws ust fly |
Don't allow or forbid flying in this world like the plugin wasn't there |
(Set) default flags
Command | Short example | Example description |
---|---|---|
/worlds defaults |
/ws df |
List all default flags for worlds |
/worlds defaults set gamemode <gamemodename> |
/ws df st gamemode creative |
Set the default gamemode of worlds to creative (possible values are survival , creative , adventure or spectator ) |
/worlds defaults set build <value> |
/ws df st build true |
Allow building by default by setting the value to true
|
/worlds defaults set pvp <value> |
/ws df st pvp true |
Disable PvP by default by setting the value to false
|
/worlds defaults set damage <value> |
/ws df st damage true |
Enable damage by default by setting the value to true
|
/worlds defaults set interact <value> |
/ws df st interact false |
Disable interaction (opening chests, ...) by default by setting the value to false
|
/worlds defaults set explode <value> |
/ws df st explode false |
Disable explosions by default by setting the value to false
|
/worlds defaults set drop <value> |
/ws df st drop true |
Disable dropping items by default by setting the value to false
|
/worlds defaults set hunger <value> |
/ws df st hunger true |
Enable hunger by default by setting the value to true
|
/worlds defaults set fly <value> |
/ws df st fly true |
Allow flying by default by setting the value to true
|
Unset flags
Command | Short example | Example description |
---|---|---|
/worlds defaults unset permission |
/ws df ust permission |
Remove the permission for this world so everybody can join |
/worlds defaults unset gamemode |
/ws df ust gamemode |
Remove the gamemode for this world so it's not changed when joining the world |
/worlds defaults unset build |
/ws df ust build |
Don't allow or forbid building in this world like the plugin wasn't there |
/worlds defaults unset pvp |
/ws df ust pvp |
Don't allow or forbid PvP in this world like the plugin wasn't there |
/worlds defaults unset damage |
/ws df ust damage |
Don't allow or forbid damage in this world like the plugin wasn't there |
/worlds defaults unset interact |
/ws df ust interact |
Don't allow or forbid interaction in this world like the plugin wasn't there |
/worlds defaults unset explode |
/ws df ust explode |
Don't allow or forbid explosions in this world like the plugin wasn't there |
/worlds defaults unset drop |
/ws df ust drop |
Don't allow or forbid dropping items in this world like the plugin wasn't there |
/worlds defaults unset hunger |
/ws df ust hunger |
Don't enable or disable hunger in this world like the plugin wasn't there |
/worlds defaults unset fly |
/ws df ust fly |
Don't allow or forbid flying in this world like the plugin wasn't there |
Using Regions
WorldGuard lets you and players guard areas of land against griefers and undesirables, as well as tweak and disable various gameplay features.
Command: "/region"
Alias: "/rg"
Permissions: worldguard.create
, worldguard.modify
, worldguard.delete
Creating a region
If you aren't OP on your server, you must find a way to give yourself the permission: worldguard.create
. This can be done through permission-management plugins such as PurePerms.
Command: /region create <region-name>
Now you will have to select two points to create the region. The region is specified as the area between the two points (cube/cuboid). Congratulations, you've created your first region! You can create as many regions as you like.
Managing a region
Now that you've created your region, you would want to manage it. There are many flags you can play with, for this. You can get a list of region flags using the command /region flags get <region-name>
.
Toggle PvP
You can disable Player v. Player damage by using the command /region flags set <region-name> pvp false
. You can re-enable pvp by using /region flags set <region-name> pvp true
.
Toggle Terrain Modification (Block breaking, Block placing, ...etc)
Block breaking/placing and interaction with the environment is by default disabled. To bypass this add permissions to the group/user that you wish to be able to bypass such protection.
Region-based effects
To give a player effects when they join a region, use /region flags set <region-name> effects <effect-id> <effect-amplifier>
. The effect duration is infinity and is gone once the player quits the region. To give player speed 2 and jump 3 on joining a region, you can use...
/region flags set <region-name> effects 1 2
,
/region flags set <region-name> effects 8 3
Creating subregions
To create a subregion simply create a region within another and set it's priority flag using /region flags set <region-name> priority <value>
where the value is a number. Higher values mean higher priorities and the default value is 0. If 2 regions have the same priority, the first one created will be used.
Blocking specific commands
You can block specific commands in specific regions by using the command /region flags set <region-name> blocked-cmds <command>
. Example to block command /give
and /op
in a region:
/region flags set <region-name> blocked-cmds /give
,
/region flags set <region-name> blocked-cmds /op
Allow specific commands
You can allow usage of certain commands in a specific region by using the command /region flags set <region-name> allowed-cmds <command>
. Example to allow command /give
and /op
in a region:
/region flags set <region-name> allowed-cmds /give
,
/region flags set <region-name> allowed-cmds /op
This will allow the use of /give
and /op
only, in <region-name>
. No other commands can be used other than these.
Enable opening doors, trapdoors, chests, hoppers etc.
To do this, you can enable the "use" flag for the region. When "use" is set to true, players will be able to interact with such blocks.
Toggle item drops
To allow/disallow item dropping in a region, you can set the flag "item-drops" to true or false by using the command /region flags set <region-name> item-drops true
.
Toggle eating
To allow/disallow eating in a region, you can set the flag "eat" to true or false by using /rg flags set <region-name> eat true/false
.
Prevent leaf decay
If you are using various types of leaves for decorating regions of your server you might have noticed that if said leaves are not attached to wood they will eventually decay and despawn. WorldGuard provides a flag specifically for that issue.
To prevent leaf decay in a certain area use /region flags set <region-name> allow-leaves-decay false
Prevent plant growth
If you want to stop plants from growing (i.e freeze crops in their current state, prevent grass growth, etc.) you can use the 'allow-plant-growth' flag like this: /rg flags set <region-name> allow-plant-growth false
Prevent block spreading
If you want to stop blocks like Mycelium or Grass from spreading to other blocks you can use the 'allow-spreading' flag like this: /rg flags set <region-name> allow-spreading false
Prevent burning of blocks
If you want to stop blocks from burning away set the allow-block-burn
flag to false.
Disable explosion
To disable explosion in a region, set the flag "explosion" to false. You can set it to true if you want to enable it.
More Flags
-
notify-enter: Send a message when player enters a region. Usage:
/region flags set <region-name> notify-enter Hello, you have entered this region.
-
notify-leave: Send a message when player leaves a region. Usage:
/region flags set <region-name> notify-leave Hello, you have left this region.
- allowed-enter: Allow/disallow players from entering a region. Set this flag to true or false.
- allowed-leave: Allow/disallow players from leaving a region. Set this flag to true or false.
-
whitelist: Add player to whitelist. Usage:
/region flags set <region-name> whitelist muqsitrayyanxo
- fly-mode: Let players fly in the region
-
- 0 => Shows vanilla behaviour.
-
- 1 => Flight mode enabled.
-
- 2 => Flight mode disabled.
-
- 3 => Flight mode enabled, but is disabled once the player leaves the region.
- enderpearl: Allow/disallow use of ender pearls (true/false).
- send-chat: Allow/disallow players to chat (true/false).
- receive-chat: Allow/disallow players from receiving chat (true/false).
- game-mode: Set a region's game-mode. (0, 1, 2, 3).
- sleep: Allow or block players from entering beds (true/false).
Reset a flag of a region to default value.
/region flags reset <region-name> <flag>
Customized access to regions
Want to create a VIP store that only vips can access? You can do just that by combining the flag 'allowed-enter' and the permission worldguard.enter.<REGION_NAME>
like this:
Let's assume that our region is called "vip_shop", in that case we would do the following to only allow VIPs to enter: /rg flags set vip_shop allowed-enter false
and then add the 'worldguard.enter.vip_shop' permission to the VIP group or to the user that you wish to access the shop.
Similarily you could prevent a certain group from leaving a region using the 'allowed-leave' and the permission worldguard.leave.<REGION_NAME>
.
Groups and Permissions
These commands allow you to set up permissions for different groups! The multi-group inheritance system to allow you to inherit group permissions.
/addgroup <group>
Adds a new group to the groups list.
/addparent <target_group> <parent_group>
Adds a group to another group inheritance list.
/defgroup <group> [world]
Allows you to set default group.
/fperms
Allows you to find permissions for a specific plugin.
/groups
Shows a list of all groups.
/grpinfo <group> [world]
Shows info about a group.
/listgperms <group> <page> [world]
Shows a list of all permissions from a group.
/listuperms <player> <page> [world]
Shows a list of all permissions from a user.
/ppinfo
Shows info about PurePerms.
/ppsudo <login / register>
Registers or logs into your Noeul account.
/ppreload
Reloads all PurePerms configurations.
/rmgroup <group>
Removes a group from the groups list.
/rmparent <target_group> <parent_group>
Removes a group from another group inheritance list.
/setgperm <group> <permission> [world]
Adds a permission to the group.
/setgroup <player> <group> [world]
Sets group for the user.
/setuperm <player> <permission> [world]
Adds a permission to the user.
/unsetgperm <group> <permission> [world]
Removes a permission from the group.
/unsetuperm <player> <permission> [world]
Removes a permission from the user.
/usrinfo <player> [world]
Shows info about a user.
Using MultiWorlds
All MultiWorld commands starts with /mw
(/multiworld
) except for the /gamerule
command that was added as an alias to change game rules from settings.
In game, you can get list of all commands using commands /mw help
All MultiWorld Commands:
Command | Description |
---|---|
/mw help |
Displays list of all MultiWorld commands Alias: /mw ? Usage: /mw help <page: 0-1>
|
/mw create |
Generate new world using seed and generator Aliases: /mw new , /mw generate Usage: /mw create <levelName> [seed] [generator] Seed is value seed is the initial value by which the world is generated, when you set it empty, world will be generated by random number. You can use 6 generators ( Normal , Nether , End , Void , SkyBock and Nether_Old = Nether generator without glowstone and quartz ore) |
/mw teleport |
Teleports you or selected player to world spawn Aliases: /mw tp , /tp move Usage: /mw tp <levelName> [player] If you are using Slapper plugin and after you click on the npc you want to move the player to another world, you can use /slapper edit <id> addcommand mw tp <world> {player} command |
/mw list |
Displays list of all levels Alias: /mw ls Usage: /mw list
|
/mw info |
Displays level information Alias: /mw i Usage: /mw info This command can be used only in game |
/mw delete |
Remove level Aliases: /mw del , /mw dl , /mw remove , /mw rm Usage: /mw remove <level> Default level can not be deleted |
/mw update |
Change spawn, lobby or default level Aliases: /mw ue Usage: `/mw update <spawn |
/mw load |
Loads level Aliases: /mw ld Usage: /mw load <level>
|
/mw unload |
Unloads level Aliases: /mw unld Usage: /mw unload <level>
|
/mw gamerule |
Manages with level game rules Aliases: /gamerule , /mw gr , /mw gamer , /mw grule Usage: `/gamerule <list |
/mw manage |
Opens form world manager Aliases: /mw mg , /mw mng ,Usage: `/mw manage <list |
/mw rename |
Renames world Aliases: /mw rnm , /mw re Usage: /mw rename <oldName> <newName>
|