Clears items from player inventory, including items being dragged by the player. Can also detects and queries the amount of specified items.
Syntax[]
- Java Edition
clear [<targets>] [<item>] [<maxCount>]
- Bedrock Edition
clear [player: target] [itemName: Item] [data: int] [maxCount: int]
Arguments[]
JE: <targets>
: entity
BE: player: target
: CommandSelector<Player>
- Specifies the player(s) whose items are cleared. If not specified, defaults to the player who executes the command.
- Must be a player name, a target selector or a UUID[Java Edition only]. And the target selector must[JE only]/should[BE only] be of player type.
JE: <item>
: item_predicate
BE: itemName: Item
: enum
- Specifies the item to be cleared. If not specified, all items are cleared.
- In Java Edition, it must be in the format of
item_id{data_tags}
(accepts item or block tags), in which data tags can be omitted when they are not needed. In Bedrock Edition, it must be an item id or a block id for which items exist.
data: int
: int
- Specifies the data value of the item to be cleared. If not specified, or if
-1
, all items that matchitemName: Item
are cleared, regardless of their data. Values (bitwise AND 0xFFFF) that are invalid for the specified item id revert to 0. - Must be a 32-bit integer number. Should be between -1 and 2,147,483,647 (inclusive, without commas).
JE: <maxCount>
: integer
BE: maxCount: int
: int
- Specifies the maximum number of items to be cleared. If not specified, or if
-1
[Bedrock Edition only], all items that matchitem
, oritemName: Item
anddata: int
are cleared. If0
, instead of clearing of items, detects and queries the amount of specified items. - Must be a 32-bit integer number. In Java Edition, it must be between 0 and 2147483647 (inclusive). In Bedrock Edition, it should be between -1 and 2147483647 (inclusive).
Result[]
Command | Trigger | Java Edition | Bedrock Edition |
---|---|---|---|
any | the arguments are not specified correctly | Unparseable | Unparseable |
<targets> or player: target is not specified when the command's executor is not a player. | Failed | Failed | |
player: target is not in player type | N/A | ||
<targets> or player: target fails to resolve to one or more online players | Failed | ||
there are no specified items in any player's inventory. | |||
If data: int is lower than -1. | N/A | ||
If maxCount: int is lower than -1. | |||
Otherwise | Successful |
Output[]
Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
any | Java Edition | On fail | 0 | 0 | 0 |
On success | 1 | 1 | the number of total items that are cleared or detected. | ||
Bedrock Edition | On fail | 0 | N/A | N/A | |
On success | the number of players who have the specified items. | N/A | N/A |
Note[]
Items in the inventory and items from container (chest, crafting table, etc.) dragging over the cursor can be cleared.
In Bedrock Edition, items dragging from the inventory can also be cleared, while in Java Edition only if not in creative mode can these be cleared.
In Java Edition, items in players' four crafting slots can also be cleared.
Examples[]
- To clear your entire inventory:
clear
- To clear all items from Alice's inventory:
clear Alice
- To clear all wool items from Alice's inventory:
clear Alice minecraft:wool
- To clear all orange wool items from the inventory of all players:
clear @a minecraft:wool 1
[Bedrock Edition only] orclear @a minecraft:orange_wool
[Java Edition only] - To clear all golden swords with the "Sharpness I" enchantment from the nearest player
clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1s}]}
[Java Edition only]
- To test if a random player has stone in their inventory:
clear @r minecraft:stone -1 0
[Bedrock Edition only] orclear @r minecraft:stone 0
[Java Edition only]
See also[]
/data
— can change or remove items in block or entity inventories/give
— give items to player/kill
— can destroy item entities/item
[Java Edition only] — can manipulate items in block or entity inventories/replaceitem
[Bedrock Edition only] — can replace items in block or entity inventories
History[]
Java Edition | |||||
---|---|---|---|---|---|
1.4.2 | 12w37a | Added /clear . | |||
12w38a | Added item argument to /clear . | ||||
1.8 | 14w02a | Added data argument to /clear . | |||
1.9 | 15w31b | /clear now clears the offhand slot. | |||
1.13 | 17w45a | The syntax of /clear has changed from /clear [<target>] [<item>] [<data>] [<count>] [<nbt>] to
/clear [<target>] [<item>] [<count>] . | |||
1.16 | 20w07a | /clear now clears the items in the inventory crafting grid. | |||
20w22a | /clear now works properly with the inventory crafting grid. | ||||
Pocket Edition | |||||
1.0.5 | alpha 1.0.5.0 | Added /clear . |