imported>RedX: feedback request

2026-04-05T16:57:46Z

feedback request

New page

<includeonly>{{#vardefine:onlyje|{{#if:{{{be|}}}|{{IN|java}},|}}}}{{#vardefine:onlybe|{{#if:{{{je|}}}| {{IN|bedrock}},|}}}}{{#vardefine:je-arg|{{lc:{{#explode:{{{je|}}}|:|-1}}}}}}{{#vardefine:be-arg|{{#switch:{{lc:{{{be|}}}}}
|bool=bool
|block={{#switch:{{#var:je-arg}}|block_state|block_predicate={{#var:je-arg}}|#default=block_be}}
|enum={{#if:{{#var:je-arg}}|{{#var:je-arg}}|string}}
|commandrawtext|rawtext=rawtext
|commandfilepath|filepath=function
|commandintegerrange=int_range
|commanditem|item={{#switch:{{#var:je-arg}}|item_stack|item_predicate={{#var:je-arg}}|#default=item_be}}
|commandmessage|message=message
|commandoperator|operator=operation
|commandcompareoperator|compareoperator=compareoperator
|commandposition|position=block_pos
|commandpositionfloat|positionfloat=vec3
|commandselector<actor>|actor={{#if:{{#var:je-arg}}|{{#ifeq:{{{type}}}|entities|entity|inapplicability}}|entity}}
|commandselector<player>|player={{#if:{{#var:je-arg}}|{{#ifeq:{{{type}}}|players|entity|inapplicability}}|entity}}
|commandwildcardint|wildcard int=inapplicability
|float=float
|int={{#switch:{{#var:je-arg}}|time=time|gamemode=gamemode|item_slot=item_slot|#default=integer}}
|json::value|json=component
|relativefloat={{#switch:{{#var:je-arg}}|rotation=rotation|vec2=vec2|angle=angle|#default=relativefloat}}
|basic_string|string={{#switch:{{#var:je-arg}}|particle=particle|objective=objective|#default=string}}
|command=inapplicability
|wildcardcommandselector<actor>|wildcardselector=score_holder
|blockstatecommandparam|blockstate=blockstatecommandparam
|=
|
}}}}{{#ifeq:{{#var:je-arg|{{#var:be-arg}}}}|{{#var:be-arg|{{#var:je-arg}}}}|{{#switch:{{#var:je-arg|{{#var:be-arg}}}}
|rawtext=It is a greedy phrase string argument (taking the rest of the command as the string argument).
|bool=Must be a {{nbt|boolean}}Boolean (either <code>true</code> or <code>false</code>).
|double=Must be a {{nbt|double}}[[wikipedia:Double precision floating-point format|Double-precision floating-point number]] (from -(2-2-52)×21023 (≈-1.8×10308) to (2-2-52)×21023 (≈1.8×10308) ). {{#if:{{{min|}}}|{{#if:{{{max|}}}|It must be between {{{min}}} and {{{max}}} (inclusive).|It must be greater than or equal to {{{min}}}.}}|{{#if:{{{max|}}}|It must be less than or equal to {{{max}}}.}}}}
|float=Must be a {{nbt|float}}[[wikipedia:Single precision floating-point format|Single-precision floating-point number]] (from -(2-2-23)×2127 (≈-3.4×1038) to (2-2-23)2×127 (≈3.4×1038) ). {{#if:{{#var:je-arg}}|{{#if:{{{min|}}}|{{#if:{{{max|}}}|{{#var:onlyje|And}} it must be between {{{min}}} and {{{max}}} (inclusive).|{{#var:onlyje|And}} it must be greater than or equal to {{{min}}}.}}|{{#if:{{{max|}}}|{{#var:onlyje|And}} it must be less than or equal to {{{max}}}.}}}}}}
|integer=Must be a {{nbt|integer}}32-bit integer number (from -2147483648 (-231) to 2147483647 (231-1) ). {{#if:{{#var:je-arg}}|{{#if:{{{min|}}}{{{max|}}}|{{#var:onlyje|And}} it must be between {{{min|-2147483648}}} and {{{max|2147483647}}} (inclusive).}}}}
|long=Must be a {{nbt|long}} 64-bit long (from -9223372036854775808 (-263) to 9223372036854775807 (263-1) ).
|string=Must be a string. {{#if:{{#var:je-arg}}|{{#switch:{{{type}}}|word={{#var:onlyje|And}} it must be in a single word (Allowed characters include: {{cd|-|+|.|_|delimiter=, }}, <code>A</code>-<code>Z</code>, <code>a</code>-<code>z</code>, and <code>0</code>-<code>9</code>).|phrase={{#var:onlyje|And}} it must be a quotable phrase, which is either a single word (allowed characters: {{cd|-|+|.|_|delimiter=, }}, <code>A</code>-<code>Z</code>, <code>a</code>-<code>z</code>, and <code>0</code>-<code>9</code>) or a quoted string (by {{cd|"|'|delimiter= or }} ).|greedy={{#var:onlyje|And}} it is a greedy phrase (taking the rest of the command as the string argument).}}}}{{#if:{{#var:be-arg}}|{{#var:onlybe|And}} it must be a single word that has no space or a double-quoted string (When quoted, {{cd|\}} can be used to escape characters).}}
|angle=Must be a yaw angle, measured in degrees with [[wikipedia:Single precision floating-point format|single-precision floating-point number]]s. -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. Tilde notation can be used to specify a rotation relative to the execution yaw rotation.
|block_pos={{#if:{{#var:je-arg}}|{{#if:{{#var:be-arg}}|{{#var:onlyje}} m|M}}ust be a [[Coordinates#Block position|block position]] composed of <code><''X''></code>, <code><''Y''></code> and <code><''Z''></code>, each of which must be an integer or a [[Coordinates#Commands|tilde and caret notation]].}}{{#if:{{#var:be-arg}}|{{#if:{{#var:je-arg}}|{{#var:onlybe}} m|M}}ust be a three-dimensional coordinates composed of <code><''X''></code>, <code><''Y''></code> and <code><''Z''></code>, each of which must be a [[wikipedia:Single precision floating-point format|single-precision floating-point number]] or [[Coordinates#Commands|tilde and caret notation]].}}
|block_predicate={{#if:{{#var:be-arg}}|{{#var:onlyje}} m|M}}ust be in the format of <code>block_id[block_states]{data_tags}</code>(accepts block tags), in which block states and data tags can be omitted when they are not needed.{{#if:{{#var:be-arg}}|{{#var:onlybe}} must be a [[Bedrock Edition data values|block id]].}}
|block_state={{#if:{{#var:be-arg}}|{{#var:onlyje}} m|M}}ust be in the format of <code>block_id[block_states]{data_tags}</code>(does not accept block tags), in which block states and data tags can be omitted when they are not needed.{{#if:{{#var:be-arg}}|{{#var:onlybe}} must be a [[Bedrock Edition data values|block id]].}}
|block_be=Must be a [[Bedrock Edition data values|block id]].
|blockstatecommandparam=Must be a blockstate argument as <code>["<''state1''>"=<''value1''>,"<''state2''>"=<''value2''>,...]</code>. For example: <code>["old_leaf_type"="birch","persistent_bit"=true]</code>.
|color=Must be a team color (<code>reset</code> or one of the 16 [[Formatting codes#Color codes|chat colors]].)
|column_pos=Must be a column coordinates composed of <code><''X''></code> and <code><''Z''></code>, each of which must be an integer or [[Coordinates#Relative world coordinates|tilde notation]].
|compareoperator=Must be one of <code><</code>, <code><=</code>, <code>=</code>, <code>>=</code>, and <code>></code>.
|component={{#if:{{#var:je-arg}}|{{#var:onlyje|It}} must be a valid [[text component]].}}{{#if:{{#var:be-arg}}|{{#var:onlybe|It}} must be a [[JSON]] {{nbt|compound}}Object.}}
|dimension={{#var:onlyje|It}} must be a [[resource location]], which resolves into a [[dimension]] during command execution.{{#if:{{#var:be-arg}}|{{#var:onlybe| It}} must be either <code>overworld</code>, <code>nether</code>, or <code>the_end</code>. }}
|entity=Must be a player name{{#if:{{#var:je-arg}}|,| or}} a [[target selector]]{{#if:{{#var:je-arg}}| or a [[UUID]]{{#if:{{#var:be-arg}}|{{only|java}}}}}}.{{#if:{{{type|{{{be|}}}}}}| {{#if:{{#var:je-arg}}|{{#switch:{{{type|{{lc:{{{be}}}}}}}}|entities|entity|actor|commandselector<actor>={{#switch:{{{amount}}}|single= {{#var:onlyje|And}} the target selector must be in [[Target_selectors#Player_type_and_single_type|single type]].}}|players|player|commandselector<player>={{#switch:{{{amount}}}|single= {{#var:onlyje|And}} the target selector must be of [[Target_selectors#Player_type_and_single_type|single-player type]].|multiple= And the target selector must{{#if:{{#var:be-arg}}|{{only|java|short=1}}/should{{only|bedrock|short=1}}}} be of [[Target_selectors#Player_type_and_single_type|player type]].}}}}}}{{#if:{{#var:be-arg}}|{{#ifeq:{{{amount}}}|multiple|{{#switch:{{{type|{{lc:{{{be}}}}}}}}|players|player|commandselector<player>={{#var:onlybe| And}} the target selector should be of [[Target_selectors#Player_type_and_single_type|player type]].}}}}}}}}
|entity_anchor=Must be either <code>eyes</code> or <code>feet</code>.
|entity_summon=Must be a [[resource location]] of a summonable [[entity]] type.
|float_range=Must be a range acceptable for [[wikipedia:Single precision floating-point format|single-precision floating-point]] values. (e.g. <code>0.1</code> - exact match of 0.1. <code>..0.1</code> - less than or equal to 0.1. <code>0.1..</code> - more than or equal to 0.1. <code>0.1..1</code> - from 0.1 to 1, both inclusive.)
|function={{#if:{{#var:je-arg}}|{{#var:onlyje|It}} must be a [[resource location]] or one prefixed with a <code>#</code>, which resolves into a [[function]] or a function [[tag]] during command execution.}}{{#if:{{#var:be-arg}}|{{#var:onlybe| It}} must be of the format <code>path/to/function/file</code>, which resolves into a function located at <code>[behavior_pack]/functions/path/to/function/file.mcfunction</code> during command execution.}}
|gamemode=Must be one of the following:<ul><li><code>survival</code>{{#if:{{#var:be-arg}}| (can be abbreviated as <code>s</code> or <code>0</code> {{in|bedrock}})}} for [[Survival]] mode</li><li><code>creative</code>{{#if:{{#var:be-arg}}| (can be abbreviated as <code>c</code> or <code>1</code> {{in|bedrock}})}} for [[Creative]] mode</li><li><code>adventure</code>{{#if:{{#var:be-arg}}| (can be abbreviated as <code>a</code> or <code>2</code> {{in|bedrock}})}} for [[Adventure]] mode</li>{{#if:{{#var:be-arg}}|<li><code>default</code>(can be abbreviated as <code>d</code> or <code>5</code>) for default gamemode {{only|bedrock}}</li>}}<li><code>spectator</code> for [[Spectator]] mode</li></ul>Note that "[[hardcore]]" is not a valid option, as it is technically not a game mode.
|game_profile=Specifies one or more game profiles (player profiles). Must be a player name (should be a real one if the server is in online mode) or a [[Target_selectors#Player_type_and_single_type|player-type target selector]].
|int_range=Must be a range acceptable for 32-bit integer values. (e.g. <code>0</code> - exact match of 0. <code>..0</code> - less than or equal to 0. <code>0..</code> - more than or equal to 0. <code>0..1</code> - from 0 to 1, both inclusive.)
|item_enchantment=Must be an ID of an [[enchantment]].
|item_predicate={{#if:{{#var:be-arg}}|{{#var:onlyje}} it|It}} must be in the format of <code>item_id[tests]</code>(accepts item or block tags), in which tests can be omitted when they are not needed. See [[Argument types#minecraft:item_predicate|minecraft:item_predicate]] for details.{{#if:{{#var:be-arg}}|{{#var:onlybe}} it must be an [[Bedrock Edition data values|item id]] or a [[Bedrock Edition data values|block id]] for which the item form exist.}}
|item_stack={{#if:{{#var:be-arg}}|{{#var:onlyje}} it|It}} must be in the format of <code>item_id[data_components]</code>, in which <code>[data_components]</code> can be omitted when they are not needed. See [[Argument types#minecraft:item_stack|minecraft:item_stack]] for details.{{#if:{{#var:be-arg}}|{{#var:onlybe}} it must be an [[Bedrock Edition data values|item id]] or a [[Bedrock Edition data values|block id]] for which the item form exist.}}
|item_be=It must be an [[Bedrock Edition data values|item id]] or a [[Bedrock Edition data values|block id]] for which the item form exist.
|item_slot=Must be a string notation that refer to a single slot in the inventory, which consists of "slot type" and optional "slot number", in the format of {{#if:{{#var:je-arg}}|<code><''slot_type''></code> or <code><''slot_type''>.<''slot_number''></code>{{#if:{{#var:be-arg}}| {{in|java}}}}}}{{#if:{{#var:be-arg}}|{{#if:{{#var:je-arg}}|, or }}<code><''slot_type''> <''slot_number''></code>{{#if:{{#var:je-arg}}| {{in|bedrock}}}}}}. See [[Slot]] for details.
|item_slots=Must be a string notation that refer to certain slot(s) in the inventory, which consists of "slot type" and optional "slot number", in the format of <code><''slot_type''></code> or <code><''slot_type''>.<''slot_number''></code>. Wildcard (<code>*</code>) is accepted. See [[Slot]] for details.
|loot_predicate=Specifies a [[predicate]] with a [[resource location]] or in SNBT format. Must be a valid predicate definition in [[SNBT]] format, or a resource location of an existing predicate (an entry in <code>minecraft:predicate</code> registry). For NBT tag, if it is a string tag, the tag is also parsed into a resource location and resolved into an existing predicate; otherwise, the tag is parsed as a new predicate definition.
|loot_table=Specifies a [[loot table]] with a [[resource location]] or in SNBT format. Must be a valid loot table definition in [[SNBT]] format, or a resource location of an existing loot table (an entry in <code>minecraft:loot_table</code> registry). For NBT tag, if it is a string tag, the tag is also parsed into a resource location and resolved into an existing loot table; otherwise, the tag is parsed as a new loot table definition.
|loot_modifier= Specifies a [[item modifier]] with a [[resource location]] or in SNBT format. Must be a valid item modifier definition in [[SNBT]] format, or a resource location of an existing item modifier (an entry in <code>minecraft:item_modifier</code> registry). For NBT tag, if it is a string tag, the tag is also parsed into a resource location and resolved into an existing item modifier; otherwise, the tag is parsed as a new item modifier definition.
|message=It is a greedy phrase string argument (taking the rest of the command as the string argument). Can include spaces as well as [[target selectors]]. The game replaces entity selectors in the message with the list of selected entities' names, which is formatted as "name1 and name2" for two entities, or "name1, name2, ... and namen" for n entities.{{#if:{{#var:be-arg}}| {{#var:onlybe}} <code>@<''player name''></code> can be used to mention a player; <code>@here</code> can be used to mention all players.}}
|mob_effect=Must be an ID of a [[status effect]].
|nbt_compound_tag=Must be a {{nbt|compound}} compound [[NBT]] in SNBT format.
|nbt_path=Must be an [[NBT path format|NBT path]].
|nbt_tag=Must be an [[NBT]] tag of any type in SNBT format.
|objective={{#if:{{#var:be-arg}}|{{#var:onlyje}} it|It}} must be a single word. (Allowed characters include: {{cd|-|+|.|_|delimiter=, }}, <code>A</code>-<code>Z</code>, <code>a</code>-<code>z</code>, and <code>0</code>-<code>9</code>){{#if:{{#var:be-arg}}| {{#var:onlybe}} it must be a single word that has no space or a double-quoted string (When quoted, {{cd|\}} can be used to escape characters).}} It resolves into a [[Scoreboard#Objectives|scoreboard objective]] during command execution.
|objective_criteria=Must be a [[Scoreboard#Criteria|scoreboard objective criterion]].
|operation=Must be an arithmetic operator for {{cmd|scoreboard}}. Valid values include <code>=</code> (assignment), <code>+=</code> (addition), <code>-=</code> (subtraction), <code>*=</code> (multiplication), <code>/=</code> (floor division), <code>%=</code> (modulus), <code>><</code> (swapping), <code><</code> (choosing minimum) and <code>></code> (choosing maximum).
|particle={{#if:{{#var:je-arg}}|{{#if:{{#var:be-arg}}|{{#var:onlyje}} it|It}} must be in the format of <code>particle_type_id{[[Particle format|configuration tags]]}</code> for particle types with configurations, or the format of <code>particle_type_id</code> for particle types without configurations.{{#if:{{#var:be-arg}}| }}}}{{#if:{{#var:be-arg}}|{{IN|be}} it must be a single word that has no space or a double-quoted string (When quoted, {{cd|\}} can be used to escape characters). And it should be the namespaced identifier of a [[Particles (Bedrock Edition)|particle]] (the namespace cannot be omitted).}}
|relativefloat=Must be a {{nbt|float}} [[wikipedia:Single precision floating-point format|float]]. Accepts [[Coordinates#Commands|tilde notation]].
|resource={{#if:{{#var:be-arg}}|{{#var:onlyje}} m|M}}ust be an existing registered [[resource location]] in {{#if:{{{registry|}}}|<code>{{{registry}}}</code>|correct}} registry.{{#if:{{#var:be-arg}}| {{IN|be}}, must be an ID of {{#switch:{{{registry}}}
|minecraft:mob_effect=a [[status effect]] (without namespace)
|minecraft:enchantment=an [[enchantment]] (without namespace)
|minecraft:entity_type=an [[entity]] type.
|{{error|unknown registry id}}}}}}
|resource_key={{#if:{{#var:be-arg}}|{{#var:onlyje}} m|M}}ust be a [[resource location]], which resolves during command execution into a registry entry in {{#if:{{{registry|}}}|<code>{{{registry}}}</code>|correct}} registry.{{#if:{{#var:be-arg}}| {{IN|be}}, must be an ID of {{#switch:{{{registry}}}
|{{error|unknown registry id}}}}}}
|resource_location=Must be a [[resource location]] for an unregistered content.
|resource_or_tag={{#if:{{#var:be-arg}}|{{#var:onlyje}} m|M}}ust be an existing registered [[resource location]] or [[tag]] in {{#if:{{{registry|}}}|<code>{{{registry}}}</code>|correct}} registry.{{#if:{{#var:be-arg}}| {{IN|be}}, must be an ID of {{#switch:{{{registry}}}
|minecraft:worldgen/biome=a [[biome]] (with namespace)
|{{error|unknown registry id}}}}}}
|resource_or_tag_key={{#if:{{#var:be-arg}}|{{#var:onlyje}} m|M}}ust be a [[resource location]] or a [[tag]], which resolves during command execution into an entry or tag in {{#if:{{{registry|}}}|<code>{{{registry}}}</code>|correct}} registry.{{#if:{{#var:be-arg}}| {{IN|be}}, must be an ID of {{#switch:{{{registry}}}
|minecraft:worldgen/structure=a [[generated structure]] (without namespace)
|{{error|unknown registry id}}}}}}
|rotation=Must be a rotation consisting of two {{#if:{{#var:je-arg}}|double}}{{#if:{{#var:be-arg}}|{{#if:{{#var:je-arg}}|{{only|java|short=1}} or }}float{{#if:{{#var:je-arg}}|{{only|bedrock|short=1}}}}}} number elements, including yaw and pitch, measured in degrees.<ul><li>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.</li><li>For the vertical rotation (pitch), -90.0 for straight up to 90.0 for straight down.</li></ul>Tilde notation can be used to specify a rotation relative to the execution rotation.
|score_holder=It must be either a [[target selector]], a player name{{#if:{{#var:je-arg}}|, a [[UUID]]{{#if:{{#var:be-arg}}|{{only|java}}}}}}{{#if:{{#var:be-arg}}|, a unique ID of an entity{{#if:{{#var:je-arg}}|{{only|bedrock}}}}}}, or <code>*</code> for all score holders being tracked by the scoreboard system. Player names don't need to be of a player that is online or a player that exists and can use almost all unicode characters{{info needed}}. {{#if:{{#var:je-arg}}|{{#ifeq:{{{amount}}}|single|{{#var:onlyje}} the target selector must be of [[Target_selectors#Player_type_and_single_type|single type]].}}}}
|scoreboard_slot=Must be a [[Scoreboard#Display slots|scoreboard display slot]].
|style=Must contain [[Text component format#Java Edition|style information for text component]].
|swizzle=Any non-repeating combination of the characters 'x', 'y', and 'z'. Axes can be declared in any order, but they cannot duplicate. (For example, <code>x</code>, <code>xz</code>, <code>zyx</code>, or <code>yz</code>.)
|team=Must be an unquoted string, which resolves into a [[Commands/team|team]] during command execution. Allowed characters include: {{cd|-|+|.|_|delimiter=, }}, <code>A</code>-<code>Z</code>, <code>a</code>-<code>z</code>, and <code>0</code>-<code>9</code>.
|time={{#if:{{#var:be-arg}}|{{#var:onlyje}} it|It}} must be a [[wikipedia:Single precision floating-point format|single-precision floating-point number]] suffixed with a unit. It must be not less than {{{min|0}}} gameticks. Units include:<ul><li><code>d</code>: an in-game day, 24000 gameticks;</li><li><code>s</code>: a second, 20 gameticks;</li><li><code>t</code> (default and omitable): a single gametick; the default unit.</li></ul>The time is set to the closest integer after unit conversion to gametick. For example. <code>.5d</code> is same as 12000 gameticks.{{#if:{{#var:be-arg}}| {{IN|be}} it must be a {{nbt|integer}} 32-bit integer number.}}
|uuid=Must be a [[UUID]] in the [[UUID#Representation|hyphenated hexadecimal format]]. Allowed characters include: {{cd|-}}, {{cd|A|F|delimiter=-}}, {{cd|a|f|delimiter=-}}, and {{cd|0|9|delimiter=-}}.
|vec2=Must be two-dimensional coordinates with {{#if:{{#var:je-arg}}|[[wikipedia:Double precision floating-point format|double-precision floating-point number]]{{#if:{{#var:be-arg}}|{{only|java}}}}}}{{#if:{{#var:be-arg}}|{{#if:{{#var:je-arg}}| or }}[[wikipedia:Single precision floating-point format|single-precision floating-point number]]{{#if:{{#var:je-arg}}|{{only|bedrock}}}}}} elements. Accepts [[Coordinates#Relative world coordinates|tilde notations]].
|vec3=Must be three-dimensional coordinates with {{#if:{{#var:je-arg}}|[[wikipedia:Double precision floating-point format|double-precision floating-point number]]{{#if:{{#var:be-arg}}|{{only|java}}}}}}{{#if:{{#var:be-arg}}|{{#if:{{#var:je-arg}}| or }}[[wikipedia:Single precision floating-point format|single-precision floating-point number]]{{#if:{{#var:je-arg}}|{{only|bedrock}}}}}} elements. Accepts [[Coordinates#Commands|tilde and caret notations]].
|template_mirror={{#ifeq:{{PAGENAME}}|Argument types|Must be one of <code>none</code>, <code>front_back</code>, and <code>left_right</code>.|{{error|Arg desc: Please describe this argument without this template}}}}
|template_rotation={{#ifeq:{{PAGENAME}}|Argument types|Must be one of <code>none</code>, <code>clockwise_90</code>, <code>counterclockwise_90</code>, and <code>180</code>.|{{error|Arg desc: Please describe this argument without this template}}}}
|heightmap={{#ifeq:{{PAGENAME}}|Argument types|Must be one of <code>world_surface</code>, <code>motion_blocking</code>, <code>motion_blocking_no_leaves</code>, and <code>ocean_floor</code>.|{{error|Arg desc: Please describe this argument without this template}}}}
|unknown=This argument type is not registered in game.
|{{error|Arg desc: Illegal parameters}}}}|{{error|Arg desc: Illegal parameters}}}}{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}</includeonly><noinclude>
{{documentation}}

</noinclude>

Template:MC/Arg desc - Revision history

imported>RedX: feedback request