警告:根据CC BY-NC-SA 3.0协议,所有从wiki搬运的资料都必须写上来源出处(中文Minecraft Wiki),否则将被视为侵权行为!详细阅读
致繁体用户:本wiki现已更新简繁更换系统,各位用户可以通过简繁切换来查看正确的繁体译名

命令

来自Minecraft Wiki
跳转至: 导航搜索

命令(commands)是藉由输入特定文本字符串而激活的进阶功能。

使用方法[编辑]

请注意,本条目所述皆为官方原版游戏中的指令。列表外的指令均非原版指令。


一般的客户中,命令由 Minecraft聊天视窗中输入,藉由按下 T 键(预设) 或 / 键叫出聊天视窗。使用 / 键也会同时输入命令必备的前缀斜线,因此这是个实用的快捷键。在输入命令时按下 Tab ↹ 键会循环可用的命令或参数。

命令也可以在多人服务器的控制台输入,但是不需要加入前缀的 / 。命令方块中的命令可以加入前缀 / ,但是非必要。命令方块中的命令可能还会要求可选择的参数,通常是玩家的名字。

大多数命令只能在以下状况有效:

有些#命令在不允许作弊的生存模式中仍然可用

注意:在单人游戏中,如果不允许作弊,仍可以藉由公开目前的游戏至局域网 ( Esc → "公开至局域网" ,点选 "允许作弊" ,接着 "公开至局域网" ) 而暂时可以作弊。你不必真的在局域网上或让别人加入。这并不是永久的,但它可以允许命令的使用直到你离开该世界,你使用命令所改变的东西都会被存档 (items spawned 等命令) 。你可以在再次开启游戏时重复以上步骤。注意当公开至局域网时游戏便无法暂停,所以在打开游戏目录时最好找个安全的地方。你可以重新载入世界来取消公开至局域网。

如果在命令方块中执行测试类命令(例如/testfor),命令方块会将测试结果以红石信号形式输出到相连的红石比较器中。

波浪号[编辑]

很多命令可以使用波浪号(~)来指定相对座标。在波浪号后方的数字是个 偏移量 而不是一个座标。偏移符号可以指定要往轴的正或负方向移动。一个单一的波浪号可以简写为 ~0

举例来说, tp 0 64 0 将会移动使用者到座标 (0, 64, 0),而 tp ~3 ~ ~-3 会使使用者往 x 轴正向移动3格 (也就是东方),保持原本高度,并在 z 轴移动-3格 (也就是北方)。

通常绝对座标和相对座标可以溷合使用。举例来说, tp ~ 64 ~ 会保持使用者的 x 轴和 z 轴座标,但是传送使用者到绝对高度64。

偏移量的基准点由命令本身决定。举例来说, /tp 的偏移是从起始位置来算。其他常见的偏移量包括命令的执行位置或者从另一个坐标由该命令指定。

目标选择器[编辑]

:本段文字中,variable 翻译为变数,argument 翻译为参数,而value 代表数值。有些指令因为易读性的关系,并不会把它翻译出来。

大多数玩家被指定为参数的命令,可以藉由满足某些条件来选择一个或多个玩家,而不是用名字来指定玩家。要用条件来选择玩家,先选择一个目标选择器变数,然后随意地,选择一个或多个目标选择器参数以修改欲满足的条件。

举例来说,要改变红色组别所有玩家的游戏模式为创造模式,而不藉由个别玩家名字指定他们:

/gamemode creative @a[team=Red]


目标选择器变数[编辑]

摘要
变数 功能
@p 距离最近的玩家
@r 随机玩家
@a 所有玩家
@e 所有实体

目标选择器变数可以指定选择该目标大类。共有四种变数:

@p
选择最近的玩家。如果有多个最近的玩家,他们与自己距离完全相同,那么会选择其中最常进入服务器的玩家。
目标选择器参数可以用来减少会被选择到的玩家群组。举例来说,@p[team=Red] 会选择在红色组别中距离最近的玩家,即使有其他玩家更靠近自己。
c 目标选择器参数可以用来增加被选择的玩家的数量。( 举例来说,@p[c=3] 会选择最近的三名玩家)。若是负值,c 会反转指定的目标 (举例来说,@p[c=-1] 会选择 最远的 玩家)。
@r
选择随机玩家 (或使用 type 目标选择器参数来包含实体)。
目标选择器参数可以用来减少会被随机选择到的玩家群组。举例来说,@r[team=Red] 会选择在红色组别中的随机玩家。
c 目标选择器参数可以用来增加被随机选择的玩家的数量。举例来说,@r[c=3] 会选择随机三名玩家。
如果没有使用 type 参数,@r 只会选择随机玩家。type 参数可以用来选择非玩家的实体 (举例来说,@r[type=Zombie] 会随机选择殭尸@r[type=!Player] 会随机选择非玩家实体,@r[type=!Zombie] 会选择非殭尸实体...等)。
@a
选择所有玩家。
目标选择器参数可以用来减少会被选择到的玩家群组。举例来说,@a[team=Red] 只会选择在红色组别中的玩家。
@e
选择所有实体 (包含玩家)。
目标选择器参数可以用来减少会被选择到的实体群组。举例来说,@e[type=Cow] 只会选择牛。


目标选择器参数[编辑]

摘要
参数 选择标准
x, y, z 座标
r, rm 半径 (最大,最小)
m 游戏模式
c 数量
l, lm 经验等级 (最大,最小)
score_name 最高分数
score_name_min 最低分数
team 队伍名称
name 玩家名称
dx, dy, dz 体积尺寸
rx, rxm 垂直旋转 (最大,最小)
ry, rym 水平旋转 (最大,最小)
type 实体种类

在使用目标选择器之后,你可以随意地使用参数来修改所要选择的群组。当使用 @a@e 时,参数缩小所选的数量,从所有名单到特定的少数。当使用 @p@r 时,参数缩小所选的数量,从所有名单变成更小的群组来选择最近或随机的玩家。

在目标选择器变数之后增加参数 - 数值对做为以逗号分隔的列表,包含在中括号中:

@<variable>[<argument>=<value>,<argument>=<value>,…]

括号、等号和逗号旁不能有空白键,只有逗号可以用来分隔参数 - 数值对。

参数会区分大小写,不支持的参数会直接被忽略掉。举例来说,kill @e[type=Creeper,r=20] 会杀死20方圆格以内的所有爬行者,但是 kill @e[Type=Creeper,r=20] ('type' 变成大写) 会杀死20方圆格以内的 所有 实体 (包括玩家) ,因为参数不再有选择爬行者的限制。

如果最前面的四个参数值被简化为只有数值而没有参数,他们会被假定为,按照顺序的 x, y, z, 和 r。因此,下列两个指令是相同的:

/gamemode creative @a[x=10,y=20,z=30,r=4]
/gamemode creative @a[10,20,30,4]
通过坐标选择目标
[x=X,y=Y,z=Z] — 选择基于此准确位置一定距离的目标。结合选择半径以选择在特定位置的唯一目标。
坐标必须准确的符号 - #波浪号 不可以用于此参数座标选择器。
通过半径选择目标
[r=R] — 只选择以命令的执行处为中心,半径小于R的区块里的目标。
[rm=RM] — 只选择以命令的执行处为中心,半径大于RM的区块里的目标。
如果座标(参见上一段)和半径都已被定义,命令会以定义的座标为中心执行命令。如果使用极远的座标为中心以及极大的半径,如此可以模拟出一个近于线性的边缘,用以指定目标。
通过游戏模式选择目标
[m=M] — 只选择目标与指定的游戏模式M 允许值为:
  • -1: 所有的游戏模式
  • 0: 生存模式
  • 1: 创造模式
  • 2: 冒险模式
  • 3: 旁观者模式
通过数量选择目标
[c=C] — 只选择指定数量的目标。通常按与命令执行者的距离排序。
当使用 @p@r 两种变数时,此参数被预设为1,因此更大的数值会增加回传的最近或随机的目标。当使用 @a@e 两种变数时,此参数只会回传最近的目标。
如果有多名距离最近的玩家,距离完全相同,那么玩家会藉由玩家最近一次加入服务器的时间来选择。举例来说,如果距离完全相同@a[c=1] 会选择进入服务器时间最久的玩家而 @e[type=Creeper,c=3] 会选择生成最久的三只爬行者。
当输入的值为负值时,目标的顺序会被反转。举例来说,@p[c=-3] 会回传三个最远的目标,而且,如果所有目标距离都一样远,@e[c=-3] 会选择三个刚生成的目标。
通过经验等级选择目标
[l=L] — 只选择不超过 L 经验等级的目标。
[lm=LM] – 只选择不低于 LM 经验等级的目标。
通过分数选择目标
[score_name=SCORE] — 只选择目标计分板 name 的分数的没有超过 SCORE 的目标。
[score_name_min=SCOREMIN] — 只选择目标计分板 name 的分数的不低于 SCOREMIN 的目标。
例如,@a[score_points_min=30,score_points=39] 将选择目标计分板 points 的分数的不低于 30 ,且不高于 39 的目标。
另见:记分板#对象
通过队伍选择目标
[team=TEAM] — 只选择队伍 TEAM 的目标。
[team=!TEAM] — 只选择不是队伍 TEAM 的目标。
[team=] — 只选择不在任何队伍的目标。
另见:记分板#队伍
通过名字选择目标
[name=NAME] — 只选择名字为 NAME 的目标。
[name=!NAME] — 只选择名字不是 NAME 的目标。
通过体积选择目标
[dx=DX,dy=DY,dz=DZ]
只选择位于一定体积内部的目标,体积定义为从执行命令的地方开始,向正 "x" 方向 (也就是东方) 延伸 DX 格,向正 "y" 方向 (也就是上方) 延伸 DY 格,并向正 "z" 方向 (也就是南方) 延伸 DZ 格。所有的值都必须为正值。如果最初的座标已经使用 xyz 参数定义,则它会取代命令的执行位置成为最下方、最北方及最西方的角落。 (dxdydz 仍然用来指定与座标的距离;它们不是指定一个新的座标)。
玩家可以结合通过半径和通过体积选择目标,此命令将会选择重叠的区块。 (从西北下角算起在一定的半径以内,且不超过定义的体积)。
通过垂直旋转选择目标
[rx=RX] — 只选择最大不超过垂直旋转值 RX 的唯一目标。
[rxm=RXM] — 只选择最小不低于垂直旋转值 RXM 的唯一目标。
垂直旋转值从 -90.0 面对正上方到 90.0 面对正下方 (因此垂直旋转值增加时会旋转向下)。
通过水平旋转选择目标
[ry=RY] — 只选择与最大不超过水平旋转值 RY 的唯一目标。
[rym=RYM] — 只选择与最小不低于水平旋转值 RYM 的唯一目标。
水平旋转值从 -180.0 (面对正北方),到 -90.0 (面对正东方),到 0.0 (面对正南方),到179.9 (正北方偏西) ,旋转回 -180.0 (因此水平旋转值增加时会向右旋转,或者从上方看来是顺时针方向旋转)。
通过类型选择目标
[type=TYPE] — 只选择特定的实体类型的目标。
[type=!TYPE] — 只选择不是特定的实体类型的目标。
TYPE 必须是个用来内部判定不同种类实体的实体ID (举例来说,Creeper 指定爬行者MinecartRideable 指定一般的矿车PrimedTnt 指定TNT等等)。实体ID 必须区别大小写,且无效的实体ID 会造成命令失败。
当与 @r 一起使用时,原本用来选择玩家的指令也可以被用来选择其它实体。


数据标签[编辑]

数据标签是一段文字序列,使用属性/值对描述资料结构。使用在命令的数据标签指定了较复杂的玩家、实体和一些方块的数据。

数据标签由零个以上、用逗号分隔的的属性/值对组成,且用大括号界定。每个属性/值对包含属性名称和属性值,用冒号分开。但是,有些属性值可能本身就包含了属性/值对,因此数据标签可以用来描述层次结构。

例: {name1:123,name2:"sometext",name3:{subname1:456,subname2:789}}

这些数据标签所描述的资料结构和 Minecraft 世界存档中的资料结构是一样的。这些资料结构在另一篇有详细描述,而命令会要求数据标签要使用一样的属性名字 (区分大小写):

