手册:/clear

clear

命令

权限等级

1

命令旗标

用法旗标

普通命令（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：该响应的状态消息，对于命令响应为该命令的执行反馈文本。

脚本API

主页面：Manual:@minecraft/server.Dimension.runCommand

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

历史

携带版
1.0.5		1.0.5.0			加入了/clear命令。

画廊

• 
  命令/clear的帮助页面。
• 
  命令clear @a grass的执行效果，但并不会输出它清除了什么方块。
• 
  命令clear @a wool 14 0的执行效果，很明显它的功用转为了检测而非清除。
• 
  检测玩家是否有红色羊毛的简易命令装置，其中循环型命令方块内的命令为clear @a wool 14 0，而连锁型命令方块为title @a actionbar 有玩家拥有红色羊毛。。