Argument types

This page contains a list of all argument types.

Java Edition

brigadier:bool

Must be a boolean (either true or false).

Official examples

• true
• false

brigadier:double

Must be a Double-precision floating-point format number.

Each double argument may have 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

Must be a Single-precision floating-point format number.

Each float argument type may have 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

Must be a 32-bit integer number. And it must be between -2147483648 and 2147483647 (inclusive).

Each integer argument type may have 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

Must be a 64-bit long.

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

Each long argument type may have 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

Must be 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

Must be a block position composed of <x>, <y> and <z>, each of which must be an integer or tilde and caret notation.

Official examples

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

minecraft:block_predicate

It must be a block argument (accepts block tags).

Official examples

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

minecraft:block_state

It must be a block argument (does not accept block tags).

Official examples

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

minecraft:color

Must be a team color (reset or one of the 16 chat colors.)

Official examples

• red
• green

minecraft:column_pos

Must be a column coordinates composed of <x> and <z>, each of which must be an integer or tilde and caret notation.

Official examples

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

minecraft:component

Must be a raw JSON text.

Official examples

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

minecraft:dimension

Must be a namespaced ID of a dimension.

Official examples

• minecraft:overworld
• minecraft:the_nether

minecraft:entity

Must be a player name, a target selector or a UUID.

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

Must be either eyes or feet.

Official examples

• eyes
• feet

minecraft:entity_summon

Must be a of a namespaced ID of a summonable entity type.

Official examples

• minecraft:pig
• cow

minecraft:float_range

Must be a range acceptable for float values. (e.g. 0.1 - exact match of 0.1. ..0.1 - less than or equal to 0.1. 0.1.. - more than or equal to 0.1. 0.1..1 - between 0.1 and 1, inclusive.)

Official examples

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

minecraft:function

It must be a namespaced ID, which refers to a single function, or one prefixed with a #, which refers to a function tag.

Official examples

• foo
• foo:bar
• #foo

minecraft:game_profile

Must be a collection of game profiles (player profiles), which can be a player name (must be a real one if the server is in online mode), or a player-type target selector.

Official examples

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

minecraft:int_range

