Editing MinecraftCommands (section)

=== clear ===

{{/infobox
|clear
|op
|1.4.2|12w37a
}}

Clears items from player inventory.

;Syntax

: <code>clear [''player''] [''item''] [''data''] [''maxCount''] [''dataTag'']</code>

;Arguments

: ''player'' (optional)
:: Must be a player name or a [[#Target selectors|target selector]]. If not specified, defaults to the player who executed the command. Not optional in command blocks.

: ''item'' (optional)
:: Specifies the [[Data values|id]] of the item to be cleared. If not specified, all items in the player's inventory are cleared.

: ''data'' (optional)
:: Specifies the [[Data values|data value]] of the item to be cleared. If not specified, or if <code>-1</code>, all items that match ''item'' are cleared, regardless of their data.

: ''maxCount'' (optional)
:: Specifies the maximum number of items to be cleared. If not specified, or if <code>-1</code>, all items that match ''item'' and ''data'' are cleared. If <code>0</code>, does not clear items, but returns successfully if there were items that could have been cleared (allowing detection of items rather than clearing of items).

: ''dataTag'' (optional)
:: Specifies the data tags of the item to be cleared (only items matching the specified data tags will be cleared — data tags not specified will not be considered). Must be a compound [[NBT tag]] (for example, <code>{display:{Name:Fred}}</code>).

;Result

: Fails if the arguments are not specified correctly, if ''player'' fails to resolve to one or more online players, or if no items are removed (except when ''maxCount'' is <code>0</code>)

: On success, removes the specified items from the player(s).

;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>

: To clear all orange wool items from the inventory of all players: <code>clear @a minecraft:wool 1</code>

: To clear all golden swords with the "Sharpness I" enchantment from the nearest player, regardless of their damage value:
:: <code>clear @p minecraft:golden_sword -1 -1 {ench:[{id:16s,lvl:1s}]}</code>

;See also

: {{cmd|blockdata}} — can change or remove items in block inventories
: {{cmd|entitydata}} — can change or remove items in entity inventories
: {{cmd|give}} — give items to player
: {{cmd|kill}} — can destroy item entities
: {{cmd|replaceitem}} — can replace items in block or entity inventories


<!-- please retain double newline above for section differentiation -->