命令(Command)是通过输入特定文本字符串而激活的高级功能。
使用方法
在Java版中选取实体的UUID。
在客户端中,命令通过Minecraft的聊天窗口输入,通过按下T键、![]()
![]()
在命令方块中,命令可以以前缀斜杠开头,但不是必须的。在命令方块中的命令通常还需要一个可选参数,如玩家名称。
命令也可以在多人服务器的控制台中输入,但是不应加入前缀/。在英语中,以这种方式执行命令的服务器管理员被称为“ghosting”。
大多数命令只能在以下状况有效:
- 在Minecraft多人游戏服务器游戏中,由管理员或命令方块使用。
- 在其他的多人模式游戏中,由开启局域网并允许作弊的玩家,或主持多人游戏服务器的玩家使用。
- 在单人模式中,创建世界时开启作弊(由“更多选项”按钮)。
权限等级为0的命令所有玩家均可用。详见权限等级。
注意:在Java版中,在单人游戏中,如果不允许作弊,仍可以通过公开目前的游戏至局域网 (Esc→“公开至局域网”,点选“允许作弊”为开,接着“开始局域网游戏”) 而暂时可以作弊。你不必实际连入局域网或等待别人加入。这并不是永久的,但直至退出世界前都可以使用命令,且命令做出的修改都会被保存(物品、生物生成等)。你可以在再次开启游戏时重复以上步骤。注意当公开至局域网时游戏便无法暂停,所以在公开到局域网时若有需要最好找个安全的地方。你可以重新载入世界来取消公开至局域网。
在基岩版中,作弊可以随时使用设置菜单中的选项切换。开启作弊会导致玩家在那个世界永远无法获得成就,即使后来作弊被关闭。
相对坐标和局部坐标
世界坐标被视作绝对坐标。很多命令可以使用波浪号(~)来指定相对坐标,使用插入符(^)来指定局部坐标(也有人称本地坐标)。在波浪号和插入符后可以跟一个数字,表示相对基准点的偏移量。基准点由命令本身决定。举例来说,常见的基准点包括命令的执行位置和命令指定的其他坐标。局部坐标的基准点默认为是脚部。
相对坐标以世界的绝对坐标为偏移量。局部坐标以执行者的头部为基准点,并在包括头部的倾斜角度下分别指向左、上、前方为坐标轴 x y z 的正方向。无论是哪一个,数字的正负号都表示向坐标轴的正或负方向偏移。一个单独的波浪号~是~0的简写,表示没有偏移。同样地,^是^0的简写。
举例来说,/tp 0 64 0将会移动使用者到坐标(0, 64, 0),而/tp ~3 ~ ~-3会使使用者往x轴的正方向(东方)移动3米,保持原本高度,并在z轴的负方向(北方)移动3米,而/tp ^ ^ ^3会使使用者往前移动3米。
通常绝对坐标和相对坐标可以混合使用,但局部坐标不可与绝对或相对坐标混合使用。举例来说,/tp ~ 64 ~会保持执行者的x轴和z轴坐标,但是将传送执行者到绝对高度64。/tp ^-5 ^ ^将根据头部的倾斜,将玩家向右传送5个方块的距离。
在基岩版,多个命令参数有时可以不需要空格,如~~~可以代表~ ~ ~,~~1~可以代表~ ~1 ~,比如/tp @a ~1 ~2 ~3可以简写为/tp @a ~1~2~3。注意~~1不能代表~ ~ 1,因为~1会被视为一个整体,而1~不会。
目标选择器
大多数以实体或玩家作为参数的命令,可以通过某些限定条件来选择一个或多个实体或玩家,而不必指定实体名、玩家名或UUID。要用条件来选择实体或玩家,应先输入一个目标选择器变量,如有需要,还可再使用一个或多个目标选择器参数以制定具体的条件(可选)。
比如,要把A队所有玩家的游戏模式改为创造模式,但不使用玩家名来逐个指明:
/gamemode creative @a[team=A][仅Java版]
再如,把标签为A的玩家的游戏模式改为创造模式,但不使用玩家名来逐个指明:
/gamemode creative @a[tag=A]
请注意,Java版的目标选择器和基岩版有较大的区别,有的语法只适用于Java版,有的语法只适用于基岩版,请注意文中的“仅Java版”和“仅基岩版”标识。
目标选择器变量
| 变量 | 功能 |
|---|---|
@p |
距离最近的玩家 |
@r |
随机玩家 |
@a |
所有玩家 |
@e |
所有实体 |
@s |
命令的执行者 |
@c |
自己的吉祥物 |
@v |
所有吉祥物 |
@initiator |
与NPC交互的玩家 |
目标选择器变量用于指定待选目标的大致分类。共有8种变量:
@p
- 选择最近的玩家。在服务器控制台中输入时,默认基准点为(0, 0, 0)。如果有多个最近的玩家,他们与基准点距离完全相同,那么会选择其中最晚进入服务器的玩家。
c[仅基岩版]或 limit[仅Java版]目标选择器参数可以用来追加待选目标。例如, @p[c=3][仅基岩版]或 @p[limit=3][仅Java版]将选择三个最近的玩家。 - 在基岩版中,若参数
c是负值,会反转选择目标的顺序。例如,@p[c=-1]会选择最远的一名玩家。
type参数不适用于@p。
@r
- 选择随机玩家。
c[仅基岩版]或 limit[仅Java版]目标选择器参数可以用来追加待选目标。例如, @r[c=3](特别地,c=-1在此处并不适用)[仅基岩版]或 @r[limit=3][仅Java版]将随机选择三个玩家。 - 在基岩版中,如果没有使用
type参数,@r只会选择随机玩家。type参数还可以用来选择非玩家的实体。例如,@r[type=zombie]会随机选择一个僵尸,@r[type=!player]会随机选择一个非玩家实体。 - 在Java版中,
type参数不适用于@r。要选择随机的实体,请使用@e[sort=random,limit=1]代替。
@a
- 选择所有玩家,包括已死亡玩家。
type参数不适用于@a。
@e
- 目标选择器参数可以进一步筛选待选目标。例如,
@e[type=cow]只会选择牛。
@s
- 只选择唯一一个实体:该命令的执行者,包括已死亡玩家。若命令执行者不是一个实体,比如是命令方块或服务器控制台执行命令,则此选择器不会选中任何东西。
@c
- 选择自己的吉祥物。
[仅教育版]
- 目标选择器参数可以用于标记自己的吉祥物。例如,
/tp @c 50 60 40会将自己的吉祥物传送到指定的位置。
@v
- 选择所有的吉祥物。
[仅教育版]
- 目标选择器参数可以用于标记所有的吉祥物。例如,
/remove @v将移除所有的吉祥物。
@initiator
- 选择当前与NPC交互的玩家。
[仅基岩版] - 对于NPC内置的命令界面,有一个特有的选择器变量为
@initiator,它可以选择当前与该NPC进行交互(例如打开NPC对话框、使用NPC按钮和关闭NPC对话框)的玩家。如果该选择器用于外置命令,则不会报错,但不会选择到任何玩家。
目标选择器参数
| 通过坐标 | |
|---|---|
| 参数 | 选择标准 |
x, y, z
|
坐标 |
distancer、rm |
距离 |
dx, dy, dz
|
体积尺寸 |
| 通过记分板参数 | |
| 参数 | 选择标准 |
scores
|
记分项分数 |
tag
|
记分板标签 |
team |
队伍名称 |
| 通过其他特性 | |
| 参数 | 选择标准 |
limit、sortc |
数量 |
levell、lm |
经验等级 |
gamemodem |
游戏模式 |
name
|
实体名称 |
x_rotationrx、rxm |
垂直旋转角度 |
y_rotationry、rym |
水平旋转角度 |
type
|
实体类型 |
family |
家族 |
nbt |
实体的数据标签 |
advancements |
进度 |
predicate |
谓词 |
在使用目标选择器之后,你可以使用参数来限定所要选择的群组。当使用@a或@e时,待选目标从全体筛选成特定的少数。当使用@p或@r时,参数将从完整的待选列表缩小到被筛选后的待选列表。当使用@s时,命令执行者只有在所有参数都满足时才会被选择,否则命令将执行失败。
在目标选择器变量之后附加键值对构成的逗号分隔,并包含在方括号中:
@<变量>[<参数>=<值>,<参数>=<值>,…]
参数和值区分大小写(在基岩版中可以不区分大小写),括号、等号和逗号旁可以有空格(目标选择器和第一个方括号之间除外)。键值对只能用逗号分隔。
- 指定基准点
[x=<值>,y=<值>,z=<值>]- 在世界中定义一个位置,用于
distance参数或dx、dy和dz参数。如果没有这些参数,单独定义位置是没有用的,所以将它(并且只有它)应用于@e仍然会选择世界上的所有实体。 - 坐标可以是整数或像
12.34这样的小数(具体为双精度浮点数)且不会进行中心校正(center-corrected),这意味着x=0不再自动更正为x=0.5。波浪号可用于此参数[仅基岩版]。
- 通过距离选择目标
[<x>,<y>,<z>,distance=<值>]— 根据到某点的欧几里得距离过滤目标。如果位置参数未定义,则相对于命令执行的位置计算。只允许使用非负数。[仅Java版] [r=R]— 只选择所有小于R个方块的目标执行命令。[rm=RM]— 只选择所有大于RM个方块的目标执行命令。[仅基岩版]
- 支持使用范围表示,以定义圆形区域:
@e[distance=10]— 选择所有距离执行位置10个方块的实体。@e[distance=10..12]— 选择所有距离执行位置10至12个方块之间(包含)的实体。@e[distance=5..]— 选择所有距离执行位置大于5个方块的实体。@e[distance=..15]— 选择所有距离执行位置小于15个方块的实体。
- 通过体积尺寸选择目标
[<x>,<y>,<z>,dx=<值>,dy=<值>,dz=<值>]— 选择所有位于一定长方体区域内部的目标。体积定义为从基准点开始,向“x”方向(东方)延伸特定格(包括基准点本身,下同),向“y”方向(上方)延伸特定格,并向“z”方向(南方)延伸特定格。- 这可以解释为创建一个由初始位置(<x>, <y>, <z>)至对角线向量(<dx>, <dy>, <dz>)组成的正方体,然后选择碰撞箱
[仅Java版]或脚部坐标 [仅基岩版]与其重叠的所有实体。如果位置参数未定义,则相对于命令执行的位置计算。允许任何值,包括负数和小数。 - 注意
dx、dy、dz用来指定与坐标的距离;它们不是指定一个新的坐标。 - 可以将通过按距离来选择与按体积来选择组合在一起, 在这种情况下,命令将选择在两个区域的重叠内的实体(在基准点的某个半径范围内,且不在定义的体积之外)。
- 通过分数选择目标
[scores={<objective>=<值>,...}]— 根据指定目标的分数过滤目标。- 所有的记分项都放在一个单独的标签中,并这个标签中分别列出分数选择器。此选择器支持使用范围。
@e[scores={myscore=10}]— 选择所有记分项myscore分数为10的目标。@e[scores={myscore=10..12}]— 选择所有记分项myscore分数为10到12之间(包含)的目标。@e[scores={myscore=5..}]— 选择所有记分项myscore分数为5及以上的目标。@e[scores={myscore=..15}]— 选择所有记分项myscore分数为15及以下的目标。@e[scores={foo=10,bar=1..5}]— 选择所有记分项foo分数为10,且记分项bar分数为1到5之间(包含)的目标。
- 通过标签选择目标
[tag=<标签名>]— 选择所有有标签“标签名”的目标。[tag=!<标签名>]— 选择所有没有标签“标签名”的目标。[tag=]— 选择所有没有标签的目标。[tag=!]— 选择所有有标签的目标。- 允许使用多个参数。被选择的实体必须满足所有的参数条件。
@e[tag=a,tag=b,tag=!c]— 选择所有拥有标签a和b,但没有标签c的目标。@r[tag=a]— 选择一个有标签a的随机玩家。
- 通过队伍选择目标
[仅Java版]
[team=<某队伍>]— 选择所有属于队伍“某队伍”的目标。[team=!<某队伍>]— 选择所有不属队伍“某队伍”的目标。[team=]— 选择所有不属于任何队伍的目标。[team=!]— 选择所有属于任意队伍的目标。
- 指定数量并排序选择目标
- 当使用
@p和@r变量时,此参数默认为1。对它们使用limit参数时会增加选择最近或随机目标的数量。当使用@a或@e变量时,此参数会限制目标数量。
- 当输入的值为负值时,目标的顺序会被反转。举例来说,
@p[c=-3]会回传3个最远的目标,而且,如果所有目标距离都一样远,@e[c=-3]会选择3个刚加载/生成的目标。[仅基岩版]
[limit=<值>,sort=(nearest|furthest|random|arbitrary)]— 选择指定数量的目标,并指定优先级。[仅Java版] sort=nearest— 将目标由近到远排序。(@p的默认排序方式)sort=furthest— 将目标由远到近排序。sort=random— 将目标随机排序。(@r的默认排序方式)sort=arbitrary— 将目标按生成时间由远到近排序。(@a和@e的默认排序方式)
- 通过经验等级选择目标
[level=<值>]— 根据指定目标的经验等级过滤目标。这将自动过滤非玩家目标。[仅Java版] [l=L]— 只选择所有经验等级低于L的目标。[仅基岩版] [lm=LM]— 只选择所有经验等级高于LM的目标。[仅基岩版]
- 此选择器支持使用范围。
@a[level=10]— 选择所有10级的玩家。@a[level=10..12]— 选择所有10级与12级之间(包含)的玩家。@a[level=5..]— 选择所有至少为5级的玩家。@a[level=..15]— 选择所有至多为15级的玩家。
- 通过游戏模式选择目标
[gamemode=<游戏模式>]— 选择所有处于指定游戏模式的目标。[仅Java版] [gamemode=!<游戏模式>]— 选择所有不处于指定游戏模式的目标。[仅Java版] [m=M]— 选择所有处于指定游戏模式的玩家。[仅基岩版] [m=!M]— 选择所有不处于指定游戏模式的玩家。[仅基岩版]
- <游戏模式>的值可以为
spectator[仅Java版]、 adventure、creative和survival。 - 这将自动过滤非玩家目标。
- 在基岩版中,M可以为全称,也可以是数字(0=生存模式,1=创造模式,2=冒险模式)或缩写(s=生存模式,c=创造模式,a=冒险模式)。
- 通过名称选择目标
[name=<某名称>]— 选择所有名字为“某名称”的目标。[name=!<某名称>]— 选择所有名字不为“某名称”的目标。- 这是一个字符串,包含空格时应当用双引号括起。不能是JSON文本。
@e[name=!Steve]— 选择不叫“Steve”的目标。
- 通过垂直旋转选择目标
[x_rotation=<值>]— 根据指定目标的垂直旋转角度过滤目标。[仅Java版] [rx=RX]— 仅选择所有最大垂直旋转角度为RX的目标。[仅基岩版] [rxm=RXM]— 仅选择所有最小垂直旋转角度为RXM的目标。[仅基岩版]
- 更具体地说,是旋转高度与地平线的夹角,以度为单位。垂直旋转值从-90(垂直向上)向上增加,之后增加到0(水平),最后增加到90(竖直向下)(因此垂直旋转值随着向下旋转而增加)。
- 此选择器支持范围。
@e[x_rotation=0]— 选择所有看向地平线的目标。@e[x_rotation=30..60]— 选择所有看向地平线偏下30°至60°(包含)的目标。@e[x_rotation=45..]— 选择所有看向地平线偏下45°(包含)及更低的目标。@e[x_rotation=..0]— 选择所有看向地平线偏上的目标。
- 通过水平旋转选择目标
[y_rotation=<值>]— 根据指定目标的水平旋转角度过滤目标。[仅Java版] [ry=RY]— 仅选择最大水平旋转为RY的目标。[仅基岩版] [rym=RYM]— 仅选择最小水平旋转为RYM的目标。[仅基岩版]
- 其角度以正南(或正Z轴方向)为基准顺时针旋转。水平旋转值从-180(面向正北)开始,到-90(面向正东),再到0(面向正南),再到90(面向正西),最后到180(再次面向正北)。
- 此选择器支持范围。
@a[y_rotation=0]— 选择所有看向正南的目标。@a[y_rotation=45]— 选择所有看向南偏西45°的目标。@a[y_rotation=96]— 选择所有看向西偏北6°的目标。@a[y_rotation=-90..0]— 选择所有看向正东和正南(包含)之间的目标。@a[y_rotation=-90..90]— 选择所有看向正东和正西之间(包含)的目标,区域穿过正南。@a[y_rotation=0..]— 选择所有不看向南方(包含)和东方之间的目标。
- 通过实体类型选择目标
[type=<实体类型>]— 选择所有特定的实体类型的目标。[type=!<实体类型>]— 选择所有不是特定的实体类型的目标。- 实体类型必须使用有效的实体ID或或实体标签。如果实体ID的命名空间在
minecraft:内则可以省略命名空间。(举例来说,minecraft:creeper指定苦力怕,minecart指定普通矿车,tnt指定点燃的TNT等等)实体ID或标签区分大小写。 - 当与
@r一起使用时,原本用来选择玩家的命令也可以被用来选择其他实体。
- 通过家族选择目标
[仅基岩版]
[family=<家族>]— 选择属于指定家族的实体。[family=!<家族>]— 选择不属于指定家族的实体。- 给定的实体家族可以是任何字符串,但不包括命名空间。这些实体家族在实体家族种类行为组件中定义。原版行为包使用的默认值包括更广泛的大型家族(例如
mob、inanimate、monster、undead)以及更具体的小型家族(例如zombie、skeleton)和单个生物的家族(例如wandering_trader、enderman、creeper)。单个实体可以属于多个家族。
- 通过NBT选择目标
[仅Java版]
[nbt=<NBT>]— 选择具有指定NBT的所有目标。NBT结构以其命令定义编写。- 例如:
@a[nbt={OnGround:1b}]— 选择所有站在地上的玩家。@e[type=sheep,nbt={Color:0b}]— 选择所有白色的绵羊。@e[type=item,nbt={Item:{id:"minecraft:slime_ball"}}]— 选择所有黏液球物品实体。@e[nbt={Tags:["a","b"]}]与@e[tag=a,tag=b]的效果相同。后者更简单,且减少了CPU的负载。
- 注意:当匹配字符串内的命名空间ID时,不得省略其命名空间。
- 因此
@e[type=item,nbt={Item:{id:"slime_ball"}}]找不到任何东西,因为 id字段始终包含一个已经被转换的命名空间ID字符串。
- 因此
- 从Java版1.13开始,目标选择器支持
advancements参数,取代/advancement test。参数名称是进度的IDadvancements后接一组用中括号包含来的键值对,其中键为进度或条件的名称,值为true或false或表示进度的各条件的键值对。@a[advancements={story/form_obsidian=true}]— 选择所有已达成进度“冰桶挑战”(minecraft:story/form_obsidian)的玩家。@a[advancements={story/form_obsidian=false}]— 选择所有未达成进度“冰桶挑战”(minecraft:story/form_obsidian)的玩家。@a[advancements={story/obtain_armor={iron_helmet=true}}]— 选择所有装备过铁头盔的玩家。选择时玩家不一定正在装备铁头盔,也不一定需要达成进度“整装上阵”(minecraft:story/obtain_armor)。@a[advancements={story/follow_ender_eye=true}]与@a[advancements={story/follow_ender_eye={in_stronghold=true}}]的效果相同。
- 通过谓词选择目标
[仅Java版]
[predicate=<命名空间ID>]— 选择所有匹配该谓词的目标。[predicate=!<命名空间ID>]— 选定所有不匹配该谓词的目标。
- 从19w38a起,选择器可以在其参数中使用谓词。
@a[predicate=example:test_predicate]— 选择所有匹配谓词example:test_predicate的玩家。@e[predicate=!minecraft-wiki:smart_entity]— 选择所有不匹配谓词minecraft-wiki:smart_entity的实体。
数据标签
数据标签是一种树状数据结构,可以被用花括号包含的键值对描述。数据标签用于Java版的命令中,用于指定玩家、实体和一些方块的较为复杂的数据。
数据标签由零个或多个用逗号分隔的键值对组成,且本身用大括号括住。每个键值对包含键名和键值,用冒号分开。但是,有些键值可以继续包含键值对,因此数据标签可以用来描述层次结构。
- 例:
{name1:123,name2:"sometext",name3:{subname1:456,subname2:789}}
这些数据标签所采用的数据结构与Minecraft世界存档相同。这种数据结构在其他条目中有详细描述。命令使用的数据标签中键名有严格的限定(区分大小写):
| 对象 | 例子 |
|---|---|
| 方块 | 箱子、熔炉、命令方块、刷怪蛋、告示牌等 |
| 物品 | 物品栏中的物品 (包括附魔、自定义名称等) |
| 物品实体 | 在地上的物品 |
| 生物 | 苦力怕、牛、村民等 |
| 弹射物 | 弓箭、火球、喷溅药水等 |
| 交通工具 | 船、矿车等 |
| 动态方块 | 引燃的TNT、正在掉落的沙子、沙砾、铁砧 |
| 其他实体 | 烟花火箭、画和物品展示框 |
指定键名的键值也必须符合数据类型要求。
| 类型 | 说明 |
|---|---|
| 字节(byte) | 介于-128和127之间(包含)的整数。 |
| 短整型(short) | 介于-32768和32767之间(包含)的整数。 |
| 整型(int) | 介于-2147483648和2147483647之间(包含)的整数。 |
| 长整型(long) | 介于-9,223,372,036,854,775,808和9,223,372,036,854,775,807之间(包含)的整数。 |
| 单精度浮点型(float) 双精度浮点型(double) |
Float: 32位单精度浮点数,介于-3.4E+38和+3.4E+38之间。
Double: 64位双精度浮点数,介于-1.7E+308和+1.7E+308之间。
|
| 字符串(string) | 一串字符,如果内容包含不在 a-z A-Z 0-9 _ .(不包括空格)的字符则需要在整个字符串前后加上双引号。\可以将后面的字符转义(不支持像JSON那样\u00a7这样的转义)。转义方式为,在"及\号前加上\。
|
| 列表(list) | 值的序列,用逗号分隔并用方括号包含。所有值的数据类型必须统一——数据类型标准由列表的第一个元素决定。
|
| 复合标签(compound) | 键值对的序列,用逗号分隔并用花括号包含。
每个数据标签的内容本身就是一个复合标签。 复合标签里面可以包含任何标签。 |
| 字节数组(byte-array) | 介于-128和127(包含)之间的整数序列,用逗号分隔内容并用方括号包含,首个元素前方需要加入类型标识B;。
|
| 整型数组(int-array) | 介于-2,147,483,648和2,147,483,647(包含)之间的整数序列,用逗号分隔内容并用方括号包含,首个元素前方需要加入类型标识I;。
|
| 长整型数组(int-array) | 介于-9,223,372,036,854,775,808和9,223,372,036,854,775,807(包含)之间的整数序列,用逗号分隔内容并用方括号包含,首个元素前方需要加入类型标识L;。
|
| 布尔型(boolean) | 一种数据类型,只有“true”和“false”两种取值。由于程序通常使用 字节存储布尔值,布尔型只会在JSON格式中出现。在NBT中,true和false相当于1和0。
|
某些命令要求明确指明某些数值的数据类型,这可以通过在数值后附加限定字符(B、S、L、F、D)来实现。举例来说,3s表示短整型,3.2f表示单精度浮点,等等。(字符I不能限定整型。)限定字符不区分大小写。在不加限定字符,且Minecraft无法根据上下文来确定数据类型或需要比对数据标签时,会将数据类型假定为双精度浮点型(数值有小数部分时)、整型(数值没有小数点,且在整型取值范围内)或字符串(若前述情况均不符合)。被方括号包含的集合中,被逗号分隔的元素若全为整型,则会将数据类型假定为整型数组(如[I;1,2,3]是一个整型数组,[L;1L,2L,3L]是一个长整型数组);否则会假定为列表。但有以下特例:[]是一个空列表,而[,]是一个空整型数组。
如果用/clear等命令来查找数据标签,这些命令只会检查目标实体/方块/物品是否存在此标签。这意味着一个符合条件的实体/方块/物品可能同时还拥有其他标签。这对列表和数组同样成立:只要列表或数组中包含待查找的所有元素,就会成功匹配,既不考虑元素的排列顺序,也不考虑是否有多余的元素存在。
原始JSON文本
在Java版中,/tellraw和/title命令使用严格的JSON语法以显示文字。此外,部分NBT标签的值需要输入原始JSON文本。
在基岩版中,原始JSON文本可以作用于/tellraw的内容、/titleraw的标题、书与笔的文本(题目和作者除外)以及告示牌的文本。
Java版中的ID参数
许多命令要求指定某种方块、物品、实体、药水效果、附魔、boss栏等的ID。在下文的命令语法中,这些参数会被标注为<方块>、<物品>,或在实例中用诸如minecraft:stone 之类的标识符替换。这些ID都有命名空间。所有来自Minecraft的内容都使用minecraft命名空间,而来自mod及数据包的内容都使用其他命名空间。 在大多数情况下,可以省略命名空间为 minecraft的ID的前缀,但是在某些情况下,例如匹配NBT数据标签时,需要完整的命名空间ID。
<方块>
例子:
stoneminecraft:redstone_wire[power=15,north=up,south=side]minecraft:jukebox{RecordItem:{...}}minecraft:furnace[facing=north]{BurnTime:200}
<方块>参数的格式为命名空间ID[方块状态]{数据标签},其中方块状态和数据标签在不需要时可以省略。
- 方块的命名空间ID是必需的(如果没有设定命名空间则将默认为预设值:
minecraft:)。 - 方块状态是可选的,位于
[]内,名称与值用等号分隔,名称数值组用逗号分隔,且必须是该方块支持的状态:[<方块状态名称>=<值>,<方块状态名称>=<值>,…]
minecraft:stone[doesntexist=purpleberry]有语法错误,因为stone(石头)没有doesntexist状态。minecraft:redstone_wire[power=tuesday]有语法错误,因为redstone_wire(红石线)的power是一个在0和15之间的数字。
- 数据标签是可选的,位于
{}内。 - 如果方块参数被用于检查方块,则只会检查参数内指定了的方块状态与数据标签是否符合。
- 如果方块参数用于放置方块,你所提供的任何状态与标签都会被设置,而其他未提供的状态与标签会被设为预设值
- 如当你设置
redstone_wire[power=15],那它将设置power到15却使north设为预设值(在这个情况下被设置为none)
- 如当你设置
如果方块参数被用于检查方块,则也可以填写带#前缀的方块标签的命名空间ID,如#minecraft:planks。
<物品>
例子:
stoneminecraft:stick{display:{Name:"\"谎言之杖\""}}
<物品>参数的格式为命名空间ID{数据标签},其中数据标签在不需要时可以省略。
参数类型列表
下列为Java版中的参数类型。
权限等级
权限等级用于控制命令执行者可以执行什么命令。比如在Java版中,/kick不能在命令方块中执行,因为这个命令需要3的权限等级,而命令方块的权限等级仅为2。
在Java版中,权限等级可为0,1,2,3或4。
在基岩版中,权限等级可为0,1,2,3或4。
- 命令方块或命令方块矿车的权限等级为
1。 - 服务器控制台的权限等级为
4。 - 函数和附加包中的脚本的权限等级为
1。 /execute执行子命令的权限等级为2。- 对于玩家来说:
- 如果该玩家在服务器中,且该玩家在“玩家权限”屏幕中的“操作员命令”开关已打开,那么他的权限等级默认为
1(可在server.properties中更改)。 - 如果该玩家在单人游戏世界或局域网世界中,且该玩家在“玩家权限”屏幕中的“操作员命令”开关已打开,那么他的权限等级默认为
3。 - 否则,他的权限等级为
0。[需要测试]
- 如果该玩家在服务器中,且该玩家在“玩家权限”屏幕中的“操作员命令”开关已打开,那么他的权限等级默认为
注:命令的权限等级与暂停菜单和“玩家权限”屏幕中的身份(访客,成员,操作员或自定义)不同。例如在单人游戏世界中,身份为操作员的玩家的权限等级为3,因为其对应的“操作员命令”开关已打开;身份为访客或成员的玩家的权限等级为0,因为其对应的“操作员命令”开关没有打开。
命令列表及其概述
下表列出了所有可用命令,包括即将到来的命令。点击表头可以排序。
点击每一行第一格中的链接可以查看命令的具体用法。
| 命令 | 描述 | BE | EDU | JE | JE权限等级 | BE及EDU权限等级 | 仅限MP | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
/?
|
/help的替代命令,提供命令使用帮助。
|
是 | 是 | 是 | 0 | 0 | — | — | — | — | — |
/ability
|
赋予或剥夺玩家的能力。 | 是 | 是 | — | — | 1 | — | — | — | — | |
/advancement
|
添加、移除或查询玩家的进度。 | — | — | 是 | 2 | — | — | — | — | — | |
/agent
|
操控吉祥物。 | WS | WS | — | 0 | 0 1 |
— | — | — | — | |
/alwaysday
|
/daylock的替代命令,锁定或解锁日夜循环。
|
是 | 是 | — | — | 1 | — | — | — | — | |
/attribute
|
修改或查询玩家和生物的属性。 | — | — | 是 | 2 | — | — | — | — | ||
/ban
|
将玩家加入封禁列表。 | — | — | 是 | 3 | — | 是 | — | — | — | |
/ban-ip
|
将IP地址加入封禁列表。 | — | — | 是 | 3 | — | 是 | — | — | — | |
/banlist
|
显示封禁列表。 | — | — | 是 | 3 | — | 是 | — | — | — | |
/bossbar
|
修改或查询Boss栏。 | — | — | 是 | 2 | — | — | — | — | ||
/camerashake
|
启用镜头抖动效果。 | 是 | — | — | — | 1 | — | — | — | — | |
/changesetting
|
更改一个正在运行的服务器的设置。 | 是 | — | — | — | 4 | 是 | — | — | — | — |
/classroommode
|
允许编辑受限制的方块。 | — | 是 | — | — | 0 |
— | — | — | — | — |
/clear
|
从玩家物品栏中删除物品。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/clearspawnpoint
|
从世界中移除出生点。 | 是 | — | — | — | 1 | — | — | — | — | |
/clone
|
将特定区域的方块复制到另一处。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/closechat
|
如果聊天框已打开,则关闭它。 | 是 | 是 | — | — | 0 | — | — | — | — | — |
/closewebsocket
|
断开已连接的WebSocket服务器。 | WS | WS | — | — | 0 | — | — | — | — | — |
/code
|
启动代码编辑器。 | — | 是 | — | — | 0 | — | — | — | — | — |
/codebuilder
|
设置一个玩家的代码编辑状态。 | 是 | 是 | — | — | 1 | — | — | — | — | — |
/connect
|
/wsserver的替代命令,连接至一个WebSocket服务器。
|
是 | 是 | — | — | 0 2 |
— | — | — | — | — |
/data
|
允许玩家获取、合并或是移除实体或方块的数据标签。 | — | — | 是 | 2 | — | — | — | |||
/datapack
|
控制加载的数据包。 | — | — | 是 | 2 | — | — | — | — | — | |
/daylock
|
/alwaysday的替代命令,锁定或解锁日夜循环。
|
是 | 是 | — | — | 1 | — | — | — | — | |
/debug
|
开始或结束调试会话。 | — | — | 是 | 3 | — | — | — | — | — | — |
/defaultgamemode
|
更改默认的游戏模式。 | — | — | 是 | 2 | — | — | — | — | — | |
/dedicatedwsserver
|
尝试连接一个WebSocket服务器。 | 是 | — | — | — | 0 | MP | — | — | — | — |
/deop
|
撤销玩家的管理员权限。 | 是 | 是 | 是 | 3 | 2 | 是 |
— | — | — | |
/dialogue
|
打开一个玩家的NPC对话。 | — | 是 | — | — | 1 | — | — | — | — | |
/difficulty
|
设置难度等级。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/effect
|
添加或移除状态效果。 | 是 | 是 | 是 | 2 | 1 | — | — | — | ||
/enableencryption
|
为当前WebSocket连接启用加密。 | WS | WS | — | — | 0 | — | — | — | — | — |
/enchant
|
附魔玩家的物品。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/event
|
用于触发一个实体的事件。 | 是 | — | — | — | 1 | — | — | — | ||
/execute
|
代表实体执行另一命令。 | 是 | 是 | 是 | 2 | 1 | — | ||||
/experience
|
/xp的替代命令,给予玩家经验。
|
— | — | 是 | 2 | — | — | — | — | — | |
/fill
|
在某个区域填充特定方块。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/fog
|
用于更改玩家当前的雾设置。 | 是 | — | — | — | 1 | — | — | — | — | |
/forceload
|
强制不断加载区块。 | — | — | 是 | 2 | — | — | — | — | — | |
/function
|
运行一个函数。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/gamemode
|
更改玩家的游戏模式。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/gamerule
|
更改或查询游戏规则。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/getchunkdata
|
获得特定区块的数据。 | 是 | 是 | — | — | 3 | — | — | — | — | — |
/getchunks
|
获得已加载区块列表。 | 是 | 是 | — | — | 3 | — | — | — | — | — |
/geteduclientinfo
|
显示有关客户端的数据。 | — | 是 | — | — | 0 | — | — | — | — | — |
/geteduserverinfo
|
显示有关服务端的数据。 | 是 | — | — | — | 0 | 是 | — | — | — | — |
/getlocalplayername
|
显示本地玩家姓名。 | 是 | 是 | — | — | 0 | — | — | — | — | — |
/getspawnpoint
|
获得特定玩家的出生地点。 | 是 | 是 | — | — | 3 | — | — | — | — | — |
/gettopsolidblock
|
获得特定位置以下最高的非空气方块。 | 是 | 是 | — | — | 0 1 |
— | — | — | — | — |
/give
|
给予玩家物品。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/globalpause
|
查询或设置所有玩家的世界暂停状态。 | 是 | 是 | — | — | 3 | — | — | — | — | — |
/help
|
/?的替代命令,提供命令使用帮助。
|
是 | 是 | 是 | 0 | 0 | — | — | — | — | — |
/immutableworld
|
设置世界的不可变状态。 | 是 | 是 | — | — | 1 | — | — | — | — | |
/item
|
用于修改方块或实体的物品栏。 | — | — | 是 | 2 | — | — | — | |||
/kick
|
将玩家踢出服务器。 | 是 | 是 | 是 | 3 | 1 | — | — | — | — | |
/kill
|
清除实体(玩家、生物、掉落物等)。 | 是 | 是 | 是 | 2 | 1 | — | — | — | ||
/lesson
|
处理教育版课程报告。 | — | 是 | — | — | 0 | — | — | — | — | — |
/list
|
列出服务器中的玩家。 | 是 | 是 | 是 | 0 | 0 | — | — | — | — | |
/listd
|
以JSON形式列出服务器中的玩家及信息。 | WS | WS | — | — | 3 | — | — | — | — | |
/locate
|
显示最近的给定结构的坐标。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/locatebiome
|
显示最近的给定生物群系的坐标。 | — | — | 是 | 2 | — | — | — | — | — | |
/loot
|
从一个物品栏中掉落物品到地面上。 | — | — | 是 | 2 | — | — | — | |||
/me
|
显示一条关于自己的信息。 | 是 | 是 | 是 | 0 | 0 | — | — | — | — | |
/mixer
|
Mixer交互性控制。 | 是 | — | — | — | 0 | — | — | — | — | — |
/mobevent
|
控制或查询允许运行的生物事件。 | 是 | 是 | — | — | 1 | — | — | — | — | |
/msg
|
/tell和/w的替代命令,向另一玩家发送私信。
|
是 | 是 | 是 | 0 | 0 | — | — | — | — | |
/music
|
设置玩家是否能控制当前播放的音乐。 | 是 | — | — | — | 1 | — | — | — | — | |
/op
|
授予玩家管理员权限。 | 是 | 是 | 是 | 3 | 2 | 是 |
— | — | — | |
/ops
|
/permission的替代命令,重载并应用权限。
|
是 | 是 | — | — | 4 | 是 | — | — | — | |
/pardon
|
从封禁列表中移除玩家封禁项目。 | — | — | 是 | 3 | — | 是 | — | — | — | |
/pardon-ip
|
从封禁列表中移除IP封禁项目。 | — | — | 是 | 3 | — | 是 | — | — | — | |
/particle
|
创建粒子。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/permission
|
/ops的替代命令,重载并应用权限。
|
是 | 是 | — | — | 4 | 是 | — | — | — | |
/playanimation
|
运行一次特定动作。 | 是 | — | — | — | 1 | — | — | — | ||
/playsound
|
播放音效。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/publish
|
向局域网开放单人游戏世界。 | — | — | 是 | 4 | — | 仅限SP | — | — | — | |
/querytarget
|
检测某实体所在坐标、旋转角度、所在维度及专用ID。 | WS | WS | — | — | 0 2 |
— | — | — | ||
/recipe
|
给予或剥夺合成配方。 | — | — | 是 | 2 | — | — | — | — | — | |
/reload
|
从硬盘中重新加载战利品表、进度和函数。 | 是 | 是 | 是 | 2 | 2 | — | — | — | — | |
/remove
|
移除吉祥物。 | — | 是 |
— | — | 2 | — | — | — | — | |
/replaceitem
|
替换物品栏中的物品。 | 是 | 是 | 已移除 | 2 | 1 | — | — | |||
/ride
|
控制一个实体的骑行状态。 | 是 | — | — | — | 1 | — | — | — | ||
/save
|
准备备份,查询其状态或恢复。 | 是 | — | — | — | 4 | 是 | — | — | — | |
/save-all
|
保存服务器世界状态到硬盘。 | — | — | 是 | 4 | — | 是 | — | — | — | |
/save-off
|
关闭服务器自动保存。 | — | — | 是 | 4 | — | 是 | — | — | — | |
/save-on
|
开启服务器自动保存。 | — | — | 是 | 4 | — | 是 | — | — | — | |
/say
|
向多个玩家发送消息。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/schedule
|
安排函数在特定的游戏刻后运行。 | 是 | — | 是 | 2 | 1 | — | — | — | — | — |
/scoreboard
|
管理记分板的目标、玩家和队伍。 | 是 | 是 | 是 | 2 | 1 | — | — | — | ||
/seed
|
显示世界种子。 | — | — | 是 | 0[仅单人游戏] 2[仅多人游戏] |
— | — | — | — | — | |
/setblock
|
将方块替换为其他方块。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/setidletimeout
|
设置无操作玩家被踢出的延时。 | — | — | 是 | 3 | — | 是 | — | — | — | |
/setmaxplayers
|
设置可加入游戏的玩家数量上限。 | 是 | 是 | — | — | 3 | — | — | — | — | |
/setworldspawn
|
设置世界出生点。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/spawnitem
|
在特定位置生成一个物品实体。 | — | 是 | — | — | 0 | — | — | — | — | |
/spawnpoint
|
设置一个玩家的出生地点。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/spectate
|
使一个处于旁观模式的玩家旁观一个实体。 | — | — | 是 | 2 | — | — | — | — | — | |
/spreadplayers
|
将实体传送到随机位置。 | 是 | 是 | 是 | 2 | 1 | — | — | — | ||
/stop
|
关闭服务器。 | 是 | — | 是 | 4 | 4 | 是 | — | — | — | |
/stopsound
|
停止音效。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/structure
|
无需结构方块即可保存和加载结构。 | 是 | — | — | — | 1 | — | — | |||
/summon
|
生成一个实体。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/tag
|
修改实体的标签。 | 是 | 是 | 是 | 2 | 1 | — | — | — | ||
/takepicture
|
从一个玩家的角度拍摄另一个玩家的照片。 | 是 | 是 | — | — | 1 | — | — | — | — | |
/team
|
修改队伍。 | — | — | 是 | 2 | — | — | — | — | ||
/teammsg
|
/tm的替代命令,指定要发送给队伍的消息。
|
— | — | 是 | 0 | — | — | — | — | — | |
/teleport
|
/tp的替代命令,传送实体。
|
是 | 是 | 是 | 2 | 1 | — | — | — | ||
/tell
|
/msg和/w的替代命令,向另一个玩家发送私信。
|
是 | 是 | 是 | 0 | 0 | — | — | — | — | |
/tellraw
|
向玩家显示JSON消息。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/testfor
|
统计符合给定条件的实体。 | 是 | 是 | 已移除 | 2 | 1 | — | — | — | ||
/testforblock
|
检测某方块是否在某位置。 | 是 | 是 | 已移除 | 2 | 1 | — | — | — | — | |
/testforblocks
|
检测两个区域中的方块是否相同。 | 是 | 是 | 已移除 | 2 | 1 | — | — | — | — | |
/tickingarea
|
添加、删除或列出常加载区域。 | 是 | 是 | — | — | 1 | — | — | — | — | |
/time
|
更改或查询游戏中的世界时间。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/title
|
管理屏幕上的标题。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/titleraw
|
使用JSON管理屏幕上的标题。 | 是 | 是 | — | — | 1 | — | — | — | — | |
/tm
|
/teammsg的替代命令,指定要发送给队伍的消息。
|
— | — | 是 | 0 | — | — | — | — | — | |
/toggledownfall
|
切换天气。 | 是 | 是 | — | — | 1 | — | — | — | — | |
/tp
|
/teleport的替代命令,传送实体。
|
是 | 是 | 是 | 2 | 1 | — | — | — | ||
/trigger
|
设置一个触发器。 | — | — | 是 | 0 | — | — | — | — | — | |
/videostream
|
连接一个WebSocket服务器,并进行视频推流。 | — | 是 | — | — | 0 | — | — | — | — | — |
/w
|
/tell和/msg的替代命令,向另一玩家发送私信。
|
是 | 是 | 是 | 0 | 0 | — | — | — | — | |
/wb
|
/worldbuilder的替代命令,给予能编辑受限制方块的能力。
|
是 | 是 | — | — | 1 | — | — | — | — | |
/weather
|
设置天气。 | 是 | 是 | 是 | 2 | 1 | — | — | — | — | |
/whitelist
|
管理服务器白名单。 | 是 | — | 是 | 3 | 4 | 是 | — | — | — | |
/worldborder
|
管理世界边界。 | — | — | 是 | 2 | — | — | — | — | — | |
/worldbuilder
|
/worldbuilder的替代命令,给予能编辑受限制方块的能力。
|
是 | 是 | — | — | 1 | — | — | — | — | |
/wsserver
|
/connect的替代命令,连接至WebSocket服务器。
|
是 | 是 | — | — | 0 2 |
— | — | — | — | — |
/xp
|
/experience的替代命令 |
是 | 是 | 是 | 2 | 1 | — | — | — | — |
已移除的命令
| 命令 | 描述 | 移除版本 | 移除原因 | BE | EDU | JE | JE权限等级 | BE及EDU权限等级 | 仅限MP | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/achievement
|
给予或剥夺玩家的成就。 | Java版1.12 (17w13a) |
Java版1.12中,成就系统被进度替代。 | — | — | 已移除 | 2 | — | — | — | — | — | |
/banip
|
将IP地址加入封禁列表。 | Java版Indev 0.31 | 被整理进/ban-ip。
|
— | — | 已移除 | ? | — | 是 | — | — | — | |
/blockdata
|
修改方块的数据标签。 | Java版1.13 (17w47a) |
被整理进/data。
|
— | — | 已移除 | 2 | — | — | — | — | — | |
/broadcast
|
在整个服务器中广播消息。 | Java版Classic 0.0.16a_01 | 被整理进/say。
|
— | — | 已移除 | 1 | — | — | — | — | — | — |
/chunk
|
控制一个区块是否常加载。 | Java版1.13.1-pre1 | 被整理进/forceload。
|
— | — | 已移除 | 2 | — | — | — | — | — | |
/clearfixedinv
|
清除固定的物品栏。 | 携带版Alpha 0.16.0 (build 2) |
? | 已移除 | 已移除 | — | — | ? | ? | — | — | — | |
/detect
|
当限制条件满足时执行命令。 | 基岩版1.2.0 | 被整理进/execute。
|
已移除 | — | — | — | 1 | — | — | — | — | — |
/entitydata
|
修改实体的数据标签。 | Java版1.13 (17w45b) |
被整理进/data。
|
— | — | 已移除 | 2 | — | — | — | — | — | |
/executeasself
|
执行一个命令。 | ? | ? | 已移除 | 已移除 | — | — | 0 | — | — | — | — | — |
/home
|
将玩家召唤到世界的生成点。 | Java版Alpha v1.2.5 | 世界生成点现在基于生成区块了,而不是单一位置。 | — | — | 已移除 | 0 | — | — | — | — | — | — |
/position
|
控制是否在HUD中显示玩家坐标。 | 教育版1.0.21 | 被整理进/gamerule。
|
— | 已移除 | — | — | 0 | — | — | — | — | — |
/resupply
|
村民重新补给。 | ? | ? | 已移除 | — | — | 2 | — | — | — | — | — | |
/setfixedinvslot
|
以一个物品设置固定的物品栏。 | 携带版Alpha 0.16.0 (build 2) |
? | 已移除 | 已移除 | — | — | ? | ? | — | — | — | |
/setfixedinvslots
|
设置固定物品栏数量。 | 携带版Alpha 0.16.0 (build 2) |
? | 已移除 | 已移除 | — | — | ? | ? | — | — | — | |
/setspawn
|
将当前位置设为新玩家默认的生成点。 | Java版Indev 0.31 | 世界生成点现在基于生成区块了,而不是单一位置。 | — | — | 已移除 | 2 | — | — | — | — | — | — |
/solid
|
在放置石头和放置基岩间切换。 | Java版Indev 0.31 | 放置的方块现在由物品栏决定。 | — | — | 已移除 | 2 | — | — | — | — | — | — |
/stats
|
更新命令结果产生的记分项。 | Java版1.13 (17w45a) |
被整理进/execute。
|
— | — | 已移除 | 2 | — | — | — | |||
/unban
|
从封禁列表中移除封禁项目。 | Java版Alpha v1.0.16 | 被整理进/pardon。
|
— | — | 已移除 | 3 | — | 是 | — | — | — |
其他
“WS”表示这类命令通常需要使用WebSocket服务器代为执行,在游戏界面中无法被执行。“部分”表示这些命令通常并未被移除,但是玩家已无法通过任何正常方式在最新版本中执行。
基岩版开发者命令
基岩版开发者命令是供游戏的开发和测试使用的,在正式版本中玩家通常无法看见并执行这些命令。然而,这些命令曾被意外地保留了下来。随后在基岩版1.2.14中被移除。
命令指引
- 格式
在Java版中:
语法 含义 纯文本纯文本,直接键入。 <参数名>需要使用一合适的值来替换该参数。 [可选输入项]该输入项是可选的。 (输入项|输入项)(必须的)在显示的值中选择一个填写。 [输入项|输入项](可选的)在显示的值中选择一个填写。 省略 ...需要接入一条子指令。
在基岩版中:
语法 含义 纯文本纯文本,直接键入。 名称:种类需要使用一合适的值来替换该参数。 参数|参数在显示的值中选择一个填写。 <参数>该参数是必需的。 [可选参数]该参数是可选的。 省略号 …此参数可能是含有空格的多个单词。 参数:整型此参数需要输入整数。 参数:浮点型此参数需要输入小数。 参数:字符串此参数是字符串。
- 成功条件
- 只有情况符合命令的成功条件时游戏才会认为命令执行成功。成功与否本身会产生许多影响,例如接收了命令方块红石信号的红石比较器,其输出会有所变化。请注意,并非所有的“成功”的命令都会使世界有所改变,“失败”的命令也不意味着命令什么也没有做。
- 限制条件
- 描述该命令的执行者与执行条件要求。
- 无:此命令可以由任何玩家在任何世界执行。下列命令没有限制条件:
/help、/me、/tell和/trigger。 - 是管理员:此命令只能由管理员或在启用作弊的单人游戏执行。在多人游戏服务器中,这类命令的结果会向所有在线管理员通报。
- 仅多人游戏:此命令只能在多人游戏服务器中执行。下列命令只能在多人游戏服务器中执行:
/ban、/ban-ip、/banlist、/deop、/kick、/list、/op、/pardon、/pardon-ip、/save-all、/save-off、/save-on、/setidletimeout、/stop和/whitelist。
- 所有多人游戏限定的命令都不允许参数中有目标选择器。
- 除了
/list、/kick[仅基岩版]所有的多人游戏命令都不能由命令方块执行。 - 许多这类命令都可以对从未进入服务器甚至非Minecraft注册账号的玩家使用。
- 不在命令方块上执行:此命令的执行者不能是命令方块。
- 无:此命令可以由任何玩家在任何世界执行。下列命令没有限制条件:
历史
| Java版Classic | |||||
|---|---|---|---|---|---|
| 0.0.15a(多人测试3) | 加入了/ban、/banip、/broadcast、/deop、/kick、/op、/tp和/unban命令。 | ||||
| 0.0.16a_01 | 将/broadcast命令变更为/say。 | ||||
| 0.0.17a | 加入了/setspawn命令。 | ||||
| 0.0.20a | 加入了/solid命令。 | ||||
| Java版Indev | |||||
| 0.31 | 移除了所有命令。 | ||||
| Java版Alpha | |||||
| v1.0.16 | 加入了/ban、/ban-ip、/banlist、/deop、/home、/kick、/op、/pardon、/pardon-ip、/say和/stop命令。 | ||||
| v1.0.16_01 | 加入了/save-all、/save-on、/save-off和/tp命令。 | ||||
| v1.0.16_02 | 加入了/list和/tell命令。 | ||||
| v1.2.5 | 移除了/home命令。 | ||||
| v1.2.6 | 加入了/kill命令。 | ||||
| Java版Beta | |||||
| 1.3 | 加入了/whitelist命令。 | ||||
| Java版 | |||||
| 1.3.1 | 12w16a | 加入了作弊模式和/gamemode、/give、/time、/toggledownfall和/xp命令。 | |||
| 12w17a | 加入了/help命令。
| ||||
| 多人游戏中的命令被显示为斜体。 | |||||
| 12w18a | 输入命令时游戏不再暂停。 | ||||
| 12w21a | 加入了/seed命令。 | ||||
| 12w22a | 加入了/defaultgamemode命令。 | ||||
| 12w24a | 加入了/publish命令。 | ||||
| 12w25a | 可在将世界开放到局域网时开关作弊模式。 | ||||
| 12w27a | 加入了/debug命令。 | ||||
| 12w30a | /gamemode 3改为/gamemode 0。 | ||||
| 1.4.2 | 12w32a | 加入了/difficulty、/gamerule、/spawnpoint和/weather命令。
| |||
| 加入了目标选择器。 | |||||
| 12w37a | 加入了/clear命令。 | ||||
| 12w38a | /clear命令加入了item参数。 | ||||
| 12w41a | /xp的限制从5,000加大到2,147,483,647。 | ||||
| 1.4.4 | 1.4.4-pre | 加入了/enchant命令。 | |||
| 1.5 | 13w03a | 加入了/testfor命令。 | |||
| 13w04a | 加入了/scoreboard命令。 | ||||
| 13w09b | 加入了/effect命令。 | ||||
| 1.6.1 | 13w23a | 加入了/spreadplayers命令。
| |||
加入了游戏规则naturalRegeneration。 | |||||
| 13w24a | 加入了游戏规则doDaylightCycle。 | ||||
| 13w24b | /kill命令造成的伤害从1,000加入了至3.4×1038。 | ||||
| 1.6-pre | /effect命令加入了clear参数。 | ||||
| 1.6.1-pre | 加入了/playsound命令。 | ||||
| 1.7.2 | 13w36a | 加入了/summon命令。
| |||
加入了/achievement命令。 | |||||
/give命令加入了dataTag参数。 | |||||
| 13w37a | 加入了/setblock、/tellraw和/testforblock命令。 | ||||
| 13w38a | 加入了/setidletimeout命令。 | ||||
| 13w43a | 加入了/setworldspawn命令。 | ||||
| 1.8 | 14w02a | 加入了/blockdata命令。
| |||
加入了目标选择器@e。 | |||||
/kill命令加入了player|entity参数。 | |||||
/clear命令加入了data参数。 | |||||
/testfor命令加入了dataTag参数。 | |||||
/testfor命令可在命令方块以外运行。 | |||||
JSON文本规范中加入了insertion属性。 | |||||
| 14w02c | 为修复44371,/kill命令现在直接清除非生物实体,不再对其造成3.4×1038虚空伤害。 | ||||
| 14w03a | /tp命令加入了旋转角度参数。
| ||||
目标选择器加入了dx、dy和dz参数。 | |||||
加入了/clone和/fill命令。 | |||||
加入了游戏规则logAdminCommands。 | |||||
| NBT数据现在支持使用字符串ID。 | |||||
| 虽然数字ID仍能在NBT数据中使用,但在其余命令中均不再有效。 | |||||
| 14w04a | 加入了/particle命令。 | ||||
| 14w05a | /gamemode和/defaultgamemode命令加入了spectator参数。 | ||||
| 14w06a | /effect命令加入了hideParticles参数。
| ||||
加入了/trigger命令。 | |||||
| 14w07a | 加入了/execute和/testforblocks命令。
| ||||
/testfor命令现在只要求NBT标签被检测的部分一致。 | |||||
| 14w08a | 使用/execute执行命令的返回值会回传到运行/execute命令的命令方块上。 | ||||
| 14w10a | 加入了游戏规则showDeathMessages。
| ||||
/clone命令加入了force选项。 | |||||
| 14w17a | 加入了/worldborder命令。
| ||||
加入了游戏规则randomTickSpeed。 | |||||
| 14w19a | 加入了/worldborder damage和/worldborder warning命令。 | ||||
| 14w20a | 加入了/title命令。
| ||||
JSON文本规范中加入了selector属性。 | |||||
/clone命令加入了move选项。 | |||||
| 14w26a | 加入了/worldborder add命令。
| ||||
加入了/replaceitem命令。 | |||||
加入了游戏规则sendCommandFeedback。 | |||||
| 14w28a | 加入了/stats命令。 | ||||
| 14w29a | 加入了/worldborder get命令。
| ||||
/particle命令加入了force参数。 | |||||
加入了/time query命令。 | |||||
| 允许设立自定义游戏规则。 | |||||
/stats命令加入了QueryResults。 | |||||
| 14w30a | /summon命令可以召唤闪电。 | ||||
| 14w31a | /debug可在单人游戏中运行。
| ||||
/debug命令加入了chunk参数。 | |||||
| 14w32b | 加入了/entitydata命令。
| ||||
/give现在无法突破堆叠限制。 | |||||
| 1.8.1 | 1.8.1-pre1 | 加入了游戏规则doEntityDrops。
| |||
游戏规则doTileDrops不再影响实体。 | |||||
| 1.9 | 15w37a | 加入了游戏规则spectatorsGenerateChunks。 | |||
| 15w43a | 现在被/gamemode命令或F3 + N切换游戏模式的玩家会在聊天框中得到提示消息。 | ||||
| 15w49a | /playsound命令支持Tab键自动补全。
| ||||
/particle命令加入了player和params参数。 | |||||
| 15w49b | /time query现在支持day作为参数值。 | ||||
| 15w51a | 加入了游戏规则spawnRadius,用于指定重生点半径。 | ||||
| 16w02a | 目标选择器m接受游戏模式的全称及其缩写,如a和adventure,且可以将其反选,如@a[m=!a]。
| ||||
/playsound命令要求source参数,指定声音所属的分类,以归入音量控制。 | |||||
在命令方块中运行/help命令时,会在“上一个输出”中随机显示诙谐的语句。 | |||||
| 16w03a | /achievement命令不再影响统计数据。 | ||||
| 16w07a | 加入了游戏规则disableElytraMovementCheck。 | ||||
| 1.9.3 | pre1 | /tp命令不再将玩家传送至-512<y<512以外的区域。 | |||
| pre2 | 加入了/stopsound命令。 | ||||
| 1.10 | 16w21b | /tp命令的y轴坐标范围扩大至-4096~4096。 | |||
| 1.10-pre1 | 加入了/teleport命令。与/tp效果类似,但传送目标必须指定、无法直接传送到其他玩家身上,且相对坐标基于命令执行者而非传送目标。 | ||||
| 1.11 | 16w32a | /execute、/fill、/setblock和/testforblock命令加入了方块状态支持。 | |||
| 16w32b | /title命令加入了显示文本至快捷栏上方的功能。 | ||||
| 16w38a | 加入了游戏规则doWeatherCycle和maxEntityCramming。
| ||||
移除了隐含目标选择器(如@e[167,28,454])。 | |||||
无效的目标选择器(如@e[Type=creeper]、@e[asdf=nonexistent]和@e[malformed])现在会产生错误,而不再被静默忽略。 | |||||
| 16w39a | 加入了/locate命令。 | ||||
| 1.12 | 17w13a | 加入了/recipe和/advancement命令。
| |||
加入了游戏规则doLimitedCrafting。 | |||||
移除了/achievement命令。 | |||||
| 17w16b | 加入了游戏规则maxCommandChainLength。
| ||||
加入了目标选择器@s,用于选择命令执行者。 | |||||
| 17w18a | 加入了游戏规则announceAdvancements。 | ||||
加入了/reload命令。 | |||||
| 1.12-pre1 | 加入了游戏规则gameLoopFunction。
| ||||
加入了/function命令。 | |||||
| 1.13 | 17w45a | 命令中不同的部分现在由不同颜色标示,而即使不运行命令,错误部分也将会显示为红色。 | |||
| 在大部分情况下命令将不再允许出现大写字母,并运行得比以前更加快速而效率。 | |||||
在目标选择器中加入了了nbt参数。 | |||||
| 修改了部分命令的语法。 | |||||
加入了/tag与/team命令。 | |||||
移除了/enchant、/stats、/testfor、/testforblock、/testforblocks与/toggledownfall命令。 | |||||
重写/execute命令。 | |||||
/gamerule命令不再接受未知值(自定义游戏规则)。 | |||||
/gamerule命令现在会对值进行类型检查。 | |||||
/publish命令现在支持可选参数port。 | |||||
/tp现在是/teleport的缩写。 | |||||
| 17w45b | 加入了/data命令。
| ||||
移除了/entitydata命令。 | |||||
重制了 /execute store命令。 | |||||
| 17w46a | 加入了/datapack命令。
| ||||
| 加入了选项以切换命令自动补全的模式。 | |||||
| 命令界面的UI样式标准更新,并重新在多人游戏中工作。 | |||||
| 17w47a | 移除了/blockdata命令。
| ||||
| 粒子名变更。 | |||||
| 在聊天选项中加入了切换自动命令建议。 | |||||
| 17w48a | 调整了命令补全界面的UI。 | ||||
| 重制了tab键—将补全完整的坐标。 | |||||
| 17w49b | 移除了游戏规则gameLoopFunction,使用函数标签#minecraft:tick取代。 | ||||
| 17w50a | 现在可以在命令里使用局部坐标^。
| ||||
Tab键—在没有指向方块时用~ ~ ~补全。 | |||||
| 18w01a | 加入了/tp的facing语法,这会调整目标实体面向的实体或坐标。
| ||||
为/time set加入了了noon以及midnight选项。 | |||||
| 将所有自定义名称(如方块、物品、生物实体、方块实体)转变为可翻译的文本. | |||||
物品实体的NBT键Thrower和Owner不再是字符串,而以两个长整型组件L和M。 | |||||
雪球、鸡蛋和末影珍珠的NBT键owner不再是字符串,而以两个长整型组件L和M。 | |||||
| 18w02a | 命令中的错误现在有了更好的错误信息(提示中有更多的信息)。 | ||||
对/tp进行了简化,并且现在允许跨维度传送了。 | |||||
加入了 /execute的子命令用于允许对于命令的进一步控制。 | |||||
服务器命令现在将会执行于世界重生点而非固定为坐标0,0,0。 | |||||
| 18w03a | 命令和函数变得更快、效率更高了。 | ||||
| 为分析器加入了命令(/debug)。 | |||||
/data get的标签路径现在可以使用非数字标签。 | |||||
加入了/particle <name> <pos>作为该命令的一个简写。 | |||||
| 18w05a | 加入了/bossbar命令。
| ||||
新的/execute store子命令。 | |||||
| 为命令UI加入了了基本的目标选择器。 | |||||
| 现在为不明确的命令提示。 | |||||
| 18w06a | 重新加入了/enchant命令。
| ||||
| 为实体选择器加入了命令建议。 | |||||
| 实体选择器和方块状态参数现在允许使用空格了。 | |||||
/locate现在接受之前在Temple分组下所有结构的不同名称Desert_Pyramid、Igloo、Jungle_Pyramid和Swamp_Hut。 | |||||
| 18w08a | 为/locate命令输出的坐标加入了可点击的传送链接(将传送命令输入至聊天窗口)。 | ||||
| 18w19a | /seed输出的种子现在可被直接通过点击来复制。 | ||||
| 18w20a | 组队现在可以有一个前缀和后缀。 | ||||
| pre7 | 加入了 /scoreboard objectives modify <记分项> displayname <显示名称>。 | ||||
| pre8 | 加入了 /team modify <队伍> displayName。
| ||||
加入了 /scoreboard objectives modify <记分项> rendertype hearts,使生命值栏目显示为心形,就像这样: | |||||
加入了 /scoreboard objectives modify <记分项> rendertype integer,使生命值栏目显示为黄色的数字。 | |||||
| 队伍名称、记分项名称现在为文本元件,而不是纯字符串。 | |||||
/team option 改为 /team modify。 | |||||
| 1.13.1 | 18w31a | 加入了/chunk命令。 | |||
| pre1 | 将/chunk改名为/forceload。 | ||||
| 2018年9月26日 | 据MIT许可证开源(曾在数据库网站提供了源代码,未指定许可证)。 | ||||
| 1.14 | 18w43a | 加入了/drop和/schedule。
| |||
/replaceitem可在物品展示框上使用。 | |||||
| 18w44a | 删除了/drop 命令中的award 部分。 | ||||
| 18w45a | /drop更名为/loot并重做。 | ||||
| 19w02a | 加入了/teammsg。 | ||||
| 1.16 | 20w06a | 加入了/locatebiome命令。 | |||
| 20w17a | 加入了/attribute命令。 | ||||
| 1.17 | 20w46a | 移除了/replaceitem命令。
| |||
加入了/item命令。 | |||||
| pre1 | 加入了/perf命令。 | ||||
| 携带版Alpha | |||||
| 0.7.4 | 加入了对命令的支持,但尚未实现任何命令的运行。 | ||||
| 0.16.0 | build 1 | 加入了/clearfixedinv、/clone、/deop、/execute、/fill、/gamemode、/give、/help(及其别名/?)、/kill、/list、/op、/say、/setblock、/setfixedinvslot、/setworldspawn、/spawnpoint、/summon、/tell(及其别名/msg和/w)、/testforblock、/testforblocks、/time、/toggledownfall、/tp(及其别名/teleport)、/weather、/wsserver和/xp命令。
| |||
大部分命令的功能与Java版1.10相同。差别在于:不支持数据标签、/clone命令无法使用forced模式、/gamemode命令仅允许指定创造模式和生存模式、/give命令中玩家目标为可选参数,以及/execute命令中实体目标为可选参数。 | |||||
| build 2 | 移除了/clearfixedinv、/setfixedinvslot及其他教育版相关的命令。 | ||||
| build 5 | 加入了/enchant命令。 | ||||
| 携带版 | |||||
| 1.0.0 | 0.17.0.1 | 加入了/locate和/connect命令。 | |||
| 0.17.0.2 | 移除了/locate命令。 | ||||
| 1.0.0.0 | 重新加入了/locate命令。仅能用于查找要塞。 | ||||
| 1.0.3 | 1.0.3.0 | 加入了/transferserver命令。 | |||
| 1.0.5 | 1.0.5.0 | 加入了/clear、/difficulty、/effect、/gamerule、/me、/particle、/playsound、/replaceitem、/spreadplayers、/stopsound、/testfor和/title命令。 | |||
| 1.0.5.3 | 移除了/particle命令。
| ||||
/effect命令的amplifier参数不再允许为负值。 | |||||
| 1.1.0 | 1.1.0.0 | /replaceitem支持canplaceon和candestroy。
| |||
/locate可查找其他结构。 | |||||
加入了游戏规则dodaylightcycle、doentitydrops、dofiretick、domobspawning、domobloot、dotiledrops、doweathercycle、keepinventory和mobgriefing。 | |||||
| ? | 加入了/setmaxplayers。 | ||||
| 基岩版 | |||||
| 1.2.0 | 1.2.0.2 | 加入了/tickingarea。 | |||
| 1.4.0 | ? | 将/transferserver移动到开发者命令,玩家不再能够正常使用。 | |||
| 1.5.0 | 1.5.0.0 | 为启用教育版功能的世界加入了5个新命令。 | |||
| 1.6.0 | 1.6.0.6 | 为/gamerule加入了游戏规则doInsomnia。 | |||
| 1.7.0 | 1.7.0.2 | 加入了/scoreboard。 | |||
加入了了游戏规则commandblocksenabled。 | |||||
| 1.8.0 | 1.8.0.8 | 重新加入了/particle。 | |||
加入了randomTickSpeed游戏规则。 | |||||
加入了/reload。 | |||||
加入了/function。 | |||||
| 1.9.0 | 1.9.0.0 | 加入了/tellraw。
| |||
加入了showdeathmessages游戏规则。 | |||||
加入了immediaterespawn游戏规则。 | |||||
为/particle加入了新粒子。 | |||||
| 1.11.0 | 1.11.0.1 | 加入了/resupply,但并没有作用。 | |||
| 1.11.0.3 | 加入了/mobevent。 | ||||
| 1.12.0 | 1.12.0.2 | 加入了spawnradius游戏规则。
| |||
/clear的数据值功能失效。 | |||||
加入了sendcommandblockfeedback游戏规则。 | |||||
为/particle加入了更多的新粒子。 | |||||
| 为地图制作及Add-ons加入了新命令。 | |||||
| ? | 移除了/resupply。 | ||||
| 1.14.0 | 1.14.0.3 | /clear的数据值功能被修复。 | |||
| 1.16.0 | 1.16.0.57 | 加入了/kick命令。 | |||
| 正式版 | 加入了/whitelist命令。 | ||||
| 1.16.100 | 1.16.100.52 | 加入了/playanimation、/ride和/structure命令。 | |||
| 1.16.100.54 | 加入了/fog命令。 | ||||
| 1.16.100.57 | 加入了/camerashake、/clearspawnpoint和/event命令。 | ||||
| 1.16.100.58 | 加入了/music命令。 | ||||
| 1.16.100.59 | 加入了/schedule命令。 | ||||
| 1.16.210 | 1.16.210.53 | 移除了/mixer命令。 | |||
| 1.16.210.54 | 重新加入了/mixer命令。 | ||||
| 1.16.210.58 | 再次移除了/mixer命令。 | ||||
| 1.16.210.60 | 加入了/gametest命令。 | ||||
| 1.17.0 | 1.16.230.50 | 将/whitelist重命名为/allowlist。 | |||
| 1.17.10 | 1.17.10.22 | 加入了/dialogue命令。 | |||
漏洞
Template:Issue list
参见
| 版本 | |||||||
|---|---|---|---|---|---|---|---|
| 开发周期 |
| ||||||
| 技术 |
| ||||||
| 多人游戏 | |||||||
| 游戏订制 | |||||||
| 版本 |
| ||||||
|---|---|---|---|---|---|---|---|
| 开发 |
| ||||||
| 技术性 | |||||||
| 多人游戏 | |||||||
| 特色功能 | |||||||