Must be a range acceptable for integer values. (e.g. 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

Must be a namespaced ID of an enchantment.

Official examples

• unbreaking
• silk_touch

minecraft:item_predicate

It must be a item argument (accepts item tags).

Official examples

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

minecraft:item_slot

Must be a string notation that refer to certain slots in the inventory.

See also: Commands/replaceitem

The slot reference is 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 are 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

It must be a item argument (does not accept item tags).

Official examples

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

minecraft:message

Must be a plain text. Can include spaces as well as target selectors. The game replaces entity selectors in the message with selected entities' names.

Official examples

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

minecraft:mob_effect

Must be a a namespaced ID of a status effect.

Official examples

• spooky
• effect

minecraft:nbt_compound_tag

Must be a compound NBT in SNBT format.

Official examples

• {}
• {foo:bar}

minecraft:nbt_path

Must be an NBT path.

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

Must be an NBT tag of any type in SNBT format.

Official examples

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

minecraft:objective

Must be a scoreboard objective name.

Official examples

• foo
• *
• 012

minecraft:objective_criteria

Must be a scoreboard objective criterion.

Official examples

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

minecraft:operation

Must be a arithmetic operator for /scoreboard.
Valid values include = (assignment), += (addition), -= (subtraction), *= (multiplication), /= (floor division), %= (modulus), >< (swapping), < (choosing minimum) and > (choosing maximum).

Official examples

• =
• >
• <

minecraft:particle

It must be a namespaced ID of a particle followed by particle parameters that are particle-specific.

• dust requires three color channel parameters to be set along with the name, representing red, green, and blue, each being a value in the range 0 to 1; and an additional parameter representing size. For example: /particle dust 1.0 0.5 0.5 1.0 creates a pink particle at regular size. If one or more values are greater than 1, the particles change their colors. The greater the values the greater is the range of different colors.
• block and falling_dust has a parameter in namespaced_ID[block_state=foo] format to specify a block, in which block states can be omitted when unneeded. For example: /particle block minecraft:grass_block[snowy=true]
• item requires a namespaced ID of an item as a parameter. For example: /particle item minecraft:apple

Official examples

• foo
• foo:bar
• particle with options

minecraft:resource_location

Must be a namespaced ID.

Official examples

• foo
• foo:bar
• 012

minecraft:rotation

Must be a rotation, including yaw and pitch, measured in degrees.

• For the horizontal rotation (yaw), -180.0 for due north, -90.0 for due east, 0.0 for due south, 90.0 for due west, to 179.9 for just west of due north, before wrapping back around to -180.0.
• For the vertical rotation (pitch), -90.0 for straight up to 90.0 for straight down.

Tilde notation can be used to specify a rotation relative to the target's previous rotation.

Official examples

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

minecraft:score_holder

Must be a selection of score holders. It may be either a target selector, a player name, a UUID, or * for all score holders.

Each score holder argument may specify if it can select only one score holder or multiple 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

Must be a scoreboard display slot.

Official examples

• sidebar
• foo.bar

minecraft:swizzle

Must be a collection of axes. Axes can be declared in any order, but they cannot duplicate.

Official examples

• xyz
• x

minecraft:team

Must be a team name.

Official examples

• foo
• 123

minecraft:time

Must be a time in Minecraft. It must be a single-precision floating point number suffixed with a unit.

Units:

• d: an in-game day, 24000 gameticks;
• s: a second, 20 gameticks;
• t (default and omitable): a single gametick; the default unit.

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

Official examples

• 0d
• 0s
• 0t
• 0

minecraft:uuid

Must be a UUID in the hyphenated hexadecimal format. Allowed characters include:

• -
• A-F
• a-f
• 0-9

Official examples

• dd12be42-52a9-4a91-a8a1-11c01849e498

minecraft:vec2

Must be a two-dimensional coordinates with floating-point number elements. Accepts tilde and caret notations.

Official examples

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

minecraft:vec3

Must be a three-dimensional coordinates 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

Bedrock Edition

ActorDefinitionIdentifier

Must be a of a name ID of a summonable entity type.

AgentCommand::Mode

Represents a subcommand of /agent.

AgentCommands::CollectCommand::CollectionSpecification

Must be all. Represents all items in /agent collect.

AgentCommands::Direction

Represents a direction for /agent command.

AutomaticID<Dimension,int>

Represents a dimension.

Block

It must be a block id.

BlockSlot

Must be a string notation that refer to certain slots in the inventory. See #minecraft:item_slot.

bool

Must be a boolean (either true or false).

ChangeSettingCommand::Setting

Represents a setting for /changesetting. Must be either allow-cheats or difficulty.

CloneCommand::CloneMode

Represents a clone mode of /clone. Must be one of mormal, force, and move.

CloneCommand::MaskMode

Represents a mask mode of /clone. Must be one of replace, masked, and filtered.

CodeBuilderCommand::Action

Represents a action of /codebuilder. Must be either reset or navigate.

CommandFilePath

It must be of the format path/to/function/file, which refers to a function located at [behavior_pack]/functions/path/to/function/file.mcfunction.

CommandItem

It must be a item id or a block id for which items exist.

CommandMessage

Must be a plain text. Can include spaces as well as target selectors. The game replaces entity selectors in the message with selected entities' names.

CommandOperator

Must be a arithmetic operator for /scoreboard.
Valid values include = (assignment), += (addition), -= (subtraction), *= (multiplication), /= (floor division), %= (modulus), >< (swapping), < (choosing minimum) and > (choosing maximum).

CommandPosition

Must be a block position composed of <x>, <y> and <z>, each of which must be an integer or tilde and caret notation.

CommandPositionFloat

Must be a three-dimensional coordinates with floating-point number elements. Accepts tilde and caret notations.

CommandRawText

^{[more information needed]}

CommandSelector<Actor>

Represents entities. Must be a player name or a target selector.

CommandSelector<Player>

Represents players. Must be a player name or a target selector.

CommandWildcardInt

Must be a 32-bit integer, or a asterisk (*) to represent MIN_INT(-2,147,483,648),

Difficulty

Represents a difficulty level. Must be one of the following:

• peaceful, p, or 0) for peaceful difficulty.
• easy, e, or 1 for easy difficulty.
• normal, n, or 2 for normal difficulty.
• hard, h, or 3 for hard difficulty.

