Command Reference - Multiverse/Multiverse-Core GitHub Wiki
Installation -> Basics -> Permissions -> Command Reference |
If you're looking for the Multiverse-Portals, Multiverse-NetherPortals or Multiverse-Inventories Command References, click the links!
Looking for just the permissions?
Click here to go the Big List O' Permissions!
- Anchor Command
- Clone Command
- Confirm Command
- Coordinate Command
- Create Command
- Debug Command
- Delete Command
- Environment Command
- Gamerule Command
- Gamerules Command
- Help Command
- Import Command
- Information Command
- List Command
- Modify Command
- Purge Command
- Regen Command
- Reload Command
- Remove Command
- Set Spawn Command
- Silent Command
- Spawn Command
- Teleport Command
- Unload Command
- Who Command
In Multiverse 2, we have included a handy new help system. To access this help, simply type:
/mv
In order to properly read this command reference, we'll walk through reading the "usage" of a command.
Whenever reading this wiki or the in-game /mv
help, you should remember that items in ALL CAPS should be replaced with a variable. Items in lowercase should be typed exactly how they appear.
Items inside square braces ([]
) are OPTIONAL where items inside curly braces ({}
) are REQUIRED
Let's look at a simple one first:
This means that this command has one optional parameter, meaning you could type /mv info
or /mv info world
. Obviously, the command will do different things with or without its params. You can tell what those effects are by reading this wiki.
Let's look at the most complex example:
NOTE: This is the most complex command in MV2 and in order to use it correctly, please refer to the Create Command.
/mv create {NAME} {ENV} -s [SEED] -g [GENERATOR[:ID]]
At first, you will notice that there are 2 required params, NAME, and ENV. Then you will see the flags afterward. If you want to use a seed you must add -s gargamel
to the command string. If you want a generator the same principle applies: -g BukkitFullOfMoon
. Full examples of this command are located at the Create Command reference
Displays a listing of all worlds that you can enter.
/mv list
/mv list
/mv list
/mvl
/mvlist
multiverse.core.list.worlds
The list command will only show you the worlds that you have access to enter. For example, if you are blacklisted in sky
but not in world
and world_nether
, when you type /mvlist
you would see:
Worlds which you can view:
world - NORMAL
world_nether - NETHER
This allows you to have worlds that are completely unknown to people. Keep in mind though, if you're in a world that someone else cannot view, and you chat from it, your chat prefix would be of that world. Here is an example of a world listing. NOTE: To get colored worlds, you will need to use the world alias feature.
Displays the Multiverse help pages.
/mv [FILTER] [PAGE #]
/mv
/mv 3
/mvh del
/mvh mod 2
/mv
/mvh
/mvhelp
/mv help
/mvsearch
/mv search
multiverse.help
Displays an in game help menu for Multiverse. This will only show users commands they have access to. Use the optional integer parameter to indicate which page you would like to view. The total number of pages will be displayed once you use /mv
for the first time.
The help command now supports searching! This means if you type /mvh del
you will see a list of all commands whose name
, description
, alias(s)
or usage
contain 'del'. These results may be paged, depending on how long your search string, so to see another page of a search simply do: /mvh del 2
.
NOTE: When searching, if you try: /mv delete
you will see the help for the Delete Command. This is because you have hit the nail on the head with your search: you typed the exact name of a command! If you wish to search for any commands that contain the word 'delete', use any of the other help aliases: /mvh delete
, /mvhelp delete
, /mv help delete
...
Here is an example use of the Help command while given OP status. This example also has Multiverse-Portals and Mutliverse-NetherPortals installed, which is why there are 5 pages.
Displays information about the world you're in or the world you pass in.
/mv info [WORLD] [PAGE #]
/mv info
/mv info 2
/mv info world
/mv info world 2
/mv info ...
/mvi ...
/mvinfo ...
multiverse.core.info
The info command is currently UNFINISHED it is primarily used so that you can tell the developers exactly how MV knows your world is configured. You can also use it to ensure that the world is behaving the way you want it to. Please consider this a debug command for right now.
Creates a new world and loads it.
/mv create {NAME} {ENV} [-s SEED] [-g GENERATOR[:ID]] [-t TYPE] [-a true|false]
/mv create my_world NORMAL
/mv create my_hell NETHER
/mv create my_cloud_world -g SkyLandsPlus NORMAL
/mv create flat_world NORMAL -t FLAT
/mv create "My-Seed-World" NORMAL -s gargamel
/mv create moon NORMAL -g BukkitFullOfMoon
/mv create Custom-world-with-a-generator-and-an-ID NORMAL -g BukkitFullOfMoon:Dinnerbone
/mv create Custom-generator-world-with-seed NORMAL -g BukkitFullOfMoon:Dinnerbone -s gargamel
/mv create example NORMAL -g "BananaGen:hilly,tscale=35.0,terrainheight=15.0,notorches"
/mv create ...
/mvc ...
/mvcreate ...
multiverse.core.create
The create command allows you to add new worlds to your server thus allowing many different worlds of many different types. Each world has many properties that you can edit and tweak. Please see the World Properties page for information on each of these settings. In addition, you can modify worlds in game by using the /mv modify
command. Please see the appropriate section below for Seeds or Custom Generators.
When you are going to create a new world you MUST specify a name and environment. Valid environments can be seen by using /mv env
. Your world names CANNOT have spaces, use the Alias Feature for that.
You can create a world with a custom seed by adding -s SEEDNAME
after the 2 required params. Here is an example that creates the famed gargamel world and names it mountain_world:
/mv create mountain_world NORMAL -s gargamel
As of Minecraft 1.1, the concept of world types has been introduced. These seem to be like generators but baked into Minecraft itself. Currently, there are only FLAT
, LARGEBIOMES
, AMPLIFIED
, NORMAL
, NETHER
, and END
for world types. To use a world type, simply use the -t
parameter, for type. Here is a flat normal world:
/mv create flat_world NORMAL -t FLAT
As of Minecraft 1.1 if you want a flat world with no structures, all you have to do is add the -a false
flag. We used -a
for Allow Structures and because -g
was already taken.
*NOTE: This will only work with NORMAL
worlds.
/mv create flat_world NORMAL -t FLAT
Currently, there are only FLAT
and NORMAL
for world types.
Multiverse 2 supports Custom Generators. What does this mean? We support any plugin that makes use of the Bukkit custom generator feature. If an author has implemented their own style that does NOT use the custom generator method described here, it may not work with MV. We will try and keep an updated page of Custom Generator Plugins.
Once you've found a plugin you want to use, copy the jar of that plugin to your plugins folder. Then all that's left to do is type a single command:
(For this example I've decided to use BukkitFullOfMoon which will generate a cratered moon world by @Dinnerbone).
/mv create moon NORMAL -g BukkitFullOfMoon
The BukkitFullOfMoon
above is the plugin name. This plugin only has one generator, and it's defined correctly, so the :GENID
is needed. Some plugins may contain multiple generators, in which case you would type this: (This next one I'm making up entirely...)
/mv create land_lake NORMAL -g WaterWorlds:Lakes
OR
/mv create hell_lake NORMAL -g WaterWorlds:LavaLakes
You should know that if you decide to use spaces in your world name that whenever people want to use /mv tp
, /mv modify
or any command that takes the world name as a param, they will have to surround the name in quotes, like so:
/mv tp "My world name with spaces"
/mv tp My world name with spaces
will NOT work.
Imports an existing world folder.
/mv import {NAME} {ENV} [GENERATOR[:ID]]
/mv import my_world NORMAL
/mv import my_hell NETHER
/mv import my_cloud_world SKYLANDS
/mv import moon NORMAL -g BukkitFullOfMoon
/mv import ...
/mvi ...
/mvimport ...
multiverse.core.import
The import command is almost identical to the create command apart from the fact that it is used to import a world folder that already exists. Since the world already exists, you cannot apply a new seed to it, however currently you MUST provide the correct environment AND Generator for the imported world. If you do not, bad things will happen to your world. We are working to remove these requirements. For this command, you do NOT need the -g
when specifying a generator and in fact, you will receive an error message if you provide the -g
.
Reloads worlds.yml and config.yml.
/mv reload
/mv reload
/mv reload
/mvr
/mvreload
multiverse.core.reload
The reload command will reload any Multiverse-Core as well as any Official Multiverse Plugin configs. Any values currently loaded into memory will be replaced with the config values. These configs also get reloaded on plugin load/server restart, so there is no need to use if after one of those. Any value in worlds.yml
can be modified in game by using the /mvmodify
command
Sets the respawn point for the current world.
/mv set spawn
/mv set spawn
/mv set spawn
/mvss
/mvsetspawn
multiverse.core.spawn.set
The set spawn command does exactly what it sounds like. You can walk to where you want players to spawn, type /mv set spawn
and it's set. To go to the spawn you can use /mv spawn
.
Displays your current coordinates.
/mv coord
/mv coord
/mv coord
/mvcoord
multiverse.core.coord
This command simply displays where you are and where you're looking/standing. Useful for getting un-lost.
Allows you to teleport to a different world.
/mv tp [PLAYER] {WORLD}
/mv tp world
/mv tp Rigby90 world_nether
/mv tp ...
/mvtp ...
multiverse.teleport.self.NAME
multiverse.teleport.other.NAME
The teleport command allows you to teleport yourself or others to a specified world. There are many different permissions associated with this command, with the categories being self
and other
; allowing you to teleport yourself and others respectively.
Each Type of Destination will have each of the permissions (self
and other
) associated with it. The most basic example is for worlds:
multiverse.teleport.self.w
multiverse.teleport.other.w
The letter(s) at the end are the identifier for the destination. This is the same thing you would put before the destination if you teleport to it: /mv tp w:MyWorld
. So Portals would be:
multiverse.teleport.self.p
multiverse.teleport.other.p
Even if you have the multiverse.teleport.other.w
permission, you can only teleport people to worlds where YOU can go yourself. This will allow you to teleport a player to a world that they themselves cannot go to, as long as you have the permission to do so.
Please see the FAQ for why this change was made (Old permissions were simply multiverse.core.tp.[self|other]
!
/mvtp
can be used with Destinations as seen in Destinations
Displays who is in which world(s).
/mv who [WORLD|-a]
/mv who
/mv who world_nether
/mv who -a
/mv who --all
/mv who ...
/mvw ...
/mvwho ...
multiverse.core.list.who
Displays who is currently in which worlds. If you want to see who is in a specific world, pass the world name in as the only parameter. By default, /mv who
will not show worlds that are empty. If you want to see all worlds simply add either -a
or --all
to the end of your command: /mvwho -a
. The -a
/--all
flag will override a world provided.
Here is an example of the mv who
command in use combined with both world aliases and colors.
Teleports you to the spawn.
/mv spawn [PLAYER]
/mv spawn
/mv spawn lithium3141
/mv spawn ...
/mvs ...
/mvspawn ...
multiverse.core.spawn.self
multiverse.core.spawn.other
Allows you to teleport yourself (or another player) to the current world's spawn. If you want to teleport a player to a different world or different location within a world please see /mv tp
. This command does tell the teleportee who teleported them, even if it was the console. This is done to prevent admin abuse.
Unloads a world from the Bukkit server.
/mv unload {WORLD}
/mv unload world
/mv unload ...
/mvunload ...
multiverse.core.unload
This command will ONLY unload the world from the server. It does NOT remove it from the Multiverse Configs OR delete the world folder.
See also: /mv remove
and /mv delete
Unloads a world from the Bukkit server and removes it from the MV configs.
/mv remove {WORLD}
/mv remove world
/mv remove ...
/mvremove ...
multiverse.core.remove
This command will unload the world from the server AND remove it from the Multiverse Configs. It will NOT delete the world folder.
See also: /mv unload
and /mv delete
Unloads a world from the Bukkit server, removes it from the MV configs AND DELETES the world folder.
/mv delete {WORLD}
/mv delete world
/mv delete ...
/mvdelete ...
multiverse.core.delete
This command will destroy the life, universe and everything associated with the world you pass as a parameter. For this reason, this command requires /mv confirm
. Here is an example usage:
/mv delete world
*You now have 10 seconds to type /mv confirm
or the world will NOT be deleted.*
See also: /mv confirm
, /mv unload
and /mv remove
Confirms an action that could destroy the life, the universe and everything.
/mv confirm
/mv confirm
/mv confirm
/mvconfirm
multiverse.core.confirm
This command will confirm a requested action. See the /mv delete
command for an example use. If you fire up your server and type /mv confirm
, nothing will happen.
See also: /mv delete
and /mv tp
Removes the specified entities from the specified worlds
/mv purge [WORLD|all] {all|animals|monsters|MOBNAME}
/mv purge all
/mv purge world all
/mv purge all all
/mv purge world CREEPER
/mv purge world CREEPER,PIG,ZOMBIE
/mv purge all monsters
/mv purge
/mvpurge
multiverse.core.purge
The Purge command allows you to remove all of a specified type of entity from a world. Understand that if the spawn rules allow the purged type of mob to spawn, they'll populate almost instantly after the purge. This is used to clear out any remaining mobs from a setting change or if a user abuses a mob spawn command.
If you specify the first parameter as all
All worlds will be purged of the specified mob type. You are allowed to specify multiple mob types. Feel free to mix monsters and animals.
Clones a world (Copies a world directory to another directory)
/mv clone world NewWorldName
/mv clone world world_backup
/mv clone myworld_nether myworld_nether_backup
/mv clone
/mvclone
multiverse.core.clone
The Clone command allows you to copy your world to another directory for a backup or to simply have two of the world for whatever reason you'd like.
Regenerates a world
/mv regen {WORLD} [-s [SEED]]
/mv regen world
/mv regen world -s
/mv regen world -s 11546315
/mv regen
/mvregen
multiverse.core.regen
The Regen command allows you to regenerate your world to where EVERYTHING built gets destroyed and regenerated. If the -s
argument is provided, a new seed will be used, and if no seed is specified, a random one will be generated. Otherwise, the world will be regenerated using the same seed.
The modify command has been documented as 4 separate sections for easier documentation. Please see the links below.
/mv modify set ...
/mv modify add ...
/mv modify remove ...
/mv modify clear ...
Modifies a world's variable
/mv modify set {PROPERTY} {VALUE} [WORLD]
/mv modify set animals false
/mv modify set pvp true world
/mv modify set diff 0
/mv modify set diff hard world_extreme
/mv modify set respawnWorld respawn_world death_world
/mv modify set ...
/mvmodify set ...
/mvm set ...
/mvmset ...
multiverse.core.modify
The modify command lets you set the variables for your Multiverse worlds in game without needing to ever edit a config file. The set
command sets a non-array value. An example would be turning animal spawning on, or setting the world scale to 2. The PROPERTY value that is required for this command must be one of the values listed below. If you do not specify a world, the current world will be used. A world is required from the console.
- alias - String
- color - String
- Must be one of these:
AQUA, BLACK, BLUE, DARKAQUA, DARKBLUE, DARKGRAY, DARKGREEN, DARKPURPLE, DARKRED, GOLD, GRAY, GREEN, LIGHTPURPLE, RED, YELLOW, WHITE
- Must be one of these:
- animals - Boolean
- monsters - Boolean
- pvp - Boolean
- scale/scaling - Double
- price - How much it costs to enter the world. Enter 0 for free. Enter negative value for debit, positive value for credit.
- currency/curr - What it costs to enter the world in the form of an Item ID (-1 to use the econ plugin you have installed)
- respawnWorld - String
- This value can either be the Name of a world or the Alias of that world. Space CAN be used.
- mode/gamemode - String
- Sets the mode for all players in a world. Must be
creative
,survival
oradventure
- Sets the mode for all players in a world. Must be
- diff/difficulty - String/Integer
- Sets the difficulty of a world. You can use string or integers:
- Possible values are PEACEFUL - 0, EASY - 1, NORMAL - 2, HARD - 3
- weather - Boolean
- Turn weather on/off.
See the World Properties page for more detail on these variables.
The second item is the type required. This means you cannot do /mv modify set scale fish
or /mv modify set animals 7
The animals
and monsters
values, when used with set
, will set the overall spawn behavior of animals/monsters. If you have any monsters in the monsters
list and you /mv modify set monsters true
you're saying: "I want monsters to spawn, except the ones in the monsters list"
See also: /mv modify {add/remove}
and /mv modify clear
Adds or Removes a value to a world's property
/mvmodify {add|remove} {VALUE} {PROPERTY} [WORLD]
/mvmodify add creeper monsters
/mvmodify remove sheep animals world_nether
/mvmodify {add|remove} ...
/mv modify {add|remove} ...
/mvm add|remove} ...
/mvmadd ...
/mvmremove ...
multiverse.core.modify
The modify command lets you add or remove values in each world without needing to ever edit a config file. The add
and remove
sub-commands allow you to add and remove values from variables that contain lists, such as player white lists or which animals are allowed to spawn. If you do not specify a world, the current world will be used. A world is required from the console.
- worldblacklist - String: What worlds can you not go to from here.
- animals - String
- monsters - String
See the World Properties page for more detail on these variables.
The second item is the type required. This means you cannot do `/mvmodify add fernferret blockblacklist
The animals
and monsters
values when used with add
or remove
will add or remove specific animals/monsters. If you have the monsters (the boolean one that you can use set
with) set to true and then add monsters to the list using /mvmodify add
You are saying "I want monsters to spawn, except the ones in the monsters list"
See also: /mvmodify set
and /mvmodify clear
Clears all values from a list property
/mv modify clear {PROPERTY} [WORLD]
/mv modify clear worldblacklist
/mv modify clear monsters world_nether
/mvmodify clear ...
/mv modify clear ...
/mvm clear ...
/mvmclear ...
multiverse.core.modify
The modify clear command lets you clear an entire list without having to use a bunch of /mv modify remove ...
commands. If you do not specify a world, the current world will be used. A world is required from the console.
worldblacklist
animals
monsters
See the World Properties page for more detail on these variables.
See also: /mv modify set
and /mv modify {add|remove}
Sets a Minecraft game rule for a world.
/mv gamerule {RULE} {VALUE} [WORLD]
/mv gamerule mobGriefing false
/mv gamerule doFireTick false world1
/mvgamerule
/mv rule
/mvrule
multiverse.core.gamerule.set
Allows setting vanilla Minecraft game rules.
When called from console, [WORLD]
is required. When called in-game, omitting [WORLD]
will result in changing the rule for the player's current location.
All the game rules are case sensitive.
- commandBlockOutput - Boolean
- Whether command blocks should notify admins when they perform commands.
- doFireTick - Boolean
- Whether fire should spread.
- doMobLoot - Boolean
- Whether mobs should drop items.
- doMobSpawning - Boolean
- Whether mobs should naturally spawn.
- doTileDrops - Boolean
- Whether blocks should have drops.
- keepInventory - Boolean
- Whether the player should keep items in their inventory if they die.
- mobGriefing - Boolean
- Whether creepers, endermen, ghasts, and withers should be able to change blocks or zombies, skeletons, and zombie pigmen can pick up items.
Lists the set gamerules for a given world.
/mv gamerules [WORLD]
/mv gamerules
/mvgamerules
/mv rules
/mvrules
multiverse.core.gamerule.list
Lists all the gamerules with set values for a given world.
Displays the valid environments.
/mv env
/mv env
/mvenv
/mv env
multiverse.core.list.environments
Displays all valid environments that this Bukkit server knows about.
Causes several of the startup messages to be hidden when silent mode is enabled.
/mv silent [true|false]
/mv silent
/mv silent true
multiverse.core.silent
Causes several of the startup messages to be hidden when silent mode is enabled. May also apply to other messages later.
Provides detailed information on what the plugin is doing in console. Helpful for permission issues or destination issues.
/mv debug [0, 1, 2, 3]
/mv debug 0
(Turns it off)
/mvdebug 3
multiverse.core.debug
0 - Off
1 -
2 -
3 - All details
Anchors should be used if you have a place you want to go frequently. Using the /mv anchor NAME
command to first create an anchor, you can then use it in any command that takes a destination.
/mv anchor NAME [-d]
/mv anchor
- Lists the current anchors
/mv anchor NAME
- Creates the anchor with the name "NAME"
/mv anchor NAME -d
- Deletes the anchor "NAME"
None
multiverse.teleport.self.a
multiverse.teleport.other.a
A destination for frequently used teleports.
Installation -> Basics -> Permissions -> Command Reference |