命令参考
方块状态与谓词
命令中的方块写作一个ID，可选的状态放在方括号中，可选的方块数据放在花括号中。检测方块的命令也接受方块标签。
详细信息
| 方块语法 | id[state=value,state=value]{data}.minecraft: 部分可以省略。括号内允许有空格。 |
| 状态 | 每个状态只能设置一次。省略的状态保持方块的默认值。 |
| 未知的状态 | 方块不具有的状态或值会被拒绝，例如minecraft:stone[facing=east]。 |
| 方块数据 | 方块之后花括号中的数据决定方块所含的内容，例如箱子中的物品或告示牌上的文字。 |
| 放置命令 | /setblock和/fill命令只接受一个确切的方块。标签会被拒绝并提示“无法在此使用标签，只允许使用实际的方块”。 |
| 方块测试 | 由/execute if block、/fill ... replace和/clone ... filtered使用。它们接受方块id或以#开头的标签。 |
| 测试状态 | 只比较列出的状态。带标签时，没有所列状态的方块不匹配。 |
| 测试数据 | 只比较列出的值，并且该方块必须带有数据。 |
书写方块的方式
| id | 处于默认状态的方块 | /setblock 10 64 10 minecraft:stone |
| id[state=value] | 带有所选状态的方块 | /setblock ~ ~ ~ minecraft:oak_stairs[facing=east,half=top] |
| id{data} | 带有方块数据的方块 | /setblock ~ ~ ~ minecraft:chest{Items:[{Slot:0b,id:"minecraft:diamond",count:1}]} |
| id[state=value]{data} | 状态与数据合用 | /setblock ~ ~ ~ minecraft:chest[facing=north]{Items:[{Slot:0b,id:"minecraft:diamond",count:1}]} |
方块测试
| id | 处于任意状态的该方块 | /execute if block ~ ~-1 ~ minecraft:grass_block run say on grass |
| #tag | 标签中的任意方块 | /execute if block ~ ~-1 ~ #minecraft:logs run say on a log |
| id[state=value] | 带有所列状态的该方块 | /execute if block ~ ~ ~ minecraft:oak_stairs[half=top] run say upside down |
| #tag[state=value] | 标签中具有所列状态的任意方块 | /execute if block ~ ~ ~ #minecraft:stairs[facing=east] run say facing east |
| id{data} | 带有所列数据的该方块 | /execute if block ~ ~ ~ minecraft:chest{Items:[{id:"minecraft:diamond"}]} run say has diamonds |
| #tag{data} | 标签中持有所列数据的任意方块 | /execute if block ~ ~ ~ #minecraft:signs{is_waxed:1b} run say waxed |
使用方块检测的命令
| execute if block | 仅当方块匹配时才运行其余部分 | /execute if block ~ ~-1 ~ #minecraft:logs run say on a log |
| execute unless block | 仅当方块不匹配时才运行其余部分 | /execute unless block ~ ~ ~ minecraft:air run say solid |
| fill ... replace | 只替换区域内匹配的方块 | /fill ~-5 ~ ~-5 ~5 ~ ~5 minecraft:air replace #minecraft:leaves |
| clone ... filtered | 只复制匹配的方块 | /clone 0 64 0 10 70 10 20 64 0 filtered #minecraft:wool move |
示例
/setblock ~ ~ ~ minecraft:oak_stairs[facing=east,half=top]放置朝东的上下颠倒的橡木楼梯。
/setblock ~ ~ ~ minecraft:chest[facing=north]{Items:[{Slot:0b,id:"minecraft:diamond",count:1}]}放置一个朝北的箱子，第一个槽位中有一颗钻石。
/fill ~-5 ~ ~-5 ~5 ~ ~5 minecraft:stone replace minecraft:dirt将你所在高度的11×11正方形内的泥土变为石头。
/fill ~-5 ~ ~-5 ~5 ~ ~5 minecraft:oak_slab[type=top] replace minecraft:oak_slab[type=bottom]将区域内下半的橡木台阶变为上半台阶。
/clone 0 64 0 10 70 10 20 64 0 filtered minecraft:stone只把区域内的石头方块复制到新位置。
/execute if block ~ ~ ~ #minecraft:stairs[facing=east] run say facing east如果你站在任何朝东的楼梯方块中，就会说出这段文本。