手册:/fill

fill

命令

权限等级

1

命令旗标

用法旗标

普通命令（0）

可见性旗标

可见（0）

同步旗标

同步命令（0）

执行旗标

允许执行（0）

类型旗标

无类型（0）

作弊旗标

作弊命令（0）

游戏内描述

“

以一种特定方块填充一整个区域或部分区域。

”

限制条件

  本页面介绍的是基岩版命令信息。关于Java版命令信息，请见“Minecraft Wiki:命令/fill”。

/fill命令以规定方块填充一片区域。

重载

1. fill <from: x y z> <to: x y z> <tileName: Block> [tileData: int] [oldBlockHandling: FillMode]
2. fill <from: x y z> <to: x y z> <tileName: Block> [blockStates: block states] [oldBlockHandling: FillMode]
3. fill <from: x y z> <to: x y z> <tileName: Block> <tileData: int> replace [replaceTileName: Block] [replaceDataValue: int]
4. fill <from: x y z> <to: x y z> <tileName: Block> <blockStates: block states> replace [replaceTileName: Block] [replaceBlockStates: block states]

参数

key 1>":<value 1>,"<key 2>":<value 2>,...]的方块状态。

oldBlockHandling 枚举参数

FillMode类型，必选。指定旧方块的处理方式。

• 可以为以下5种中的一种：
  • replace - 默认设置，替换方块，在设定为此参数时也可规定替换何种方块为规定方块。
  • destroy - 原位置的方块将被破坏。破坏的掉落物为无附魔的下界合金镐（或锹）破坏此方块时的掉落物。
  • outline - 将区域的外层边界替换为规定方块，但内部不受影响。
  • hollow - 将区域的外层边界替换为规定方块，且内部镂空（替换为空气）。
  • keep - 仅替换空气，保留原有方块。

; from和to 基本参数

x y z类型，必选。指定要填充区域的两个对角方块。

• 可以为同一个坐标。两个相同坐标放在from或放在to里的意义都是一致的，例如0 0 0 1 1 1和1 1 1 0 0 0指代的是同一个区域。
• 必须为玩家名或目标选择器。

tileName 枚举参数

Block类型，必选。指定要填充区域的方块类型。

• 必须为有效的方块ID。

tileData 基本参数

int类型，必选。指定要填充区域的方块数据值。

• 必须为0-65535之间的整数值。

replaceTileName 枚举参数

Block类型，必选。指定要将何种方块替换为规定方块。

• 必须为有效的方块ID。

replaceDataValue 基本参数

int类型，必选。指定待替换方块的数据值。

• 必须为0-65535之间的整数值。

; from和to 基本参数

x y z类型，必选。指定要填充区域的两个对角方块。

• 可以为同一个坐标。两个相同坐标放在from或放在to里的意义都是一致的，例如0 0 0 1 1 1和1 1 1 0 0 0指代的是同一个区域。
• 必须为玩家名或目标选择器。

tileName 枚举参数

Block类型，必选。指定要填充区域的方块类型。

• 必须为有效的方块ID。

blockStates 基本参数

block state类型，必选。指定要填充区域的方块状态。

• 必须为格式为["<key 1>":<value 1>,"<key 2>":<value 2>,...]的方块状态。

replaceTileName 枚举参数

Block类型，必选。指定要将何种方块替换为规定方块。

• 必须为有效的方块ID。

replaceBlockStates 基本参数

block state类型，必选。指定待替换的方块状态。

• 必须为格式为["<key 1>":<value 1>,"<key 2>":<value 2>,...]的方块状态。

效果

命令	触发条件	执行结果
除/fill ... destroy的其它重载	没有方块被改变	失败
/fill ... destroy	在该区域全为空气的情况下尝试填充空气
任意	参数未正确指定
	在规定的区域中存在子区域未加载
	填充的方块数大于32,768
	执行成功	填充方块

输出

命令	执行结果	成功次数增量
任意	失败	0
	成功	1

示例

/fill 0 0 0 15 15 15 air - 将(0,0,0)和(15,15,15)所围区域填充为空气。

/fill ~-1 ~-1 ~-1 ~1 ~-1 ~1 wool 14 - 在执行者下方的3×3区域填充红色羊毛。

/fill 0 0 0 15 15 15 concrete 0 replace concrete 5 - 将(0,0,0)和(15,15,15)所围区域中的黄绿色混凝土（数据值5）填充为白色混凝土（数据值0）。

/fill 0 0 0 15 15 15 concrete 0 keep - 将(0,0,0)和(15,15,15)所围区域中的空气填充为白色混凝土。

/fill 0 0 0 15 15 15 concrete 0 replace air - 此命令意义和上一条等同（基本上可以认为keep=replace air 0）

/fill 0 0 0 15 15 15 glass 0 hollow - 将(0,0,0)和(15,15,15)所围区域镂空，并在外层填充玻璃。