Argument types

This page contains a list of all argument types in Java Edition.

List of argument types

brigadier:bool

Represents a boolean.

Must be either true or false.

Official examples

• true
• false

brigadier:double

Represents a Double-precision floating-point format number argument.

Each double argument has a custom minimum and maximum value.

Precision varies throughout number line; the maximum absolute value is about 1.8*10³⁰⁸.

Official examples

• 0
• 1.2
• .5
• -1
• -.5
• -1234.56

JSON properties in command syntax output

•  properties: The root properties object.
  •  max: The maximum value of this double argument.
  •  min: The minimum value of this double argument.

brigadier:float

Represents a Single-precision floating-point format number argument.

Each float argument type has a custom minimum and maximum value.

Precision varies throughout number line; the maximum absolute value is about 3.4*10³⁸.

Official examples

• 0
• 1.2
• .5
• -1
• -.5
• -1234.56

JSON properties in command syntax output

•  properties: The root properties object.
  •  max: The maximum value of this float argument.
  •  min: The minimum value of this float argument.

brigadier:integer

Represents a 32-bit integer.

Each integer argument type has a custom minimum and maximum value.

Maximum range is from -(2³¹) to (2³¹ - 1), or from (-2,147,483,648) to (2,147,483,647).

Official examples

• 0
• 123
• -123

JSON properties in command syntax output

•  properties: The root properties object.
  •  max: The maximum value of this integer argument.
  •  min: The minimum value of this integer argument.

brigadier:long

Represents a 64-bit long.

Note: Although a long argument type is present in brigadier, it is not used by Minecraft.

Each long argument type has a custom minimum and maximum value.

Maximum range is from −(2⁶³) to (2⁶³−1), or from (−9,223,372,036,854,775,808) to (9,223,372,036,854,775,807).

Official examples

• 0
• 123
• –123

JSON properties in command syntax output

•  properties: The root properties object.
  •  max: The maximum value of this long argument.
  •  min: The minimum value of this long argument.

brigadier:string

Represents a string.

Each string argument type can accept either a single word (no spaces), a quotable phrase (either single word or quoted string), or a greedy phrase (taking the rest of the command as the string argument).

Official examples

Single word

• word
• word_with_underscores

Quotable phrase

• "quoted phrase"
• word
• ""

Greedy phrase

• word
• words with spaces
• "and symbols"

JSON properties in command syntax output

•  properties: The root properties object.
  •  type: The type of this string argument. Can be word, phrase, or greedy

minecraft:block_pos

Represents a block position.

Accepts tilde and caret notations.

Official examples

• 0 0 0
• ~ ~ ~
• ^ ^ ^
• ^1 ^ ^-5
• ~0.5 ~1 ~-5

minecraft:block_predicate

Represents a predicate for a block in a world.

Checks its block state properties and NBT data (for block entities if present). Accepts block tags for block type checking.

Official examples

• stone
• minecraft:stone
• stone[foo=bar]
• #stone
• #stone[foo=bar]{baz:nbt}

minecraft:block_state

Represents a predicate for a block state.

Checks for an exact match for a block state and the block entity NBT must include the NBT given.

Official examples

• stone
• minecraft:stone
• stone[foo=bar]
• foo{bar:baz}

minecraft:color

Represents a color used in chat formatting.

Can be reset or one of the 16 chat colors.

Official examples

• red
• green

minecraft:column_pos

Represents a column position.

Accepts tilde and caret notations.

Official examples

• 0 0
• ~ ~
• ~1 ~-2
• ^ ^
• ^-1 ^0

minecraft:component

Represents a raw JSON text.

Official examples

• "hello world"
• ""
• "{"text":"hello world"}"
• [""]

minecraft:dimension

Represents a Dimension.

Accepts a valid namespaced ID for a dimension.

Official examples

• minecraft:overworld
• minecraft:the_nether

minecraft:entity

Represents a target selector.

