Commands

Commands may be used by players, operators and the Command Block while in multiplayer connected to a Minecraft server, and in singleplayer when the user has cheats enabled for the world (cheats are enabled during world creation via the "More World Options..." button). Some commands are also available in singleplayer even when cheats are not enabled. Commands may be entered from a Minecraft client while in the game or on the host computer's server console.

Commands being entered into the Minecraft client itself must be prefixed by a slash (example: ). The command window is identical to the chat window and can be accessed by pressing or starting directly by entering a slash.

Commands being executed via the console are not preceded by a slash. Commands in command blocks can be preceded by a slash, but this is not required.

Pressing cycles through possible commands or arguments.

In the following tables, required arguments appear in, and optional arguments appear in [square brackets]. Arguments in italics should be replaced by an appropriate value; arguments in plain text must be entered exactly as shown.

Player commands
These commands can be used in the chat window by any player who is allowed to connect to a server, and can also be used in singleplayer whether or not cheats are enabled.

doesn't protect.) Useful when lost, stuck or to restore health and hunger (assuming you can get your items back easily). Also displays message "Ouch. That looks like it hurt." || Cannot be used in a command block.
 * publish|| Opens your single-player game for LAN friends to join. This command appears in the singleplayer cheats. || Cannot be used in a command block.
 * playsound  [x] [y] [z] [volume] [pitch] [minimumVolume]|| Plays the selected sound to the selected player. The format for playing sounds are as follows:
 * playsound  [x] [y] [z] [volume] [pitch] [minimumVolume]|| Plays the selected sound to the selected player. The format for playing sounds are as follows:
 * playsound  [x] [y] [z] [volume] [pitch] [minimumVolume]|| Plays the selected sound to the selected player. The format for playing sounds are as follows:

Example: Sound located at .minecraft\assets\sound\mob\pig\death.ogg

The value for sound would be written as mob.pig.death, as the command originates from the sound folder. For sequentially numbered files pertaining to the same event (Example: various walking sounds), the player must exclude the number of the sound.

Example: Sound located at .minecraft\assets\sound\mob\pig\say[1-3].ogg

The value for sound would be written as mob.pig.say in this case. Since there are multiple mob.pig.say files (say1, say2, and say3), the command will play a randomly selected sound out of the three available.

The coordinates x, y, and z are the coordinates to play the sound from. If prefixed with "~", they will be relative to the player's current location. Note that "~" is shorthand for "~0", and thus "~ ~ ~" can be used as a substitute for the player's current location.

The volume argument controls the distance from which a sound may be heard. At values less than 1.0, the sound will be quieter and have a smaller sphere within which it may be heard. At values greater than 1.0, the sound will not actually grow louder, but its audible range (a 16-block radius at 1.0) will be multiplied by volume.

The minimumVolume argument controls the volume of the sound outside its normal audible sphere. Note that the sound inside this sphere may actually be less than the volume of the sound outside this sphere, if volume is less than minimumVolume.

The pitch argument alters both the pitch and the duration of the sound.
 * player must be online, volume must be at least 0.0, pitch must be between 0.0 and 2.0 (inclusive), minimumVolume must be between 0.0 and 1.0 (inclusive), and the player must be able to hear the sound from where it is played.
 * say ||Broadcasts message to all players on the server. If a multi-person target selector (e.g. @a) is used, the list of names is formatted as "name1, name2, and name3", or "name1 and name2" for two names. Therefore, regardless of any target selectors which are used, this command will only output once.|| All target selectors (e.g. @p) in the message must evaluate.
 * scoreboard ||See Scoreboard for more information. Scoreboard-specific commands.||Main Article
 * seed|| Displays the seed. This command can always be used in single-player mode, regardless of whether cheats are enabled or not. || Always succeeds (if user is a command block, player in singleplayer, or server op).
 * setblock     [datavalue] [oldblockHandling] [datatag]||Places the block in the x, y and z coordinates specified.||tilename must exist, datavalue must exist if specified, oldBlockHandling must be either replace, keep or destroy if specified and datatag must evaluate if specified.
 * spawnpoint  [x y z] || Sets the spawnpoint of that player to that position, or to the current position if x y and z are not specified. Player is optional if x y z are not specified; will set the spawnpoint of the user to their current location. NOTE: Spawnpoint coordinates must be specified in whole numbers. No decimals. || Player must be online, and x, y, and z must be within the range -30,000,000 to 30,000,000 (inclusive). NOTE: Sleeping in a bed will also set a spawn point where the bed is, but you can only sleep in beds at night.
 * spreadplayers   [spreadDistance] [maxRange]  ||This command allows players to spread out over a long or short distance.
 * setblock     [datavalue] [oldblockHandling] [datatag]||Places the block in the x, y and z coordinates specified.||tilename must exist, datavalue must exist if specified, oldBlockHandling must be either replace, keep or destroy if specified and datatag must evaluate if specified.
 * spawnpoint  [x y z] || Sets the spawnpoint of that player to that position, or to the current position if x y and z are not specified. Player is optional if x y z are not specified; will set the spawnpoint of the user to their current location. NOTE: Spawnpoint coordinates must be specified in whole numbers. No decimals. || Player must be online, and x, y, and z must be within the range -30,000,000 to 30,000,000 (inclusive). NOTE: Sleeping in a bed will also set a spawn point where the bed is, but you can only sleep in beds at night.
 * spreadplayers <x> <z> [spreadDistance] [maxRange] <respectTeams true | false> <player ...>||This command allows players to spread out over a long or short distance.
 * spawnpoint <player> [x y z] || Sets the spawnpoint of that player to that position, or to the current position if x y and z are not specified. Player is optional if x y z are not specified; will set the spawnpoint of the user to their current location. NOTE: Spawnpoint coordinates must be specified in whole numbers. No decimals. || Player must be online, and x, y, and z must be within the range -30,000,000 to 30,000,000 (inclusive). NOTE: Sleeping in a bed will also set a spawn point where the bed is, but you can only sleep in beds at night.
 * spreadplayers <x> <z> [spreadDistance] [maxRange] <respectTeams true | false> <player ...>||This command allows players to spread out over a long or short distance.
 * spreadplayers <x> <z> [spreadDistance] [maxRange] <respectTeams true | false> <player ...>||This command allows players to spread out over a long or short distance.

