命令/clear

clear

需要的权限等级	2‌‌[仅Java版] 1‌‌[仅基岩版]
限制条件	启用作弊‌‌[仅基岩版]

清空玩家物品栏的物品。

语法

• Java版

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

• 基岩版

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

参数

Java版：[<目标>]

基岩版：[玩家：目标]

必须是玩家名、目标选择器或UUID‌‌^[仅Java版]。若未指定则默认为命令执行者。

Java版：[<物品>]

基岩版：[物品名：字符串]

指定将被清除的物品的命名空间ID。若未指定则清除物品栏中所有物品。

基岩版：[数据：整数]

指定将被清除的物品的数据值。必须处于-1至2,147,483,647（含）之间。若未指定或数据为-1，则清除所有符合指定命名空间ID的物品。

Java版：[最大数量]

基岩版：[最大数量：整数]

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

效果

命令	触发条件	Java版	基岩版
任意	参数未正确指定	无法解析	执行失败
	[<目标>]或[玩家：目标]未指定且命令执行者不是玩家	执行失败
	[<目标>]或[玩家：目标]无法解析为一个或多个在线玩家
	玩家物品栏中不存在指定物品
	执行成功时	清除或检测指定玩家的物品

示例

• 清除自己的所有物品：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版
1.3.1		12w37a			加入了/clear命令。
		12w38a			向/clear加入了item参数。
1.8		14w02a			向/clear加入了data参数。
1.9		15w31b			/clear现在可以更改副手槽位的物品。
1.13		17w45a			/clear的语法从/clear [<target>] [<item>] [<data>] [<count>] [<nbt>]变为 /clear [<target>] [<item>] [<count>]。
携带版
1.0.5		alpha 1.0.5.0			加入了/clear命令。

参见

• /data — 更改或移除方块物品栏内的物品
• /loot — 将指定的战利品放入物品栏或世界
• /give — 给予玩家物品
• /kill — 清除实体
• /replaceitem — 替换方块或实体的物品栏中的物品

命令

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