admin 我的世界clear指令
clear
| 需要的权限等级 | Java版：2 基岩版：1 |
|---|---|
| 限制条件 | 启用作弊[仅基岩版] |
清除玩家物品栏的物品。
语法
- 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版]
