命令

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

使用方法

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

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

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

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

• 在单人模式中，创造世界时允许作弊 (藉由"更多选项"按钮)
• 在 Minecraft 多人联机服务器游戏中，由管理员或命令方块使用
• 在其他的多人模式游戏中，由开启局域网并允许作弊的玩家，或主持多人联机服务器的玩家使用

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

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

如果在命令方块中执行测试类命令（例如/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: 旁观模式

在1.9中，可以使用以下值：

• s，survival: 生存模式
• c，creative: 创造模式
• a，adventure: 冒险模式
• sp，spectator: 旁观模式

通过数量选择目标

[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 格。如果最初的坐标已经使用 x 、 y 和 z 参数定义，则它会取代命令的执行位置，成为体积选择参数的计算位置。 (dx 、 dy 和 dz 仍然用来指定与坐标的距离；它们不是指定一个新的坐标)。

玩家可以结合通过半径和通过体积选择目标，此命令将会选择重叠的区块。 (从西北下角算起在一定的半径以内，且不超过定义的体积)。

通过垂直旋转选择目标

[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 世界存档中的资料结构是一样的。这些资料结构在另一篇有详细描述，而命令会要求数据标签要使用一样的属性名字 (区分大小写)：

资料结构规范连结

对象	举例
方块	箱子、熔炉、命令方块、刷怪蛋、告示牌...等等
物品	在物品栏中的物品 (包括附魔、自订名称...等等)
物品实体	在地上的物品
生物	爬行者、牛、村民...等等
弹射物	弓箭、火球、喷溅药水...等等
交通工具	船、矿车...等等
动态方块	引燃的 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]
Int Array	从 -2147483648 到 2147483647 的整数的序列，用逗号分离并用中括号包含。
Compound	属性值对的序列，用逗号分离并用大括号包含。 例子: {X:3,Y:64,Z:129} 每个数据标签的内容本身就是一种复合标签。

 字节数组类型无法用于命令。

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

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

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

原始 JSON 文本

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

分数与目标选择器会在告示牌被放置或修改时或在一本成书被“翻开”（书写后第一次打开）时解析成具体的值。它们在此之后不会更新，也不会在使用NBT编辑器修改已存在的木牌或已被标明翻开的书时起作用。在resolution中木牌无法换行，书不会转到下一页，而所有额外的文本都会消失。

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

• 基础聊天组成物件
  •  text：String (字串) 代表在聊天中直接出现的纯文字。注意像是"@a" 和 "@p" 的选择器并不会转译成玩家名字；必须使用 selector 代替。"\n" 是新的一行 (enter 键)。
  •  extra：外加物件的表单，使用和基础物件相同的格式。
    • 为使用和基础物件相同格式的表单元素 (递归的)。注意所有物件的性质都会被子物件所继承，除了 text 、 extra 、 translate 、 with 和 score。这表示子物件会保留和这个物件一样的格式和情况，除非子物件明确的覆盖原物件。
  •  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"：可以是纯字串，或是和这个基础物体的格式一样的物体。注意，clickEvent 和 hoverEvent 在提示工具中不会有效果，但是它的格式和 extra 标签仍然有作用。
      • "show_item"：像 NBT 标签的格式化的字串。包含 "id" 标签，和可选的 "Damage" 标签和 "tag" 标签 (和give指令所用的数据值和数据标签一样)。
      • "show_achievement"：这个成就或游戏数据的名字。它使用和成就、游戏数据记分板对象判据以及/achievement 命令一样的格式。
      • "show_entity"：一个像是复合体，包含字符串值 "type" (例如 "Zombie")、 "name" 和 "id" (应该要是实体 UUID，但实际上可以是任何字串)，的格式化字串。
  •  translate：使用玩家选择的语言来显示的翻译识别器。此识别器和 assets 档案夹或资源包里的 lang files 可以找到的识别器是一样的。翻译过的文字只会在 text 字串 未 被使用时显示。
  •  with：translate所使用的聊天组件参数列表和/或字串参数。
    • 该参数对应于在当前的语言中翻译字符串使用的参数文本,并依序排列(例如,列表中的第一个元素将被匹配翻译字串中的"%1$s")。
  •  score： 显示一个玩家在一个记分板目标里的分数。若该玩家没有被该记分板目标追踪，则什么都不显示。完全忽视可能存在的text或translate。
    •  name：要被显示分数的玩家的名字。选择器(例如@p)可被使用,除了被记分板系统创造的"假"玩家名。另外,如果名称为"*",它将会显示玩家自己的分数(例如, /tellraw @a {score：{name："*",objective："obj"}}将给每个在线玩家显示他们自己在"obj" 目标里的分数)。注意非玩家实体不会显示分数(例如@e[type=Cow]),即使该实体已在记分板目标里被给予了一个分数。
    •  objective： 要被显示玩家分数的记分板名。
    •  value：可选。如果存在,此值将被使用，无论该目标本身的分数是多少。
  •  selector：一串包含了一个选择器(@p,@a,@r,或@e)的字符串以及,可选的,选择器参数。不像text,选择器将会被译解为正确的玩家/实体名。如果多于一个玩家/实体被选择器发现了,其将会被以例如'名字1和名字2'或'名字1,名字2,名字3,和名字4'的形式显示。完全忽视可能存在的text,translate,或score。

由于extra的缘故，以上格式可递归地嵌套成非常复杂与多功能的文本串。然而，原始Json文本不必弄得如此复杂：几乎所有的属性都是可选或者丢弃的。

为了使Json有效，每一个Json文本至少应该有以下中的一个元素：text,translate,score或是 selector（其余的元素都是可选的）。为便于速记，整个对象也可以被用一个字串代替。在这个时候，这个字串将被视作text的值。例如，"This is raw text"和{text:"This is raw text"}是等价的。这种速记写法在任何需要使用原始Json文本的地方都是有效的（包括/tellraw里面所用到的<raw json message>参数，extra中的元素，和"show_text" hover_event中的值）。

/tellraw 也接受一个对象或字串的数组（array）；它们是连锁的。它甚至接受嵌套的数组树；并从最内层向外遍历。例如：

/tellraw @a ["Hello there, ",{selector:"@p"},"."]
/tellraw @a [[[["The "],[["quick ","brown "],[{selector:"@p"}," jumps "],"over "],"the "],["lazy ","dog."]]]

不像是其它使用 JSON 的命令, /tellraw 字串支持以 \u#### 形式表示的 Unicode, 其中 #### 是所需的十六进制的 Unicode 字符。

从版本1.9开始，Json语句书写的格式被标准化。元素名以及类型为string的值都需要使用引号将之包括，例如{text:"Good morning, ",extra:{selector:"@p"}}这样的格式在1.9后失效，取而代之的是{"text":"Good morning, ","extra":{"selector":"@p"}}。

外部链接

Skylinerw的 JSON 格式例子(英文)

JSON相关指令生成器(可选中文)

命令摘要

下表列出了所有可用命令，点击第一列的命令了解该命令的详情。

命令列表

命令	描述	仅限 OP	需求等级	仅限 MP	方块	实体	玩家	世界
/achievement	获得/移除玩家的成就。	Op	2	-	-	-	玩家	-
/ban	添加一个玩家到黑名单中。	Op	3	MP	-	-	玩家	-
/ban-ip	添加一个IP地址到黑名单中。	Op	3	MP	-	-	玩家	-
/banlist	显示黑名单。	Op	3	MP	-	-	玩家	-
/blockdata	修改一个方块的数据标签。	Op	2	-	方块	-	-	-
/clear	从玩家的物品栏清除物品。	Op	2	-	-	-	玩家	-
/clone	将方块从一个位置复制到另一位置。	Op	2	-	方块	-	-	-
/debug	开始或终止一个 debugging session。	Op	3	-	-	-	-	-
/defaultgamemode	设定默认的游戏模式。	Op	4	-	-	-	-	世界
/deop	撤销一位玩家的管理员身份。	Op	3	MP	-	-	玩家	-
/difficulty	设定难度。	Op	2	-	-	-	玩家	-
/effect	添加或移除状态效果。	Op	2	-	-	实体	玩家	-
/enchant	附魔一个玩家的物品。	Op	2	-	-	-	玩家	-
/entitydata	修改实体的数据标签。	Op	2	-	-	实体	-	-
/execute	执行另一条命令。	Op	2	-	-	-	-	-
/fill	用一种特定方块填充一块区域。	Op	2	-	方块	-	-	-
/gamemode	设定一位玩家的游戏模式。	Op	2	-	-	-	玩家	-
/gamerule	设定或查询一个游戏规则值。	Op	2	-	-	-	-	世界
/give	给予一位玩家一个物品。	Op	2	-	-	-	玩家	-
/help	提供命令的帮助。	-	0	-	-	-	-	-
/kick	将一位玩家踢出服务器。	Op	3	MP	-	-	玩家	-
/kill	杀死实体（玩家、生物、物品等）。	Op	2	-	-	实体	玩家	-
/list	列出在服务器上的玩家。	Op	0	MP	-	-	玩家	-
/me	显示一条关于你自己的信息。	-	0	-	-	-	玩家	-
/op	给予一位玩家管理员身份。	Op	3	MP	-	-	玩家	-
/pardon	从黑名单移除项目。	Op	3	MP	-	-	玩家	-
/particle	制造颗粒效果。	Op	2	-	-	-	玩家	-
/playsound	播放一个音效。	Op	2	-	-	-	玩家	-
/publish	对局域网开放单人世界。	Op	4	-	-	-	-	世界
/replaceitem	替换物品栏中的物品。	Op	2	-	方块	实体	玩家	-
/save-all	将服务器保存至硬盘中。	Op	4	MP	-	-	-	世界
/save-off	禁用服务器自动保存。	Op	4	MP	-	-	-	世界
/save-on	启用服务器自动保存。	Op	4	MP	-	-	-	世界
/say	向多名玩家显示一条信息。	Op	1	-	-	-	玩家	-
/scoreboard	管理对象、玩家和队伍。	Op	2	-	-	实体	玩家	-
/seed	显示世界种子。	Op	2	-	-	-	-	世界
/setblock	将一个方块变更至另一个方块。	Op	2	-	方块	-	-	-
/setidletimeout	设定踢出挂机玩家的时间。	Op	3	MP	-	-	玩家	-
/setworldspawn	设定出生点。	Op	2	-	-	-	-	世界
/spawnpoint	设定一位玩家的出生点。	Op	2	-	-	-	玩家	-
/spreadplayers	将实体传送至随机位置。	Op	2	-	-	实体	玩家	-
/stats	通过命令的返回改变记分板对象。	Op	2	-	方块	实体	玩家	-
/stop	停止服务器。	Op	4	MP	-	-	-	世界
/summon	生成一个实体。	Op	2	-	-	实体	-	-
/tell	向其他玩家显示一条私人信息。	-	0	-	-	-	玩家	-
/tellraw	向玩家显示一条JSON信息。	Op	2	-	-	-	玩家	-
/testfor	计算匹配特定条件的实体数。	Op	2	-	-	实体	玩家	-
/testforblock	探测一个方块是否在一个位置。	Op	2	-	方块	-	-	-
/testforblocks	探测两块区域内的方块是否匹配。	Op	2	-	方块	-	-	-
/time	改变或查询世界的游戏时间。	Op	2	-	-	-	-	世界
/title	管理屏幕标题。	Op	2	-	-	-	玩家	-
/toggledownfall	切换天气。	Op	2	-	-	-	-	世界
/tp	传送实体。	Op	2	-	-	实体	玩家	-
/trigger	设定触发装置的激活。	-	0	-	-	-	玩家	-
/weather	设定天气。	Op	2	-	-	-	-	世界
/whitelist	管理服务器白名单。	Op	3	MP	-	-	玩家	-
/worldborder	管理世界边界。	Op	2	-	-	-	-	世界
/xp	增加或移除玩家的经验值。	Op	2	-	-	-	玩家	-

命令列表

格式

若你看到…	那么
纯文本	如所示地，完全依其输入。
斜体	用一个适当的值替换此项。
<尖括号>	这是一项必需参数。
[方括号]	这是一项可选参数。
x|y	从给出的选项中选择一个。 可选项被垂直线隔开列出: |
ellipsis …	参数可能由多个被空格隔开的词组成。

成功条件

一条命令的成功条件必须被满足来使游戏认为命令"成功"。这被用于决定各种各样的事件,比如反馈自输入了一条命令的命令方块的一个红石比较器的输出。注意不是所有"成功"命令都实际上完成了些什么,而不是所有"失败"命令都没能做些有用的事。

限制

描述了能使用命令的人或情况的限制。

• 无: 命令能被任何玩家在任何世界中使用。下列命令没有限制: /help, /me, /tell,和/trigger。
• 管理员: 命令只能被一个管理员或在开启作弊的单人模式下使用。在多人服务器中,这些命令的结果会被播送至其他在线管理员。
• 多人: 命令仅在多人服务器上可用。下列命令被限制仅用于多人服务器: /ban, /ban-ip, /banlist, /deop, /kick, /list, /op, /pardon, /pardon-ip, /save-all, /save-off, /save-on, /setidletimeout, /stop, /whitelist。

多人命令的参数不能有目标选择器，且除了/list，多人命令不能在命令方块中使用。大多数命令能用于从未登入过服务器的玩家，甚至是没有在Minecraft 注册（或者不能注册）账号名字的玩家。

• 非命令方块: 命令不能被命令方块执行。

achievement

命令/infobox 给予一位玩家一项成就或提高统计数据。

格式

achievement <give|take> <stat_name|*> [玩家]

参数

stat_name

必须是以下中的:

• achievement.achievement_name，achievement_name是合法的成就标识符。
• stat.statistic_name， statistic_name 是合法的统计标识符。
• *代表所有的成就。

玩家 (可选)

必须为一个玩家名或目标选择器。若未指定,默认为命令执行者。在命令方块中为必需项。

结果

若参数指定不正确则失败, 或者玩家中的玩家不在线也会失败。

若成功,给予或移除玩家的特定成就（包括所有的前提成就）或是给玩家特定的统计数据增加/减少1。

例子

给予你自己"Overkill"成就: achievement give achievement.overkill

给予Alice"Taking Inventory"成就: achievement give achievement.openInventory Alice

要给最近的玩家的"Mob Kills"增加1: achievement give stat.mobKills @p

清除所有玩家的所有成就: achievement take * @a

另见

修改玩家的命令:

• /effect — 给予玩家一个状态效果
• /spawnpoint — 设定玩家的生成位置
• /xp — 更改玩家的经验值或等级

ban

这些命令管理着服务器的封禁列表。封禁列表包含的是不允许连接服务器的玩家或IP地址。封禁会在适当的时候取代任何白名单。

参见：/whitelist

ban

命令/infobox 将玩家列入封禁名单。

格式

ban <名字> [原因 …]

参数

名字

被封禁的玩家名字。不需要玩家在线，甚至不需要真的存在这个玩家。

原因 (可选)

随着封禁显示的文字，呈献给其他管理员并记入服务器日志。

结果

总是成功。 玩家的名字将列入服务器的封禁名单，阻止任何使用这个名字的玩家连接服务器。

ban-ip

命令/infobox 将IP地址加入封禁列表

格式

ban-ip <address|name> [原因 …]

参数

address|name

必须为一个玩家名或一个IP地址。

原因 (可选)

随着封禁显示的文字，呈献给其他管理员并记入服务器日志。

结果

若address|name的IP无效或指定玩家不在线则失败。

若成功, IP地址（在线玩家的，或是指定的）将加入服务器的封禁列表， 阻止任何来自这个IP的玩家连接服务器。

banlist

命令/infobox 显示封禁列表。

格式

banlist ips

banlist players

结果

总是成功。 显示被封禁的IP与被封禁的玩家。

blockdata

命令/infobox 修改方块的数据标签。

格式

blockdata <x> <y> <z> <dataTag>

参数

x y z

指定要修改的方块的坐标。可以使用波浪号代表与命令执行处的相对坐标。

dataTag

指定方块要被加入或覆盖的数据标签。必须是NBT格式组（例如，{CustomName:Fred}）。

结果

若参数指定不正确则失败。

若成功, 修改目标方块的数据标签。

例子

将位于(0,64,0)的信标的初始效果改为急迫：

blockdata 0 64 0 {Primary:3}

另见

• 实体格式 — 所有方块的数据标签
• /entitydata — 改变实体的数据标签
• /replaceitem — 替换物品到方块的物品栏
• /setblock – 在一个位置放置一个新方块
• /stats — 设置方块的CommandStats

clear

命令/infobox 清除玩家的物品栏。

格式

clear [玩家] [物品] [数据] [最大数量] [数据标签]

参数

玩家 (可选)

必须为一个玩家名或一个目标选择器。若未指定,默认为命令使用者。在命令方块中为必需项。

物品 数据(可选)

指定要被清除的物品的ID和数据。如果没有指定，就清除物品栏中所有的物品。如果物品已被指定，但没有数据，有着该物品ID的物品都会被清除，不论数据如何。数据可以设置为 -1 来忽略此项并清除某种指定了 最大数量或数据标签的物品。

最大数量 (可选)

指定物品被清除的最大数量。若未指定或为-1，清除所有物品。若为0，不清除物品，但有物品可供清除时返回成功。 (用于检测物品的同时不清除物品)。

数据标签 (可选)

指定要被清除物品的数据标签(匹配指定数据标签的物品才会被清除 — 其它的物品不会被清除). 必须是NBT格式组 (例如， {display:{Name:Fred}})。

结果

若参数指定不正确，或玩家中的玩家不在线，或没有物品被清除则失败。

若成功,移除玩家的特定物品。

例子

清除所有物品: clear

清除Alice的所有物品: clear Alice

清除Alice身上的所有羊毛（无视颜色）: clear Alice minecraft:wool

清除所有玩家的橙色羊毛（仅限橙色）: clear @a minecraft:wool 1

清除离你最近的玩家身上带有“锋利I”的金剑（无视这把剑的耐久）:

clear @p minecraft:golden_sword -1 -1 {ench:[{id:16s,lvl:1s}]}

另见

/give — 给予玩家物品

clone

命令/infobox 将方块从一个区域复制至另一个区域。

格式

clone <x1> <y1> <z1> <x2> <y2> <z2> <x> <y> <z> [遮罩模式] [复制模式] [TileName]

游戏中的帮助不会列出最后一项参数。TileName是为可选项留下的占位符

参数

x1 y1 z1和x2 y2 z2

指定被复制区域（“源区域”）的任意两对角。可以使用波浪号 来指定一段相对于命令执行位置的距离。

构成角的方块在它们坐标的正方向上延伸。因此，各轴上较小的坐标将会正好符合区域边界，但较大的坐标将会超过边界一个方块，源区域的方块体积是(x_最大 - x_最小 + 1) × (y_最大 - y_最小 + 1) × (z_最大 - z_最小 + 1)。例如， 0 0 0 0 0 0 占一个方块体积， 而 0 0 0 1 1 1与1 1 1 0 0 0都占同一个8体积的源区域。

x y z

指定克隆区域（“目标区域”）的下西北角（即，各轴的最小坐标）。可以使用波浪号来指定一段相对于命令执行位置的距离。

遮罩模式 (可选)

必须是其中之一：

• filtered — 仅复制拥有特定方块ID的方块（见下文的TileName）。
• masked — 仅复制非空气方块。否则目标区域内的方块将会被源区域内的空气方块覆盖。
• replace — 复制所有方块,用源区域的方块覆盖目标区域的“所有”方块。

若未指定，默认为replace.

复制模式 (可选)

必须是其中之一：

• force — 强制复制，甚至当源区域与目标区域重叠时。
• move — 复制源区域至目标区域，然后将源区域替换为空气。当在遮罩模式filtered下使用时，仅被复制的方块会被空气替换。
• normal — 非move或force。 当需要指定“TileName”时使用。

若未指定，默认为normal.

TileName (可选)

指定使用遮罩模式filtered时复制的方块ID(例如, minecraft:stone)。当使用遮罩模式filtered时必选。

结果

若参数指定不正确，或源区域方块体积大小超过32768时（足够8个区块大小），或源区域与目标区域重叠（除非使用force复制模式）， 或源区域或目标区域没有处于加载状态，则失败。

若成功，在目标区域填充源区域的方块，源区域不改变(除非使用克隆模式move)。

另见

/fill — 用一种方块填充一个区域

debug

命令/infobox 开始或停止一个调试会话。

格式

debug <start|stop>

参数

start

开始一个新的调试分析会话。

stop

停止这个调试分析会话。

结果

若当一个调试会话活动时尝试开始一个调试会话，或当没有调试会话运行时尝试停止一个调试会话，则失败。

若成功，开始或停止这个调试会话。 当启动时，控制台中会包含对性能瓶颈的通知。在停止时, 会创建一个结果档案文件在“debug”文件夹中。

defaultgamemode

命令/infobox 设置新玩家在服务器默认的游戏模式 （创造模式，生存模式，等等）。

格式

defaultgamemode <模式>

参数

模式

必须为其中之一：

• survival (可简写为s或0)为生存模式
• creative (可简写为c或1)为创造模式
• adventure (可简写为a或2)为冒险模式
• spectator (可简写为sp或3)为旁观模式

“极限模式”不是一个有效的模式参数选项，因其技术上不是一个游戏模式。

结果

若参数指定不正确则失败。

若成功，设置默认的游戏模式，并显示在世界选择菜单中，加入世界的新玩家将会被置于默认的游戏模式。

例子

设定默认游戏模式为生存: defaultgamemode survival, defaultgamemode s,或defaultgamemode 0

另见

/gamemode – 更改一位玩家的游戏模式

deop

命令/infobox 撤销一位玩家的管理员身份。

格式

deop <玩家>

参数

玩家

指定一个玩家从管理员列表中移除。 可以是任何参数但目标选择器没什么用，只有确定的玩家才能会有有意义的结果。

满足参数条件则总会成功。 若玩家匹配管理员列表上的一个名字,从列表移除该名字而任何该名字的玩家都不再拥有管理员身份。

例子

将Alice从管理员列表中移除: deop Alice

difficulty

命令/infobox 设定难度等级(和平,简单,等。)。

格式

difficulty <新难度>

参数

新难度

必须为其中之一：

• peaceful (可被简写为p或0)为和平难度
• easy (可被简写为e或1)为简单难度
• normal (可被简写为n或2)为普通难度
• hard (可被简写为h或3)为困难难度

"极限模式"不是一个有效的新难度参数选项,因其不是一个难度。

结果

若参数指定不正确则失败。

若成功,更改游戏的难度。在多人服务器中难度保持到服务器重启——重启后将从server.properties读取难度。

例子

更改难度为困难: difficulty hard, difficulty h,或difficulty 3

另见

/gamemode – 更改一位玩家的游戏模式(创造,生存,等。)

effect

命令/infobox 命令effect管理玩家及其它实体上的状态效果。

格式

effect <玩家> clear（移除所有效果）

effect <玩家> <效果> [秒数] [倍率] [隐藏粒子] (给予一种效果)

参数

玩家

指定目标(们)。必须是一位玩家的名字或目标选择器（@e 允许选择玩家外其他实体目标）

效果

指定给予的效果。必须是一个状态效果ID（例如，1或minecraft:speed）。

秒数 (可选)

以秒为单位指定效果时长。必须在0至1000000(包含)间。若未指定，默认为30秒。

倍率 (可选)

指定给效果的级别的数字。必须在0至255(包含)间。若未指定，默认为0。

隐藏粒子 (可选)

指定是否隐藏状态效果的粒子。必须为true或false。若未指定，默认为false。

结果

若参数指定不正确，或当玩家 不是有效实体（有名字的玩家必须在线），或当秒数被指定为0而目标没有该效果时，或当在clear模式下没有效果被移除时失败。

若成功:

• clear — 从目标(们)身上清除所有状态效果。
• 效果 — 给目标(们)添加状态效果。如果一个目标已经拥有该状态效果,同等级的新状态效果仅在拥有更长的持续时覆写旧的持续时间,但更高等级的新状态效果将会覆写之前的持续时间。如果秒数设为0,会取消特定效果作为代替。

例子

给予最近的玩家一个60秒的速度1效果: effect @p 1 60

给予最近的玩家一个60秒的速度3效果: effect @p 1 60 2

从所有玩家身上清除任何急迫效果: effect @a 3 0

清除所有僵尸身上的所有效果: effect @e[type=Zombie] clear

enchant

命令/infobox 给一位玩家选中的物品添加附魔。

格式

enchant <玩家> <附魔ID> [等级]

参数

玩家

指定目标（们）。必须是一个玩家名或目标选择器。

附魔ID

指定添加至玩家手持物品的附魔。必须是一个有效的附魔ID（例如, 16或minecraft:sharpness）。

等级 (可选)

指定附魔等级。必须至少为1且不大于特定附魔的最大等级。若未指定,默认为1。指定为0可取消对应的附魔效果。

结果

若参数指定不正确，或当玩家中的玩家不在线时，或当附魔对物品不可用或与现有附魔冲突时则失败(例如，"火焰保护"无法给予已附魔"保护"的盔甲，而"锋利III"无法给予已附魔"锋利I"的剑)。

若成功,添加指定的附魔至目标的手持物品。

例子

给所有手持弓的玩家附魔无限: enchant @a 51

entitydata

命令/infobox 修改实体的数据标签。

格式

entitydata <实体> <数据标签>

参数

实体

指定修改的实体。必须是实体的UUID或@e目标选择器。

数据标签

指定实体要被加入或覆盖的数据标签必须是NBT格式组（例如, {CustomName:"Fred"}）。

结果

若参数指定不正确，或没有符合实体的非玩家实体则失败。（玩家不可修改。）

若成功修改目标实体的数据标签。

例子

阻止所有现有僵尸捡拾物品:

entitydata @e[type=Zombie] {CanPickUpLoot:0}

execute

命令/infobox 让别的玩家在别的位置执行一条命令。

格式

execute <实体> <x> <y> <z> <命令 …>

一个替换格式可以让某个方块被检测到时才执行命令：

execute <实体> <x> <y> <z> detect <x2> <y2> <z2> <方块> <数据> <命令 …>

参数

实体

指定目标命令执行者。 必须为一个玩家名或目标选择器。

x y z

指定命令运行的位置。 x 和z必须在-30,000,000到30,000,000内 （包括）。可使用目标选择器 来指定与目标的相对坐标。

命令

指定要运行的命令必须为一个有效命令。

x2 y2 z2 （仅在detect模式可用）

指定要检测方块的位置。 x2和z2 必须在-30,000,000到30,000,000内 （包括）。可使用波浪号 来指定与目标的相对坐标。

方块和数据 (仅在detect模式可用)

指定方块ID和数据，用于与(x2,y2,z2)的方块匹配来使命令运行。方块必须是有效的方块ID（例如，minecraft:stone），且数据 必须是适应方块的有效数据或填写-1 来匹配所有方块数据。

结果

若参数指定不正确，或实体不是有效实体（有名字的玩家必须在线），或检测到的方块与数据与命令不匹配，或预设的命令执行失败则失败。

若成功，让命令以目标的身份执行，且无视管理员权限限制。

例子

在每个僵尸的位置生成闪电:

execute @e[type=Zombie] ~ ~ ~ summon LightningBolt

在每个站在任意种类沙子上的僵尸的位置生成闪电:

execute @e[type=Zombie] ~ ~ ~ detect ~ ~-1 ~ minecraft:sand -1 summon LightningBolt

另见

/testforblock — 检测一个特定位置的某个方块（包括指定的数据标签）

fill

命令/infobox 用特定方块全部或部分填充一个区域。

格式

fill <x1> <y1> <z1> <x2> <y2> <z2> <方块名> [数据值] [旧方块处理方式] [数据标签]

当使用replace选项时，fill命令同样有一个可选的替代格式：

fill <x1> <y1> <z1> <x2> <y2> <z2> <方块名> <数据值> replace [替换方块名] [替换数据值]

参数

x1 y1 z1 and x2 y2 z2

指定将被填充的区域("填充区域")的任意两对角方块。

方块名

指定用于填充该区域的方块。必须为一个方塊ID(例如,minecraft:stone)。

数据值(可选)

指定用于填充方块的方块数据。必须在0到15间(包含)。

旧方块处理方式(可选)

必须为其中之一:

• destroy -用指定方块替换填充区域内所有方块(包括空气),以实体掉落被替换的方块及方块内容物就像它们被采掘了。
• hollow -仅用指定方块替换填充区域外层的方块。内部方块被改变为空气,以实体掉落它们的内容物但本身不掉落。
• keep -仅用指定方块替换填充区域内的空气方块。
• outline -仅用指定方块替换填充区域外层的方块。内部方块不被影响。
• replace -用指定方块替换填充区域内所有方块(包括空气),而不以实体掉落方块或方块内容物。可选的, instead of specifying a data tag for the replacing block, 方块id和数据值可被指定来限制哪些方块被替换(见下替换方块名和替换数据值)

若未指定,默认为replace。

数据标签(可选)

指定用于填充方块的数据标签(例如,一个箱子的内容物,一面旗帜上的图案,等)。必须为一個NBT格式組(例如, {CustomName:Fred})。不能与替换方块名和替换数据值参数合并。

替换方块名 替换数据值(可选)

仅当旧方块处理方式为replace时可用的参数。不能与数据标签参数合并。

指定填充区域内被替换的方块的数据值。若替换数据值未被指定,决定替换哪些方块时数据值将被忽视。若两参数均未被指定,替换填充区域内所有方块。

结果

若参数指定不正确,若填充区域未被载入,若填充区域的方块体积大于32768,若指定方块ID的数据值或数据标签是不可用的,或若没有方块被改变则失败。

若成功,将填充区域内的方块更改为特定方块。

gamemode

命令/infobox 设定一个玩家的游戏模式。

格式

gamemode <模式> [玩家]

参数

模式

必须为其中之一:

• survival (可简写为s或0)为生存模式
• creative (可简写为c或1)为创造模式
• adventure (可简写为a或2)为冒险模式
• spectator (可简写为sp或3)为旁观模式

"极限模式"不是一个有效的模式参数选项,因其技术上不是一个游戏模式。

玩家 (可选)

若指定,必须是一位玩家的用户名或一个目标选择器。若未指定,默认为使用命令的玩家。当在命令方块中使用,玩家为必需项。

结果

若参数指定不正确，或玩家中的玩家不在线则失败。

若成功,更改默认的或指定的玩家游戏模式。

例子

使你进入创造模式: gamemode creative, gamemode c,或gamemode 1

使所有玩家进入生存模式: gamemode 0 @a

另见

defaultgamemode – 设定加入世界玩家的初始游戏模式

gamerule

命令/infobox 设置或查询一条游戏规则的值。

格式

gamerule <规则> [值]

参数

规则

指定了要设置或查询的游戏规则。可为任何值,但只有某些预设的游戏规则会影响游戏玩法(见下预设游戏规则)。

值 (可选)

指定将游戏规则设置的值。可为任何值,但只有true或false指定预设的游戏规则会真正影响游戏玩法，除了randomTickSpeed的情况下，任何0或以上的数字将会影响游戏玩法(见下预设游戏规则)。

预设游戏规则

规则名	描述	默认值
commandBlockOutput	命令执行时是否在控制台进行文本提示	true
disableElytraMovementCheck	是否让服务器停止检查当玩家使用鞘翅时是否作弊（移动太快）	false
doDaylightCycle	时间是否运动	true
doEntityDrops	非生物实体是否掉落物品	true
doFireTick	火是否传播及自然熄灭	true
doMobLoot	生物是否掉落物品	true
doMobSpawning	生物是否自然生成	true
doTileDrops	方块被破坏时是否掉落物品（包括TNT破坏的）	true
keepInventory	玩家死亡后是否对物品栏和经验进行保存	false
logAdminCommands	是否在服务器日志中记录管理员使用过的命令日志	true
mobGriefing	爬行者，僵尸，末影人，恶魂，凋灵，兔子，羊，及村民是否能改变、破坏方块及村民，僵尸，骷髅，及僵尸猪人是否能捡拾物品。	true
naturalRegeneration	玩家是否能在饥饿值足够时自然恢复生命值（不影响治疗）	true
randomTickSpeed	多少刻发生随机方块（例如植物生长，树叶腐烂等）一个区块游戏刻为0将禁用随机方块，较高的数字将增加随机方块数。	3
reducedDebugInfo	调试画面显示所有或简化的信息	false
sendCommandFeedback	对话框是否会显示被一个玩家执行一些特殊命令的提示。也影响命令方块是否保存它们输出文本的默认行为。	true
showDeathMessages	玩家死亡时是否会在聊天框有提示	true
spawnRadius	控制玩家能在距离世界出生点多远的位置重生	10
spectatorsGenerateChunks	是否禁止旁观者模式的玩家生成区块	true

结果

当规则名未被定义及值未被提供(例如,尝试询问一条未定义的游戏规则)时失败。

成功时,返回游戏规则的值(若值未被提供)或将游戏规则设为指定的值(若值被提供)。

可定义新游戏规则及设值(通过给出一个值)或查询(通过不给出一个值)。

例子

停止日夜交替: gamerule doDaylightCycle false

停止自然恢复: gamerule naturalRegeneration false

定义一条叫MyNewRule的新游戏规则并将其值设为10: gamerule MyNewRule 10

give

命令/infobox 给一位玩家一种物品。

格式

give <玩家> <物品> [数量] [数据] [数据标签]

参数

玩家

指定给予物品的目标。必须为一个玩家名或目标选择器。

物品

指定给予的物品。必须为一个可用的物品ID (例如, 256或minecraft:iron_shovel),或为一个可用的方块ID。

数量 (可选)

指定给予的物品数量。必须在1及64间(包含)。若未指定,默认为1。

数据 (可选)

指定所给予物品的物品数据。必须为一个介于-2,147,483,648和2,147,483,647之间的整数（包含这两个数，不含逗号），但是当数据值对于指定的物品ID无效时，数据值默认为0。

数据标签 (可选)

指定给予物品的数据标签。必须是NBT格式组(例如，{display:{Name:Fred}})。

结果

若参数指定不正确则失败, 或者因为玩家不在线则失败。

若成功, 那么就在目标的位置生成特定的物品。如果player指定了多个目标，每个目标都会收到指定数量的物品。 如果物品的Owner 标签被设置成为特定的目标并且PickupDaily标签被设置成为0那么这个物品会被立即拾起，并且只能被指定的目标拾起(如果他的背包中有空间的话)。

例子

生成30个云杉木板并给予John,物品附加描述"Wooden planks":

give John minecraft:planks 30 1 {display:{Lore:["Wooden planks"]}}

另见

/summon — 在任意位置生成任何实体

help

命令/infobox 提供命令的帮助。

格式

help [页数|命令名]

? [页数|命令名]

参数

页数|命令名 (可选)

指定命令列表的页数或提供帮助的命令。若未指定,默认为1(命令列表的第一页)。

结果

若页数不是一个可用页数则失败,或当命令名不是一个可用命令名。甚至当指定一个可用的命令名时技术上是失败的,虽然它显示了该命令的用法。

若成功,显示命令列表的一页。多人命令不会在单人模式下显示, even when open to LAN players.

若指定了一个可用的命令名,显示该命令的用法。 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 (默认为Tab ↹键) to explore 每个参数的可用选项。

例子

显示命令列表的第一页: ?或help

显示命令列表的第三页: ? 3

显示命令help的用法: help help

kick

命令/infobox 将一位玩家踢出一个服务器。

格式

kick <玩家> [原因…]

描述

自服务器强制断开玩家的连接,向他们显示一条可选的原因。

成功条件

玩家必须在线。

kill

命令/infobox 杀死实体(玩家，生物，物品等)。

格式

kill [玩家|实体]

参数

玩家|实体

指定要杀死的目标(包括“非生物”实体例如物品，交通工具等)。必须为一个玩家名或一个目标选择器。若未指定，默认为命令使用者。在1.8之前不能在命令方块中使用。

如果玩家或实体不存在则命令执行失败（如果是玩家名则必须在线）。

如果命令执行成功，则对实体造成3.4×10³⁸的虚空伤害。 即便是创造模式的玩家或生物也会被直接杀死并掉落物品，不是最小尺寸的史莱姆和岩浆怪则会分裂成更小尺寸。 如果目标是其他实体（如船，矿车，掉落物，经验球等）则将被直接清除。

例子

杀死你自己: kill

杀死Bob: kill Bob

清除所有掉落物: kill @e[type=Item]

list

命令/infobox 列出在服务器上的玩家。

格式

list

描述

显示所有当前连接的玩家的名字(可以同样通过按下Tab ↹来实现,但通过指令可以获得更多相关信息,例如玩家的状态)

成功条件

永远成功,甚至在命令方块中。

me

命令/infobox 显示一条关于你自己的信息。

格式

me <动作…>

描述

以"*你的名字 动作"(例,"*Alice打喷嚏。"或"*Alice爆炸了。")的格式发送一条叙述信息给其他玩家。若一个多人的目标选择器 (例如,@a)在动作中被使用, 名单被格式化为“名字1名字2,和名字3”,或“名字和名字2”两个名字 。因此,无论任何目标选择器在动作中被使用,此命令仅会输出一次。

成功条件

所有目标选择器 (例如,@p) in 动作 must evaluate.

op

命令/infobox 给予一位玩家管理员身份。

格式

op <玩家>

描述

在服务器上给予玩家管理员身份。

成功条件

永远成功。

pardon

命令/infobox 从黑名单上移除项目。

格式

pardon <名字>

pardon-ip <地址>

参数

名字

指定自黑名单移除的名字。

地址

指定自黑名单移除的IP地址。必须为一个可用的IP地址。

结果

当参数未正确指定时失败。

成功时,若该名字或该IP地址在黑名单上,它会被移除,允许任何人使用该名字或从该IP地址连接至服务器。

particle

命令/infobox 创造粒子。

格式

particle <名字> <x> <y> <z> <xd> <yd> <zd> <速度> [数量] [模式]

参数

名字

指定创造的粒子。必须为一个粒子名称(例如, explode)。

x y z

指定创造粒子的位置。所有值(包括y)必须在-30,000,000和30,000,000(不包含±30,000,000)之间。可使用tilde notation来指定一个相对于命令执行处的位置。

xd yd zd

指定在其中生成粒子的区域的尺寸。

例外: 当名字是reddust,mobSpell,或mobSpellAmbient而数量为0或未指定,指定粒子的颜色 in RGB format offset from 粒子的默认颜色(reddust的默认是一个近红色(a random red tint 在0.8至1.0间),而其它的则默认为黑色)。例如, with reddust, 0 0 0产生一个红色粒子,-1 1 0产生一个绿色粒子(红被减少至0而绿增加至1),0 0 1产生一个紫色粒子(蓝被添加至了原本的红色),等。 With mobSpell或mobSpellAmbient,0 0 0产生一个黑色粒子,0 1 0 产生一个绿色粒子,0 0 0.5产生一个深蓝色粒子,等。若数量大于0,颜色将是随机的。

速度

指定粒子的速度。必须至少为0。

数量(可选)

指定创造的粒子效果的数量。必须至少为0(至少产生一个粒子)。

模式(可选)

指定显示模式。可为 anything 但仅force会拥有一个效果:允许粒子在通常的16方块半径外被看见。

结果

当参数未正确指定时失败。

成功时,创造指定粒子。

例子

创造一个硬化的巨大经验粒子于东10方块：

particle hugeexplosion ~10 ~ ~ 0 0 0 0

playsound

命令/infobox 播放一段声音。

格式

playsound <声音> <玩家> [x] [y] [z] [音量] [音调] [最小音量]

参数

声音

指定播放的声音。必须为在sounds.json中被定义的一个声音项目(例如,mob.pig.say)。

一个声音项目可被多个声音关联,而被实际产生的声音会从它们中随机挑选, 被选中概率由其权重决定,就像游戏通常那样。例如,声音项目mob.pig.say会随机播放多个猪音效之一,因为有多个声音关联于该项目。

资源包可能向sounds.json添加它们自己的项目;该命令会被成功播放。该命令使用的声音名称不是文件名;而是严格使用于sounds.json内定义的项目(该名称可能与实际音频文件的文件名和目录相差甚远),而因此一个资源包在添加新声音时必须为这些音频文件定义声音事件项 (但当资源包替换原有的已经被相关事件定义过的音频文件时，不必重新定义声音时间).

玩家

指定声音的目标。必须为一个玩家名或一个目标选择器。

x y z(可选)

指定播放声音的位置。可用tilde notation来指定一个相对于目标(们)的位置。

音量(可选)

指定声音能被听见的距离。必须至少为0.0。对小于1.0的值,声音会较轻而拥有一个较小的,在其中能被听见的球体范围。对大于1.0的值,声音不会实际上增大,但其可闻范围(1.0时有一个16方块的半径)会被音量相乘。声音总会基于与球体中心的距离逐渐衰减至无声。

音调(可选)

指定声音的音调。必须在0.0至2.0间(包含),而小于0.5的值与0.5等价。小于1.0的值降低音调而提升持续时间;大于1.0的值提升音调而降低持续时间。音调的值是乘在音频频率前的系数, 所以当0.5-1.0(包含)的音调值被翻倍时，所得的新音调将高一个八度。 (如果您是一位音乐家，希望将其他音符转换为音调数值，请参阅 Note block#Usage。 但请注意1.0的音调值并不一定对于每个音效都是F♯ )若未指定,默认为1.0。

最小音量(可选)

指定在声音的通常可闻球体范围外的目标们听到的音量。若一个目标在通常的球体范围外,作为替代,声源会被放置在距离目标较近的位置(少于四个方块远),而minimumVolume会决定它的音量。必须在0.0至1.0间(包含)。

结果

当参数未正确指定,当指定的玩家名无法解析到一个或多个在线玩家时,或当目标们无法从声音被播放处听到其则失败。

成功时,为目标玩家们播放一段声音。

publish

命令/infobox 对局域网开放单人游戏世界。

格式

publish

描述

为你的LAN朋友们的加入开放你的单人游戏。该命令出现在单人作弊命令中。

成功条件

无法在一个命令方块中被使用。

replaceitem

命令/infobox 用给出的物品替换方块(箱子,熔炉,等)或实体(玩家们或生物们)物品栏内的物品。

格式

replaceitem block <x> <y> <z> <格数> <物品> [数量] [数据] [数据标签]

replaceitem entity <选择器> <格数> <物品> [数量] [数据] [数据标签]

参数

x y z (仅block模式)

指定要改变的方块的位置。可用tilde notation来指定一个相对于命令执行处的位置。

选择器 (仅entity模式)

指定要改变的实体。必须为一个玩家名或目标选择器。

格数

指定要改变的物品栏格数。可用的值取决于一个方块或一个实体是否被改变。

对于方块,必须为slot.container.格数,格数被一个指定格子的数字代替。

• 箱子,发射器,投掷器,漏斗,及陷阱箱左上角的格被编号为0而后先水平增长,再是垂直的(因此,例如,一个箱子的最上一行格子被从左至右编号为0至8)。双重箱子与双重陷阱箱被当做两个单独的容器方块。
• 一个酿造台的底部格被从左至右编号为0至2,而其顶部格为3。
• 一个熔炉的格子中输入格被编号为0,燃料格为1,而输出格为2。

其它能容纳物品但不拥有物品栏GUI的方块(花盆与唱片机)仅能被/blockdata改变。

对于实体,必须为下列之一,格数被一个指定格子的数字代替:

格子	格数	限制
slot.armor.chest		仅盔甲架,生物们,及玩家们(虽然不是所有生物会显出或使用物品)
slot.armor.feet
slot.armor.head
slot.armor.legs
slot.weapon		仅盔甲架与生物们(虽然不是所有生物会显出或使用物品)
slot.enderchest.格数	0 to 26	仅玩家们
slot.hotbar.格数	0 to 8
slot.inventory.格数	0 to 26
slot.horse.saddle		仅马,驴,及骡; 物品必须为一个鞍
slot.horse.armor		仅马; 物品必须为一种马铠
slot.horse.chest.格数	2 to 16	仅有箱子的驴与骡
slot.villager.格数	0 to 7	仅村民们

一个物品展示框的物品栏仅能被用/entitydata改变。

物品

指定被放置于方块或实体的物品栏格内的物品。必须为一个item id,或一个block id for which an item exists (例如, minecraft:golden_sword)。

数量(可选)

为被放置于方块或实体的物品栏格内的物品指定数量。必须在1至64间(包含), even for items with a smaller stack size.

数据(可选)

为被放置于方块或实体的物品栏格内的物品指定物品数据。必须为一个在-2,147,483,648至2,147,483,647间(包含,去除逗号)的整数,但 values which are invalid for the specified 物品id会默认为0。若未指定,默认为0.

数据标签(可选)

为被放置于方块或实体的物品栏格内的物品指定data tag。必须为一个 compound NBT tag (例如, {display:{Name:Fred}})。

结果

当参数指定不正确时,当指定方块不是一个容器时,当选择器 fails to resolve to one or more entities (named players must be online),或当目标实体没有 the specified slot 时(例如,僵尸没有slot.horse.armor)失败。

成功时,用特定物品替换特定格内的物品(失去格内之前的物品)。

例子

用四棵云杉树苗替换上方一个方块的一个单箱子右下格内的物品:

replaceitem block ~ ~1 ~ slot.container.26 minecraft:sapling 4 1

用四棵云杉树苗替换最近的玩家的快捷栏最右格内的物品:

replaceitem entity @p slot.hotbar.8 minecraft:sapling 4 1

另见

/blockdata —也能替换一个容器中的物品

/entitydata —也能替换一个生物物品栏中的物品,或改变盔甲与武器的掉落率

/give —给予玩家们物品而不指定特定物品栏格子或复写其它物品

save

命令/infobox 这些命令管理服务器的保存。

save-all

将服务器保存至硬盘。

格式

save-all

描述

强制服务器将未处理的对世界变更与玩家数据保存至硬盘。

成功条件

总是成功。

save-off

禁用自动的服务器保存。

格式

save-off

描述

禁用服务器编写世界文件。所有的变更将会暂时 be queued.

成功条件

总是成功。

save-on

启用自动的服务器保存。

格式

save-on

描述

启用服务器编写世界文件。这是默认行为。

成功条件

总是成功。

say

命令/infobox 向多个玩家发送信息。

格式

say <message …>

描述

向所有在线玩家播送message。若使用了多人的target selector(例如,@a),名单格式为"名字1,名字2,和名字3",两个名字时为"名字1和名字2"。因此,无论使用了何种目标选择器,此命令仅会输出一次。

成功条件

所有信息里的目标选择器(例如, @p)evaluate。

scoreboard

命令/infobox 这些命令管理记分板的objectives, players,和teams。

格式

scoreboard <objectives|players|teams> …

更多资料见记分板#命令列表。

seed

命令/infobox 显示世界种子。

格式

seed

描述

显示种子。此命令总是能在单人游戏中使用,无论作弊是否被启用。

成功条件

总是成功(若使用者是一个命令方块,单人游戏的玩家,或服务器管理员)。

setblock

命令/infobox 将一个方块更改为另一个方块。

格式

setblock <x> <y> <z> <方块名> [数据值] [旧方块处理方式] [数据标签]

参数

x y z

指定要更改的方块坐标。可使用波浪线(~)来指定一个相对于命令执行处的位置。

方块名

指定新的方块。必须为一个方块ID(例如, minecraft:stone)。

数据值(可选)

指定新方块的附加数据。必须在0到15之间(包括)。如果没有指定,默认为0.

旧方块处理方式(可选)

指定任何处理方块变化。必须为其中之一:

• destroy —旧方块掉落本身与其内容物(如同被一个玩家破坏)，播放方块碎裂的声音。
• keep —只有空气方块会被改变(非空气方块将被"保存")。
• replace —旧方块不掉落本身与其内容物，没有声音。

如果没有指定"旧方块处理方式",默认为replace.

数据标签(可选)

指定新方块的数据标签。必须是一个NBT格式组(例如,{CustomName:Fred})。

结果

若没有正确指定参数，或当使用 keep 模式时尝试去更换一个非空气方块， 或使用keep或replace模式时新方块和旧方块一样，则失败。

若成功，则在指定的位置更改方块。

另见

• /blockdata — 修改一个方块的数据值
• /clone — 将一个区域的方块复制到另一区域
• /fill — 用方块填充一块区域

setidletimeout

命令/infobox 设置t出空闲不动玩家的时间.

格式

setidletimeout <x(数字,移除挂机玩家的时间,单位:分钟)>

参数

设置空闲玩家移出时间,当玩家x分钟不动后会被t出游戏.

结果

100%成功率.

setworldspawn

命令/infobox 设置世界出生点。

格式

setworldspawn

setworldspawn <x> <y> <z>

参数

x y z (坐标)

指定玩家的出生点. x轴和z轴必须要要在-30,000,000 到 30,000,000(包括两值). y轴必须设置在0和256之间(包括两值)。可以使用波浪号 来指定相对坐标。如果没有指定坐标，就预设为命令执行的地方。在命令方块里必须填写

如果服务器不是在冒险模式,玩家会出生在(x,z)附近的最高的方块上— y会被无视。如果服务器是在冒险模式，那么新的出生坐标直接就是设置的坐标，包括y坐标(就算y坐标是在地下或者那里根本没有方块) -- 如果y的层数并没有空间给玩家出生，那么生成点将会向上移动直到那里有空间给玩家出生(最多移动到y=256)

虽然出生区块一般都是会一直被加载，然而新的出生区块需要等待玩家走到其附近才会开始加载。指南针(在Minecraft里指向生成点而不是指向北方)也不会马上更新直至世界被重新加载

结果

成功时，把出生点设置到指定的坐标。

若没有正确指定参数，则失败。

spawnpoint

命令/infobox 为特定玩家设置出生点。

格式

spawnpoint

spawnpoint <玩家>

spawnpoint <玩家> <x> <y> <z>

参数

玩家 (可选)

指定哪个玩家的出生点会被更改。必须是一个玩家名或者是目标选择器。如果没有指明，预设是执行命令的玩家。在命令方块里必须填写

x y z (可选)

指定玩家新的出生点的坐标。 x 和 z必须是整数并且在-30,000,000 至 30,000,000。 y 必须是一个在0 至 256 的整数。 可以使用波浪号 来指定相对坐标。如果没有指定坐标，那么预设为指定玩家的坐标。

结果

若没有正确指定参数，或玩家不在线则失败。

成功时把指定玩家的出生点设置到指定坐标

spreadplayers

命令/infobox 把实体（玩家、生物、物品等）随机传送到区域内地表的某个位置

格式

spreadplayers <x> <z> <目标之间的间距> <最大范围> <保持队形> <玩家|实体 …>

参数

x z

指定那个把目标随机传送到的区域的中心。 x 和 z必须是整数并且在-30,000,000 至 30,000,000。 以使用波浪号 来指定相对坐标。

目标之间的间距

指定目标之间最小的间距。不能少于是0.0

最大范围

指定目标和中心在x和z轴上的最大距离(所以那个区域是正方形而不是圆形)。必须比目标之间的间距大最小1.0

保持队形

指定传送时会不会保持队伍在一起。必须是true或false。 如果true,同队的目标会传送到同一个地点

玩家|实体

指定需要随机传送的目标。必须是1或更多的玩家名和/或 目标选择器，之间以空白来分隔(@e可以用来执行玩家以外的实体)

结果

若没有正确指定参数，或因目标数太多导致它们不能在指定区域内有足够的间距，或者是目标尝试散布到世界边界以外。

成功时，目标会随机传送到区域内表面的某个位置。目标一定会被传送到最高的方块上，并且不会在熔岩上。同时也会暂时加载目标传送到的区块

例子

传送所有玩家到以(0,0)为中心，大小为1,000×1,000的区域中的一个随机的地点，同队的玩家需要聚集在一起，并且每队之间最小的间隔为200格

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

另见

/tp — 传送一个玩家/实体到一个指定的位置(甚至是在地下)

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 停止服务端。

格式

stop

描述

把所有的更改保存到硬盘，然后退出服务端。

成功条件

总是成功。

stopsound

命令/infobox

停止音效播放。

格式

stopsound <玩家> [来源] [音效]

参数

玩家

指定音效的目标。必须是玩家名称或目标选择器。

来源 （可选）

Specifies which category in the music & sound options the sound falls under. Must be master, music, record, weather, block, hostile, neutral, player, ambient, or voice.

sound (optional)

Specifies the sound to stop. Must be a sound event defined in sounds.json (for example, mob.pig.say).

Result

summon

命令/infobox 召唤一个 实体 (生物, 弹射物, 物品, 车辆等.).

格式

summon <实体> [x] [y] [z] [数据标签]

参数

实体名称

指定召唤的实体。必须是一个实体ID (例如，Bat, EntityHorse, WitherSkull, XPOrb, PrimedTNT,等等。) or LightningBolt.

x y z (可选)

指定召唤的实体的坐标。x 和 z 必须在 -30,000,000 至 30,000,000 (包括) 之间, y 必须至少是0. 可以使用 波浪号 (~) 以指定与执行者的相对坐标。 如果没有指定, 默认是命令执行地的坐标。

数据标签 (可选)

指定实体的数据标签。必须是一个NBT格式组(例如,{CustomName:Fred}). 闪电没有任何可以指定的数据标签。

结果

当参数未正确指定则失败。

成功,创建指定的实体在指定的位置。

例子：

召唤一个叫 "Powered Creeper" 的高压爬行者在当前的位置:

summon Creeper ~ ~ ~ {powered:1,CustomName:"Powered Creeper"}

在当前位置往西面10格召唤出一个闪电:

summon LightningBolt ~-10 ~ ~

在当前位置召唤一个带有骷髅头和熔岩桶的盔甲架

/summon ArmorStand ~ ~ ~ {Equipment:[{id:lava_bucket},{},{},{},{id:skull}]}

tell

命令/infobox 发送一条私密信息给一个或多个玩家。

格式

tell <玩家> <私密信息...>

msg <玩家> <私密信息...>

w <玩家> <私密信息...>

参数

玩家

向指定的玩家发送私聊信息。必须是一个玩家的名字或一个目标选择器（但是当使用者是管理员时才能使用目标选择器）。

私密信息

发送指定的信息，可以包括空格以及目标选择器，but only if run from the server console — in other words, from the computer running the server, or by remote access to it).

结果

当任何目标选择器不能找到至少一个玩家时或指定名字的目标玩家不在线时命令执行失败。

如果成功, 只有指定的目标玩家能在聊天栏里看到这条私信。

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).