资料结构规范连结
对象 举例
方块 箱子、熔炉、命令方块、刷怪蛋、告示牌...等等
物品 在物品栏中的物品 (包括附魔、自订名称...等等)
物品实体 在地上的物品
生物 爬行者、牛、村民...等等
弹射物 弓箭、火球、喷溅药水...等等
交通工具 船、矿车...等等
Dynamic tiles 引燃的 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
可以有浮点数的数字 (举例来说:3.14159)

 String
一串文字,可以自由选择是否要加上双引号。

如果字符串包含逗号、中括号、大括号,一定 要加上双引号。如果字符串里面 要包含双引号,需在双引号前加上反斜线。

例: "Call me \"Ishmael\""

 List
值的序列,用逗号分离并用中括号包含。不必每个值都用同一种类型 -- 所需的类型由数据结构指定。.
例: [3.2,64,129.5]

 Byte Array
从 -128 到 127 的整数的序列,用逗号分离并用中括号包含。

 Int Array
从 -2147483648 到 2147483647 的整数的序列,用逗号分离并用中括号包含。

 Compound
属性值对的序列,用逗号分离并用大括号包含。
Example: {X:3,Y:64,Z:129}

每个数据标签的内容本身就是一种 Compound。

有些命令可能会要求那个数字的类型,以在数字后面加上一个字母来表示。举例来说, 3i 表示整数,3.2f 表示浮点数...等等

如果用 /testfor/testforblock/clear 等指令来寻找相符的数据标签,它们只会检查那些实体/方块/物品是否存在此标签。这表示当找到符合的实体/方块/物品时,它们可能同时还有其他标签。这在 lists (表单) 和 arrays (序列) 也适用:表单的顺序未被确认,只要每个要求的元素都在表单里面,那么即使有额外的元素存在,它也会符合条件。

数据结构的形式是 JSON 的一种形式 lenient

原始 JSON 文本[编辑]

/tellraw/title 指令使用特殊的lenient JSON 格式来表示更复杂的文字。和上述 NBT 格式表示法相似,Strings (字串)、Objects (Compounds)(物件,指复合体)、Lists (表单) 被用来表示原始文本的不同性质。

JSON 文本的形式是支援以下 (大多是可选择的) 元素的 JSON 物件:


  • 基础聊天组成物件

    •  text: String (字串) 代表在聊天中直接出现的纯文字。注意像是"@a" 和 "@p" 的选择器并不会转译成玩家名字;必须使用 selector 代替。"\n" 是新的一行 (enter 键)。

    •  extra: 外加物件的表单,使用和基础物件相同的格式。

      • 为使用和基础物件相同格式的表单元素 (递迴的)。注意所有物件的性质都会被子物件所继承,除了 textextratranslatewithscore。这表示子物件会保留和这个物件一样的格式和情况,除非子物件明确的覆盖原物件。

    •  color: 用来渲染文字的颜色。有效值有:"black" 、 "dark_blue" 、 "dark_green" 、 "dark_aqua" (碧绿)、 "dark_red" 、 "dark_purple" 、 "gold" 、 "gray" 、 "dark_gray" 、 "blue" 、 "green" 、 "aqua" 、 "red" 、 "light_purple" 、 "yellow" 、 "white" 和 "reset" (取消母对象使用的颜色效果)。技术上来说,"bold" (粗体)、 "underline" (底线)、 "italic" (斜体)、 "strikethrough" (删除线) 和 "obfuscated" (模煳处理) 都是可接受的,不过最好还是使用下方提到的标籤格式。

    •  bold: 布尔 (true/false) - 是否将文字渲染为粗体,预设为 false。

    •  underlined: 布尔 (true/false) - 是否将文字渲染为加底线,预设为 false。

    •  italic: 布尔 (true/false) - 是否将文字渲染为斜体,预设为 false。

    •  strikethrough: 布尔 (true/false) - 是否将文字渲染为加上删除线,预设为 false。

    •  obfuscated: 布尔 (true/false) - 是否将文字渲染为模煳处理,预设为 false。

    •  insertion: 当玩家按着 shift 并点击时,这个字串就会插入至聊天文字栏。它不会覆盖原有的正在输入的文字。

    •  clickEvent: 当玩家在文字上点击时发生动作。

      •  action: 当点击时所引发的动作。有效值为 "open_url" (在玩家的预设浏览器中打开值为 value 的 URL 位址),"run_command" (在聊天栏输入 value ,就好像是玩家自己输入的一样。这可以用来执行命令,但是如果玩家没有所需的权限,命令会失败。), "change_page" (只能用在成书,翻至第 value 页如果该页存在),和 "suggest_command" (和 "run_command" 相似,但是命令文字只会出现在玩家的聊天输入栏,并不会自动执行。不像 insertion ,这会直接取代原先就存在于聊天输入栏中的内容)。

      •  value: 特定的 action 会使用到的 URL 位址、聊天内容或命令。注意,命令之前一定要加上 "/" 斜线。

    •  hoverEvent: 允许当玩家滑鼠在文字之上时显示提示。

      •  action: 提示所显示的种类。有效值为 "show_text" (显示纯 JSON 文本), "show_item" (显示可能带有 NBT 标籤的物品的提示工具), "show_achievement" (显示用来描述成就或数据的标准格式。一般的成就是绿色的,最终的成就是深紫色的,数据名称是灰色的。除此之外,还有成就的描述),和 "show_entity" (显示实体的名字,或可能是它的种类、和它的通用唯一识别码)。

      •  value: 这个标籤的格式取决于 action (动作)。注意, "show_text" 是唯一支援物体当作值的动作;其他动作的值都是字串,所以必须用引号包含。
        • "show_text": 可以是纯字串,或是和这个基础物体的格式一样的物体。注意,clickEventhoverEvent 在提示工具中不会有效果,但是它的格式和 extra 标籤仍然有作用。
        • "show_item": 像 NBT 标籤的格式化的字串。包含 "id" 标籤,和可选的 "Damage" 标籤和 "tag" 标籤 (和give指令所用的數據值和數據標籤一樣).
        • "show_achievement": The achievement or statistic's name. This uses the same format as achievement and statistic Scoreboard objective criteria and the /achievement command.
        • "show_entity": A string formatted like a compound with the string values "type" (such as "Zombie"), "name", and "id" (should be an entity UUID, but can actually be any string).

    •  translate: The translation identifier of text to be displayed using the player's selected language. This identifier is the same as the identifiers found in lang files from assets or resource packs. The translated text will only be displayed if the text string is not used.

    •  with: A list of chat component arguments and/or string arguments to be used by translate.
      • The arguments are text corresponding to the arguments used by the translation string in the current language, in order (for example, the first list element corresponds to "%1$s" in a translation string).

    •  score: A compound for displaying a player's score in an objective. Displays nothing if the player is not tracked in the given objective. Ignored completely if text or translate is present.

      •  name: The name of the player whose score should be displayed. Selectors (such as @p) can be used, in addition to "fake" player names created by the scoreboard system. In addition, if the name is "*", it will show the player's own score (for example, /tellraw @a {score:{name:"*",objective:"obj"}} will show every online player their own score in the "obj" objective). Note that non-player entity scores (such as @e[type=Cow]) do not show, even if the entity has been given a score in the objective.

      •  objective: The internal name of the objective to display the player's score in.

      •  value: Optional. If present, this value is used regardless of what the score would have been.

    •  selector: A string containing a selector (@p,@a,@r, or @e) and, optionally, selector arguments. Unlike text, the selector will be translated into the correct player/entity names. If more than one player/entity is detected by the selector, it will be displayed in a form such as 'Name1 and Name2' or 'Name1, Name2, Name3, and Name4'. Ignored completely if text, translate, or score is present.
外部连结
Skylinerw's JSON Formatting Examples
Tellraw Generator

玩家命令[编辑]

这些命令可由联入服务器的任何玩家在聊天输入框里直接输入。

命令 描述
help [页码 | 命令名]
? [页码 | 命令名]
列出可以使用的命令或有关命令名更多的信息。
tell <玩家名称> <信息>
msg<玩家名称> <信息>
w <玩家名称> <信息>
用来发送给服务器里的玩家一条私信。 在需要和玩家交流时非常有用。
me <动作信息> 和 /emote 或 /action相似,而且其作用和IRC客户端里的 /me 命令一样, /me命令会以叙述的方式显示出这个玩家在做什么,具体显示为"* 你的名字 动作信息" (比如: "* 你的名字 打了个喷嚏。")。
trigger <目标> <add | set> <数值> 修改带有Trigger准则的目标(被称为触发器),此命令可以被非管理员玩家使用。见版本记录

只有管理员可用的命令[编辑]

这些命令只有管理员(Operator)通过服务器或客户端使用。客户端使用时需要加“/”前缀。例如输入的应该是“/help”而非只是“help”。必需的参数由<尖括号>标出;可选的参数由[方括号]标出。用斜体标注的参数必须用一个适当的数值代替;用普通字体的参数直接照搬即可。

在单人生存模式中,开启作弊功能且对局域网开放单人世界的服主也可以使用下列命令。

注意: 在多人模式下,普通玩家通常看不见OP指令的输入,但是对于其他的在线OP却是可见的。

命令 描述
achievement give <数据名> [玩家名] 用于赐予玩家成就
blockdata <x> <y> <z> <数据标签> 用于编辑指定坐标的数据标签
clear <玩家名> [物品] [数据] 清空该玩家的物品栏,或只清除特定的物品。
clone <x1> <y1> <z1> <x2> <y2> <z2> <X> <Y> <Z> [主模式] [子模式] 复制指定区域的方块,目的坐标是(X,Y,Z),主模式有 [ replace ]复制每一个方块、[ masked ]只会复制非空气方块、[ filtered ]过滤不想被影响的方块。

子模式有 [ move | force | normal ]。

