プレイヤーのインベントリからアイテムを消去する。
- 構文
- Java Edition
clear [<targets>] [<item>] [<maxCount>]
- Bedrock Edition
clear [player: target] [itemName: Item] [data: int] [maxCount: int]
- 引数
- targets(BE:player: target)(省略可能)
- プレイヤー名、またはターゲットセレクターでなければならない。指定されなかった場合、コマンドを実行したプレイヤーが対象となる。コマンドブロックでは、この引数は必須となる。
- item(BE: itemName: Item)(省略可能)
- 消去するアイテムのIDを指定する。指定されなかった場合、プレイヤーのインベントリ内にあるすべてのアイテムを消去する。
- data: int(省略可能)[Bedrock Edition限定]
- 消去するアイテムのデータ値を指定する。指定されなかった、または
-1
が指定された場合、アイテムのデータ値に関わらずitemに合致するすべてのアイテムを消去する。
- 消去するアイテムのデータ値を指定する。指定されなかった、または
- maxCount(BE: maxCount: int)(省略可能)
- 消去するアイテムの最大個数を指定する。指定されなかった、または
-1
が指定された場合[Bedrock Edition限定]、itemおよびdataに合致するすべてのアイテムを消去する。0
が指定された場合はアイテムは消去されないが、条件に合致するアイテムが存在した場合、結果は成功となる(アイテムの消去ではなくアイテムの検知が可能となる)。
- 消去するアイテムの最大個数を指定する。指定されなかった、または
- 結果
- 引数が正しく指定されなかった、player引数でオンラインのプレイヤーを解決できなかった、またはアイテムが消去できなかった(maxCountが
0
である場合を除く)場合に失敗する。 - 成功すると、プレイヤーから指定したアイテムが消去される。
- 例
- 自分のインベントリからすべてのアイテムを消去する
clear
- Aliceのインベントリからすべてのアイテムを消去する
clear Alice
- Aliceのインベントリからすべての羊毛を消去する
clear Alice minecraft:wool
- すべてのプレイヤーのインベントリから橙色の羊毛を消去する
clear @a minecraft:wool 1
[Bedrock Edition限定]、clear @a minecraft:orange_wool
[Java Edition限定]
- 最寄りのプレイヤーのインベントリから「ダメージ増加 I」のエンチャント効果が付与された金の剣を消去する
clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1s}]}
[Java Edition限定]
- 関連項目
/data
— ブロック、またはエンティティのインベントリのアイテムを変更または消去するコマンド/give
— プレイヤーにアイテムを与えるコマンド/kill
— アイテムエンティティを消去するコマンド/replaceitem
— ブロックやエンティティのインベントリのアイテムを置換するコマンド
歴史
Java Edition | |||||
---|---|---|---|---|---|
1.3.1 | 12w37a | /clear が追加された。 | |||
12w38a | 引数 item が追加された。 | ||||
1.8 | 14w02a | 引数 data が追加された。 | |||
Bedrock Edition | |||||
1.0.5 | alpha 1.0.5.0 | /clear が追加された。 |