Minecraft:Commands/clear - Revision history

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T20:08:39Z

Fix template calls: add MC/ prefix

← Older revision		Revision as of 20:08, 9 April 2026
Line 13:		Line 13:
	Items in the inventory and items from container (chest, crafting table, etc.) dragging over the cursor can be cleared.		Items in the inventory and items from container (chest, crafting table, etc.) dragging over the cursor can be cleared.

	{{IN\|bedrock}}, items dragging from the inventory can also be cleared, while {{in\|java}} only if not in creative mode can these be cleared.		{{MC/In\|bedrock}}, items dragging from the inventory can also be cleared, while {{MC/In\|java}} only if not in creative mode can these be cleared.

	{{IN\|java}}, items in players' four crafting slots can also be cleared.		{{MC/In\|java}}, items in players' four crafting slots can also be cleared.

	== Syntax ==		== Syntax ==
Line 26:		Line 26:

	== Arguments ==		== Arguments ==
	{{~~argument~~\|targets\|entity\|player: target\|CommandSelector<Player>}}		{{MC/Argument\|targets\|entity\|player: target\|CommandSelector<Player>}}
	: Specifies the player(s) whose items are cleared. If not specified, defaults to the player who executes the command.		: Specifies the player(s) whose items are cleared. If not specified, defaults to the player who executes the command.
	: {{~~arg~~ desc\|je=entity\|amount=multiple\|type=players\|be=player}}		: {{MC/Arg desc\|je=entity\|amount=multiple\|type=players\|be=player}}

	{{~~argument~~\|item\|item_predicate\|itemName: Item\|enum}}		{{MC/Argument\|item\|item_predicate\|itemName: Item\|enum}}
	: Specifies the item to be cleared. If not specified, all items are cleared.		: Specifies the item to be cleared. If not specified, all items are cleared.
	: {{~~arg~~ desc\|je=item_predicate\|be=CommandItem}}		: {{MC/Arg desc\|je=item_predicate\|be=CommandItem}}

	{{~~argument~~\|be=1\|data: int\|int}}		{{MC/Argument\|be=1\|data: int\|int}}
	: Specifies the [[Minecraft:Bedrock Edition data values\|data value]] of the item to be cleared. If not specified, or if <code>-1</code>, all items that match <code>itemName: Item</code> are cleared, regardless of their data. Values (bitwise AND 0xFFFF) that are invalid for the specified item id revert to 0.		: Specifies the [[Minecraft:Bedrock Edition data values\|data value]] of the item to be cleared. If not specified, or if <code>-1</code>, all items that match <code>itemName: Item</code> are cleared, regardless of their data. Values (bitwise AND 0xFFFF) that are invalid for the specified item id revert to 0.
	: {{~~arg~~ desc\|be=int}} Should be between -1 and 2,147,483,647 (inclusive, without commas).		: {{MC/Arg desc\|be=int}} Should be between -1 and 2,147,483,647 (inclusive, without commas).

	{{~~argument~~\|maxCount\|integer\|maxCount: int\|int}}		{{MC/Argument\|maxCount\|integer\|maxCount: int\|int}}
	: Specifies the maximum number of items to be cleared. If not specified, or if <code>-1</code>{{only\|bedrock}}, all items that match <code>item</code>, or <code>itemName: Item</code> and <code>data: int</code> are cleared. If <code>0</code>, instead of clearing of items, detects and queries the amount of specified items.		: Specifies the maximum number of items to be cleared. If not specified, or if <code>-1</code>{{only\|bedrock}}, all items that match <code>item</code>, or <code>itemName: Item</code> and <code>data: int</code> are cleared. If <code>0</code>, instead of clearing of items, detects and queries the amount of specified items.
	: {{~~arg~~ desc\|be=int\|je=integer\|min=0}} {{IN\|bedrock}}, it should be between -1 and 2147483647 (inclusive).		: {{MC/Arg desc\|be=int\|je=integer\|min=0}} {{MC/In\|bedrock}}, it should be between -1 and 2147483647 (inclusive).

	== Result ==		== Result ==
