清除玩家物品栏的物品。
语法[]
- Java版
clear [<targets>] [<item>] [<maxCount>]
- 基岩版
clear [player: target] [itemName: Item] [data: int] [maxCount: int]
参数[]
JE:<targets>
:entity
BE:player: target
:CommandSelector<Player>
JE:<item>
:item_predicate
BE:itemName: Item
:CommandItem
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版]
历史[]
Java版 | |||||
---|---|---|---|---|---|
1.4.2 | 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.16 | 20w07a | /clear 现在会清除玩家合成栏中的物品。 | |||
20w22a | /clear 现在会正确地清除玩家合成栏中的物品。 | ||||
携带版 | |||||
1.0.5 | 1.0.5.0 | 加入了/clear 命令。 |
另见[]
/data
— 更改或移除方块物品栏内的物品/give
— 给予玩家物品/kill
— 清除实体/item
[仅Java版] — 修改方块或实体的物品栏中的物品 /replaceitem
[仅基岩版] — 替换方块或实体的物品栏中的物品
语言