EffectCommand::Mode

Represents a mode for /effect. Must be clear.

Enchant::Type

Must be a name ID of an enchantment.

EquipmentSlot

Must be a string notation that refer to certain slots in the inventory. See #minecraft:item_slot.

ExecuteCommand::Mode

Represents a mode for /execute. Must be detect.

FillCommand::FillMode

Represents a fill mode of /fill. Must be one of destroy, hollow, keep, outline, and replace.

float

Must be a Single-precision floating-point format number.

GameType

Represents a gamemode. Must be one of:

• survival, s, or 0 for survival mode.
• creative, c, or 1 for creative mode.
• adventure, a, or 2 for adventure mode.

int

Must be a 32-bit integer number.

Json::Value

Must be a JSON Object.

ListDCommand::DetailMode

Represents a detail mode for /listd. Must be one of ids, uuids, and stats.

MobEffect

Must be a a name ID of a status effect.

ObjectiveSortOrder

Represents a sort order for /scoreboard. Must be either ascending or descending.

PermissionCommand::Action

Represents an action of /permission command.

PermissionCommand::AvailableCommandPermissionPresets

Represents a permission of /permission command. Must be one of visitor, member, and operator.

RelativeFloat

Must be a float or a tilde and caret notation.

ReplaceItemCommand::ReplaceMode

Represents a replace mode of /replaceitem. Must be either destroy or keep.

ReplaceItemCommand::TargetType

Represents a target type of /replaceitem. Must be either block or entity.

SaveCommand::Mode

Represents a mode of /save command. Must be one of hold, query, and resume.

ScoreboardCommand::Action

Represents an action of /scoreboard command.

ScoreboardCommand::Category

Represents a category of /scoreboard command. Must be either objective or player.

SetBlockCommand::SetBlockMode

Represents a setblock mode of /setblock. Must be one of destroy, keep and replace.

std::basic_string<char,std::char_traits<char>,std::allocator<char>>>

Must be a string. And it must be either a single word (no spaces) or a quoted string.

std::unique_ptr<Command,std::default_delete<Command>>

Represents a complete command.

StructureFeatureType

Represents a feature type for /locate command.

TagCommand::Action

Represents an action of /tag. Must be one of add, remove and list.

TeleportCommand::FacingResult

Must be facing.

TestForBlocksCommand::Mode

Represents a mode of /testforblocks command. Must be either masked or all.

TickingAreaCommand::AddAreaType

Must be circle.

TickingAreaCommand::Mode

Represents a mode of /tickingarea command.

TickingAreaCommand::TargetDimensions

Must be all-dimensions.

TimeCommand::Mode

Represents a mode of /time. Must be one of add, set and query.

TimeCommand::Query

Represents a time type to query in /time. Must be one of daytime, gametime and day.

TimeCommand::TimeSpec

Represents a time to set in /time. Must be day, night, noon, midnight, sunrise, or sunset.

TitleCommand::Mode

Represents a mode of /title.

TitleRawCommand::Mode

Represents a mode of /titleraw.

WeatherCommand::WeatherRequest

Must be query.

WeatherCommand::WeatherType

Represents a weather to set in /weather. Must be one of clear, rain and thunder.

WhitelistCommand::Action

Represents an action of /whitelist.

WildcardCommandSelector<Actor>

Must be a selection of score holders. It may be either a target selector, a player name, a scoreboard ID for an entity, or * for all score holders.