Line 57:		Line 57:
	== Output ==		== Output ==

	{{Output table}}		{{MC/Output table}}
	{{Output table\|edition=je\|On fail\|0\|0\|0}}		{{MC/Output table\|edition=je\|On fail\|0\|0\|0}}
	{{Output table\|On success\|1\|1\|the number of total items that are cleared or detected.}}		{{MC/Output table\|On success\|1\|1\|the number of total items that are cleared or detected.}}
	{{Output table\|edition=be\|On fail\|0}}		{{MC/Output table\|edition=be\|On fail\|0}}
	{{Output table\|On success\|the number of players who have the specified items.}}		{{MC/Output table\|On success\|the number of players who have the specified items.}}
	{{Output table}}		{{MC/Output table}}

	== Examples ==		== Examples ==
Line 76:		Line 76:
	=== ''Java Edition'' ===		=== ''Java Edition'' ===
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java}}		\|{{MC/HistoryLine\|java}}
	\|{{HistoryLine\|\|1.4.2\|dev=12w37a\|Added {{~~cmd~~\|clear\|link=none}}.}}		\|{{HistoryLine\|\|1.4.2\|dev=12w37a\|Added {{MC/Cmd\|clear\|link=none}}.}}
	\|{{HistoryLine\|\|\|dev=12w38a\|Added {{cd\|item}} argument to {{~~cmd~~\|clear\|link=none}}.}}		\|{{HistoryLine\|\|\|dev=12w38a\|Added {{MC/Cd\|item}} argument to {{MC/Cmd\|clear\|link=none}}.}}
	\|{{HistoryLine\|\|1.8\|dev=14w02a\|Added {{cd\|data}} argument to {{~~cmd~~\|clear\|link=none}}.}}		\|{{HistoryLine\|\|1.8\|dev=14w02a\|Added {{MC/Cd\|data}} argument to {{MC/Cmd\|clear\|link=none}}.}}
	\|{{HistoryLine\|\|1.9\|dev=15w31b\|{{~~cmd~~\|clear\|link=none}} now clears the offhand slot.}}		\|{{HistoryLine\|\|1.9\|dev=15w31b\|{{MC/Cmd\|clear\|link=none}} now clears the offhand slot.}}
	\|{{HistoryLine\|\|1.13\|dev=17w45a\|The syntax of {{~~cmd~~\|clear\|link=none}} has changed from {{~~cmd~~\|clear [<target>] [<item>] [<data>] [<count>] [<nbt>]}} to		\|{{HistoryLine\|\|1.13\|dev=17w45a\|The syntax of {{MC/Cmd\|clear\|link=none}} has changed from {{MC/Cmd\|clear [<target>] [<item>] [<data>] [<count>] [<nbt>]}} to
	{{~~cmd~~\|clear [<target>] [<item>] [<count>]}}.}}		{{MC/Cmd\|clear [<target>] [<item>] [<count>]}}.}}
	\|{{HistoryLine\|\|1.16\|dev=20w07a\|{{~~cmd~~\|clear\|link=none}} now clears the items in the inventory crafting grid.}}		\|{{HistoryLine\|\|1.16\|dev=20w07a\|{{MC/Cmd\|clear\|link=none}} now clears the items in the inventory crafting grid.}}
	\|{{HistoryLine\|\|\|dev=20w22a\|{{~~cmd~~\|clear\|link=none}} now works properly with the inventory crafting grid.}}		\|{{HistoryLine\|\|\|dev=20w22a\|{{MC/Cmd\|clear\|link=none}} now works properly with the inventory crafting grid.}}
	\|{{HistoryLine\|\|1.20.5\|dev=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.}}		\|{{MC/HistoryLine\|\|1.20.5\|dev=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.}}
	}}		}}

	=== ''Bedrock Edition'' ===		=== ''Bedrock Edition'' ===
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|pocket}}		\|{{MC/HistoryLine\|pocket}}
	\|{{HistoryLine\|\|1.0.5\|dev=alpha 1.0.5.0\|Added {{~~cmd~~\|clear\|link=none}}.}}		\|{{HistoryLine\|\|1.0.5\|dev=alpha 1.0.5.0\|Added {{MC/Cmd\|clear\|link=none}}.}}
	}}		}}

	== See also ==		== See also ==
	* {{~~cmd~~\|data}} — can change or remove items in block or entity inventories		* {{MC/Cmd\|data}} — can change or remove items in block or entity inventories
	* {{~~cmd~~\|give}} — give items to player		* {{MC/Cmd\|give}} — give items to player
	* {{~~cmd~~\|kill}} — can destroy item entities		* {{MC/Cmd\|kill}} — can destroy item entities
	* {{~~cmd~~\|item}}{{only\|java}} — can manipulate items in block or entity inventories		* {{MC/Cmd\|item}}{{only\|java}} — can manipulate items in block or entity inventories
	* {{~~cmd~~\|replaceitem}}{{only\|bedrock}} — can replace items in block or entity inventories		* {{MC/Cmd\|replaceitem}}{{only\|bedrock}} — can replace items in block or entity inventories

	== External links ==		== External links ==
