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 also enters the forward slash that commands require as a prefix, so it is a useful shortcut. The and  keys 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.

When the cursor is at a location corresponding to some types of argument (such as an ID), a list of applicable values appear above the text box. If the argument is already containing some characters, the list displays only those values containing the typed text.

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 argument, like a player's username.

The majority of commands are available only 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"). The player does not actually need to be on a LAN or have others join. This is not permanent, but allows the use of commands until the player quits the world, and changes the player makes via commands (items spawned, etc.) are saved with the world. The player can do this each time the player starts playing the world again. Note that this disables game pausing for the duration, so while open to LAN, you should get somewhere safe or reload your world before using the Game Menu. The player can disable the LAN world by reloading the world. To permanently enable cheats, the level.dat has to be edited.

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 tilde notation, the offsets are in the positive directions of the world coordinate axes:. For caret notation, they are along axes originating in the center of the target's head and pointing leftwards, upwards, and forwards, respectively, changing with the head's rotation. In terms of a :. For both, 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, teleports the user to the coordinate (0, 64, 0), while  teleports 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  teleports 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, keeps the user's "x" and "z" coordinates unchanged, but teleports the user to absolute height of 64. Similarly, teleports the player 5 blocks to the right, based on the tilt of their head.

Target selectors
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 (or, $$, seven) variables:




 * Target the nearest player. When run by the console, the origin of selection is (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 is selected. For example,  targets 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   targets the three nearest players).




 * Target a random player.


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


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


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




 * Target all players, including dead players. The only other selector that can find dead players is.


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




 * Target all entities (including players).


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




 * Target 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, then this selector finds nothing.


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




 * Target your agent only.


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




 * Target all agents.


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