debug <start | stop> 开始一次新的除错进程或是停止当前进程。除错进程会监控任何控制台内的潜在信息并在停止之后将信息记录在debug文件夹内。
defaultgamemode <survival | creative | adventure | spectator> 设置默认的游戏模式。新加入的玩家将被设置为该模式。生存/创造/冒险/旁观也可以简写为“s/c/a/sp”或“0/1/2/3”。
difficulty <0 | 1 | 2 | 3> 改变游戏难度。0为和平,1为容易,2为普通,3为困难,
effect <玩家名> <药水效果> [秒数] [倍率] 给予目标玩家持续指定时间的指定药水效果(默认30秒,最长可设置1000000秒)。“倍率”代表效果强度(最大为255),0为取消该效果。药水效果用ID表示,详见药水效果
effect <玩家名> clear 清除该玩家身上的所有效果。
enchant <玩家名> <魔咒ID> [魔咒等级] 附魔玩家持有的物品。请注意用该命令附魔的魔咒无法超越正常附魔步骤的限制,例如最大等级、魔咒冲突、魔咒限制等,详见附魔
entitydata <实体名> <数据标签> 用于编辑指定实体的数据标签,对玩家无效
execute <玩家名 | 实体名> <x> <y> <z> <命令> 以目标玩家或实体为中心执行命令,可以用来通过玩家及实体的运动生成生物或放置方块。
fill <x1> <y1> <z1> <x2> <y2> <z2> <方块名> [数据值] [旧方块处理方式]<数据标签> 用指定方块填满指定区域。旧方块处理方式可为:[ replace | destroy | keep | hollow | outline ]。能指定要处理的旧方块种类,前提是不包含方块实体值,仅能在replace模式中使用,语法:/fill [x] [y] [z] [x] [y] [z] [方块名] [数据] replace [过滤方块名] [过滤数据]
gamemode <survival | creative | adventure | spectator> [玩家名] 改变该玩家的游戏模式。生存/创造/冒险/旁观也可以简写为“s/c/a/sp”或“0/1/2/3”。如果未定义玩家名,那么该命令会更改你自己的游戏模式。注意: 要成功改变游戏模式,该玩家必须在线。
gamerule <规则名> [true | false] 激活或取消规则名。规则包括:doFireTick, doMobLoot, doMobSpawning, doTileDrops, keepInventory, mobGriefing and commandBlockOutput(详见命令方块条目)
give <玩家名> <数据值> [数量] [附加数据值] 给予玩家的物品栏一定'数量(默认为1)的物品(由数据值方块实体值(默认为0)定义)。
kill [玩家名] 对指定的玩家造成1000 (Heart.svg × 500)点伤害(一击必杀),未指定则为使用该命令的玩家。 当你迷路或者被卡住的时候很有用。如果你有把握找回身上的物品,那么这也是个快速补满饥饿值的好方法。这个命令在创造模式下依然有效。
partcles <颗粒> <x> <y> <z> <x偏移量> <y偏移量> <z偏移量> <速度> [颗粒数] 显示颗粒效果。
playsound <音乐/声效> <玩家名> [x] [y] [z] [音量] [频率] [最小音量] 播放声效。
publish 将单人游戏向局域网玩家开放。
replaceitem <entity | block> 给予实体或方块物品。
say <信息> 广播 信息 至所有在线的玩家。(使用明亮的粉红色字体)
scoreboard <objective | players> 详细信息请参见计分板条目。
seed 显示服务器地图种子。
setblock <x> <y> <z> <方块名> [数据值] [旧方块处理方式] [数据标签] 用于创造,删除,或代替单个方块。旧方块处理方式可为:[ keep | replace | destroy ]
setworldspawn [x] [y] [z] 设置所有玩家的出生点(即使是从未进入服务器的玩家或是不在线的玩家,但不会覆盖床的设置)。
spawnpoint <玩家名> [x] [y] [z] 将该玩家的出生点移到指定位置。如果该位置没有定义,那么“指定位置”就是玩家当前位置。
spreadplayers <x> <z> <分布距离> <最大半径> <是否采用队伍> <玩家名> 把玩家分布到一个起始点.能够定义分散范围与最小间距。
summon <实体名> [x] [y] [z] [数据标签] 用于在游戏中生成任何实体,包括巨人,末影水晶,末影龙,和激活的TNT。
tellraw <玩家名> <原json消息> 运用json语言来在聊天窗口中显示高级文本(如创造出"按钮"和格式化文本)。
testfor <玩家名> 测试指定的玩家是否在线或指定玩家是否在指定位置,在1.7.6之前只可以由命令方块使用。
testforblock <x> <y> <z> <方块名> [数据值] [数据标签] 检测在指定位置的方块否与指定的方块相同。
testforblocks <x1> <y1> <z1> <x2> <y2> <z2> [模式] 检测在指定区域的方块是否与另一区域的方块相同。
time set <时间 | day | night> 设置世界时间。时间为0到24000之间的整数,0为凌晨,6000为正午,12000为傍晚,18000为午夜。"time set day"相当于把时间设为1000(旧版为0),"time set night"相当于把时间设为12500(旧版为12000)。
time add <时间> 将世界时间往后拨一段时间。时间必须为自然数。
toggledownfall 更改天气为下雨或下雪。
tp <目标玩家> 将玩家自己传送至目标玩家的位置。
tp <玩家名> <目标玩家> 将指定玩家传送至目标玩家的位置。
tp <玩家名> <x> <y> <z> 将指定玩家传送到指定位置。如果坐标号前加~,则代表相对坐标。例如/tp John ~3 64 ~3会将ID为John的玩家传送到他目前的x、z坐标各加3的位置,再将高度调到64。
weather <clear | rain | thunder> <持续秒数> 改变天气。持续秒数最大为1000000。
xp <数量> <玩家名> 给予该玩家指定数量的经验。最大数量为2,147,483,647。负数代表减少经验。数量后加L代表增加指定的等级。

只有多人生存模式可用的命令[编辑]

命令 描述
ban <玩家名称> 封禁拥有玩家名称名称的玩家,列入黑名单,令其永远无法登进此服务器。 注意:封禁操作会覆盖之前的白名单操作。
ban-ip <ip 地址> 封禁一个特定的IP,列入黑名单,并从此拒绝任何从该地址而来的连接请求。
banlist [ips] 显示封禁名单。若要列出封禁的IP,请使用banlist ips指令。
deop <玩家名称> 撤销一个玩家的管理员身份。
kick <玩家名称> 强制断开玩家名称与服务器的连接。
list 显示当前在线的玩家列表。(按Tab ↹也会有同样的效果)。
op <玩家名称> 授予 玩家名称 在服务器里的管理员职位。
pardon <玩家名称> 玩家名称 移出黑名单,允许他再次连接到服务器。
pardon-ip <ip地址> ip地址 从IP黑名单移除,允许该IP连接到服务器。
save-all 强制将服务器尚未储存地变更写入存档。
save-off 取消服务器对地图存档的写入。所有的更改都会暂时进入等待队列。
save-on 允许服务器写入地图存档。这项是默认设定。
setidletimeout <闲置时限(分钟)> 会自动将挂机过久的玩家踢下线。
stop 正常关闭服务器。
whitelist <add|remove> <玩家名称> 玩家名称加进或移出白名单。
whitelist <list> 显示所有在白名单上的玩家。
whitelist <on|off> 启用/停用服务器的白名单机制。 注意: 服务器的OP总是能够在白名单打开时进入服务器,无论他们在与不在白名单上。
whitelist reload 重新从硬盘读取white-list.txt上的白名单。(当white-list.txt在Minecraft外被更改时可以使用此指令)。

Summary of commands[编辑]

The table below summarizes available commands. Click a column heading to sort by that column.

Summary of Commands
Command Description Op Only MP Only Blocks Entities Players World
/achievement Gives a player an achievement. Op 无效输入 无效输入 无效输入 Players 无效输入
/ban Adds player to banlist. Op MP 无效输入 无效输入 Players 无效输入
/ban-ip Adds IP address to banlist. Op MP 无效输入 无效输入 Players 无效输入
/banlist Displays banlist. Op MP 无效输入 无效输入 Players 无效输入
/blockdata Modifies the data tag of a block. Op 无效输入 Blocks 无效输入 无效输入 无效输入
/clear Clears items from player inventory. Op 无效输入 无效输入 无效输入 Players 无效输入
/clone Copies blocks from one place to another. Op 无效输入 Blocks 无效输入 无效输入 无效输入
/debug Starts or stops a debugging session. Op 无效输入 无效输入 无效输入 无效输入 无效输入
/defaultgamemode Sets the default game mode. Op 无效输入 无效输入 无效输入 无效输入 World
/deop Revoke operator status from a player. Op MP 无效输入 无效输入 Players 无效输入
/difficulty Sets the difficulty level. Op 无效输入 无效输入 无效输入 Players 无效输入
/effect Add or remove status effects. Op 无效输入 无效输入 Entities Players 无效输入
/enchant Enchants a player item. Op 无效输入 无效输入 无效输入 Players 无效输入
/entitydata Modifies the data tag of an entity. Op 无效输入 无效输入 Entities 无效输入 无效输入
/execute Executes another command. Op 无效输入 无效输入 无效输入 无效输入 无效输入
/fill Fills a region with a specific block. Op 无效输入 Blocks 无效输入 无效输入 无效输入
/gamemode Sets a player's game mode. Op 无效输入 无效输入 无效输入 Players 无效输入
/gamerule Sets or queries a game rule value. Op 无效输入 无效输入 无效输入 无效输入 World
/give Gives an item to a player. Op 无效输入 无效输入 无效输入 Players 无效输入
/help Provides help for commands. 无效输入 无效输入 无效输入 无效输入 无效输入 无效输入
/kick Kicks a player off a server. Op MP 无效输入 无效输入 Players 无效输入
/kill Kills entities (players, mobs, items, etc.). Op 无效输入 无效输入 Entities Players 无效输入
/list Lists players on the server. Op MP 无效输入 无效输入 Players 无效输入
/me Displays a message about yourself. 无效输入 无效输入 无效输入 无效输入 Players 无效输入
/op Grants operator status to a player. Op MP 无效输入 无效输入 Players 无效输入
/pardon Removes entries from the banlist. Op MP 无效输入 无效输入 Players 无效输入
/particle Creates particles. Op 无效输入 无效输入 无效输入 Players 无效输入
/playsound Plays a sound. Op 无效输入 无效输入 无效输入 Players 无效输入
/publish Opens single-player world to local network. Op 无效输入 无效输入 无效输入 无效输入 World
/replaceitem Replaces items in inventories. Op 无效输入 Blocks Entities Players 无效输入
/save-all Saves the server to disk. Op MP 无效输入 无效输入 无效输入 World
/save-off Disables automatic server saves. Op MP 无效输入 无效输入 无效输入 World
/save-on Enables automatic server saves. Op MP 无效输入 无效输入 无效输入 World
/say Displays a message to multiple players. 无效输入 无效输入 无效输入 无效输入 Players 无效输入
/scoreboard Manages objectives, players, and teams. Op 无效输入 无效输入 Entities Players 无效输入
/seed Displays the world seed. Op 无效输入 无效输入 无效输入 无效输入 World
/setblock Changes a block to another block. Op 无效输入 Blocks 无效输入 无效输入 无效输入
/setidletimeout Sets the time before idle players are kicked. Op MP 无效输入 无效输入 Players 无效输入
/setworldspawn Sets the world spawn. Op 无效输入 无效输入 无效输入 无效输入 World
/spawnpoint Sets the spawn point for a player. Op 无效输入 无效输入 无效输入 Players 无效输入
/spreadplayers Teleports entities to random locations. Op 无效输入 无效输入 Entities Players 无效输入
/stats Update objectives from command results. Op 无效输入 Blocks Entities Players 无效输入
/stop Stops a server. Op MP 无效输入 无效输入 无效输入 World
/summon Summons an entity. Op 无效输入 无效输入 Entities 无效输入 无效输入
/tell Displays a private message to other players. 无效输入 无效输入 无效输入 无效输入 Players 无效输入
/tellraw Displays a JSON message to players. Op 无效输入 无效输入 无效输入 Players 无效输入
/testfor Counts entities matching specified conditions. Op 无效输入 无效输入 Entities Players 无效输入
/testforblock Tests whether a block is in a location. Op 无效输入 Blocks 无效输入 无效输入 无效输入
/testforblocks Tests whether the blocks in two regions match. Op 无效输入 Blocks 无效输入 无效输入 无效输入
/time Changes or queries the world's game time. Op 无效输入 无效输入 无效输入 无效输入 World
/title Manages screen titles. Op 无效输入 无效输入 无效输入 Players 无效输入
/toggledownfall Toggles the weather. Op 无效输入 无效输入 无效输入 无效输入 World
/tp Teleports entities. Op 无效输入 无效输入 Entities Players 无效输入
/trigger Sets a trigger to be activated. Op 无效输入 无效输入 无效输入 Players 无效输入
/weather Sets the weather. Op 无效输入 无效输入 无效输入 无效输入 World
/whitelist Manages server whitelist. Op MP 无效输入 无效输入 Players 无效输入
/worldborder Manages the world border. Op 无效输入 无效输入 无效输入 无效输入 World
/xp Adds or removes player experience. Op 无效输入 无效输入 无效输入 Players 无效输入

List of commands[编辑]

Syntax
If you see… Then
plain text Enter this literally, exactly as shown.
italics Replace this with an appropriate value.
<angle brackets> This is a required argument.
[square brackets] This is an optional argument.
x|y

Pick one of the options shown.

Available options are shown separated by vertical bars: |

ellipsis … The argument may consist of multiple words separated by spaces.
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 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: /help, /me, /tell, and /trigger.
  • Operator: The command may only be used by an operator or in singleplayer mode with cheats enabled. On multiplayer servers, the results of these commands are broadcast to other ops online.
No multiplayer commands permit target selectors in arguments and, except for /list, 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 which are not (or cannot be) registered as Minecraft accounts.
  • No command blocks: The command cannot be executed by a command block.


achievement[编辑]

命令/infobox

Gives a player an achievement or increases a statistic.

Syntax
achievement <give|take> <stat_name|*> [player]
Arguments
stat_name
Must be either:
  • achievement.achievement_name, where achievement_name is a valid achievement identifier
  • stat.statistic_name, where statistic_name is a valid statistic identifier
  • * to represent all achievements
