Minecraft Wiki

The Minecraft Wiki has moved from Fandom; see the linked discussion page for details.

READ MORE

Minecraft Wiki
Advertisement
Information icon
This feature is exclusive to Java Edition. 

Manipulate or copy items in the inventories of blocks (chests, furnaces, etc.) or entities (players or mobs).

Syntax[]

item modify (block <pos>|entity <targets>) <slot> <modifier>
Modifies the items in the specified slot with the specified modifier.
item replace (block <pos>|entity <targets>) <slot> with <item> [<count>]
Replaces the items in the specified slot with the specified items.
item replace (block <pos>|entity <targets>) <slot> from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>]
Copies the source items to the target slot and optionally modifies it with the modifier.

Syntax displayed in various ways

Arguments[]

<pos>: block_pos

Specifies the position of the block to be modified.
Must be a block position composed of <x>, <y> and <z>, each of which must be an integer or a tilde and caret notation.

<targets>: entity

Specifies one or more entities to modify.
Must be a player name, a target selector or a UUID.

<slot>: item_slot

Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified.
Must be a string notation that refer to certain slots in the inventory, which consists of "slot type" and optional "slot number", in the format of <slot_type> or <slot_type>.<slot_number>. See Slot for details.

<modifier>: resource_location

Specifies the item modifier to apply on the chosen item.
Must be a resource location which will be resolved during command execution into unregistered content or client-side content.

<item>: item_stack

Specifies the item to be placed in the block or entity's inventory slot.
It must be in the format of item_id{data_tags}(accepts item and block tags), in which data tags can be omitted when they are not needed.

<count>: integer

Specifies the number of items to be placed in the block or entity's inventory slot.
Must be a 32-bit integer number. And it must be between 1 and 64 (inclusive).

<sourcePos>: block_pos

Specifies the position of the block to copy items from.
Must be a block position composed of <x>, <y> and <z>, each of which must be an integer or a tilde and caret notation.

<sourceTarget>: entity

Specifies an entity to copy items from.
Must be a player name, a target selector or a UUID.

<sourceSlot>: item_slot

Specifies the inventory slot to copy the items from. Valid values depend on whether the source is block or an entity. See <slot> argument above for more information.

Result[]

CommandTriggerJava Edition
anythe arguments are not specified correctly Unparseable
/item modify ...
/item ... from ...
the specified <modifier> doesn't exist Failed
/item modify block ...
/item replace block ...
<pos> is unloaded or out of the world
the block at the <pos> is not a container
the block at the <pos> does not have the specified slot
/item modify entity ...
/item replace entity ...
<targets> fails to resolve to one or more entities (named player must be online)
All selected entities meet one or more of the following conditions:
  • It doesn't have the specified slot (for example, zombies have no horse.armor)
  • Specified item cannot be placed into the specified slot of its (for example, to place a stone into armor.chest of a player)
/... with <item> <count><count> exceeds the stack limit of the specified item
/... from block ...<sourcePos> is unloaded or out of the world
the block at <sourcePos> is not a container
the block at <sourcePos> does not have the specified slot
/... from entity ...<sourceTarget> fails to resolve to a single entity (named player must be online)
the <sourceTarget> doesn't have the specified slot (for example, zombies have no horse.armor)
anyOtherwiseSuccessful

Output[]

CommandEditionSituationSuccess Count/execute store success .../execute store result ...
anyJava EditionOn fail000
/item (modify|replace) block ...On success111
/item (modify|replace) entity ...On success11the number of entities whose items are successfully replaced

Examples[]

  • To replace the items in the bottom-right slot of a single chest two block above with four spruce saplings:
    • /item replace block ~ ~2 ~ container.26 with minecraft:spruce_sapling 4
  • To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings:
    • /item replace entity @p hotbar.8 with minecraft:spruce_sapling 4
  • To replace the item in the offhand of the selected player with the item in their main hand:
    • /item replace entity @s weapon.offhand from entity @s weapon.mainhand
  • To put a brown banner on a player's head
    • /item replace entity @s armor.head with minecraft:brown_banner
  • To increase the count of the item in your main hand:
    • /item modify entity @s weapon.mainhand example:increase_count
    • file in a datapack: data/example/item_modifiers/increase_count.json
      {
        "function": "minecraft:set_count",
        "count": 1,
        "add": true
      }
      

History[]

Java Edition
1.1720w46aAdded /item, replacing /replaceitem.
21w19aSyntax of /item has been changed.
1.19Pre-release 1Replacing the off-hand slot using /item no longer produces a vibration.[1]
Upcoming Java Edition
1.20.223w31aCan now replace items in jukeboxes.
Can now remove items in chiseled bookshelves.

See also[]

  • /data — can also replace items in a container's or mob's inventory, or modify the drop chances of armor and weapons
  • /give — give items to players without specifying specific inventory slots or overwriting other items
  • /replaceitem — The Bedrock Edition equivalent
Advertisement