x and z mark the center of the area across which players are to be spread. spreadDistance is the rough minimum distance players will be spread apart.

maxRange is the maximum distance from x, z where players will be put. Note that this distance is not a circular radius; it represents the maximum distance on either coordinate (thus forming a box ranging from x-maxRange to x+maxRange and z-maxRange to z+maxRange).

respectTeams may be true or false, and represents whether players should be moved individually or teams should be kept together. player ... is the list of players to spread.


 * x and z must be within the range -30,000,000 to 30,000,000 (exclusive), spreadDistance must be at least 0, maxRange must be at least 1.0 greater than spreadDistance, and there must not be too many players to fit within the area (note that if maxRange is larger than 30,000,000, this can fail with even one player if it attempts to place them in the Far Lands).
 * summon <EntityName> [x] [y] [z] [DataTag]|| Spawns desired entity. For example,  would create a saddled pig named Mr. Pig at the player's current location.||x and z must fall within the range -30,000,000 to 30,000,000 (exclusive), and y must be at least 0. If coordinates aren't specified the entity will spawn at the player's location.
 * tellraw <player> <raw message>|| Sends a message to a specified player, or to every player online on a server. Links can also be sent, with customizable actions when they are clicked, for example giving an apple to a player or teleporting the player to another location. This command can also be used to fake player messages.|| The specified player must be online, and the text message must have quote marks (") at the beginning and at the end for the command to work.
 * testforblock <x> <y> <z> <tilename> [datavalue] [datatag]||Used to test whether a particular block is in the x, y and z coordinates specified.||tilename must exist, datavalue must exist if specified, and datatag must evaluate if specified.
 * time set <number | day | night>||Sets the world time. number is an integer between 0 and 24000, inclusive, where 0 is dawn, 6000 midday, 12000 dusk and 18000 midnight.  Number can be greater than 24000; in this case, the the time of day wraps around, but the moon's phase is advanced.  However, Setting the time "backward" (earlier than the current time) does not change the moon.  "time set day" sets the time to 1000(As of 1.7), and "time set night" sets the time to 12500. || Number must be 0 or positive, or "day" or "night".
 * time add <number> ||Increments the world time, as above. || Number must be 0 or positive.  The daytime wraps, and the moon's phase advances; adding 24000 will advance the moon's phase by one day.
 * toggledownfall||Toggles rain and snow.||Always succeeds.
 * tp [playername] <targetplayer>||Teleports player playername to targetplayer 's location. If no player is specified, it will teleport yourself. || Playername is not optional in command blocks. Both players must be online.
 * tp [playername] <x> <y> <z>||Teleports player playername (or yourself if no player is specified) to coordinates x,y,z. (the y value cannot be smaller than 0). Can also relatively move the player by adding the ~ character before the coordinate value. For example typing /tp John ~3 64 ~3 will teleport a player called John 3 blocks away from his current x and z, and to y 64. || x and z must fall within the range -30,000,000 to 30,000,000 (exclusive), and y must be at least 0. Playername is not optional in command blocks, and the player must be online.
 * weather <clear | rain | thunder> [seconds] || Changes the weather for the specified duration. || Seconds must be at least 1, and cannot be greater than 1000000, and a valid weather condition must be provided.
 * xp <amount> [playername] ||Gives the specified user the given number of orbs. Maximum is 2,147,483,647 per command. Negative amounts may not be used to remove experience points. || Amount can be at most 2,147,483,647. Playername is not optional in command blocks, and player must be online.
 * xp <amount>L [playername] || Gives playername the amount number of experience levels. Maximum is 2,147,483,647 - if a player is given levels pushing them past this limit, they get reset to 0. Negative amounts may be used to remove experience levels. || Amount must be between -2,147,483,648 and 2,147,483,647, inclusive. Playername is not optional in command blocks, and player must be online.
 * }
 * tp [playername] <targetplayer>||Teleports player playername to targetplayer 's location. If no player is specified, it will teleport yourself. || Playername is not optional in command blocks. Both players must be online.
 * tp [playername] <x> <y> <z>||Teleports player playername (or yourself if no player is specified) to coordinates x,y,z. (the y value cannot be smaller than 0). Can also relatively move the player by adding the ~ character before the coordinate value. For example typing /tp John ~3 64 ~3 will teleport a player called John 3 blocks away from his current x and z, and to y 64. || x and z must fall within the range -30,000,000 to 30,000,000 (exclusive), and y must be at least 0. Playername is not optional in command blocks, and the player must be online.
 * weather <clear | rain | thunder> [seconds] || Changes the weather for the specified duration. || Seconds must be at least 1, and cannot be greater than 1000000, and a valid weather condition must be provided.
 * xp <amount> [playername] ||Gives the specified user the given number of orbs. Maximum is 2,147,483,647 per command. Negative amounts may not be used to remove experience points. || Amount can be at most 2,147,483,647. Playername is not optional in command blocks, and player must be online.
 * xp <amount>L [playername] || Gives playername the amount number of experience levels. Maximum is 2,147,483,647 - if a player is given levels pushing them past this limit, they get reset to 0. Negative amounts may be used to remove experience levels. || Amount must be between -2,147,483,648 and 2,147,483,647, inclusive. Playername is not optional in command blocks, and player must be online.
 * }
 * xp <amount> [playername] ||Gives the specified user the given number of orbs. Maximum is 2,147,483,647 per command. Negative amounts may not be used to remove experience points. || Amount can be at most 2,147,483,647. Playername is not optional in command blocks, and player must be online.
 * xp <amount>L [playername] || Gives playername the amount number of experience levels. Maximum is 2,147,483,647 - if a player is given levels pushing them past this limit, they get reset to 0. Negative amounts may be used to remove experience levels. || Amount must be between -2,147,483,648 and 2,147,483,647, inclusive. Playername is not optional in command blocks, and player must be online.
 * }
 * xp <amount>L [playername] || Gives playername the amount number of experience levels. Maximum is 2,147,483,647 - if a player is given levels pushing them past this limit, they get reset to 0. Negative amounts may be used to remove experience levels. || Amount must be between -2,147,483,648 and 2,147,483,647, inclusive. Playername is not optional in command blocks, and player must be online.
 * }