例子

私信告诉Alice：Start the mission: tell Alice Start the mission!

tellraw

命令/infobox 玩家发送一条Json格式的消息。

格式

tellraw <玩家> <raw json message>

参数

玩家

指定发送该消息的玩家。必须是一个玩家的名字或目标选择器。

原始Json文本

指定发送的消息。必须是有效的原始JSON文本。(例如，{text:"Hi there!",bold:true})

结果

如果参数指定不正确, 或者当 玩家 无法解析到一个或多个在线玩家时命令失败.

成功时，目标玩家在自己的聊天区域接受到指定的JSON格式化的消息

参见

/say — 向所有玩家发送一条简单的消息

/tell — 向指定玩家发送一条简单的消息

testfor

命令/infobox 检测并统计符合指定条件的实体。

格式

testfor <玩家> [数据标签]

参数

玩家

指定计数的目标。必须是一个玩家名称或一个目标选择器 （@e除了玩家之外，其他实体目标也是可以的).

数据标签(可选)

指定实体必须匹配成功的数据标记。必须是一个复合的NBT标签 （例如{XpLevel:3}）。

结果

如果没有正确地指定参数，或者指定实体不存在（指定的玩家须在线）则失败。

成功，产生一个输出强度等于匹配目标的玩家的数量的信号，这可以通过朝外的靠着命令方块的红石比较器测量。