If an entity in unloaded chunks should be targeted, the entity is affected upon the chunk reloading. However, the game reports that the entity was targeted upon executing the command. For example, if the player enters, and all chickens are in unloaded chunks, then the chat immediately claims to have killed a chicken, but the chickens are not actually killed until their chunks load.

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 is targeted only if all arguments pass, otherwise the command fails.

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.


 * Position arguments


 * Define a position in the world for use with either the  argument or the distance component arguments, ,   and  . Defining position alone has no use without these, so applying it (and only it) to   still selects all entities in the world.
 * The positional components are doubles, allowing for values like, and they are not center-corrected, meaning   is no longer corrected to   - tilde notation is available for selector argument coordinates.
 * The positional components are doubles, allowing for values like, and they are not center-corrected, meaning   is no longer corrected to   - tilde notation is available for selector argument coordinates.


 * Selecting targets by distance


 * - Filter target selection based on their Euclidean distances from some point. If the positional arguments are left undefined, radius/i is calculated relative to the postion of the command's execution. Only unsigned values are allowed.
 * Ranges are supported, allowing circular regions to be defined:
 * — Target all entities exactly 10 blocks away.
 * — Target all entities more than 10 blocks but less than 12 blocks away (inclusive).
 * — Target all entities at least 5 blocks away.
 * — Target all entities at most 15 blocks away.




 * - Filter target selection based on their x-difference, y-difference, and z-difference from some point, as measured from the closest corner of the entities' hitboxes.
 * This can be interpreted as creating a rectangular volume defined by an initial position (,,) and diagonal vector (,,), then selecting all entities whose hitboxes are at least partially contained by that volume. If the positional arguments are left out, the selection is interpreted as originating from the position of the command's execution. Any values are allowed, including signed and fractional numbers.
 * Note that, ,  specify signed differences from the given coordinate. They do not specify a separate coordinate, nor do they extend in both the positive and negative directions.
 * — Select all entities whose hitbox collects with the block region (1~5, 2~7, 3~9) (or, mathematically speaking, the region that is {(x,y,z)∈R3|x∈[1.0,5.0),y∈[2.0,7.0),z∈[3.0,9.0)}).
 * — Select all entities whose hitbox contains the point (1,2,3).
 * It is possible to combine selection by distance and selection by volume, in which case the command select targets only within the overlap of both regions (within certain radius/i of the volume's initial point and not outside the defined volume).


 * Selecting targets by scores


 * - Filter target selection based on their scores in specified objectives.
 * 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.
 * — Select all entities with a score in objective myscore of exactly 10.
 * — Select all entities with a score in objective myscore of between 10 and 12 (inclusive).
 * — Select all entities with a score in objective myscore of 5 or greater.
 * — Select all entities with a score in objective myscore of 15 or less.
 * To
 * — Select all entities with a score in objective foo of exactly 10, and a score in objective bar of between 1 and 5 (inclusive).


 * Selecting targets by team


 * - Filter target selection to those who are on a given team.
 * — Filter to those who are not on a given team.
 * — Filter to those who are teamless.
 * — Filter to those who have some team.


 * Limiting and sorting target selection


 * - Limit the number of targets selected to be no higher than the given value.
 * When using the variables  and , this argument defaults to 1. Applying the   argument to them may artificially increase the number of nearest or random targets selected. When applying this argument to   or  , this argument returns only a limited number of targets.
 * - Limit the number of targets, and specify selection priority.
 * — Sort by increasing distance. (Default for )
 * — Sort by decreasing distance.
 * — Sort randomly. (Default for )
 * — Do not sort. (Default for,  )
 * or  or   — Select the nearest 3 players.
 * or  — Select the furthest 4 players.
 * or  — Select 2 players, chosen randomly.


 * Selecting targets by experience level


 * - Filter target selection based on their experience levels. This naturally filters out all non-player targets.
 * This selector supports ranges:
 * — Select all players who have exactly 10 levels.
 * — Select all players who have between 10 and 20 levels (inclusive).
 * — Select all players who have at least 30 levels.
 * — Select all players who have at most 29 levels.


 * Selecting targets by game mode


 * — Filter target selection to those who are in the specified game mode.
 * — Filter target selection to those who are not in the specified game mode.
 * Permitted values for  are,  ,  , and.
 * This naturally filters out all non-player targets.
 * or  or   — Select all players who are in Survival mode.
 * — Select all players who are not in Spectator mode.


 * Selecting targets by name


 * — Filter target selection to all those with a given name.
 * — Filter target selection to all those without a given name.
 * This is a string, so spaces are allowed only if quotes are applied. This cannot be a JSON text compound.
 * - Select all entities that are not named "Steve".


 * Selecting targets by vertical rotation


 * — Filter target selection based on their pitch, or more specifically their declination from the horizon, measured in degrees. Values range from -90 (straight up) to 0 (at the horizon) to +90 (straight down).
 * This argument supports ranges:
 * — Select all entities that are looking directly at the horizon.
 * — Select all entities that are looking between 30&deg; and 60&deg; (inclusive) below the horizon.
 * — Select all entities that are looking 45&deg; or more below the horizon.
 * — Select all entities that are looking at or above the horizon.


 * Selecting targets by horizontal rotation


 * — Filter target selection based on their rotation in the horizontal XZ-plane, measured clockwise in degrees from due south (or the positive Z direction). Values vary from -180 (facing due north) to -90 (facing due east) to 0 (facing due south) to +90 (facing due west) to +180 (facing due north again).
 * This argument supports ranges.
 * — Select all entities that are facing due south.
 * — Select all entities that are facing 45&deg;west of south.
 * — Select all entities that are facing 6&deg;north of west.
 * — Select all entities that are facing in the 90&deg; between due east and due south (inclusive).
 * — Select all entities that are facing between due east and due west (inclusive), through south.
 * — Select all entities that are not facing at all east.


 * Selecting targets by type


 * — Filter target selection to those of a specific entity type.
 * — Filter target selection to those not of a specific entity type.
 * The given entity type must be a valid entity ID or tags used to identify different types of entities internally. The namespace can be left out if the ID is within the  namespace. (For example,   for creepers,   for regular minecarts,   for primed TNT, etc.) Entity IDs or tags are case-sensitive.
 * When using the  parameter, this argument defaults to the type  . Defining a type for this parameter can filter the random selection to entities only.
 * — Select all skeletons.
 * — Select all entities except chickens and cows.
 * - Not applicable; select all entities that are simultaneously a chicken and a cow.
 * — Select all skeletons, wither skeletons, and strays.


 * Selecting targets by data tag


 * — Filter target selection to those that have at least one tag of the given name.
 * — Filter to those that have no tags of the given name.
 * — Filter to those that have exactly zero tags.
 * — Filter to those that have at least one tag.
 * Multiple tag arguments are allowed. All arguments specifications must be fulfilled for an entity to be selected.
 * — Select all entities that have tags a and b but not tag c.
 * — Select one random player who has tag a.


 * Selecting targets by NBT


 * — Select all targets that have the specified NBT. The NBT is written in its command definition.
 * — Select all targets that does not have the specified NBT.
 * For example:
 * — Select all players on the ground.
 * — Select all sheep that are dyed white.
 * — Selects all slime ball drops.
 * is the same as . The latter is simpler and reduces CPU load.
 * Note: When matching string form of namespaced IDs within a tag, the namespace cannot be omitted.
 * Hence  cannot find any drop as the  field always contains a namespaced ID-converted string.


 * Selecting targets by advancements


 * — Select all targets that match the specified advancement and value.
 * — Select all targets that match the specified advancement and value.
 * The argument name is the advancement id (namespace can be left out when namespaced ). The value is true or false.
 * For advancements with one criteria, testing for that criteria will always give the same results as testing for the advancement.
 * — Selects players who have achieved the advancement minecraft:story/form_obsidian.
 * — Selects players who haven't achieved the advancement minecraft:story/form_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.


 * Selecting targets by predicate


 * — Select all targets that match the specified predicate.
 * — Select all targets that fail to match the specified predicate.


 * Since 19w38a, selectors can use predicates in the argument.
 * — Selects players who match the example:test_predicate predicate.
 * — Selects entities who doesn't match the minecraft-wiki:smart_entity predicate.

Data tags
A data tag is a tree-shaped data structure that can be described starting with attribute-value pairs enclosed in curly braces. One common usage of data tags in Java Edition is in commands, used to specify complex data for any entity.

A data tag consists of zero or more attribute-value pairs delimited by commas and enclosed in curly braces. 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 size fits within 32 bits, 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 are used to match data tags, they check only for the presence of the provided tags in the target entity/block/item. This means that the entity/block/item can have additional tags and 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 matches even if there are additional elements.

Raw JSON text
The and  commands use the raw JSON text format to display texts.

Also, Some values of arguments in NBT structures are using JSON format.

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 of argument types in Java Edition
These are the argument types in Minecraft: Java Edition.

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.

Syntax

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

! If you see... !! Then
 * plain text || Enter this literally, exactly as shown.
 * || Replace this with an appropriate value.
 * || This is an optional argument.
 * || (Required) Pick one of the entries shown, often literal words.
 * || (Optional) Pick one of the entries shown, often literal words.
 * ellipsis ... || This entry may repeat more than once.
 * : || The argument is expected to be an integer.
 * : || The argument is expected to be a double-precision float.
 * : || The argument is expected to be a string. Quotes must be applied if any non-alphanumeric characters show up in the string.
 * }
 * ellipsis ... || This entry may repeat more than once.
 * : || The argument is expected to be an integer.
 * : || The argument is expected to be a double-precision float.
 * : || The argument is expected to be a string. Quotes must be applied if any non-alphanumeric characters show up in the string.
 * }
 * : || The argument is expected to be a double-precision float.
 * : || The argument is expected to be a string. Quotes must be applied if any non-alphanumeric characters show up in the string.
 * }
 * }

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 a 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 be used only 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 available only 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 that 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: