コマンド/clear

clear

必要権限レベル	2 ‌^[JE限定] 1 ‌^[BE限定]
実行制限	チート限定‌^[BE限定]

プレイヤーのインベントリからアイテムを消去する。カーソルで持っている状態でスロットには設置されていないアイテムにも作用する。

構文[]

Java Edition

clear [<対象>] [<アイテム>] [<最大個数>]

Bedrock Edition

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

引数[]

JE：<対象>：エンティティ
 BE：player: target：プレイヤー

アイテムを削除するプレイヤーを指定する。デフォルトでは、コマンドを実行したプレイヤーが対象となる。

プレイヤー名、ターゲットセレクターまたはUUID‌^{[Java Edition限定]}で指定する。また、ターゲットセレクターはプレイヤーを指すものである必要がある。

JE：<アイテム>：アイテム条件
 BE：itemName: Item：文字列（引用符無し）

削除するアイテムを指定する。Java Editionでは、絞り込むNBTタグもここで指定する。

アイテムの引数（アイテムタグも可）Java Editionでは, it指定する。 Bedrock Editionでは, it must be a item id or a block ID for which items exist.

<data: int>：int

削除するアイテムのデータ値を指定する。指定しなかった場合および-1を指定した場合は、itemName: Itemの指定に該当するすべてのアイテムが削除される。指定したアイテムの種類に対して無効なデータ値を指定した場合は、0を指定したものとして見なされる。

32ビットの整数値で指定する。 -1以上21億4748万3647以下の値で指定する。

JE：<最大個数>：32ビット整数
 BE：maxCount: int：32ビット整数

削除するアイテムの最大数を指定する。指定しない場合（および-1‌^{[Bedrock Edition限定]}の場合）、itemおよびitemName: Itemかつdata: intに該当するアイテムがすべて削除される。0を指定した場合、アイテムを削除する代わりに条件に一致するアイテムの個数が表示される。

32ビットの整数値で指定する。Java Editionでは,値は0以上2,147,483,647以下で指定する。 Bedrock Editionでは-1以上21億4748万3647以下の値で指定する。

結果[]

コマンド	トリガー	Java Edition	Bedrock Edition
任意	引数が適切に指定されていない	構文解析不能	構文解析不能
	実行者がプレイヤーでないのに、`<対象>`・`player: target`が省略されている。	失敗	失敗
	`player: target`がプレイヤータイプでない。	-
	`<targets>`・`player: target`から1人以上ののプレイヤーを検出できない。	失敗
	指定したアイテムがプレイヤーのインベントリがない。	失敗
	`data: int`が-1未満。	-
	`maxCount: int`が-1未満。	-
	成功時	指定した条件によってアイテムを削除するか、条件にあったアイテムの数を検出する。

出力[]

コマンド	エディション	状況	成功回数	`/execute store success ...`	`/execute store result ...`
任意	Java Edition	失敗時	0	0	0
	Java Edition	成功時	1	1	削除および検出されたアイテムの数。
	Bedrock Edition	失敗時	0	N/A	N/A
	Bedrock Edition	成功時	指定のアイテムを持っていたプレイヤーの数。	N/A	N/A

注釈[]

プレイヤーがチェストや作業台などのUIを開いている時にも、チェストや作業台側のスロットのアイテムはプレイヤーのインベントリ外と見なされ削除されない。ただし、インベントリ外からカーソルで摑んで取り出したアイテムに関しては削除される。

Bedrock Editionではインベントリ内からカーソルで取り出したアイテムは全モードで削除されるが、Java Editionではクリエイティブモードに限り削除されない。

Java Editionでは、プレイヤーの2×2のクラフトスロットもプレイヤーのインベントリ内と見なされ削除される。

使用例[]

自身のインベントリからすべてのアイテムを削除する：clear
Aliceのインベントリからすべてのアイテムを削除する：clear Alice
Aliceのインベントリからすべての白色の羊毛を削除する：clear Alice minecraft:white_wool
Aliceのインベントリからすべての羊毛を削除する：clear Alice #minecraft:wool
全てのプレイヤーから橙色の羊毛を削除する：clear @a minecraft:wool 1‌^{[Bedrock Edition限定]} または
clear @a minecraft:orange_wool‌^{[Java Edition限定]}
最も近いプレイヤーから、「ダメージ増加Ⅰ」のエンチャントのついた金の剣を削除する。
- clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1s}]}‌^{[Java Edition限定]}
ランダムなプレイヤーに対して、そのプレイヤーが石を持っているかどうか検査する：clear @r minecraft:stone -1 0‌^{[Bedrock Edition限定]} または
clear @r minecraft:stone 0‌^{[Java Edition限定]}

歴史[]

Java Edition
1.4.2	12w37a	`/clear`が追加された。
1.4.2	12w38a	`/clear`に引数`item`が追加された。
1.8	14w02a	`/clear`に引数が`data`追加された。
1.9	15w31b	`/clear`でオフハンドのアイテムが削除されるようになった。
1.13	17w45a	`/clear`の構文が、`/clear [<対象>] [<アイテム>] [<データ>] [<個数>] [<NBT>]`から`/clear [<target>] [<item>] [<count>]`に変更された。
1.16	20w07a	`/clear`で、インベントリ内の2×2のクラフトスロットを削除できるようになった。
1.16	20w22a	`/clear`がインベントリ内のクラフトスロットに対して正しく機能するようになった。
Pocket Edition
1.0.5	alpha 1.0.5.0	`/clear`が追加された。