例子

探测Alice是否在线: testfor Alice

探测在(0,64,0)半径为3有几个玩家 testfor @a[0,64,0,3,m=0]

探测有几个玩家在飞 testfor @a {abilities:{flying:1b}}

探测在(0,64,0)半径为20有几个僵尸: testfor @e[0,64,0,20,type=Zombie]

testforblock

命令/infobox 探测某个方块是否在特定位置。

格式

testforblock <x> <y> <z> <TileName> [dataValue] [dataTag]

参数

x y z

指定探测的方块的坐标。x 和 z 必须在 -30,000,000 至 30,000,000 (包括) 之间, y 必须至少是0. 可以使用 波浪号 (~) 以指定与执行者的相对坐标。 如果没有指定, 默认是命令执行地的坐标。

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 (可选)

指定测试的方块的数据附加值. 必须是 NBT 标签 (例如, {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.
• masked — air 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 更改或查询世界游戏时间。

格式

time <set|add|query> <数值>

参数

数值

设置时间、加快时间和查看时间：

• add - 必须介于0和2147483647之间（包括0和2147483647）
• query -必须是 daytime 或 gametime.
• set - 必须介于0和2147483647之间（包括0和2147483647）, day 或 night.

结果

如果参数没有被指定正确的数值则失败。

如果成功：

• add - 以数值的数字来增加世界时间
• query - 显示这一天的时间（从午夜开始的游戏刻）或游戏时间 （从世界创建时开始计算的游戏刻）
• set - 设置世界游戏时间的数值 (day = 1000，night = 13000)。

设置时间到1000: time set 1000 或 time set day

将世界时间增加一天：time add 24000

title

命令/infobox 服务器管理员可以通过这个命令来发送和管理标题文字. 标题会呈粗体大号字状出现在接收人屏幕的中间，并且可以出现一个"副标题"。标题和副标题均可使用 原始JSON文本。标题可以设置通过渐入方式进入画面并且渐出，并且标题在画面中的持续时间同样可以在命令中指定。标题的大小决定于图形用户界面尺寸，并且太长的标题不会自动换行，而是会继续向画面两侧延伸，尽管会有内容到屏幕之外，此时可以使用副标题达到换行功能。

命令语句

以下五个语句使用不同的变量，并且效果也不相同。

title <player> clear (从玩家的画面中移除标题)

title <player> reset (重设标题变量)

title <player> subtitle <raw json title> (设置副标题)

title <player> times <fadeIn> <stay> <fadeOut> (设置渐入所花的时间，在屏幕的保留时间，渐出所花的时间)

title <player> title <raw json title> (展示一个标题)

参数

player

指定接受指令的玩家，必须为一个有效在线玩家名或是目标选择器.

raw json title (仅限subtitle 与 title)

指定(副)标题的内容. 只有使用这个方式才有效： 原始JSON文本。 (例如， {"text":"Chapter I","bold":true}).

fadeIn, stay, 和 fadeOut (仅限times)

指定以 刻 (1/20秒) 计算的标题的淡入、停留、淡出时间。所有数值必须在 -2147483648 和 2147483647 之间 (包括), 但是负数会被当做是0. 如果没有指定 (或者重置), 默认数值分别是 20 (1 秒), 60 (3 秒), 20 (1 秒).

Result

Example result of the title command.

当参数没有被正确指定，或是player无法被解析为一个或多个在线玩家时失败。

如果成功:

• clear — 清除指定的一个或多个玩家屏幕显示的标题文字。如果没有标题文字正在被显示，将不会产生效果。
• reset — 重设指定的一个或多个玩家的title设置：副标题为空白文字，淡入时间为20(1秒)，保留时间为60(3秒)及淡出时间为20(1秒)。
• subtitle — 如果玩家正在被显示一个标题文字，指令将会将当前显示的副标题置换为指定的文本；否则，将指定下一次玩家被显示标题文字时的副标题文本。
• times — 如果玩家正在被显示一个标题文字，指令将会设置当前(及以后所有)标题的淡入，保留和淡出时间；否则，将设置之后所有标题文本的淡入，保留和淡出时间。
• title — 对指定玩家显示指定的标题文本，或者更改当前所显示的标题为新的文本。在淡出之后，将会重置副标题的文本为空，但不会重置淡入，保留和淡出时间。

例子

显示一条加粗的，标题文本为"Chapter I"同时副标题为灰色斜体"The story begins…"的标题给所有玩家：

1. title @a subtitle {"text":"The story begins…","color":"gray","italic":true}
2. title @a title {"text":"Chapter I","bold":true}

toggledownfall

命令/infobox 切换天气。

语法

toggledownfall

结果

总是成功的。如果天气目前晴朗,就会转换成下雨或下雪。如果天气目前是雨雪天气,它将停止下雨下雪。

tp

命令/infobox 传送实体 (玩家, mobs, 物品等)。

语法

tp [目标玩家] <目的地玩家>

tp [目标玩家] <x> <y> <z> [<y-rot> <x-rot>]

参数

目标玩家 (可选)

指定要传送的目标。必须是一个玩家的名字或者目标选择器(@e允许指定玩家以外的实体)。 若未指定，则默认为命令的使用者。在命令方块中使用时为必填参数。

目的地玩家

指定目标传送目标玩家。必须是一个玩家的名字或一个目标选择器 (@e允许指定玩家以外的实体).

x y z

传送目标至指定坐标. x 和 z 的值必须在 -30,000,000 到 30,000,000 之间(exclusive, without the commas), 并且y 最少为0。 可以使用波浪线来指定目标位置相对于当前位置的偏移量。

y-rot (可选)

指定传送的水平旋转值 (-180.0对应正北方，-90.0对应正东方，0.0对应正南方，90.0对应正西方，另外179.9对应西北，再旋转后值将被还原为-180.0正北方)。 可以使用波浪线来指定目标位置相对于当前旋转角度的旋转量。

x-rot (可选)

指定传送的垂直旋转值 (-90.0对应直视正上，到90.0对应直视正下)。 可以使用波浪线来指定目标位置相对于当前旋转角度的旋转量。

结果

当参数没有被正确指定，目标玩家无法被解析为一个或多个实体(使用玩家名时，玩家必须在线)，或是目的地玩家无法被解析为单独一个实体(使用玩家名时，玩家必须在线)时失败。

如果成功，将目标传送到指定的目的地。

例子

传送自己到Alice的位置: tp Alice

传送所有玩家到自己的位置: tp @a @p

传送自己到x轴为100，z轴为100，且比现在的位置高了三个方块: tp 100 ~3 100

不更改玩家位置，并旋转最近的玩家向右10度: tp @p ~ ~ ~ ~10 ~

trigger

命令/infobox 修改一个准则为触发器的记分板的值.

格式

trigger <目标> <add|set> <值>

描述

和/tellraw连用来使普通玩家能激活管理员或者地图制作者所制作的系统。这条指令仅会改变指令使用者在这个记分板目标上的值。

参数

目标

指定一个被允许的，准则为trigger的记分板目标。

add|set

• add – 将值添加到当前目标所拥有的值上。
• set – 将目标的值设置为指令所指定的值。

结果

当参数没有被正确指定，选择的目标准则不为"trigger"，或是使用这条指令的玩家没有被许可去修改这个目标的值时失败。

如果成功，这个目标的值将会被使用该指令的玩家修改。

weather

命令/infobox 更改游戏中的天气。

格式

weather <clear|rain|thunder> [单位为秒的时间]

效果

clear

将游戏里的天气改为晴天。

rain

将游戏里的天气改为雨天。(在寒冷的生物群系会下雪。)

thunder

将游戏里的天气改为雷雨天，但不一定会下雨。 (在寒冷的生物群系改为雷天时可能会下雪。).

持续的时间

游戏中的天气也会有相对持续的时间， 但必须是在1000000和1之间。 (之间没有逗号).

结果

如果未指定参数，则失败。

如果成功，在几秒钟内改变指定时间的天气。

例子

改变为晴天: weather clear 1200

改为下雨，但有时间限制: weather rain 1

whitelist

命令/infobox 管理服务器白名单。服务器的管理员总是能在白名单验证被开启时登录服务器，即使他们的名字并不在白名单上。

格式

此命令有六种变体：

whitelist add <player>

whitelist list

whitelist off

whitelist on

whitelist reload

whitelist remove <player>

参数

player (仅在add和remove模式下)

指定添加到白名单或从白名单移除的玩家。Specifies the player(s) to add or remove from the whitelist.

结果

当玩家不存在时失败。

如果成功:

• add — 将这个玩家名添加到白名单。这个名字的玩家不需要在线。
• list — 显示所有在白名单中的玩家名。
• off — 对此服务器禁用白名单。
• on — 对此服务器启用白名单。
• reload — 从磁盘重载white-list.txt(1.7.5及以前)或whitelist.json(1.7.6及以后)里玩家名的列表(当white-list.txt或whitelist.json在Minecraft外被修改时使用)。
• remove — 将这个玩家名从白名单中移除。这个名字的玩家不需要在线。

worldborder

命令/infobox 用来管理世界边界.

Syntax

该命令有八种变化，每一个有不同的参数:

worldborder add <大小> [变化时间] (增加世界边界的直径)

worldborder center <x> <z> (设置世界边界的中心)

worldborder damage amount <每格伤害值> (指定世界边界伤害量)

worldborder damage buffer <大小> (指定世界边界伤害缓冲区距离)

worldborder get (提供世界边界的信息)

worldborder set <大小> [变化时间] (设置世界边界大小)

worldborder warning distance <方块> (指定世界边界出现警告距离)

worldborder 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 将经验值给予一个玩家。

语法

xp <数量> [玩家名]

xp <数量>L [玩家名]

参数

经验值

指定给予玩家的经验值数量。经验值数量必须在 0（含）到 2,147,483,647（含）之间。

若出现字符 L 作为后缀，则改为提升玩家等级。等级数量必须在 -2,147,483,648（含）到 2,147,483,647（含）之间——负的等级数量将会扣除玩家等级。

玩家名（可选）

指定命令作用的对象。若没有指定，则默认为命令的执行者。对命令方块而言，此参数必须指定。

结果

若参数未正确设置或玩家名无法与至少一个在线玩家对应，则执行失败。

执行成功后，对象获得指定经验值或提升/扣除等级。扣除操作不会使总经验值和等级低于0。

范例

为自己增加7点经验值： xp 7

将 Alice 的等级提升3级： xp 3L Alice

将所有玩家的等级归零： xp -2147483648L @a

历史

release
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指令。
		14w28a			增加/stats指令。
		14w29a			增加/worldborder get指令。
					增加force参数到/particle指令。
					增加/time query指令。
					允许玩家创建不存在的gamerules。
					增加QueryResults到/stats指令。
		14w30a			/summon现在可以生成闪电了。
		14w31a			/debug可以在单人模式下使用。
					增加chunk参数到/debug.
		14w32b			增加/entitydata指令。
					/give不再能制造负堆叠。
1.8.1		1.8.1-pre1			增加游戏规则doEntityDrops。
					游戏规则doTileDrops不再影响实体。
1.9		15w43a			/gamemode现在在聊天栏中显示玩家所切换到的模式。
		15w49a			/playsound可以使用Tab进行补全。
					增加标签player和params到/particle
		15w49b			/time query现在接受day作为值。
		15w51a			增加游戏规则spawnRadius.
		16w02a			选择器参数m现在接受游戏模式的标准文字格式和其缩写，例如a和adventure，也可以使用!来进行反选。
					/playsound现在需要一个source参数，为声音输出指定类别。
					在命令方块中执行/help将在以前所提供的各种不同的幽默短句中随机选择一句输出。
		16w03a			/achievement不再影响统计。
		16w07a			增加游戏规则disableElytraMovementCheck.
1.9.3		1.9.3-pre1			/tp不会再把玩家传送到y轴-512至512以外的地方。
		1.9.3-pre2			增加/stopsound指令。
1.10		16w21b			/tp指令的y坐标范围扩大到-4096至4096。
		1.10-pre1			增加/teleport指令，和/tp相似, 所不同的是目标的参数是强制性的。"传送到其他玩家"是不可用的，而使用相对坐标时偏移相对于命令的执行者，而不是相对于目标。
携带版Alpha
0.7.4					增加了对命令的支持，但尚未实现任何命令。

另见

• 样式代码
• 多人游戏
• 命令方块

游戏内容

参见：Template:Gameplay/content [编辑]