player (optional)
Must be a player name or a target selector. If not specified, defaults to the command's executor. Not optional in command blocks.
Result
Fails if arguments aren't specified properly, or if player fails to resolve to one or more online players.
On success, grants or removes the specified achievement(s) (and all prerequisite achievements) to the player(s) or increases/decreases the specified statistic of the player(s) by 1.
Examples
To grant the "Overkill" achievement to yourself: achievement give achievement.overkill
To grant the "Taking Inventory" achievement to Alice: achievement give achievement.openInventory Alice
To increase the "Mob Kills" statistic by 1 for the nearest player: achievement give stat.mobKills @p
To remove all achievements from all players: achievement take * @a
See also
Commands to modify player:


ban[编辑]

These commands manage a server banlist. The server banlist is a list of players or IP addresses that will not be allowed to connect to the server. Bans supersede any whitelisting in place.

另见:/whitelist


ban[编辑]

命令/infobox

Adds player to banlist.

Syntax
ban <name> [reason …]
Arguments
name
The name of the player to be banned. Does not need to be online, or even real.
reason (optional)
Text to be displayed with the ban, to other operators and in the server logs.
Result
Always succeeds. The player name is added to the server banlist which prevents anyone from connecting to the server by that name.


ban-ip[编辑]

命令/infobox

Adds IP address to banlist.

Syntax
ban-ip <address|name> [reason …]
Arguments
address|name
Must be a player name or an IP address.
reason (optional)
Text to be displayed with the ban, to other operators and in the server logs.
Result
Fails if address|name is neither a valid IP address nor the name of an online player.
On success, the IP address (of the online player, or the address specified) is added to the server banlist which prevents anyone from connecting to the server from that address.


banlist[编辑]

命令/infobox

Displays banlist.

Syntax
banlist ips
banlist players
Result
Always succeeds. Displays banned IP addresses or banned players.


blockdata[编辑]

命令/infobox

Modifies the data tag of a block.

Syntax
blockdata <x> <y> <z> <dataTag>
Arguments
x y z
Specifies the coordinates of the block to be modified. May be provided in tilde notation to identify a position relative to the command's execution.
dataTag
Specifies the data tag elements to be added to, or overwrite elements of, the specified block. Must be a compound NBT tag (for example, {CustomName:Fred}).
Result
Fails if arguments are not specified properly.
On success, modifies the data tag of the targeted block.
Examples
To change the primary power of the beacon at (0,64,0) to Haste:
blockdata 0 64 0 {Primary:3}
See also


clear[编辑]

命令/infobox

Clears items from player inventory.

Syntax
clear [player] [item] [data] [maxCount] [dataTag]
Arguments
player (optional)
Must be a player name or a target selector. If not specified, defaults to the command's user. Not optional in command blocks.
item data (optional)
Specifies the id and data of the item to be cleared. If neither argument is specified, clears all items from the inventory. If item is specified, but not data, all items with id item are cleared, regardless of their data. data can be set to -1 to ignore data and clear all blocks of a certain id when maxCount or dataTag must be specified but data needs to be ignored.
maxCount (optional)
Specifies the maximum number of items to be cleared. If not specified, or if -1, clears all items. If 0, does not clear items, but returns successfully if there were items that could have been cleared (allowing detection of items rather than clearing of items).
dataTag (optional)
Specifies the data tags of the item to be cleared (only items matching the specified data tags will be cleared — data tags not specified will not be considered). Must be a compound NBT tag (for example, {display:{Name:Fred}}).
Result
Fails if the arguments are not specified properly, if player fails to resolve to one or more online players, or if no items are removed.
On success, removes the specified items from the player(s).
Examples
To clear your entire inventory: clear
To clear all items from Alice's inventory: clear Alice
To clear all wool items from Alice's inventory: clear Alice minecraft:wool
To clear all orange wool items from the inventory of all players: clear @a minecraft:wool 1
To clear all golden swords with the "Sharpness I" enchantment from the nearest player, regardless of their damage value:
clear @p minecraft:golden_sword -1 -1 {ench:[{id:16s,lvl:1s}]}
See also
/give — give items to player


clone[编辑]

命令/infobox

Clones blocks from one region to another.

Syntax
clone <x1> <y1> <z1> <x2> <y2> <z2> <x> <y> <z> [maskMode] [cloneMode] [TileName]
The in-game help for the clone command does not list the final argument. TileName is a placeholder name for the purpose of discussion.
Arguments
x1 y1 z1 and x2 y2 z2
Specifies any two opposing corner blocks of the region to be cloned (the "source region"). May use tilde notation to specify distances relative to the command's execution.
The blocks that make up the corners extend in the positive direction from the coordinates used to identify them. Because of this, the lesser coordinates of each axis will be right on the region boundary, but the greater coordinates will be one block from the boundary, and the block volume of the source region will be (xgreater - xlesser + 1) × (ygreater - ylesser + 1) × (zgreater - zlesser + 1). For example, 0 0 0 0 0 0 has a 1-block volume, and 0 0 0 1 1 1 and 1 1 1 0 0 0 both identify the same region with an 8-block volume.
x y z
Specifies the lower northwest corner (i.e., the smallest coordinates of each axis) of the region to clone to (the "destination region"). May use tilde notation to specify a distance relative to the command's execution.
maskMode (optional)
Must be one of:
  • filtered — Clone only blocks with the specified block id (see TileName below).
  • masked — Copy only non-air blocks. Blocks in the destination region that would otherwise be overwritten by air are left unmodified.
  • replace — Copy all blocks, overwriting all blocks of the destination region with the blocks from the source region.
If not specified, defaults to replace.
cloneMode (optional)
Must be one of:
  • force — Force the clone even if the source and destination regions overlap.
  • move — Clone the source region to the destination region, then replace the copied blocks with air. When used in filtered mask mode, only the cloned blocks will be replaced with air.
  • normal — Don't move or force. Used when TileName also needs to be specified.
If not specified, defaults to normal.
TileName (optional)
Specifies the block id (for example, minecraft:stone) to copy when using filtered mask mode. Not optional when using filtered mask mode.
Result
Fails if the arguments are not specified correctly, if the block volume of the source region is greater than 32768 (enough for the equivalent of eight chunk sections), if the source and destination region overlap (unless using force clone mode), or if one or both regions isn't currently rendered.
On success, overwrites blocks in the destination region with blocks from the source region, leaving the source region unmodified (unless using move clone mode).
See also
/fill — fill a region with a block


debug[编辑]

命令/infobox

Starts or stops a debugging session.

Syntax
debug <start|stop>
Arguments
start
Starts a new debug profiling session.
stop
Stops the active debug profiling session.
Result
Fails if tried to start a debug session when one is already active, or if tried to stop a debug session when none is running.
On success, starts or stops the debug session. While active, includes notifications about potential performance bottlenecks in the console. When stopped, creates a profiler results file in the folder "debug".


defaultgamemode[编辑]

命令/infobox

Sets the default game mode (creative, survival, etc.) for new players entering a multiplayer server.

Syntax
defaultgamemode <mode>
Arguments
mode
Must be one of:
  • survival (can be abbreviated as s or 0) for survival mode
  • creative (can be abbreviated as c or 1) for creative mode
  • adventure (can be abbreviated as a or 2) for adventure mode
  • spectator (can be abbreviated as sp or 3) for spectator mode
"hardcore" is not a valid option for the mode argument, as it is technically not a game mode.
Result
Fails if arguments aren't specified properly.
If successful, sets the default game mode that is shown on the world selection menu. New players that join the world will be put into the default game mode.
Examples
To set the default game mode to survival: defaultgamemode survival, defaultgamemode s, or defaultgamemode 0
See also
/gamemode – changes a player's game mode


deop[编辑]

命令/infobox

Revoke operator status from a player.

Syntax
deop <player>
Arguments
player
Specifies a player to remove from the list of operators. May be anything but target selectors will not evaluate and only actual player names will produce a useful result.
Result
Always succeeds if restrictions are satisfied. If player matches a name on the list of operators, the name is removed from the list and any player by that name no longer has operator status.
Examples
To remove Alice from the list of operators: deop Alice


difficulty[编辑]

命令/infobox

Sets the difficulty level (peaceful, easy, etc.).

Syntax
difficulty <new difficulty>
Arguments
new difficulty
Must be one of:
  • peaceful (can be abbreviated as p or 0) for peaceful difficulty
  • easy (can be abbreviated as e or 1) for easy difficulty
  • normal (can be abbreviated as n or 2) for normal difficulty
  • hard (can be abbreviated as h or 3) for hard difficulty
"hardcore" is not a valid option for the new difficulty argument, as it is not a difficulty.
Result
Fails if arguments aren't specified properly.
If successful, changes the game's difficulty. On a multiplayer server lasts only until the server is restarted — on restart, difficulty is reloaded from server.properties.
Examples
To change the difficulty to hard: difficulty hard, difficulty h, or difficulty 3
See also
/gamemode – changes a player's game mode (creative, survival, etc.)


effect[编辑]

命令/infobox

The effect command manages status effects on players and other entities.

Syntax
effect <player> clear (removes all effects)
effect <player> <effect> [seconds] [amplifier] [hideParticles] (gives an effect)
Arguments
player
Specifies the target(s). Must be a player name or a target selector (@e is permitted to target entities other than players).
effect
Specifies the effect to grant. Must be a status effect id (for example, 1 or minecraft:speed).
seconds (optional)
Specifies the effect's duration in seconds. Must be between 0 and 1,000,000 (inclusive). If not specified, defaults to 30 seconds.
amplifier (optional)
Specifies the number of additional levels to add to the effect. Must be between 0 and 255 (inclusive). If not specified, defaults to 0.
hideParticles (optional)
Specifies whether the particles of the status effect should be hidden. Must be either true or false. If not specified, defaults to false.
Result
Fails if arguments are not specified correctly, if player fails to resolve to one or more valid entities (named players must be online), if seconds was specified as 0 and the target did not have the effect, or if no effects were removed in clear mode.
On success:
  • clear — clears all status effects from the target(s).
  • effect — Adds the status effect to the target(s). If a target already has the status effect, a new status effect with the same amplifier will only override the old duration if it is longer, but a new status effect with a higher duration will override any previous duration. If seconds is set to 0, cancels the specified effect instead.
Examples
To grant a Speed 1 effect to the nearest player for 60 seconds: effect @p 1 60
To grant a Speed 3 effect to the nearest player for 60 seconds: effect @p 1 60 2
To clear any Haste effects from all players: effect @a 3 0
To clear all effects from all zombies: effect @e[type=Zombie] clear


enchant[编辑]

命令/infobox

Adds an enchantment to a player's selected item.

Syntax
enchant <player> <enchantment ID> [level]
Arguments
player
Specifies the target(s). Must be a player name or target selector.
enchantment ID
Specifies the enchantment to be added to the item held by the target. Must be a valid enchantment ID (for example, 16 or minecraft:sharpness).
level (optional)
Specifies the enchantment level. Must be at least 1 and not greater than the maximum level for the specified enchantment. If not specified, defaults to 1.
Result
Fails if arguments are not specified correctly, if player fails to resolve to one or more online players, or if the enchantment is not valid for the item or conflicts with current enchantments (for example, "Fire Protection" cannot be given to armor which already has "Protection", and "Sharpness III" cannot be given to a sword which already has "Sharpness I").
On success, adds the specified enchantment to the item held by the target.
Examples
To give the Infinity enchantment to all players holding a bow: enchant @a 51


entitydata[编辑]

命令/infobox

Modifies the data tag of an entity.

Syntax
entitydata <entity> <dataTag>
Arguments
entity
Specifies the entity(ies) to be modified. Must be an entity UUID or the @e target selector.
dataTag
Specifies the data tag elements to be added to, or overwrite elements of, the specified entity. Must be a compound NBT tag (for example, {CustomName:Fred}).
Result
Fails if arguments are not specified properly, or if entity fails to resolve to one or more non-player entities (players can not be changed).
On success, modifies the data tag of the targeted entity(ies).
Examples
To prevent all current zombies from picking up loot:
entitydata @e[type=Zombie] {CanPickUpLoot:0}


execute[编辑]

命令/infobox

Executes a command with a different user and position.

