Commands/clear

{
    "title": "<code>/clear</code>",
    "rows": [
        {
            "field": "\n* 2 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Java Edition\">(link to Java Edition article, displayed as JE)  only</span></i>]</sup>\n* 1 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE)  only</span></i>]</sup>",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "(link to Options article, displayed as Cheat) only‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE)  only</span></i>]</sup>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Clears items from player inventory, including items being dragged by the player. Can also detect and query the amount of specified items.

Usage[edit | edit source]

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.

Syntax[edit | edit source]

• Java Edition

clear [<targets>] [<item>] [<maxCount>]

• Bedrock Edition

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

Arguments[edit | edit source]

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. In Bedrock Edition, the target selector should 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[tests](accepts item or block tags), in which tests can be omitted when they are not needed. See minecraft:item_predicate for details. In Bedrock Edition, it must be an item id or a block id for which the item form exist.

data: int: int

Specifies the data value of the item to be cleared. If not specified, or if -1, all items that match itemName: 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 (from -2147483648 (-2³¹) to 2147483647 (2³¹-1) ). 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 match item, or itemName: Item and data: int are cleared. If 0, instead of clearing of items, detects and queries the amount of specified items.

Must be a 32-bit integer number (from -2147483648 (-2³¹) to 2147483647 (2³¹-1) ). In Java Edition, it must be between 0 and 2147483647 (inclusive). In Bedrock Edition, it should be between -1 and 2147483647 (inclusive).

Result[edit | edit source]

Command	Trigger	Java Edition	Bedrock Edition
Any	The command is incomplete, or any argument is 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 a target selector that 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.
	data: int is lower than -1.	N/A
	maxCount: int is lower than -1.
	Otherwise	Successful

Output[edit | edit source]

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

Examples[edit | edit source]

• 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‌^{[Java Edition only]}
• To clear all orange wool items from the inventory of all players: clear @a minecraft:wool 1‌^{[Bedrock Edition only]} or clear @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 0 0‌^{[Bedrock Edition only]} or clear @r minecraft:stone 0‌^{[Java Edition only]}

History[edit | edit source]

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.
1.20.5			24w09a				Updated the syntax. Now uses item components instead of NBT tags.
							Now target items must have every component that is the same as the specified key-value pair, or the default value of the component if it is not specified.
Pocket Edition
1.0.5			alpha 1.0.5.0				Added /clear.

See also[edit | edit source]

• /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

Navigation[edit | edit source]

v t e Commands
All editions	clear clone damage deop difficulty effect enchant execute fill function gamemode gamerule give help kick kill list locate loot me msg op particle playsound recipe reload ride say schedule scoreboard setblock setworldspawn spawnpoint spreadplayers stopsound summon tag teleport tell tellraw time title tp transfer w weather xp removed placefeature
Java Edition only	advancement attribute ban ban-ip banlist bossbar data datapack debug defaultgamemode experience fillbiome forceload item jfr pardon pardon-ip place publish random return save-all save-off save-on seed setidletimeout spectate team teammsg tm tick trigger worldborder whitelist removed achievement banip blockdata broadcast chunk entitydata home iron locatebiome replaceitem setspawn solid stats testfor testforblock testforblocks toggledownfall unban warden_spawn_tracker wood developer chase debugconfig debugmobspawning debugpath raid serverpack spawn_armor_trims test warden_spawn_tracker
JE & BE only	stop
Bedrock Edition only	allowlist changesetting clearrealmevents dedicatedwsserver gametips project reloadconfig save removed detect mixer resupply simulationtype volumearea
Minecraft Education only	classroommode closechat code codebuilder lesson remove videostream removed position videostreamaction
BE & edu only	? ability allowlist alwaysday camera camerashake clearspawnpoint codebuilder_actorinfo connect daylock dialogue enableencryption event fog getlocalplayername gettopsolidblock hud immutableworld inputpermission listd mobevent music ops permission playanimation querytarget replaceitem script scriptevent setmaxplayers structure takepicture testfor testforblock testforblocks tickingarea titleraw toggledownfall wb worldbuilder wsserver removed clearfixedinv executeasself place setfixedinvslot setfixedinvslots transferserver
Joke	Java Edition only debugdim transform vote warp
Other resources	Argument types Slot Target selectors