Line 106:		Line 106:

	== Navigation ==		== Navigation ==
	{{Navbox commands}}		{{MC/Navbox commands}}

	de:Befehl/clear		de:Befehl/clear

SyncBot: Remove broken links to missing pages

2026-04-09T15:43:30Z

Remove broken links to missing pages

← Older revision		Revision as of 15:43, 9 April 2026
Line 4:		Line 4:
	* 2 {{only\|java\|short=1}}		* 2 {{only\|java\|short=1}}
	* 1 {{only\|bedrock\|short=1}}		* 1 {{only\|bedrock\|short=1}}
	\|others=~~[[Minecraft:~~Cheat]] only{{only\|bedrock\|short=1}}		\|others=Cheat only{{only\|bedrock\|short=1}}
	}}		}}

	Clears [[Minecraft:item]]s from player [[Minecraft:inventory]], including items being dragged by the ~~[[Minecraft:~~player]]. Can also detect and query the amount of specified items.		Clears [[Minecraft:item]]s from player [[Minecraft:inventory]], including items being dragged by the player. Can also detect and query the amount of specified items.

	== Usage ==		== Usage ==
Line 47:		Line 47:
	{{Result table\|The command is incomplete, or any argument is not specified correctly.\|unparseable\|unparseable}}		{{Result table\|The command is incomplete, or any argument is not specified correctly.\|unparseable\|unparseable}}
	{{Result table\|<code><targets></code> or <code>player: target</code> is not specified when the command's executor is not a player.\|fail\|fail}}		{{Result table\|<code><targets></code> or <code>player: target</code> is not specified when the command's executor is not a player.\|fail\|fail}}
	{{Result table\|<code>player: target</code> is a target selector that is not in ~~[[Minecraft:Target_selectors#Player_type_and_single_type\|~~player type]].\|N/A\|}}		{{Result table\|<code>player: target</code> is a target selector that is not in player type.\|N/A\|}}
	{{Result table\|<code><targets></code> or <code>player: target</code> fails to resolve to one or more online players.\|fail}}		{{Result table\|<code><targets></code> or <code>player: target</code> fails to resolve to one or more online players.\|fail}}
	{{Result table\|There are no specified items in any player's inventory.}}		{{Result table\|There are no specified items in any player's inventory.}}
Line 85:		Line 85:
	\|{{HistoryLine\|\|1.16\|dev=20w07a\|{{cmd\|clear\|link=none}} now clears the items in the inventory crafting grid.}}		\|{{HistoryLine\|\|1.16\|dev=20w07a\|{{cmd\|clear\|link=none}} now clears the items in the inventory crafting grid.}}
	\|{{HistoryLine\|\|\|dev=20w22a\|{{cmd\|clear\|link=none}} now works properly with the inventory crafting grid.}}		\|{{HistoryLine\|\|\|dev=20w22a\|{{cmd\|clear\|link=none}} now works properly with the inventory crafting grid.}}
	\|{{HistoryLine\|\|1.20.5\|dev=24w09a\|Updated the syntax. Now uses ~~[[Minecraft:~~item ~~component]]s~~ instead of ~~[[Minecraft:~~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.}}		\|{{HistoryLine\|\|1.20.5\|dev=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.}}
	}}		}}

Line 108:		Line 108:
	{{Navbox commands}}		{{Navbox commands}}

	~~[[Minecraft:~~de:Befehl/clear]]		de:Befehl/clear
	~~[[Minecraft:~~es:Comandos/clear]]		es:Comandos/clear
	~~[[Minecraft:~~fr:Commandes/clear]]		fr:Commandes/clear
	~~[[Minecraft:~~ja:コマンド/clear]]		ja:コマンド/clear
	~~[[Minecraft:~~ko:명령어/clear]]		ko:명령어/clear
	~~[[Minecraft:~~pt:Comandos/clear]]		pt:Comandos/clear
	~~[[Minecraft:~~ru:Команды консоли/clear]]		ru:Команды консоли/clear
	~~[[Minecraft:~~th:คำสั่ง/clear]]		th:คำสั่ง/clear
	~~[[Minecraft:~~uk:Команди консолі/clear]]		uk:Команди консолі/clear
	~~[[Minecraft:~~zh:命令/clear]]		zh:命令/clear

imported>MinecraftBedrockPlayer7 at 17:01, 20 November 2025

2025-11-20T17:01:14Z

New page

{{Infobox command
|name=clear
|oplevel=
* 2 {{only|java|short=1}}
* 1 {{only|bedrock|short=1}}
|others=[[Minecraft:Cheat]] only{{only|bedrock|short=1}}
}}

Clears [[Minecraft:item]]s from player [[Minecraft:inventory]], including items being dragged by the [[Minecraft:player]]. Can also detect and query the amount of specified items.

== Usage ==

Items in the inventory and items from container (chest, crafting table, etc.) dragging over the cursor can be cleared.

{{IN|bedrock}}, items dragging from the inventory can also be cleared, while {{in|java}} only if not in creative mode can these be cleared.

{{IN|java}}, items in players' four crafting slots can also be cleared.

== Syntax ==

* '''Java Edition'''
: <code>clear [<targets>] [<item>] [<maxCount>]</code>

* '''Bedrock Edition'''
: <code>clear [player: target] [itemName: Item] [data: int] [maxCount: int]</code>

== Arguments ==
{{argument|targets|entity|player: target|CommandSelector<Player>}}
: Specifies the player(s) whose items are cleared. If not specified, defaults to the player who executes the command.
: {{arg desc|je=entity|amount=multiple|type=players|be=player}}

{{argument|item|item_predicate|itemName: Item|enum}}
: Specifies the item to be cleared. If not specified, all items are cleared.
: {{arg desc|je=item_predicate|be=CommandItem}}

{{argument|be=1|data: int|int}}
: Specifies the [[Minecraft:Bedrock Edition data values|data value]] of the item to be cleared. If not specified, or if <code>-1</code>, all items that match <code>itemName: Item</code> are cleared, regardless of their data. Values (bitwise AND 0xFFFF) that are invalid for the specified item id revert to 0.
: {{arg desc|be=int}} Should be between -1 and 2,147,483,647 (inclusive, without commas).

{{argument|maxCount|integer|maxCount: int|int}}
: Specifies the maximum number of items to be cleared. If not specified, or if <code>-1</code>{{only|bedrock}}, all items that match <code>item</code>, or <code>itemName: Item</code> and <code>data: int</code> are cleared. If <code>0</code>, instead of clearing of items, detects and queries the amount of specified items.
: {{arg desc|be=int|je=integer|min=0}} {{IN|bedrock}}, it should be between -1 and 2147483647 (inclusive).

== Result ==

{{Result table}}
{{Result table|The command is incomplete, or any argument is not specified correctly.|unparseable|unparseable}}
{{Result table|<code><targets></code> or <code>player: target</code> is not specified when the command's executor is not a player.|fail|fail}}
{{Result table|<code>player: target</code> is a target selector that is not in [[Minecraft:Target_selectors#Player_type_and_single_type|player type]].|N/A|}}
{{Result table|<code><targets></code> or <code>player: target</code> fails to resolve to one or more online players.|fail}}
{{Result table|There are no specified items in any player's inventory.}}
{{Result table|<code>data: int</code> is lower than -1.|N/A}}
{{Result table|<code>maxCount: int</code> is lower than -1.}}
{{Result table|succeed}}
{{Result table}}

== Output ==

{{Output table}}
{{Output table|edition=je|On fail|0|0|0}}
{{Output table|On success|1|1|the number of total items that are cleared or detected.}}
{{Output table|edition=be|On fail|0}}
{{Output table|On success|the number of players who have the specified items.}}
{{Output table}}

== Examples ==
* To clear your entire inventory: <code>clear</code>
* To clear all items from Alice's inventory: <code>clear Alice</code>
* To clear all wool items from Alice's inventory: <code>clear Alice #minecraft:wool</code>{{only|Java}}
* To clear all orange wool items from the inventory of all players: <code>clear @a minecraft:wool 1</code>{{only|Bedrock}} or <code> clear @a minecraft:orange_wool</code>
* To clear all golden swords with the "Sharpness I" enchantment from the nearest player
** <code>clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1s}]}</code>{{only|Java}}
*To test if a random player has stone in their inventory: <code>clear @r minecraft:stone 0 0</code>{{only|Bedrock}} or <code> clear @r minecraft:stone 0</code>{{only|Java}}

== History ==
=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.4.2|dev=12w37a|Added {{cmd|clear|link=none}}.}}
|{{HistoryLine|||dev=12w38a|Added {{cd|item}} argument to {{cmd|clear|link=none}}.}}
|{{HistoryLine||1.8|dev=14w02a|Added {{cd|data}} argument to {{cmd|clear|link=none}}.}}
|{{HistoryLine||1.9|dev=15w31b|{{cmd|clear|link=none}} now clears the offhand slot.}}
|{{HistoryLine||1.13|dev=17w45a|The syntax of {{cmd|clear|link=none}} has changed from {{cmd|clear [<target>] [<item>] [<data>] [<count>] [<nbt>]}} to
{{cmd|clear [<target>] [<item>] [<count>]}}.}}
|{{HistoryLine||1.16|dev=20w07a|{{cmd|clear|link=none}} now clears the items in the inventory crafting grid.}}
|{{HistoryLine|||dev=20w22a|{{cmd|clear|link=none}} now works properly with the inventory crafting grid.}}
|{{HistoryLine||1.20.5|dev=24w09a|Updated the syntax. Now uses [[Minecraft:item component]]s instead of [[Minecraft: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.}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|pocket}}
|{{HistoryLine||1.0.5|dev=alpha 1.0.5.0|Added {{cmd|clear|link=none}}.}}
}}

== See also ==
* {{cmd|data}} — can change or remove items in block or entity inventories
* {{cmd|give}} — give items to player
* {{cmd|kill}} — can destroy item entities
* {{cmd|item}}{{only|java}} — can manipulate items in block or entity inventories
* {{cmd|replaceitem}}{{only|bedrock}} — can replace items in block or entity inventories

== External links ==

* {{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/commands/commands/clear?view=minecraft-bedrock-stable|title=<code>/clear</code> Command|website=Microsoft Learn|date=October 11, 2023}}

== Navigation ==
{{Navbox commands}}

[[Minecraft:de:Befehl/clear]]
[[Minecraft:es:Comandos/clear]]
[[Minecraft:fr:Commandes/clear]]
[[Minecraft:ja:コマンド/clear]]
[[Minecraft:ko:명령어/clear]]
[[Minecraft:pt:Comandos/clear]]
[[Minecraft:ru:Команды консоли/clear]]
[[Minecraft:th:คำสั่ง/clear]]
[[Minecraft:uk:Команди консолі/clear]]
[[Minecraft:zh:命令/clear]]