命令/clear

clear

限制条件	是管理员
加入版本	1.4.2（12w37a）

清空玩家物品栏的物品。

语法

• Java版

clear [<目标>] [物品] [最大数量]

• 基岩版

clear [玩家：目标] [物品名：字符串] [数据：整数] [最大数量：整数]

参数

目标（基岩版：玩家：目标）（可选）

必须是玩家名或目标选择器。若未定义则默认为命令执行者。在命令方块中为必需参数。

物品（基岩版：物品名：字符串）（可选）

指定将被清除的物品的ID。若未定义则清除物品栏中所有物品。在Java版可以紧跟着物品标签（物品标签内的某些值其命名空间不可以省去，比如下面的例子中的minecraft:sharpness中的minecraft:不能省去，否则匹配不到）。

数据：整数（可选）‌‌^{[仅基岩版]}

指定将被清除的物品的数据值。若未指定或定义为-1，则所有符合物品值的物品会被清除而不考虑物品数据。

最大数量（基岩版：最大数量：整数）（可选）

指定物品将被清除的最大数量。若未指定或定义为-1，则所有符合物品与数据值的物品会被清除。若定义为0，则不会清除任何物品，但会成功执行并返回是否有物品本应该被清除（用来检测物品但不清除物品）。

效果

若参数没有被正确指定，玩家没能指定一个或更多的在线玩家或者没有移除任何物品（除了最大数量为0的情况），则失败。

成功时，移除指定玩家的物品，并返回移除的物品数量。

示例

清除自己的所有物品：clear

清除Alice的所有物品：clear Alice

清除Alice的所有羊毛：clear Alice #minecraft:wool‌‌^[仅Java版]

清除所有玩家的橙色羊毛：clear @a minecraft:orange_wool‌‌^[仅Java版]

清除距离最近玩家的带有“锋利 I”附魔的金剑，不论剑的损害值：

clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1}]}

另见

/data — 更改或移除方块物品栏内的物品

/give — 给予玩家物品

/kill — 清除物品实体

/replaceitem — 替换方块或实体的物品栏中的物品

历史

Java版
1.3.1			12w37a		加入了/clear命令。
			12w38a		向/clear加入了item参数。
1.8			14w02a		向/clear加入了data参数。
携带版
1.0.5			alpha 1.0.5.0		加入了/clear命令。