Syntax
execute <entity> <x> <y> <z> <command …>
An alternate syntax allows the command to be executed only if a specific block is detected:
execute <entity> <x> <y> <z> detect <x2> <y2> <z2> <block> <data> <command …>
Arguments
entity
Specifies the target to be the command's executor. Must be a player name or target selector.
x y z
Specifies the position from which to run the command. x and z must be within the range -30,000,000 to 30,000,000 (inclusive). May use tilde notation to specify distances relative to the target.
command
Specifies the command to be run. Must be a valid command.
x2 y2 z2 (detect mode only)
Specifies the position of the block to check. x2 and z2 must be within the range -30,000,000 to 30,000,000 (inclusive). May use tilde notation to specify distances relative to (x,y,z).
block and data (detect mode only)
Specifies the block id and data which the block at (x2,y2,z2) must match for the command to run. block must be a valid block id (for example, minecraft:stone), and data must be a valid block data for that type of block or -1 to match any block data.
Result
Fails if arguments are not specified properly, if entity fails to resolve to one or more valid entities (named players must be online), if the checked block is not of the correct block id and data, or if the specified command fails.
On success, executes the specified command as if executed by the specified target(s) with operator-level permission at the specified coordinate.
Examples
To summon lightning bolts at the positions of every zombie:
execute @e[type=Zombie] ~ ~ ~ summon LightningBolt
To summon lightning bolts at the positions of every zombie standing on any type of sand:
execute @e[type=Zombie] ~ ~ ~ detect ~ ~-1 ~ minecraft:sand -1 summon LightningBolt
See also
/testforblock — tests for a certain block at a specified position (including specific data tags)


fill[编辑]

命令/infobox

Fills all or parts of a region with a specific block.

Syntax
fill <x1> <y1> <z1> <x2> <y2> <z2> <TileName> [dataValue] [oldBlockHandling] [dataTag]
The fill command also has an optional alternate syntax when using the replace option:
fill <x1> <y1> <z1> <x2> <y2> <z2> <TileName> <dataValue> replace [replaceTileName] [replaceDataValue]
Arguments
x1 y1 z1 and x2 y2 z2
Specifies any two opposing corner blocks of the region to be filled (the "fill region"). May use tilde notation to specify distances relative to the command's execution.
The blocks that make up the corners extend in the positive direction from the coordinates used to identify them. Because of this, the lesser coordinates of each axis will be right on the region boundary, but the greater coordinates will be one block from the boundary, and the block volume of the source region will be (xgreater - xlesser + 1) × (ygreater - ylesser + 1) × (zgreater - zlesser + 1). For example, 0 0 0 0 0 0 has a 1-block volume, and 0 0 0 1 1 1 and 1 1 1 0 0 0 both identify the same region with an 8-block volume.
TileName
Specifies the block to fill the region with. Must be a block id (for example, minecraft:stone).
dataValue (optional)
Specifies the block data to use for the fill block. Must be between 0 and 15 (inclusive).
oldBlockHandling (optional)
Must be one of:
  • destroy - Replaces all blocks (including air) in the fill region with the specified block, dropping the replaced blocks and block contents as entities as if they had been mined.
  • hollow - Replaces only blocks on the outer edge of the fill region with the specified block. Inner blocks are changed to air, dropping their contents as entities but not themselves.
  • keep - Replaces only air blocks in the fill region with the specified block.
  • outline - Replaces only blocks on the outer edge of the fill region with the specified block. Inner blocks are not affected.
  • replace - Replaces all blocks (including air) in the fill region with the specified block, without dropping blocks or block contents as entities. Optionally, instead of specifying a data tag for the replacing block, block id and data values may be specified to limit which blocks are replaced (see replaceTileName and replaceDataValue below)
If not specified, defaults to replace.
dataTag (optional)
Specifies the data tag to use for the fill block (for example, contents of a chest, patterns on a banner, etc.). Must be a compound NBT tag (for example, {CustomName:Fred}). Cannot be combined with the replaceTileName and replaceDataValue arguments.
replaceTileName replaceDataValue (optional)
Arguments are only valid when oldBlockHandling is replace. Cannot be combined with the dataTag argument.
Specifies the block id and data of the blocks in the fill region to be replaced. If replaceDataValue is not specified, data value is ignored when determining which blocks to replace. If both arguments are not specified, replaces all blocks in the fill region.
Result
Fails if arguments are not specified properly, if the fill region is not rendered, if the block volume of the fill region is greater than 32768, if dataValue or dataTag are invalid for the specified block id, or if no blocks were changed.
On success, changes blocks in the fill region to the specified block.


gamemode[编辑]

命令/infobox

Sets a player's game mode.

Syntax
gamemode <mode> [player]
Arguments
mode
Must be one of:
  • survival (can be abbreviated as s or 0) for survival mode
  • creative (can be abbreviated as c or 1) for creative mode
  • adventure (can be abbreviated as a or 2) for adventure mode
  • spectator (can be abbreviated as sp or 3) for spectator mode
"hardcore" is not a valid option for the mode argument, as it is technically not a game mode.
player (optional)
If specified, must be either a player's username or a target selector. If unspecified, defaults to the player using the command. When used in a command block, player is not optional.
Result
Fails if arguments aren't specified properly, or if player fails to resolve to one or more online players.
If successful, changes the game mode of the default or specified players.
Examples
To put yourself into creative mode: gamemode creative, gamemode c, or gamemode 1
To put all players into survival mode: gamemode 0 @a
See also
defaultgamemode – sets the initial game mode for players joining the world


gamerule[编辑]

命令/infobox

Sets or queries a game rule value.

Syntax
gamerule <rule name> [value]
Arguments
rule name
Specifies the game rule to set or query. May be any value, but only certain predefined game rules will affect gameplay (see Predefined Game Rules below).
value (optional)
Specifies the value to set the game rule to. May be any value, though only true or false specified for predefined game rules will actually affect gameplay, except in the case of randomTickSpeed, where any number 0 or higher will affect gameplay (see Predefined Game Rules below).
Predefined Game Rules
Rule Name Description Default Value
commandBlockOutput Whether command blocks should notify admins when they perform commands true
doDaylightCycle Whether time progresses true
doEntityDrops Whether entities that are not mobs should have drops true
doFireTick Whether fire should spread and naturally extinguish true
doMobLoot Whether mobs should drop items true
doMobSpawning Whether mobs should naturally spawn true
doTileDrops Whether blocks should have drops true
keepInventory Whether the player should keep items in their inventory after death false
logAdminCommands Whether to log admin commands to server log true
mobGriefing Whether creepers, zombies, endermen, ghasts, withers, rabbits, sheep, and villagers should be able to change blocks and whether villagers, zombies, skeletons, and zombie pigmen can pick up items true
naturalRegeneration Whether the player can regenerate health naturally if their hunger is full enough (doesn't affect external healing, such as golden apples, the Regeneration effect, etc.) true
randomTickSpeed How often a random block tick occurs (such as plant growth, leaf decay, etc.) per chunk section per game tick. 0 will disable random ticks, higher numbers will increase random ticks 3
reducedDebugInfo Whether the debug screen shows all or reduced infomation false
sendCommandFeedback Whether the feedback from commands executed by a player should show up in chat. Also affects the default behavior of whether command blocks store their output text true
showDeathMessages Whether a message appears in chat when a player dies true
Result
Fails if rule name is not defined and value is not provided (i.e., attempting to query an undefined game rule).
On success, returns the value of the game rule (if value is not provided) or sets the game rule to the specified value (if value is provided).
New game rules may be defined and set (by providing a value) or queried (by not providing a value).
Examples
To stop the day-night cycle: gamerule doDaylightCycle false
To stop natural healing: gamerule naturalRegeneration false
To define a new game rule called MyNewRule and sets its value to 10: gamerule MyNewRule 10


give[编辑]

命令/infobox

Gives an item to a player.

Syntax
give <player> <item> [amount] [data] [dataTag]
Arguments
player
Specifies the target to give item(s) to. Must be a player name or target selector.
item
Specifies the item to give. Must be a valid item id (for example, 256 or minecraft:iron_shovel), or block id for which items exist.
amount (optional)
Specifies the number of items to give. Must be between 1 and 64 (inclusive). If not specified, defaults to 1.
data (optional)
Specifies the item data of the given item(s). Must be an integer between -2,147,483,648 and 2,147,483,647 (inclusive, without the commas), but values which are invalid for the specified item id default to 0. If not specified, defaults to 0.
dataTag (optional)
Specifies the data tag of the given item(s). Must be a compound NBT tag (for example, {display:{Name:Fred}}).
Result
Fails if arguments are not specified properly, or if player fails to resolve to one or more online players.
On success, summons the specified item(s) at the location(s) of the target(s). If player resolves to multiple targets, each receives the specifed number of items. The item entity's Owner tag is set to the target and its PickupDelay tag set to 0Template:Verify so the item can be picked up immediately and only by the target (if the target has room in their inventory).
Examples
To summon 30 blocks of spruce wood planks at John's location with Lore that says "Wooden planks":
give John minecraft:planks 30 1 {display:{Lore:["Wooden planks"]}}
See also
/summon — summon any entity at any location


help[编辑]

命令/infobox

Provides help for commands.

Syntax
help [page|command name]
? [page|command name]
Arguments
page|command name (optional)
Specifies the page number of the command list or the command to provide help for. If not specified, defaults to 1 (the first page of the command list).
Result
Fails if page is not a valid page number, or if command name is not a valid command name. Technically fails even if a valid command name is specified, although it displays the usage of the command.
On success, displays a page of the command list. Multiplayer commands will not be displayed while in singleplayer, even when open to LAN players.
If a valid command name was specified, displays the usage for that command. For some complicated commands may show only the basic usage — additional information can sometimes be gained by attempting to type the command and using the auto-complete control (defaults to Tab ↹ key) to explore available options for each argument.
Examples
To display the first page of the command list: ? or help
To display the third page of the command list: ? 3
To display the usage for the help command: help help


kick[编辑]

命令/infobox

Kicks a player off a server.

Syntax
kick <player> [reason …]
Description
Forcibly disconnects player from the server, displaying an optional reason to them.
Success Conditions
player must be online.


kill[编辑]

命令/infobox

Kills entities (players, mobs, items, etc.).

Syntax
kill [player|entity]
Arguments
player|entity
Specifies the target(s) to be killed (including "non-living" entities like items, vehicles, etc.). Must be a player name or a target selector. If not specified, defaults to the command's user. Not optional in command blocks.
Result
Fails if player|entity fails to resolve to one or more entities (named players must be online).
On success, inflicts 1000 (Heart.svg × 500) void damage to targets — killing them instantly even if in Creative mode or protected by a high-level Resistance effect — and issues the appropriate death message. Players and mobs killed this way drop loot, and slimes and magma cubes that aren't already of minimum size spawn smaller ones. Destroys boats, minecarts, loose items and experience orbs if they are targeted.
Examples
To kill yourself: kill
To kill Bob: kill Bob
To "kill" all item entities (making them vanish from the world): kill @e[type=Item]


list[编辑]

命令/infobox

Lists players on the server.

Syntax
list
Description
Shows the names of all currently-connected players (the same can be achieved when pressing tab)
Success Conditions
Always succeeds, even in a command block.


me[编辑]

命令/infobox

Displays a message about yourself.

Syntax
me <action …>
Description
Sends a narrative message to the other players in the form of "* Yourname action" (e.g., "* Alice sneezes." or "* Alice exploded." ). If a multi-person target selector (e.g., @a) is used in action, the list of names is formatted as "name1, name2, and name3", or "name1 and name2" for two names. Therefore, regardless of any target selectors which are used in action, this command will only output once.
Success Conditions
All target selectors (e.g., @p) in action must evaluate.


op[编辑]

命令/infobox

Grants operator status to a player.

Syntax
op <player>
Description
Grants player operator status on the server.
Success Conditions
Always succeeds.


pardon[编辑]

命令/infobox

Removes entries from the banlist.

Syntax
pardon <name>
pardon-ip <address>
Arguments
name
Specifies the name to remove from the banlist.
address
Specifies the IP address to remove from the banlist. Must be a valid IP address.
Result
Fails if arguments are not specified properly.
On success, if the name or the IP address is on the banlist, it is removed, allowing anyone to connect to the server by that name or from that IP address.


particle[编辑]

命令/infobox

Creates particles.

Syntax
particle <name> <x> <y> <z> <xd> <yd> <zd> <speed> [count] [mode]
Arguments
name
Specifies the particle to create. Must be a particle name (for example, explode).
x y z
Specifies the position at which to create the particle. All values (including y) must be between -30,000,000 and 30,000,000 (inclusive, without the commas). May use tilde notation to specify a position relative to the command's execution.
xd yd zd
Specifies the size of the area to spawn particles in.
Exception: When name is reddust, mobSpell, or mobSpellAmbient and count is 0 or not specified, specifies the color of the particle in RGB format offset from the particle's default color (reddust's default is a near-red (a random red tint between 0.8 and 1.0), while the others default to black). For example, with reddust, 0 0 0 produces a red particle, -1 1 0 produces a green particle (red is reduced to 0 and green increased to 1), 0 0 1 produces a purple particle (blue is added to the original red), etc. With mobSpell or mobSpellAmbient, 0 0 0 produces a black particle, 0 1 0 produces a green particle, 0 0 0.5 produces a dark blue particle, etc. If count is greater than 0, colors are randomized.
speed
Specifies the speed of the particle. Must be at least 0.
count (optional)
Specifies the number of particle effects to create. Must be at least 0 (which produces one particle).
mode (optional)
Specifies the display mode. May be anything but only force will have an effect: to allow the particle(s) to be seen beyond the usual 16 block radius.
Result
Fails if arguments are not specified properly.
On success, creates the specified particle.
Examples
To create a stationary huge explosion particle 10 blocks to the east:
particle hugeexplosion ~10 ~ ~ 0 0 0 0


