Commands

Commands are advanced features activated by typing certain strings of text.

Usage
In the client, commands are entered via the chat window, which is displayed by pressing the key (default) or  key. Using the key will also enter the forward slash that commands require as a prefix, so it is a useful shortcut. The and  key can be used to view previously entered text, including all previously executed commands. Pressing while entering commands cycles through possible commands or arguments, and can be used to auto-enter the coordinates of the block looked at before entering chat.

Commands may also be entered in a multiplayer server's console, but are not preceded by a when entered this way. A server admin running commands in this way is often referred to as "ghosting".

Commands in command blocks can be preceded by a slash, but it is not required. Commands in a command block usually also require an optional argument, like a player's username.

The majority of commands are only available in the following situations:


 * In a multiplayer game, entered by an operator or command block.
 * In other multiplayer games, entered by the player who opened a LAN game with cheats enabled, or is hosting their own multiplayer server
 * In singleplayer, if cheats were enabled at world creation (via the "More World Options..." button).

Some player commands are also available in singleplayer even when cheats are not enabled.

Note: In singleplayer worlds where cheats were not enabled at creation, they can be enabled on a temporary basis by opening the current game session to LAN play ( → "Open to LAN", then "Allow Cheats" button and "Start LAN World"). You do not actually need to be on a LAN or have others join. This is not permanent, but will allow the use of commands until you quit the world, and changes you make via commands (items spawned, etc.) will be saved with the world. You can do this each time you start playing the world again. Note that this will disable game pausing for the duration, so while open to LAN, you should get somewhere safe or reload your world before using the Game Menu. Remember that you can disable your LAN world by reloading the world.

Tilde and Caret notation
Many commands allow relative coordinates to be specified using tildes or carets. A number following a tilde or caret specifies an offset from a certain origin rather than a coordinate. The origin depends on the command. For example, in the offset is from the target's starting position. Other common offsets include from the position of the command's execution or from another coordinate specified by the command.

For the tilde, the offsets are in the directions of the world coordinate axes. For the caret, they are along axes originating in the center of the target's head and pointing to the left, forward, and upward, respectively, with respect to the head's tilt angle. For either, the sign of the offset specifies whether the offset is in the positive or negative direction along that axis. A single tilde or caret by itself is shorthand for  or , meaning no offset in that direction.

For example, will teleport the user to the coordinate (0, 64, 0), while  will teleport the user to a position +3 blocks in the "x" direction (i.e., east), keep their current height, and -3 blocks in the "z" direction (i.e., north) and  will teleport the user to a position +3 forwards in the direction the player is looking.

Usually absolute coordinates can be mixed with relative coordinates. For example, will keep the user's "x" and "z" coordinates the same, but teleport them to absolute height of 64. Similarly, will teleport the player 5 blocks to the right, based on the tilt of their head.

Target selectors in Java Edition
In most commands where a player may be specified as an argument, it is possible to "target" one or more players satisfying certain conditions instead of specifying players by name. To target players by condition, choose a target selector variable and, optionally, one or more target selector arguments to modify the conditions to be satisfied.

For example, to change the game mode of all players on team Red to creative mode, instead of specifying them by name individually:

Target selector variables
A target selector variable identifies the broad category of targets to select. There are five variables:




 * Targets the nearest player. When run by the console, the origin of selection will be at (0, 0, 0). If there are multiple nearest players, caused by them being precisely the same distance away, the player who most recently joined the server is selected.


 * Target selector arguments may be used to reduce the set of players from which the nearest player will be selected. For example,  will target the nearest player on team Red even if there are other players closer.


 * The  or  target selector argument can be used to increase the number of nearest players targeted (for example,   or   will target the three nearest players).




 * Targets a random player.


 * Target selector arguments may be used to reduce the set of players from which a random player will be targeted. For example,  will only target a random player from team Red.


 * The  target selector argument can be used to increase the number of random players targeted. For example,   will target three random players.


 * The  argument is not allowed on  . To select a random entity, use   instead.




 * Targets all players, including dead players. No other selector will find dead players, except.


 * Target selector arguments may be used to reduce the set of players targeted. For example,  will only target players on team Red.




 * Targets all entities (including players).


 * Target selector arguments may be used to reduce the set of entities targeted. For example,  will only target cows.




 * Targets only one entity—the entity that executed the command, including dead players. If the executor was not an entity, for instance if the executor was a command block or a server console, this selector will find nothing.


 * Target selector arguments may be used to specify whether the executor is actually eligible to be targeted. For example,  will only target the executor of the command if the executor was a cow on team Red.




 * Targets your agent only.


 * Target selector arguments may be used to target your agent. For example,  will teleport your agent only to specified location.




 * Targets all agents.


 * Target selector arguments may be used to target all agents. For example,  will remove all agents.

