命令/clear
< 命令
清空玩家物品栏的物品。
语法[编辑 | 编辑源代码]
- Java版
clear [<目标>] [物品] [最大数量]
- 基岩版
clear [玩家:目标] [物品名:字符串] [数据:整数] [最大数量:整数]
参数[编辑 | 编辑源代码]
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
— 替换方块或实体的物品栏中的物品