playsound[编辑]

命令/infobox

Plays a sound.

Syntax
playsound <sound> <player> [x] [y] [z] [volume] [pitch] [minimumVolume]
Arguments
sound
Specifies the sound to play. Must be a sound event defined in sounds.json (for example, mob.pig.say).
A sound event may be affiliated with multiple sounds, and the sound which is actually produced will be chosen at random from them, modified by their "weight", just as the game normally would. For example, the mob.pig.say sound event will play one of several pig sounds at random, because the event has multiple sounds associated with it.
Resource packs may add their own events to sounds.json; the command will successfully play these. File names are not used by this command; it strictly uses the events defined in sounds.json (which may not even be similar to the original file names and paths), and thus a resource pack adding new sound files must define events for them (this is not necessary when replacing old sounds which are already in defined events).
player
Specifies the sound's target. Must be a player name or a target selector.
x y z (optional)
Specifies the position to play the sounds from. May use tilde notation to specify a position relative to the target(s).
volume (optional)
Specifies the distance that the sound can be heard. Must be at least 0.0. For values less than 1.0, the sound will be quieter and have a smaller sphere within which it may be heard. For values greater than 1.0, the sound will not actually grow louder, but its audible range (a 16-block radius at 1.0) will be multiplied by volume. There will always be a gradual falloff to silence based on distance from the center of the sphere.
pitch (optional)
Specifies the pitch of the sound. Must be between 0.0 and 2.0 (inclusive), and values less than 0.5 are equivalent to 0.5. Values lower than 1.0 lower the pitch and increase the duration; values greater than 1.0 raise the pitch and reduce the duration. The pitch value is a multiplier applied to the frequency, so if a value between 0.5 and 1.0 (inclusive) is doubled, the pitch will be an octave higher. (If you're a musician wishing to convert other intervals to pitch values, see Note block#Usage, but be aware that 1.0 won't be F♯ for all sound effects.) If not specified, defaults to 1.0.
minimumVolume (optional)
Specifies the volume for targets outside the sound's normal audible sphere. If a target is outside the normal sphere, the sound will instead be centered some short distance from the target (less than four blocks away), and minimumVolume will determine its volume. Must be between 0.0 and 1.0 (inclusive).
Result
Fails if arguments are not specified properly, if player fails to resolve to one or more online players, or if the targets are unable to hear the sound from where it is played.
On success, plays a sound for the targeted players.


publish[编辑]

命令/infobox

Opens single-player world to the local network.

Syntax
publish
Description
Opens your single-player game for LAN friends to join. This command appears in the singleplayer cheats.
Success Conditions
Cannot be used in a command block.


replaceitem[编辑]

命令/infobox

Replaces items in the inventories of blocks (chest, furnaces, etc.) or entities (players or mobs) with the given item(s).

