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.

Optional vs. Required Params

Items inside square braces ([]) are OPTIONAL where items inside curly braces ({}) are REQUIRED

Simple command example

Let's look at a simple one first:

/mv info [WORLD]

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.

Complex command example

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

List Command

Description:

Displays a listing of all worlds that you can enter.

Usage:

/mv list

Example:

/mv list

Aliases:

/mv list
/mvl
/mvlist

Permission:

multiverse.core.list.worlds

Details:

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.

Help Command

Description:

Displays the Multiverse help pages.

Usage:

/mv [FILTER] [PAGE #]

Examples:

/mv
/mv 3
/mvh del
/mvh mod 2

Aliases:

/mv
/mvh
/mvhelp
/mv help
/mvsearch
/mv search

Permission:

multiverse.help

Details:

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.

Information Command

Description:

Displays information about the world you're in or the world you pass in.

Usage:

/mv info [WORLD] [PAGE #]

Examples:

/mv info
/mv info 2
/mv info world
/mv info world 2

Aliases:

/mv info ...
/mvi ...
/mvinfo ...

Permission:

multiverse.core.info

Details:

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.

Create Command

Description:

Creates a new world and loads it.

Usage:

/mv create {NAME} {ENV} [-s SEED] [-g GENERATOR[:ID]] [-t TYPE] [-a true|false]

Examples:

/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"

Aliases:

/mv create ...
/mvc ...
/mvcreate ...

Permission:

multiverse.core.create

Details:

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.

World Name and Environment

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.

Seeds

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

World Types

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

Map Features (Generate Structures)

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.

Generators

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

/mv tp ...
/mvtp ...

Permission:

multiverse.teleport.self.NAME
multiverse.teleport.other.NAME

Details:

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]!

Destinations:

/mvtp can be used with Destinations as seen in Destinations

Who Command

Description:

Displays who is in which world(s).

Usage:

/mv who [WORLD|-a]

Examples:

/mv who
/mv who world_nether /mv who -a /mv who --all

Aliases:

/mv who ...
/mvw ...
/mvwho ...

Permission:

multiverse.core.list.who

Details:

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.

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

Confirm Command

Description:

Confirms an action that could destroy the life, the universe and everything.

Usage:

/mv confirm

Examples:

/mv confirm

Aliases:

/mv confirm
/mvconfirm

Permission:

multiverse.core.confirm

Details:

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.

Purge Command

Description:

Removes the specified entities from the specified worlds

Usage:

/mv purge [WORLD|all] {all|animals|monsters|MOBNAME}

Examples:

/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

Aliases:

/mv purge /mvpurge

Permission:

multiverse.core.purge

Details:

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.

Clone Command

Description:

Clones a world (Copies a world directory to another directory)

Usage:

/mv clone world NewWorldName

Examples:

/mv clone world world_backup
/mv clone myworld_nether myworld_nether_backup

Aliases:

/mv clone /mvclone

Permission:

multiverse.core.clone

Details:

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.

Regen Command

Description:

Regenerates a world

Usage:

/mv regen {WORLD} [-s [SEED]]

Examples:

/mv regen world /mv regen world -s /mv regen world -s 11546315

Aliases:

/mv regen /mvregen

Permission:

multiverse.core.regen

Details:

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.

Modify Command

Description:

The modify command has been documented as 4 separate sections for easier documentation. Please see the links below.

Usage:

/mv modify set ...
/mv modify add ...
/mv modify remove ...
/mv modify clear ...

Modify Command (Set)

Description:

Modifies a world's variable

Usage:

/mv modify set {PROPERTY} {VALUE} [WORLD]

Examples:

/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

Aliases:

/mv modify set ...
/mvmodify set ...
/mvm set ...
/mvmset ...

Permission:

multiverse.core.modify

Details:

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.

Variables you can set:

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
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 or adventure
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

A note about animals and monsters:

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"

Modify Command (Add/Remove)

Description:

Adds or Removes a value to a world's property

Usage:

/mvmodify {add|remove} {VALUE} {PROPERTY} [WORLD]

Examples:

/mvmodify add creeper monsters
/mvmodify remove sheep animals world_nether

Aliases:

/mvmodify {add|remove} ...
/mv modify {add|remove} ...
/mvm add|remove} ...
/mvmadd ...
/mvmremove ...

Permission:

multiverse.core.modify

Details:

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.

Variables you can add to or remove from:

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

A note about animals and monsters:

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

Modify Command (Clear)

Description:

Clears all values from a list property

Usage:

/mv modify clear {PROPERTY} [WORLD]

Examples:

/mv modify clear worldblacklist
/mv modify clear monsters world_nether

Aliases:

/mvmodify clear ...
/mv modify clear ...
/mvm clear ...
/mvmclear ...

Permission:

multiverse.core.modify

Details:

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.

Variables you can clear:

worldblacklist
animals
monsters

See the World Properties page for more detail on these variables.

See also: /mv modify set and /mv modify {add|remove}

Gamerule Command

Description:

Sets a Minecraft game rule for a world.

Usage:

/mv gamerule {RULE} {VALUE} [WORLD]

Examples:

/mv gamerule mobGriefing false
/mv gamerule doFireTick false world1

Aliases:

/mvgamerule
/mv rule
/mvrule

Permission:

multiverse.core.gamerule.set

Details:

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.

Game rules you can set:

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.

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.