/clear 命令

/clear 命令

来源：Commands/clear，英文修订 ID：3774572。

清除玩家物品栏中的物品，包括玩家正在拖动的物品，也可检测并查询指定物品的数量。Java 版所需权限等级为 2；基岩版为 1，并需要启用作弊。

用法

可以清除物品栏中的物品，以及从箱子、工作台等容器中拖到光标上的物品。基岩版还可以清除从物品栏拖动的物品；Java 版只有不在创造模式时才可清除这类物品。Java 版也可清除玩家四个合成槽位中的物品。

语法

Java 版：

clear [<targets>] [<item>] [<maxCount>]

基岩版：

clear [player: target] [itemName: Item] [data: int] [maxCount: int]

参数

<targets>: entity／player: target（CommandSelector<Player>）：要清除物品的玩家，省略时为执行命令的玩家。可用玩家名称、玩家类型选择器，或 Java 版的 UUID。

<item>: item_predicate／itemName: Item：要清除的物品，省略时清除全部物品。Java 版格式为 item_id[tests]，支持物品或方块标签，不需要 tests 时可省略；详见 minecraft:item_predicate。基岩版必须为物品 ID，或具有物品形式的方块 ID。

data: int：基岩版要清除物品的数据值。省略或为 -1 时清除所有匹配 itemName 的物品，不考虑数据值。数值按位与 0xFFFF 后，如果对指定 ID 无效则回退为 0。必须为 32 位整数，实际应为 -1 至 2147483647。

<maxCount>: integer／maxCount: int：最多清除的物品数量。省略时，或基岩版给出 -1 时，清除所有匹配物品与数据值的物品。为 0 时不清除，而是检测并查询数量。Java 版范围为 0 至 2147483647；基岩版应为 -1 至 2147483647。

结果

命令不完整或任一参数指定错误时无法解析。下列情况失败：

  • 执行者不是玩家且未指定目标。
  • 基岩版选择器不是玩家类型。
  • 目标未解析为一名或多名在线玩家。
  • 任何玩家的物品栏中都没有指定物品。
  • 基岩版 data 或 maxCount 小于 -1。

其他情况成功。

输出

Java 版失败时成功次数、success 与 result 均为 0；成功时成功次数与 success 为 1，result 为清除或检测到的物品总数。

基岩版失败时成功次数为 0，成功时为拥有指定物品的玩家数量。

示例

  • 清空自己的全部物品栏：clear。
  • 清空 Alice 的全部物品栏：clear Alice。
  • Java 版清除 Alice 的所有羊毛：clear Alice #minecraft:wool。
  • 清除所有玩家的橙色羊毛：基岩版 clear @a minecraft:wool 1，或 clear @a minecraft:orange_wool。
  • Java 版清除最近玩家所有带锋利 I 的金剑：clear @p minecraft:golden_sword[enchantments~[{sharpness:1}]]。
  • 检测随机玩家是否有石头：基岩版 clear @r minecraft:stone 0 0；Java 版 clear @r minecraft:stone 0。

另见

  • /data：更改或移除方块、实体物品栏中的物品。
  • /give：给予玩家物品。
  • /kill：销毁物品实体。
  • Java 版 /item：操作方块或实体物品栏。
  • 基岩版 /replaceitem：替换方块或实体物品栏中的物品。

外部链接

本文为 Minecraft Wiki 对应英文条目的中文翻译与改编，已按要求省略变更历史。原作者与贡献者见来源页及其历史；除另有说明外，按 CC BY-NC-SA 3.0 非商业、署名、相同方式共享。