我的世界clear指令

清除玩家物品栏的物品。

语法

• Java版

clear [<targets>] [<item>] [<maxCount>]

• 基岩版

clear [player: target] [itemName: Item] [data: int] [maxCount: int]

参数

JE：<targets>：entity
BE：player: target：CommandSelector<Player>

指定要被清除物品的玩家。如果未指定，默认为命令执行者。

必须为玩家名、目标选择器或UUID^[仅Java版]。且目标选择器只允许玩家。

JE：<item>：item_predicate
BE：itemName: Item：CommandItem

指定要被清除的物品。如果未指定，默认为所有物品。

在Java版中，必须为物品ID参数（支持物品标签）。在基岩版中，必须为物品ID或存在其物品形式的方块ID。

data: int：int

指定要被清除物品的数据值。如果未指定或为-1，则不考虑物品的数据值；如果指定数据值对该物品无效，默认为0。

必须为32位整型数值。 必须为-1到2147483647之间的数字（含）。

JE：<maxCount>：integer
BE：maxCount: int：int

指定要被清除物品的最大值。如果未指定或为-1^{[仅基岩版]}，则默认清除所有符合其他要求的物品；如果为0，则没有物品将被清除，同时返回指定物品的数量。

必须为32位整型数值。在Java版中，必须在0和2147483647（含）之间。 在基岩版中，必须为-1到2147483647之间的数字（含）。

效果

 

命令	触发条件	Java版	基岩版
任意	参数未正确指定	无法解析	无法解析
	<targets>或player: target未指定且命令执行者不是玩家	执行失败	执行失败
	<targets>或player: target无法解析为一个或多个在线玩家
	玩家物品栏中不存在指定物品
	player: target不是玩家类型选择器	N/A
	data :int或maxCount: int小于-1
	执行成功时	清除或检测指定玩家的物品

输出

 

命令	版本	条件	成功次数	/execute store success ...	/execute store result ...
任意	Java版	执行失败	0	0	0
		执行成功	1	1	被清除或被检测到的物品总数
	基岩版	执行失败	0	N/A	N/A
		执行成功	拥有指定物品的玩家数	N/A	N/A

示例

• 清除自己的所有物品：clear
• 清除Alice的所有物品：clear Alice
• 清除Alice的所有羊毛：clear Alice #minecraft:wool^[仅Java版]或clear Alice minecraft:wool^{[仅基岩版]}
• 清除所有玩家的橙色羊毛：clear @a minecraft:orange_wool^[仅Java版]或clear @a wool 1^{[仅基岩版]}
• 清除距离最近玩家的带有“锋利 I”附魔的金剑，不论剑的损害值：
  • clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1}]}^[仅Java版]
• 检测一个随机玩家的物品栏内是否拥有石头：clear @r minecraft:stone -1 0^{[仅基岩版]}或clear @r minecraft:stone 0^[仅Java版]