Multiplayer-only Commands
These commands are usable by ops (operators) from the server console as well as through the chat window when prefixed by the command character (a forward slash). These commands are only available in SMP. With the exception of the list command, none of these commands can be executed by a command block, and none make use of target selectors. Many of these commands can be used on players who have never been to the server, or even on names which are not (or cannot be) registered as Minecraft accounts.

Command-Block-only commands
These commands can be used only in a Command Block and cannot be used in other ways. Command blocks are only obtainable via the  command.

Data tags
As of snapshot 13w36a, NBT tags can be specified for items and entities created with the and  commands. Data tags are Data_structures. The format is similar to JSON. The data is represented as a comma seperated list of pairs. Each pair has the format. The key is the name of the NBT tag and the value is the data that should be assigned to it. The value can be different types:


 * String is a piece of text, can be wrapped with double-quotes. Double quotes have to be used if the String contains commas, curly braces or square brackets. To use double-quotes inside Strings, the quote is escaped by a backslash . If you're forced to use double-quotes, the String can not have a trailing backslash or a backslash. A workaround is to add a space after the backslash. Backslashes themself are not escaped (usual in many Programming Languages). Example:
 * Number are 1 or more digits that can have a leading sign ( / ). A dot is used as decimal mark. Example:
 * Array (or 'List') is multiple, comma seperated values wrapped with square brackets. The containing values do not need to be of the same type. Example:
 * Boolean can either be  or , but using Numbers works, too. When using numbers, everything between 0 and below 1 is false, other is true. Example:
 * Hash is a container for data structures (as explained above). They are wrapped with curly braces. Notice: The Data tag itself is a Hash. Example:

Tag names are case-sensitive, and whitespace outside keys or values is ignored. See Command NBT Tags see the full amount of dataTags that can be added to the commands and.