Syntax
replaceitem block <x> <y> <z> <slot> <item> [amount] [data] [dataTag]
replaceitem entity <selector> <slot> <item> [amount] [data] [dataTag]
Arguments
x y z (block mode only)
Specifies the position of the block to be modified. May use tilde notation to specify a position relative to the command's execution.
selector (entity mode only)
Specifies the entity to modify. Must be a player name or target selector.
slot
Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified.
For blocks, must be slot.container.slot_number where slot_number is replaced with a number specifying the slot.
  • Chests, dispensers, droppers, hoppers, and trapped chests are numbered 0 for the top-left slot and then increase first horizontally, then vertically (so, for example, a chest's top row slots are numbered 0 to 8 from left to right). Double chests and double trapped chests are treated as two single container blocks.
  • A brewing stand's bottom slots are numbered 0 to 2 from left to right, and its top slot is 3.
  • A furnace's slots are numbered 0 for the input slot, 1 for the fuel slot, and 2 for the output slot.
Other blocks which hold items but don't have inventory GUIs (flower pots and jukeboxes) can only be changed with /blockdata.
For entities, must be one of the following, where slot_number is replaced with a number specifying the slot:
Slot Slot Numbers Restrictions
slot.armor.chest armor stands, mobs, and players only (though not all mobs will show or make use of the items)
slot.armor.feet
slot.armor.head
slot.armor.legs
slot.weapon armor stands and mobs only (though not all mobs will show or make use of the items)
slot.enderchest.slot_number 0 to 26 players only
slot.hotbar.slot_number 0 to 8
slot.inventory.slot_number 0 to 26
slot.horse.saddle horses, donkeys, and mules only; item must be a saddle
slot.horse.armor horses only; item must be a type of horse armor
slot.horse.chest.slot_number 2 to 16 donkeys and mules with chests only
slot.villager.slot_number 0 to 7 villagers only
The inventory of an item frame can only be changed with /entitydata.
item
Specifies the item to be placed in the block or entity's inventory slot. Must be an item id, or a block id for which an item exists (for example, minecraft:golden_sword).
amount (optional)
Specifies the number of items to be placed in the block or entity's inventory slot. Must be between 1 and 64 (inclusive), even for items with a smaller stack size.
data (optional)
Specifies the item data for the item(s) to be placed in the block or entity's inventory slot. Must be an integer between -2,147,483,648 and 2,147,483,647 (inclusive, without the commas), but values which are invalid for the specified item id will default to 0. If not specified, defaults to 0.
dataTag (optional)
Specifies the data tag for the item(s) to be placed in the block or entity's inventory slot. Must be a compound NBT tag (for example, {display:{Name:Fred}}).
Result
Fails if arguments are not specified properly, if the specified block is not a container, if selector fails to resolve to one or more entities (named players must be online), or if the targeted entity does not have the specified slot (for example, zombies don't have slot.horse.armor).
On success, replaces the items in the specified slot with the specified items (previous items in that slot are lost).
Examples
To replace the items in the bottom-right slot of a single chest one block above with four spruce saplings:
replaceitem block ~ ~1 ~ slot.container.26 minecraft:sapling 4 1
To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings:
replaceitem entity @p slot.hotbar.8 minecraft:sapling 4 1
See also
/blockdata — can also replace items in a container
/entitydata — can also replace items in a mob's inventory, or modify the drop chances of armor and weapons
/give — give items to players without specifying specific inventory slots or overwriting other items


save[编辑]

命令/infobox

These commands manage server saves.


save-all[编辑]

Saves the server to disk.

Syntax
save-all
Description
Forces the server to write all pending changes to the world and player data to disk.
Success Conditions
Always succeeds.


save-off[编辑]

Disables automatic server saves.

Syntax
save-off
Description
Disables the server writing to the world files. All changes will temporarily be queued.
Success Conditions
Always succeeds.


save-on[编辑]

Enables automatic server saves.

Syntax
save-on
Description
Enables the server writing to the world files. This is the default behavior.
Success Conditions
Always succeeds.


say[编辑]

命令/infobox

Says a message to multiple players.

Syntax
say <message …>
Description
Broadcasts message to all players on the server. If a multi-person target selector (e.g., @a) is used, the list of names is formatted as "name1, name2, and name3", or "name1 and name2" for two names. Therefore, regardless of any target selectors which are used, this command will only output once.
Success Conditions
All target selectors (e.g., @p) in the message must evaluate.


scoreboard[编辑]

命令/infobox

These commands manage scoreboard objectives, players, and teams.

Syntax
scoreboard <objectives|players|teams> …

See Scoreboard#Command reference for more information.


seed[编辑]

命令/infobox

Displays the world seed.

Syntax
seed
Description
Displays the seed. This command can always be used in single-player mode, regardless of whether cheats are enabled or not.
Success Conditions
Always succeeds (if user is a command block, player in singleplayer, or server op).


setblock[编辑]

命令/infobox

Changes a block to another block.

Syntax
setblock <x> <y> <z> <TileName> [dataValue] [oldBlockHandling] [dataTag]
Arguments
x y z
Specifies the position of the block to be changed. May use tilde notation to specify a position relative to the command's execution.
TileName
Specifies the new block. Must be a block id (for example, minecraft:stone).
dataValue (optional)
Specifies additional data to further describe the new block. Must be between 0 and 15 (inclusive). If not specified, defaults to 0.
oldBlockHandling (optional)
Specifies how to handle the block change. Must be one of:
  • destroy — The old block drops both itself and its contents (as if destroyed by a player). Plays the appropriate block breaking noise.
  • keep — Only air blocks will be changed (non-air blocks will be "kept").
  • replace — The old block drops neither itself nor any contents. Plays no sound.
If not specified, defaults to replace.
dataTag (optional)
Specifies the data tag for the new block. Must be a compound NBT tag (for example, {CustomName:Fred}).
Result
Fails if arguments are not specified properly, if tried to change a non-air block in keep mode, or tried to replace a block with an identical copy in keep or replace mode.
On success, changes the block at the specified position.
See also
  • /blockdata — modifies the data tags of a block
  • /clone — copies blocks from one region to another
  • /fill — fills a region with a block


setidletimeout[编辑]

命令/infobox

Sets the time before idle players are kicked from the server.

Syntax
setidletimeout <Minutes until kick>
Description
Set the idle kick timer. Any players idle for Minutes until kick will be kicked.
Success Conditions
Always succeeds.


setworldspawn[编辑]

命令/infobox

Sets the world spawn.

Syntax
setworldspawn
setworldspawn <x> <y> <z>
Arguments
x y z (optional)
Specifies the coordinates of the world spawn. x and z must be within the range -30,000,000 to 30,000,000 (inclusive). y must be between 0 and 256 (inclusive). May use tilde notation to specify coordinates relative to the command's execution. If not specified, defaults to the position of the command's execution. Not optional in command blocks.
If the server is not in adventure mode, players will always spawn on the topmost block near (x,z) — y is effectively ignored. If the server is in adventure mode, then the new spawnpoint will be the coordinates given exactly, including the y coordinate (even if undergound and even if there is no block there) -- if the y level given does not have space for the player then it will move up on the y axis until it does, at most y level 256.
Although spawn chunks are usually kept loaded at all times, new spawn chunks won't be loaded by this command until a player moves within range. Compasses (which in Minecraft point to the world spawn rather than north) will also not update to the change until the world is reloaded.
Result
Fails if arguments are not specified correctly.
On success, sets the world spawn to the specified coordinate.


spawnpoint[编辑]

命令/infobox

Sets the spawn point for a player.

Syntax
spawnpoint
spawnpoint <player>
spawnpoint <player> <x> <y> <z>
Arguments
player (optional)
Specifies the player whose spawn point should be set. Must be a player name or a target selector. If not specified, defaults to the command's user. Not optional in command blocks.
x y z (optional)
Specifies the coordinates of the player's new spawn point. x and z must be integers within the range -30,000,000 to 30,000,000 (inclusive). y must be an integer between 0 and 256 (inclusive). May use tilde notation to specify coordinates relative to the command's execution. If not specified, defaults to the position of the specified player(s).
Result
Fails if arguments are not specified correctly, or if player fails to resolve to one or more online players.
On success, sets the spawn point of the targeted player(s) to the specified coordinate.


spreadplayers[编辑]

命令/infobox

Teleports entities (players, mobs, items, etc.) to random surface locations within an area.

Syntax
spreadplayers <x> <z> <spreadDistance> <maxRange> <respectTeams> <player …>
Arguments
x z
Specifies the center of the region to spread targets to. x and z must be between -30,000,000 and 30,000,000 (exclusive). May use tilde notation to specify coordinates relative to the command's execution.
spreadDistance
Specifies the minimum distance between targets. Must be at least 0.0.
maxRange
Specifies the maximum distance on each horizontal axis from the center of the area to spread targets (thus, the area is square, not circular). Must be at least 1.0 greater than spreadDistance.
respectTeams
Specifies whether to keep teams together. Must be true or false. If true, targets on the same team will be teleported to the same location.
player
Specifies the targets to spread. Must be one or more player names and/or target selectors separated by spaces (@e is permitted to target entities other than players).
Result
Fails if arguments are not specified properly, if there are too many targets to satisfy the spreadDistance requirement within the specified area, or if a target is attempted to be spread to outside the world boundary.
On success, teleports targets to random surface locations within the specified area. Targets will always be placed on the top block at a location, and never on lava.
Examples
To teleport all players by team to random surface locations in a 1,000×1,000-block area centered on (0,0), with a minimum distance between teams of 200 blocks:
spreadplayers 0 0 200 500 true @a
To teleport one random player from each of three teams (Red, Blue, and Green), as well as Alice and Bob, to random surface locations in a 200×200-block area centered on (0,0), with a minimum distance between players of 50 blocks:
spreadplayers 0 0 50 100 false @r[team=Red] @r[team=Blue] @r[team=Green] Alice Bob
See also
/tp — teleports a single player or entity to a specific position (even underground).


stats[编辑]

命令/infobox

Manages the updating of scoreboard objectives with the results of other commands.

Commands can be executed by blocks (specifically, command blocks and signs) or by entities (players can execute commands directly, and other entities can be the origin of commands indirectly with the /execute command). When a command is executed, the command returns one or more "command stats": the success count, number of blocks affected, number of entities affected, number of items affected, and/or a query result (such as from /time query daytime).

The stats command allows "selectors" and "objectives" to be set (or cleared) for each of these command stats for specific blocks or entities. Selectors (for example, @e) are stored exactly as entered, and don't get evaluated immediately. When a command is later run by the block or entity, the stored selector is then used to target (other) entities and update their scoreboard objective with the value of the command stat. That value can then be displayed or operated on, just like any other scoreboard value.

The success count from a command block can also be acquired with a redstone comparator, but that is capped at a maximum value of 15, while scoreboard objectives can hold any value from -2,147,483,648 to 2,147,483,647. Success counts and query results are also usually displayed in the chat.

另见:Tutorials/Command stats
Syntax
stats block <x> <y> <z> clear <stat>
stats block <x> <y> <z> set <stat> <selector> <objective>
stats entity <selector2> clear <stat>
stats entity <selector2> set <stat> <selector> <objective>
Arguments
x y z (block mode only)
Specifies the position of the block to post command stats from. x and z must be between -30,000,000 and 30,000,000 (inclusive, without the commas) and y must be between 0 and 256 (inclusive). May use tilde notation to specify a position relative to the command's execution.
selector2 (entity mode only)
Specifies the entity to post command stats from. Must be a player name or a target selector.
stat
Specifies the command stat whose selector and objective are to be cleared or set. Must be one of:
  • AffectedBlocks — returns the number of blocks affected by a command
  • AffectedEntities — returns the number of entities affected by a command
  • AffectedItems — returns the number of items affected by a command
  • QueryResult — returns the result of a command query
  • SuccessCount — returns a command's success count
selector (set mode only)
Specifies the selector to be evaluated when a command is run by the specified block or entity to determine which entity(ies) scoreboard objective is to be updated with the result returned by stat. May be anything because it won't be evaluated until a command is run by the specified block or entity, but only a player name or a target selector will produce useful results (though player names can be fake, so even real players don't need to be online).
objective (set mode only)
Specifies the name of the objective to be updated with the result returned by stat. May be anything because it won't be evaluated until a command is run by the specified block or entity, but only the name of a defined objective will produce useful results.
Result
Fails if arguments are not specified properly, if the specified block cannot track stats (in other words, it fails if the specified block is not a command block or sign), or if selector2 fails to evaluate to one or more valid entities (named players must be online).
On success, clears or sets the selector and objective to be updated with the result returned by stat.
Examples
To set the block at (0,64,0) to update scoreboard objective MyObj of the nearest player with the value of any query result returned by the block:
stats block 0 64 0 set QueryResult @p MyObj
To stop the block at (0,64,0) from updating any scoreboard obectives with the success count of commands it executes:
stats block 0 64 0 clear SuccessCount
To have the nearest wither skull update the scoreboard objective NumBlocks of fake player #FakePlayer with the number of blocks affected by commands executed by the wither skull:
stats entity @e[type=WitherSkull,c=1] set AffectedBlocks #FakePlayer NumBlocks
See also
/blockdata — can also change the selector and objectives of blocks by altering data tags directly
/entitydata — can also change the selector and objectives of entities by altering data tags directly


stop[编辑]

命令/infobox

Stops a server.

Syntax
stop
Description
Saves all changes to disk, then shuts down the server.
Success Conditions
Always succeeds.


summon[编辑]

命令/infobox

Summons an entity (mobs, projectiles, items, vehicles, etc.).

Syntax
summon <EntityName> [x] [y] [z] [dataTag]
Arguments
EntityName
Specifies the entity to be summoned. Must be an entity id (for example, Bat, EntityHorse, WitherSkull, XPOrb, PrimedTNT, etc.) or LightningBolt.
x y z (optional)
Specifies the position to summon the entity. x and z must be between -30,000,000 to 30,000,000 (inclusive), and y must be at least 0. May use tilde notation to specify a position relative to the command's execution. If not specified, defaults to the position of the command's execution.
dataTag (optional)
Specifies the data tag for the entity. Must be a compound NBT tag (for example, {CustomName:Fred}). Lightning has no additional data tags that can be specified.
Result
Fails if arguments are not specified properly.
On success, creates the specified entity at the specified position.
Examples
To summon a charged creeper named "Powered Creeper" at the current position:
summon Creeper ~ ~ ~ {powered:1,CustomName:Powered Creeper}
To summon lightning 10 blocks west of the current position:
summon LightningBolt ~-10 ~ ~
To summon an Armor stand wielding a lava bucket and wearing a skull:
/summon ArmorStand ~ ~ ~ {Equipment:[{id:lava_bucket},{},{},{},{id:skull}]}


tell[编辑]

命令/infobox

Sends a private message to one or more players.

Syntax
tell <player> <private message …>
msg <player> <private message …>
w <player> <private message …>
Arguments
player
Specifies the targeted player(s) to send the private message to. Must be a player name (or a target selector, but only if the user is an operator).
private message
Specifies the message to send. May include spaces (as well as target selectors, but only if run from the server console — in other words, from the computer running the server, or by remote access to it).
Result
Fails if any target selectors in either argument fail to resolve to at least one online player, or if a named player is not online.
On success, only the targeted player(s) see the private message in their chat.
Any target selectors in the private message will each resolve to one or more player names (as "name" for a single player, "name1 and name2" for two players, or "name1, name2, …, and nameN" for N players, without the quotes).
Examples
To privately tell Alice to start the mission: tell Alice Start the mission!


tellraw[编辑]

命令/infobox

Sends a JSON message to players.

Syntax
tellraw <player> <raw json message>
Arguments
player
Specifies the player(s) to send the message to. Must be a player name or target selector.
raw json message
Specifies the message to send. Must be valid raw JSON text (for example, {text:"Hi there!",bold:true}).
Result
Fails if arguments are not specified properly, or if player fails to evaluate to one or more online players.
On success, the targeted players receive the JSON message in their chat.
See also
/say — send a simple text message to all players
/tell — send a simple text message to specific players


testfor[编辑]

命令/infobox

Counts entities (players, mobs, items, etc.) matching specified conditions.

Syntax
testfor <player> [dataTag]
Arguments
player
Specifies the targets to count. Must be a player name or a target selector (@e is permitted to target entities other than players).
dataTag (optional)
Specifies the data tags the entities must have to match successfully. Must be a compound NBT tag (for example, {XpLevel:3}).
Result
Fails if arguments are not specified properly, or if player fails to resolve to one or more entities (named players must be online).
On success, produces a success count equal to the number of targets matching player, which can be measured by a redstone comparator facing away from the command block.
Examples
To test if Alice is online: testfor Alice
To count the number of players in survival mode within a 3-block radius of (0,64,0): testfor @a[0,64,0,3,m=0]
To count the number of players currently flying: testfor @a {abilities:{flying:1b}}
To count the number of zombies within a 20-block radius of (0,64,0): testfor @e[0,64,0,20,type=Zombie]


testforblock[编辑]

命令/infobox

Tests whether a certain block is in a specific location.

Syntax
testforblock <x> <y> <z> <TileName> [dataValue] [dataTag]
Arguments
x y z
Specifies the position of the block to test. x and z must be between -30,000,000 and 30,000,000 (inclusive, without the commas) and y must be between 0 and 255 (inclusive). May use tilde notation to specify a position relative to the command's execution.
TileName
Specifies the block to test for. Must be a valid block id (for example, minecraft:stone).
dataValue (optional)
Specifies the block data to test for. dataValue must be between -1 and 15 (inclusive). If not specified, or if -1, dataValue matches any block data value.
dataTag (optional)
Specifies the block data tags to test for. Must be a compound NBT tag (for example, {CustomName:Fred}). If not specified, dataTag matches any block data tag.
Result
Fails if arguments are not specified properly, if the block at the specified position does not match the specified block id or data, or if the specified data tag has different values than are defined in the block's data tag (dataTag does not need to match the block's entire data tag, and data tags in the argument which are undefined in the block will not cause the command to fail).
On success, returns a success count of 1.
Examples
To test if the block at (0,64,0) is any type of wool:
testforblock 0 64 0 minecraft:wool
testforblock 0 64 0 minecraft:wool -1
To test if the block at (0,64,0) is orange wool:
testforblock 0 64 0 minecraft:wool 1
To test if the block below is a jukebox with the "mall" record inside:
testforblock ~ ~-1 ~ minecraft:jukebox -1 {Record:2261}


testforblocks[编辑]

命令/infobox

Tests whether the blocks in two regions match.

Syntax
testforblocks <x1> <y1> <z1> <x2> <y2> <z2> <x> <y> <z> [mode]
Arguments
x1 y1 z1 and x2 y2 z2
Specifies two opposing corners of the region to use as the pattern to test for (the "source region"). x1, z1, x2, and z2 must all be between -30,000,000 and 30,000,000 (inclusive, without the commas), and y1 and y2 must be between 0 and 255 (inclusive). May use tilde notation to specify coordinates relative to the command's position. The number of blocks in the source region must not exceed 524,288.
x y z
Specifies the lower northwestern corner (the corner with the most-negative values) of the region to be checked (the "destination region"). x and z must both be between -30,000,000 and 30,000,000 (inclusive, without the commas), and y must be between 0 and 254 (inclusive). May use tilde notation to specify coordinates relative to the command's position. Source and destination regions may overlap.
mode (optional)
Specifies how to match blocks. Must be one of:
  • all — every block in the source and destination regions must match exactly.
  • maskedair blocks in the source region will match any block in the destination region.
If not specified, defaults to all.
Result
Fails if arguments are not specified properly, or if the source and destination regions do not match.
On success, returns the number of matching blocks (the total number of blocks in all mode, or the number of source region non-air blocks in masked mode).


time[编辑]

命令/infobox

Changes or queries the world's game time.

Syntax
time <add|query|set> <value>
Arguments
value
Specifies the time to add, query, or set:
  • add - Must be between 0 and 2,147,483,647 (inclusive, without the commas)
  • query - Must be daytime or gametime.
  • set - Must be between 0 and 2,147,483,647 (inclusive, without the commas), day, or night.