Accepts player names, UUIDs or target selectors variables. Each entity argument may place limits on the number of entities (single/multiple) selected or the type of entities (player/any entity) selected.

Official examples

• Player
• 0123
• @e
• @e[type=foo]
• dd12be42-52a9-4a91-a8a1-11c01849e498

JSON properties in command syntax output

•  properties: The root properties object.
  •  amount: The amount of entities that can be selected. Can be single or multiple.
  •  type: The target entity type. Can be players or entities.

minecraft:entity_anchor

Represents the set of positions/rotations of an entity for tilde and caret notations to interpret.

Only accepts eyes or feet.

• Eyes: Tilde notations will refer to the eye position and caret notations will modify the pitch and yaw^[verify]
• Feet: The default behavior; tilde notations refer to the feet position.

Official examples

• eyes
• feet

minecraft:entity_summon

Represents an entity type that can be summoned.

Accepts an entity type ID. The entity type must be summonable.

Official examples

• minecraft:pig
• cow

minecraft:float_range

Represents a range acceptable for float values.

General Format:

• 0: Exact match of 0.
• ..0: Less than or equal to 0.
• 0..: More than or equal to 0.
• 0..1: Between 0 and 1, inclusive.

Official examples

• 0..5.2
• 0
• -5.4
• -100.76..
• ..100

minecraft:function

Represents one or a collection of functions.

Can accept a namespaced ID, which refers to single functions, or one prefixed with a #, which refers to single tags.

Official examples

• foo
• foo:bar
• #foo

minecraft:game_profile

Represents a collection of game profiles (player profiles).

It is backed by a target selector that only selects players.

Official examples

• Player
• 0123
• dd12be42-52a9-4a91-a8a1-11c01849e498
• @e

minecraft:int_range

Represents a range acceptable for integer values.

General Format:

• 0: Exact match of 0.
• ..0: Less than or equal to 0.
• 0..: More than or equal to 0.
• 0..1: Between 0 and 1, inclusive.

Official examples

• 0..5
• 0
• -5
• -100..
• ..100

minecraft:item_enchantment

Represents an enchantment.

Accepts a namespaced ID that refers to a valid enchantment.

Official examples

• unbreaking
• silk_touch

minecraft:item_predicate

Represents a predicate for an item by checking the item type and its NBT data.

Tags are accepted for item type checking. The item NBT data must contain the given NBT data.

Official examples

• stick
• minecraft:stick
• #stick
• #stick{foo:bar}

minecraft:item_slot

Represents a slot in an inventory.

See also: Commands/replaceitem

Accepts certain string notations that refer to certain slots in inventories. The slot reference will be mapped to an integer.

Slot	Valid slot_number	Mapped index
armor.chest		102
armor.feet		100
armor.head		103
armor.legs		101
weapon		98
weapon.mainhand		98
weapon.offhand		99
container.slot_number	0–53	0-53
enderchest.slot_number	0–26	200-226
hotbar.slot_number	0–8	0-8
inventory.slot_number	0–26	9-35
horse.saddle		400
horse.chest		499
horse.armor		401
horse.slot_number	0–14	500-514
villager.slot_number	0–7	300-307

Then, restrictions will be applied to mapped indexes.

Mapped index	Restrictions
0-53	General inventories
98-103	Mobs, players, and armor stands
200-226	Players
300-307	Villagers, pillagers
400-401	Horses, donkeys
499-514	Donkeys with chest

Official examples

• container.5
• 12
• weapon

minecraft:item_stack

Represents an item stack.

Does not accept tags. When used to check item matching, the NBT of the item checked against must include the NBT provided by this item.

Official examples

• stick
• minecraft:stick
• stick{foo:bar}

minecraft:message

Represents a message with changeable entity reference.

Accepts a string with spaces and replaces entity selectors in the message with selected entities' names.

Official examples

• Hello world!
• foo
• @e
• Hello @p :)

