命令/clear
< 命令
clear
| 限制条件 |
是操作员 |
|---|---|
| 加入版本 |
清空玩家物品栏的物品。
语法[编辑 | 编辑源代码]
- Java版：
clear [<目标>] [物品] [最大数量]
- 基岩版：
clear [玩家：目标] [物品名：字符串] [数据：整数] [最大数量：整数]
参数[编辑 | 编辑源代码]
目标（基岩版：玩家：目标）（可选）
- 必须是玩家名或目标选择器。若未定义则默认为命令执行者。在命令方块中为必需参数。
物品（基岩版：物品名：字符串）（可选）
- 指定将被清除的物品的ID。若未定义则清除物品栏中所有物品。
数据：整数（可选）[仅基岩版]
- 指定将被清除的物品的数据值。若未指定或定义为
-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}]}
历史[编辑 | 编辑源代码]
| Java版 | |||||
|---|---|---|---|---|---|
| 1.3.1 | 12w37a | 加入了/clear命令。 | |||
| 12w38a | 向/clear加入了item参数。 | ||||
| 1.8 | 14w02a | 向/clear加入了data参数。 | |||
| 携带版 | |||||
| 1.0.5 | alpha 1.0.5.0 | 加入了/clear命令。 | |||
参见[编辑 | 编辑源代码]
/data— 更改或移除方块物品栏内的物品/loot— 将指定的战利品放入物品栏或世界/give— 给予玩家物品/kill— 清除实体/replaceitem— 替换方块或实体的物品栏中的物品