Result
Fails if arguments are not specified properly.
On success:
  • add - adds value to the world's game time
  • query - returns the day time (game ticks since midnight) or the game time (game ticks since world start)
  • set - sets the world game time to value (day = 1,000, night = 13,000).
Examples
To set the time to 1,000: time set 1000 or time set day
To add one day to the world time: time add 24000


title[编辑]

命令/infobox

Manages screen titles.

Screen titles are displayed to players as a single line of large center-aligned text in the middle of their displays and can include a second line of text called a "subtitle". Both lines can include complicated formatting. Screen titles can be set to fade in and fade out, and the duration they are displayed can also be specified. Screen titles scale in size with the GUI Scale and screen titles which are too big to fit on the screen are not line-wrapped (they just overflow off the screen on both sides).

Syntax
The command has five variations, each with different arguments.
title <player> clear (removes a screen title from the screen)
title <player> reset (resets options to default values)
title <player> subtitle <raw json title> (specifies the subtitle text)
title <player> times <fadeIn> <stay> <fadeOut> (specifies fade-in, stay, and fade-out times)
title <player> title <raw json title> (displays the screen title)
Arguments
player
Specifies the player(s) to display a screen title to. Must be a player name or target selector.
raw json title (subtitle and title mode only)
Specifies the text to display as a title or subtitle. Must be valid raw JSON text (for example, {text:"Chapter I",bold:true}).
fadeIn, stay, and fadeOut (times mode only)
Specifies the time in game ticks (1/20ths of a second) for the screen title to fade in, stay, and fade out. All values must be between -2,147,483,648 and 2,147,483,647 (inclusive, without the commas), but values below 0 will be treated as 0. If not specified (or if reset), default to 20 (1 second), 60 (3 seconds), and 20 (1 second).
Result
File:Title command.png
Example result of the title command.
Fails if arguments are not specified properly, or if player fails to evaluate to one or more online players.
On success:
  • clear — Clears the screen title from the screens of the specified player(s). If no screen title is currently being displayed, has no effect.
  • reset — Resets the subtitle text to blank text, the fade-in time to 20 (1 second fade-in), the stay time to 60 (3 seconds), and the fade-out time to 20 (1 second fade-out) for the specified player(s).
  • subtitle — If a screen title is currently being displayed to the specified player(s), changes the currently-displayed subtitle to the new specified text; otherwise, specifies the subtitle for the next screen title to be displayed to the specified player(s).
  • times — If a screen title is currently being displayed to the specified player(s), changes the fade-in, stay, and fade-out times of the current screen title (and of all future screen titles); otherwise, specifies the times for future screen titles to be displayed to the specified player(s).
  • title — Displays the specified text to the specified player(s), or changes the currently-displayed text to the new specified text. After fade-out, resets the subtitle back to blank text, but does not reset fade-in, stay, and fade-out times.
Examples
To display a bold screen title "Chapter I" with a gray italic subtitle "The story begins…" to all players:
  1. title @a subtitle {text:"The story begins…",color:gray,italic:true}
  2. title @a title {text:"Chapter I",bold:true}


toggledownfall[编辑]

命令/infobox

Toggles the weather.

Syntax
toggledownfall
Result
Always succeeds. If weather is currently clear, rain or snow will start. If weather is currently rain or snow, it will stop.


tp[编辑]

命令/infobox

Teleports entities (players, mobs, items, etc.).

Syntax
tp [target player] <destination player>
tp [target player] <x> <y> <z> [<y-rot> <x-rot>]
Arguments
target player (optional)
Specifies the targets to be teleported. Must be either a player name or a target selector (@e is permitted to target entities other than players). If not specified, defaults to the command's user. Not optional in command blocks.
destination player
Specifies the targets to teleport the target player to. Must be either a player name or a target selector (@e is permitted to target entities other than players).
x y z
Specifies the coordinates to teleport the targets to. x and z must fall within the range -30,000,000 to 30,000,000 (exclusive, without the commas), and y must be at least 0. May use tilde notation to specify a position relative to the target's current position.
y-rot (optional)
Specifies the horizontal rotation (-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 north, before wrapping back around to -180.0). Tilde notation can be used to specify a rotation relative to the target's previous rotation.
x-rot (optional)
Specifies the vertical rotation (-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.
Result
Fails if the arguments are not specified correctly, if target player fails to resolve to one or more entities (named players must be online), or if destination player fail to resolve to a single entity (a named player must be online).
On success, teleports the targets to the specified destination.
Examples
To teleport yourself to Alice: tp Alice
To teleport all players to yourself: tp @a @p
To teleport yourself to (x,z) = (100,100) but three blocks above your current position: tp 100 ~3 100
To rotate the nearest player 10 degrees to the right without changing their position: tp @p ~ ~ ~ ~10 ~


trigger[编辑]

命令/infobox

Sets a trigger to be activated.

Syntax
trigger <objective> <add|set> <value>
Description
Used together with /tellraw to let players activate systems made by operators or mapmakers. The objective must be an enabled scoreboard objective of the criteria "trigger". The given value is either added to its existing value, or becomes its new value, depending on whether the second argument is add or set. The value of the objective is only changed for the player who uses the command.
Success Conditions
objective must have the "trigger" criteria and the player who is running the command must be able to modify objective.


weather[编辑]

命令/infobox

Sets the weather.

Syntax
weather <clear|rain|thunder> [duration in seconds]
Arguments
clear
Specifies to set the weather to clear weather.
rain
Specifies to set the weather to rain (or snow in cold biomes).
thunder
Specifies to set the weather to a thunderstorm (or a thunder snowstorm in cold biomes).
duration in seconds
Specifies the time for the specified weather to last. Must be between 1 and 1,000,000 (inclusive, without the commas).
Result
Fails if arguments are not specified properly.
On success, changes the weather for the specified duration (in seconds).
Examples
To get clear weather for one Minecraft day: weather clear 1200
To make it rain, but let it end at its own pace: weather rain 1


whitelist[编辑]

命令/infobox

Manages the server whitelist.

Server ops will always be able to connect when the whitelist is active, even if their names do not appear in the whitelist.

Syntax
The command has six variations.
whitelist add <player>
whitelist list
whitelist off
whitelist on
whitelist reload
whitelist remove <player>
Arguments
player (add and remove mode only)
Specifies the player(s) to add or remove from the whitelist.
Result
Fails if player doesn't exist
On success:
  • add — Adds the player name to the whitelist. The player does not need to be online.
  • list — Displays all player names in the whitelist.
  • off — Disables the server's use of a whitelist.
  • on — Enables the server's use of a whitelist.
  • reload — Reloads the list of player names in white-list.txt (1.7.5 or earlier) or whitelist.json (1.7.6 or later) from disk (used when white-list.txt or whitelist.json has been modified outside of Minecraft).
  • remove — Removes the player name from the whitelist. The player does not need to be online.


worldborder[编辑]

命令/infobox

These commands manage the world border.

Syntax
The command has eight variations, each with different arguments:
worldborder add <sizeInBlocks> [timeInSeconds] (increases the world border diameter)
worldborder center <x> <z> (recenters the world boundary)
worldborder damage amount <damagePerBlock> (specifies world border damage rate)
worldborder damage buffer <sizeInBlocks> (specifies world border damage buffer distance)
worldborder get (returns the world border diameter)
worldborder set <sizeInBlocks> [timeInSeconds] (sets the world border size and speed)
worldborder warning distance <blocks> (specifies the world border warning distance)
worldborder warning time <seconds> (specifies the world border warning time)
Arguments
sizeInBlocks (add, damage buffer, and set modes only)
Specifies a distance in blocks:
  • add — specifies the number of blocks to add to the world border diameter.
  • damage buffer — specifies the distance outside the world buffer before players start taking damage. Must be at least 0.0. Initially set to 5.0.
  • set — Specifies the new diameter for the world border. Must be between 1.0 and 60,000,000 (inclusive, without the commas).
timeInSeconds (add and set modes only)
Specifies the number of seconds it should take for the world border to move from its current diameter to the new diameter. Must be at least 0. If not specified, defaults to 0.
x z (center mode only)
Specifies the horizontal coordinates of the world border's center. Must be between -30,000,000 and 30,000,000 (inclusive, without the commas). May use tilde notation to specify coordinates relative to the command's execution.
damagePerBlock (damage amount mode only)
Specifies the damage a player takes per second per block past the world border buffer. For example, if damagePerBlock is 0.1, a player 5 blocks outside the world border buffer will take 0.5 damage per second (damage less than half a heart might not change the visual health display, but will still accumulate). Must be at least 0.0. Initially set to 0.2.
blocks (warning distance mode only)
Specifies the distance from the world border at which players will begin to see a visual warning of the world border's proximity. Must be at least 0. Initially set to 5.
seconds (warning time mode only)
Specifies the time in seconds before a moving world border overruns a player when they will begin to see a visual warning of the world border's proximity. For example, if seconds is 5, players will get a visual warning when the moving world border is 5 seconds or less away from passing their position. Must be at least 0. Initially set to 15.
Result
Fails if arguments are not specified properly, or if new world diameter will be less than 1.0 or greater than 60,000,000.
On success:
  • add — The world border begins changing its diameter. If sizeInBlocks is positive, the world border will turn green and start increasing; if negative, the world border will turn red and start decreasing. If timeInSeconds is 0 or unspecified, the change occurs immediately; otherwise the change proceeds at a rate of (sizeInBlocks/2)/timeInSeconds blocks per second.
  • center — The center of the world border immediate moves to the specified coordinates.
  • damage amount — Sets the world border damage amount to the specified value. Any player outside the world border buffer will take this amount of damage per second per block past the world border buffer distance.
  • damage buffer — Sets the world border buffer distance to the specified value. Players won't take damage until they move past this distance from the world border.
  • get — Shows the current world border diameter in the chat.
  • set — The world border begins changing its diameter. If sizeInBlocks is bigger than the current diameter, the world border will turn green and start increasing; if smaller, the world border will turn red and start decreasing. If timeInSeconds is 0 or unspecified, the change occurs immediately; otherwise the change proceeds at a rate of ((sizeInBlocks-<cirrent diameter>)/2)/timeInSeconds blocks per second.
  • warning distance — Sets the world border warning distance to this value.
  • warning time — Sets the world border warning time to this value.


xp[编辑]

命令/infobox

Adds experience to a player.

Syntax
xp <amount> [player]
xp <amount>L [player]
Arguments
amount
Specifies the amount of experience to give to the player. Must be between 0 and 2,147,483,647 (inclusive, without the commas).
If an L is added to the end, adds levels instead. Levels must be between -2,147,483,648 and 2,147,483,647 (inclusive, without the commas) — negative values remove levels instead of adding them.
player (optional)
Specifies the target of the command. Must be a player name or a target selector. If not specified, defaults to the command's executor. Not optional in command blocks.
Result
Fails if arguments are not specified properly, or if player fails to resolve to one or more online players.
On success, adds experience or adds/removes levels. Total experience and levels will not be reduced below 0.
Examples
To give 7 experience to yourself: xp 7
To give 3 levels to Alice: xp 3L Alice
To remove all levels from all players: xp -2147483648L @a


历史[编辑]

正式版本
1.3.1 12w16a 增加作弊模式
12w24a 增加/publish命令
12w25a 局域网连接可以选择是否允许作弊
12w27a 增加/debug命令
1.4.2 12w32a 增加/difficuty/gamerule/spawnpoint/weather命令
12w37a 增加/clear命令
12w38a /clear命令可以指定移除特定的方块或物品
12w41a /xp的经验上限提高到2,147,483,647
1.4.4 1.4.4pre 增加/enchant命令
1.5 13w03a 增加命令方块独占的/testfor命令。
13w04a 增加计分板/scoreboard系列命令。
1.7.2 13w36a 增加/summon指令。
13w37a 增加/setblock/testforblock/tellraw指令。
13w43a 增加/setworldspawn指令。
1.8 14w02a 增加/blockdata指令。
14w03a 增加/fill/clone指令。
14w04a 增加/particle指令。
14w06a 增加/trigger指令。
14w07a 增加/execute/testforblocks指令。
14w19a 增加/worldborder指令。
14w20a 增加/title指令。
14w26a 增加/replaceitem指令。

引用[编辑]


另见[编辑]