minecraft:mob_effect

Represents a status effect.

Accepts a namespaced ID that refers to a valid status effect.

Official examples

• spooky
• effect

minecraft:nbt_compound_tag

Represents a compound NBT in SNBT format.

Official examples

• {}
• {foo:bar}

minecraft:nbt_path

Represents an NBT/data path.

See also: Commands/data

Format:

• .: Directory separator. foo.bar means foo's child called bar.
• []: Array/list index indicator. foo[0] means element 0 of foo; bar[-1] means the last element of bar.
• "": Escapes , ., etc. in directory names. "quoted strings" may be used if a name of a key needs to be escaped.

An example

foo.bar[0]."A [crazy name]".baz.

• foo
  • bar
    • <the first list element>
      • A [crazy name]
        • baz
    • <the second list element>

Official examples

• foo
• foo.bar
• foo[0]
• [0]
• []
• {foo:bar}

minecraft:nbt_tag

Represents an NBT tag in SNBT format.

Official examples

• 0
• 0b
• 0l
• 0.0
• "foo"
• {foo:bar}

minecraft:objective

Represents a scoreboard objective.

Additionally it enforces the 16-character name length limit.

Official examples

• foo
• *
• 012

minecraft:objective_criteria

Represents a scoreboard objective criterion.

They are not referenced with namespaced IDs, even though they are stored by ID in the game.

Official examples

• foo
• foo.bar.baz
• minecraft:foo

minecraft:operation

Represents arithmetic operators for score comparison, etc.

Valid values include = (assignment), += (addition), -= (subtraction), *= (multiplication), /= (floor division), %= (floor remainder), < (choose minimum) and > (choose maximum).

Official examples

• =
• >
• <

minecraft:particle

Represents a particle effect.

See also: Commands/particle

Accepts a namespaced ID referring to a valid particle followed by particle parameters that are particle-specific.

Official examples

• foo
• foo:bar
• particle with options

minecraft:resource_location

Represents a namespaced ID.

Accepts a namespaced ID. No other characters allowed, including # prefix for tags.

Official examples

• foo
• foo:bar
• 012

minecraft:rotation

Represents a rotation (pitch and yaw).

Official examples

• 0 0
• ~ ~
• ~-5 ~5

minecraft:score_holder

Represents a selection of score holders.

Each score holder argument may specify if it can select only one score holder or multiple score holders. It may be either backed by a target selector, a literal name reference, or * for all score holders.

Official examples

• Player
• 0123
• *
• @e

JSON properties in command syntax output

•  properties: The root properties object.
  •  amount: The amount of score holders that can be selected. Can be single or multiple.

minecraft:scoreboard_slot

Represents a scoreboard display slot.

Accepts a string that refers to a display slot.

Official examples

• sidebar
• foo.bar

minecraft:swizzle

Represents a collection of axes.

Axes can be declared in any order, but they cannot duplicate.

Official examples

• xyz
• x

minecraft:team

Represents a scoreboard team.

Official examples

• foo
• 123

minecraft:time

Represents a time in Minecraft.

Accepts a single-precision floating point number suffixed with a unit. Units:

• d: an in-game day, 24000 ticks;
• s: a second, 20 ticks;
• t: a single tick; the default unit.

The time will be set to the closest integer tick after unit conversion. For example. .5d is same as 12000 ticks.

Official examples

• 0d
• 0s
• 0t
• 0

minecraft:vec2

Represents a two-dimensional vector with floating-point number elements.

Accepts tilde and caret notations.

Official examples

• 0 0
• ~ ~
• 0.1 -0.5
• ~1 ~-2

minecraft:vec3

Represents a three-dimensional vector with floating-point number elements.

Accepts tilde and caret notations.

Official examples

• 0 0 0
• ~ ~ ~
• ^ ^ ^
• ^1 ^ ^-5
• 0.1 -0.5 .9
• ~0.5 ~1 ~-5