手册:/clear

来自Minecraft基岩版开发Wiki
clear
用法旗标
普通命令(0)
可见性旗标
可见(0)
同步旗标
同步命令(0)
执行旗标
允许执行(0)
类型旗标
无类型(0)
作弊旗标
作弊命令(0)
游戏内描述

清空玩家物品栏中的物品。

/clear命令用于清除玩家物品栏中的物品。

语法[编辑]

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

参数[编辑]

player
target类型,目标选择器或玩家名,指定待清除背包的玩家。目标选择器只能是玩家。如果未指定,默认指定为命令执行者。
itemName
Item类型,物品ID,指定待清除的物品,必须是一个物品ID或存在其物品形式的方块ID。如果未指定,默认指定所有物品。
data
int类型,指定待清除物品的数据值(例如颜色方向等)。
如果未指定或指定的数据值对此物品无效则为0,如果指定为-1则不考虑此物品的数据值。必须为-1到2147483647之间的数字(含)。
maxCount
int类型,指定要被清除的物品的最大数目。
必须为-1到2147483647之间的数字(含)。

效果[编辑]

命令触发条件执行结果
任意参数未正确指定失败
玩家物品栏中不存在指定物品
[player: target]不存在或指定了非玩家目标
在指定了有效的命令名,正常给出了命令的用法时成功
可清除的物品数小于最大数量指定的数目
最大清除数量为0

输出[编辑]

命令执行结果成功次数增量
任意失败0
成功拥有指定物品的玩家数

示例[编辑]

/clear - 清除自己的物品。
/clear @a - 清除所有玩家的所有物品。
/clear @r diamond - 清除随机一名玩家的钻石。
/clear @p wool 5 - 清除最近玩家的黄绿色羊毛(数据值为5代表黄绿色)。
/clear @a concrete -1 64 - 清除所有玩家至多64个任意数据值的混凝土。
/clear @a wool 14 0 - 检测玩家是否有红色羊毛。


响应[编辑]

WebSocket[编辑]

  • :根对象
    •  header:报文消息的头。
      •  messagePurpose:该条报文消息的发送目的,对于命令响应恒为commandResponse
      •  requestId:造成该响应的请求报文的UUID。
      •  version:该报文的版本。
    •  body:报文消息的内容。
      •  statusCode:该响应的状态码。
      •  statusMessage:该响应的状态消息,对于命令响应为该命令的执行反馈文本。

Manual:/clear/response

示例[编辑]

脚本API[编辑]

  • :根对象
    •  statusCode:该响应的状态码。
    •  statusMessage:该响应的状态消息,对于命令响应为该命令的执行反馈文本。

Manual:/someCommand/response

示例[编辑]

历史[编辑]

携带版
1.0.51.0.5.0加入了/clear命令。

画廊[编辑]

Template:Commands