Target selector arguments
After a target selector, optional arguments can be used to modify the set of targets selected. When used with  or , arguments narrow down the number of targets from the full list to a specific few. When used with  or , arguments narrow the number of targets down from the full list to a smaller set from which the nearest or random player is selected. When used with, the command user will only be targeted if all arguments pass, otherwise the command will fail.

Add argument-value pairs as a comma-separated list contained within square brackets after the target selector variable:



Arguments and values are case-sensitive. Spaces are allowed around the brackets, equal signs, and commas, except in between the target variable and the first bracket. Commas must be used to separate argument-value pairs.


 * Selecting targets by coordinate


 * — Selects targets based on distance to that exact position. Combine with selecting by distance to select only targets within a certain distance of that specific position, or combine with volume dimensions to select only targets within a certain cubic volume. If it's combined with neither distance nor volume dimensions, the whole world will be selected.


 * The coordinates are doubles and allow values like, and are not center-corrected, meaning   is no longer corrected to   - tilde notation is available for selector argument coordinates.


 * Selecting targets by distance


 * — Selects only targets exactly DISTANCE blocks from the command's execution. If DISTANCE is a range, selects only targets whose distance falls within that range. Only non-negative values are allowed.


 * If a coordinate (above) and either or both radius/i are both defined, the radius/i will center on the coordinate rather than the postion of the command's execution.
 * Ranges are supported to allow for only certain distances.
 * — targets only entities exactly 10 blocks away
 * — targets only entities more than 10 blocks but less than 12 blocks away (inclusive)
 * — targets only entities more than 5 blocks away (inclusive)
 * — targets only entities less than 15 blocks away (inclusive)






 * Selects only targets within the volume defined as starting from the location where the command was executed and extending DX blocks in the "x" direction (i.e., east/west), DY blocks in the "y" direction (i.e., upwards/downwards), and DZ blocks in the "z" direction (i.e., north/south). If an initial coordinate is specified with the,  , and   arguments, that will be used instead of the position of the command's execution for the lower northwestern corner ( ,  , and   still specify distances from that coordinate; they do not specify a separate coordinate). All values are allowed, including negative and partial values.


 * — targets only entities whose hitbox collects with the block region (1~5, 2~7,3~9) (or coordinates {(x,y,z)|x∈[1,6),y∈[2,8),z∈[3,10)}).
 * — targets only entities whose hitbox collects with the block region (1,2,3).


 * It is possible to combine selection by distance and selection by volume, in which case the command will only select targets within the overlap of both regions (within certain radius/i of the volume's lower northwest corner and not outside the defined volume).


 * Selecting targets by scores


 * — Selects only targets with a score in objective OBJECTIVE1 of SCORE1, and a score in objective OBJECTIVE2 of SCORE2.


 * All tested objectives are in a single tag, with a list of individual score selectors between braces afterwards. The selectors inside the braces support ranges.
 * — Selects only entities with a score in objective myscore of exactly 10.
 * — Selects only entities with a score in objective myscore of between 10 and 12.
 * — Selects only entities with a score in objective myscore of 5 or greater.
 * — Selects only entities with a score in objective myscore of 15 or less.
 * — Selects only entities with a score in objective foo of exactly 10, and a score in objective bar of between 1 and 5.


 * Selecting targets by tag


 * — Selects only targets that have the tag TAG.
 * — Selects only targets that do not have the tag TAG.
 * — Selects only targets that have both tag TAG1 and TAG2.
 * — Selects only targets that have neither tag TAG1 nor the tag TAG2.
 * — Selects only targets that have tag TAG1 but not the tag TAG2.
 * — Selects only targets without any tags.
 * — Selects only targets with any tags.


 * — Selects only entities with tag a with tag b without tag c.
 * — Selects only one random player among players with tag a.


 * Selecting targets by team


 * — Selects only targets on team TEAM.


 * — Selects only targets not on team TEAM.


 * — Selects only targets not on any team.


 * — Selects only targets on any team.


 * Selecting targets with a limit


 * — Selects only the specified number of targets at maximum.


 * When used with  or , this argument defaults to 1, so using a higher limit will increase the number of nearest or random targets returned. When used with   or  , this argument returns only a limited number of targets.


 * Using an additional argument, one can specify how the targets are chosen and limited.
 * — sorting by distance, nearest first (default for  )
 * — sorting by distance, farthest first
 * — sorting randomly (default for  )
 * — no sorting (default for  ,  )


 * or  or   — Selects the nearest 3 players.
 * or  — Selects the furthest 4 players.
 * or  — Selects random 4 players.


 * Selecting targets by experience level


 * — Selects only targets with L experience levels.


 * This automatically filters out all non-player targets.
 * This selector supports ranges.
 * — Selects only players with level 10
 * — Selects only players with level 10, 11, or 12
 * — Selects only players with level 5 or above
 * — Selects only players with level 15 or below


 * Selecting targets by game mode


 * — Selects only targets in the specified game mode.
 * — Selects only targets that are not on the specified game mode.
 * Permitted values for GAMEMODE are:
 * : survival mode
 * : creative mode
 * : adventure mode
 * : spectator mode
 * This automatically filters out all non-player targets.


 * or  or   — Selects only players in survival mode.
 * — Selects only players not in spectator mode.


 * Selecting targets by name


 * — Selects only targets named NAME.


 * — Selects only targets not named NAME.


 * If quotes are used around NAME, then spaces are allowed. NAME can only be a simple string, not a JSON text compound.


 * Selecting targets by vertical rotation


 * — Selects only targets with vertical rotation of X_ROTATION.


 * Vertical rotation values vary from -90 facing straight up, increasing to 0 at horizontal, increasing to 90 facing straight down (thus vertical rotation values increase with rotation downwards).
 * This selector supports ranges.


 * — Selects entities with vertical rotation of exactly 10
 * — Selects entities within vertical rotation from 10 to 12 (inclusive)
 * — Selects entities within vertical rotation of 5 or above
 * — Selects entities with vertical rotation of 15 or below


 * Selecting targets by horizontal rotation


 * — Selects only targets with a horizontal rotation of Y_ROTATION.


 * Horizontal rotation values vary from -180/180 (facing due north), to -90 (facing due east), to 0 (facing due south), to 90 (facing due west), to -180/180 again. This argument supports ranges.
 * — Selects entities with horizontal rotation of exactly 10
 * — Selects entities within horizontal rotation from 10 to 12 (inclusive)
 * — Select entities within horizontal rotation of 5 or above
 * — Selects entities within horizontal rotation of 15 or below


 * Selecting targets by type


 * — Selects only targets of the specific entity type.
 * — Selects only targets not of the specific entity type.


 * TYPE must be an entity ID or tags used to identify different types of entities internally (for example,  for creepers,   for regular minecarts,   for primed TNT, etc. Namespaces is acceptable, it can be left out if the namespace is default minecraft:). Entity IDs or tags are case-sensitive and invalid entity IDs will cause the command to fail. One may use   or   to selected entities which are or are not players, respectively.


 * When used with, can change its normal behavior of targeting only players to target other entities.


 * — Selects all creepers.
 * — Selects all entities except chickens and cows.
 * is invalid.
 * — Selects skeletons, wither skeletons and strays.


 * Selecting targets by nbt


 * — Selects only targets with the specified NBT. The NBT is written in its command definition.


 * For example:
 * or  — Selects players on ground.
 * is the same as . The former is not recommended as it imposes extra load to the game.
 * — Selects sheep dyed white.
 * — Selects all slime ball drops.


 * Note: When matching string form of namespaced IDs within a tag, the reference to the ID must be in its full form (i.e. cannot omit namespace).
 * Hence  cannot find any drop as the  field always contains a namespaced ID-converted string.


 * Selecting targets by advancements


 * Since 1.13, target selector uses advancements in place of . The argument name is the advancement id (namespace can be left out when namespaced ). The value is true, false or so.


 * — Selects players who have achieved the advancement minecraft:story/from_obsidian.
 * — Selects players who haven't achieved the advancement minecraft:story/from_obsidian.
 * — Selects players who had armored with iron helmet. The selected players needn't be wearing iron helmet when selected, and needn't have achieved the advancement minecraft:story/obtain_armor.
 * is the same as.

Data tags
A data tag is a sequence of text which describes a data structure using attribute-value pairs. Data tags are used in Java Edition commands to specify complex data for players, entities, and some blocks.

A data tag consists of zero or more attribute-value pairs separated by commas and delineated by curly brackets. Each attribute-value pair consists of an attribute name and the attribute's value, separated by a colon. Some values, however, may themselves contain attribute-value pairs, allowing a data tag to describe a hierarchical data structure.


 * Example:

The data structures that data tags describe are the same ones used in Minecraft's save files. These data structures are described in other articles and commands expect data tags to use the same attribute names (which are case-sensitive):

The defined data structures also expect the values to be of the correct type.

Some commands may require that a number's type be specified by adding a letter (B, S, L, F, D) to the end of the value. For example,  for a short,   for a float, etc. (This doesn't work with I for int.) The letter can be uppercase or lowercase. When no letter is used and Minecraft can't tell the type from context, it assumes double (if there's a decimal point), int (if there's no decimal point and the number is small enough to store as an int), or string (if neither is true). A square-bracketed literal is assumed to be a list unless an identifier is used:  for an int array and   for a long array.

When commands such as, , and are used to match data tags, they only check for the presence of the provided tags in the target entity/block/item. This means that the entity/block/item may have additional tags and will still match. This is true even for lists and arrays: the order of a list is not acknowledged, and as long as every requested element is in the list, it will match even if there are additional elements.

The format used for data tags is a lenient form of JSON.

Raw JSON text
The and  commands use strict JSON syntax.

Scores and target selectors are evaluated for a Sign when it is placed or edited and for a Written Book when it is "resolved" (opened for the first time after signing). They won't update after that, and they won't work if edited onto an existing sign with an NBT editor, or onto a book that's already marked resolved. There's no way to wrap text onto the next line of a sign or the next page of a book during resolution; instead, the extra text will simply disappear.

The format of raw JSON text is a JSON string, a  JSON array, or a  JSON Object which supports the following (mostly optional) elements:
 * A string representing raw text to display directly in chat. Same as only having a tag in the  base object.
 * Same as having all elements except the first in this array appended to the end of the array of the first chat component in this array. Each element repeats this raw JSON text structure.
 * The base chat component object.
 * : A string representing raw text to display directly in chat. Note that selectors such as "@a" and "@p" are not translated into player names; use selector instead. Can use escape characters, such as for newline (enter),  for tab, etc.
 * : The translation identifier of text to be displayed using the player's selected language. This identifier is the same as the identifiers found in lang files from assets or resource packs. Ignored when exist in the root object.
 * : A player's score in an objective. Displays nothing if the player is not tracked in the given objective. Ignored when any of the previous fields exist in the root object.
 * : The name of the player whose score should be displayed. Selectors (such as @p) can be used, in addition to "fake" player names created by the scoreboard system. In addition, if the name is "*", it will show the reader's own score (for example,  will show every online player their own score in the "obj" objective).
 * : The internal name of the objective to display the player's score in.
 * : Optional. If present, this value is used regardless of what the score would have been.
 * : A string containing a selector (@p,@a,@r,@e or @s) and, optionally, selector arguments. Unlike text, the selector will be translated into the correct player/entity names. If more than one player/entity is detected by the selector, it will be displayed in a form such as 'Name1 and Name2' or 'Name1, Name2, Name3, and Name4'. Ignored when any of the previous fields exist in the root object. Clicking a player's name inserted into a /tellraw command this way will suggest a command to whisper to that player. Shift-clicking a player's name will insert that name into chat. Shift-clicking a non-player entity's name will insert its UUID into chat.
 * : A string that can be used to display the key needed to preform a certain action. An example is  which will always display "E" unless the player has set a different key for opening their inventory. Ignored when any of the previous fields exist in the root object.
 * : A string indicating the NBT path used for looking up NBT values from an entity or a block entity. Ignored when any of the previous fields exist in the root object.
 * : A list of chat component arguments and/or string arguments to be used by . Useless otherwise.
 * The arguments are text corresponding to the arguments used by the translation string in the current language, in order (for example, the first list element corresponds to "%1$s" in a translation string). Argument structure repeats this raw JSON text structure.
 * : A boolean to indicate whether the game should interpret the SNBT value at the path indicated by as a raw JSON text (according to this raw JSON text structure). Useless otherwise.
 * : A string specifying the coordinates of the block entity from which the NBT value is obtained. The coordinates can be absolute or relative. Useless if is absent.
 * : A string specifying the target selector for the entity from with the NBT value is obtained. Useless if is absent.
 * : A list of additional objects, sharing the same format as the base object.
 * A list element whose structure repeats this raw JSON text structure. Note that all properties of this object are inherited by children except for text, extra, translate, with, and score. This means that children will retain the same formatting and events as this object unless they explicitly override them.
 * : The color to render this text in. Valid values are "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", "white", and "reset" (cancels out the effects of colors used by parent objects). Technically, "bold", "italic", "underlined", "strikethrough", and "obfuscated" are also accepted, but it may be better practice to use the tags below for such formats.
 * : Boolean (true/false) - whether to render text in bold. Defaults to false.
 * : Boolean (true/false) - whether to render text in italics. Defaults to false.
 * : Boolean (true/false) - whether to render text underlined. Defaults to false.
 * : Boolean (true/false) - whether to render text with a strikethrough. Defaults to false.
 * : Boolean (true/false) - whether to render text obfuscated. Defaults to false.
 * : When the text is shift-clicked by a player, this string will be inserted in their chat input. It will not overwrite any existing text the player was writing.
 * : Allows for events to occur when the player clicks on text.
 * : The action to perform when clicked. Valid values are "open_url" (opens value as a URL in the player's default web browser), "open_file" (opens the value file on the user's computer), "run_command" (has value entered in chat as though the player typed it themselves. This can be used to run commands, but the command will fail if the player does not have the required permissions to use it), "change_page" (can only be used in written books) changes to page value if that page exists, and "suggest_command" (similar to "run_command" but it cannot be used in a written book, the text only appears in the player's chat input and it is not automatically entered. Unlike insertion, this will replace the existing contents of the chat input). "open_file" is used in messages automatically generated by the game (e.g. on taking a screenshot) and cannot be used in commands or signs.
 * : The URL, file, chat, command or book page used by the specified action. Note that commands must be prefixed with the usual "/" slash.
 * : Allows for a tooltip to be displayed when the player hovers their mouse over text.
 * : The type of tooltip to show. Valid values are "show_text" (shows raw JSON text), "show_item" (shows the tooltip of an item which can have NBT tags), and "show_entity" (shows an entity's name, possibly its type, and its UUID).
 * : The formatting of this tag varies depending on the action. Note that "show_text" is the only action to support an Object as the value; all other action values are Strings and should thus be wrapped in quotes.
 * "show_text": Can be either a raw String of text, or an Object with the same formatting as this base object. Note that clickEvent and hoverEvent do not function within the tooltip, but the formatting and extra tags still work.
 * "show_item": A string formatted like item NBT data. Contains the "id" tag, and optionally the "Damage" tag and "tag" tag (which is the same compound used as "dataTag" in the command).
 * "show_entity": A string formatted like a compound with the string values "type" (such as "Zombie"), "name", and "id" (should be an entity UUID, but can actually be any string).

Due to the extra tag, the above format may be recursively nested to produce very complex and functional text strings. However, a raw json text doesn't have to be complicated at all: virtually all properties are optional and may be left out.

To be valid, each object must have at least either text, translate, score, selector or keybind (everything else is optional). As a matter of shorthand, however, the entire Object may be substituted with a String. In this case, that string will be considered the value of the text property. For example,  is equivalent to. This shorthand substitution is valid anywhere a raw text object is required (including the base  argument of, the elements of the extra list, and the value of a "show_text" hover_event).

also accepts an array of objects and/or strings; they are concatenated. It even accepts a tree of nested arrays; they are traversed depth-first. For example:

/tellraw @a ["Hello there, ",{"selector":"@p"},"."] /tellraw @a [["The "],[["quick ","brown "],[{"selector":"@p"}," jumps "],"over "],"the "],["lazy ","dog."]

Finally, unlike other commands using JSON, Strings support Unicode via the notation , where #### is the Unicode hexadecimal number for the desired character.


 * External links


 * Skylinerw's JSON Text Component
 * Tellraw Generator
 * List of all Keybinds

Block/item/entity... names
Many commands have arguments that identify particular types of blocks, items, entities, advancements, bossbars, effects, enchantments and so on. In the command syntax below, these typically appear as elements named,  , or the like which are replaced with identifiers such as   in the examples. These IDs all have namespaces. All original Minecraft contents are namespaced  while contents from mods or data packs have other namespaces. Namespace prefix of IDs namespaced  can be omitted for most situations; however, in certain cases, such as NBT data tag matching, full namespaced ids are required.

List and Summary of commands
The table below summarizes all commands, including upcoming ones. Click a column heading to sort by that column. Click the link in the first unit of each row to get detailed usage of each command.

Command guide

 * Syntax


 * {| class="wikitable" style="text-align:center" data-description="Syntax"

! If you see… !! Then Pick one of the options shown.
 * plain text || Enter this literally, exactly as shown.
 * italics || Replace this with an appropriate value.
 *  || This is a required argument.
 * [square brackets] || This is an optional argument.
 * x | y
 *  || This is a required argument.
 * [square brackets] || This is an optional argument.
 * x | y
 * x | y
 * x | y

Available options are shown separated by vertical bars: |
 * ellipsis … || The argument may consist of multiple words separated by spaces.
 * x: int || The argument consists of numbers.
 * y: string || The argument consists of multiple words which could be separated by spaces.
 * }
 * y: string || The argument consists of multiple words which could be separated by spaces.
 * }
 * }


 * Success Conditions


 * A command's Success Conditions must be met in order for the game to consider the command "successful". This is used to determine a variety of things, such as the output of a redstone comparator feeding from command block with a command. Note that not all "successful" commands actually do something, and not all "failed" commands fail to do something useful.


 * Restrictions


 * Describes restrictions on who can use the command or in what context.


 * None: The command can be used by any player in any world. The following commands have no restrictions:, , , and.


 * Operator: The command may only be used by an operator or in singleplayer mode with cheats enabled. On multiplayer servers, the results of these commands are broadcast to other ops online.


 * Multiplayer: The command is only available on a multiplayer server. The following commands are restricted to multiplayer servers:, , , , , , , , , , , , , ,.
 * No multiplayer commands permit target selectors in arguments.
 * Except for, multiplayer commands cannot be used in command blocks.
 * 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.


 * No command blocks: The command cannot be executed by a command block.

Video
Video made by slicedlime:

History
{{History||1.12.0|snap=beta 1.12.0.2|Added  game rule.
 * Added  game rule.
 * Added more new particles for {cmd|particle}}.
 * Added new commands for map making and add-ons.