Minecraft:Commands/item

Template:For Template:Exclusive Template:Update Template:Infobox command Manipulate or copy Minecraft:items in the Minecraft:inventories of Minecraft:blocks (Minecraft:chests, Minecraft:furnaces, etc.) or Minecraft:entities (Minecraft:players or Minecraft:mobs).

Syntax

item modify (block <pos>|entity <targets>) <slot> <modifier>

Modifies the items in the specified slot with the specified Minecraft:item 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.

item override (block <pos>|entity <targets>) <slots> with <item> [<count>]

item override (block <pos>|entity <targets>) <slots> from (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]

Similar to Template:Cd, but can fill items across multiple slots. When there are more target slots than source slots, the extra target slots are cleared. See Template:Slink and Minecraft:Slot for more details.

item fill (block <pos>|entity <targets>) <slots> with <item> [<count>]

item fill (block <pos>|entity <targets>) <slots> from (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]

Similar to Template:Cd, but instead of clearing extra target slots, items from the source slots are repeated to fill all target slots.

Syntax displayed in various ways

Simplified tree:
item ... ... modify <TARGET> <slot> <modifier> ... replace <TARGET> <slot> ... with <item> [<count>] ... from <SOURCE> <sourceSlot> [<modifier>] ... override <TARGET> <slots> ... fill <TARGET> <slots> ... with <item> [<count>] ... from <SOURCE> <sourceSlots> [<modifier>] where substituted arguments are: <TARGET> = (block <pos>|entity <targets>) <SOURCE> = (block <sourcePos>|entity <sourceTarget>)

Minimised:
item (modify (block <pos>|entity <targets>) <slot> <modifier>|replace (block <pos>|entity <targets>) <slot> (with <item> [<count>]|from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>])|(override|fill) (block <pos>|entity <targets>) <slots> (with <item> [<count>]|from (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]))

Maximised:

item modify block <pos> <slot> <modifier> item modify entity <targets> <slot> <modifier> item replace block <pos> <slot> with <item> [<count>] item replace block <pos> <slot> from block <sourcePos> <sourceSlot> [<modifier>] item replace block <pos> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>] item replace entity <targets> <slot> with <item> [<count>] item replace entity <targets> <slot> from block <sourcePos> <sourceSlot> [<modifier>] item replace entity <targets> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>] item override block <pos> <slot> with <item> [<count>] item override block <pos> <slot> from block <sourcePos> <sourceSlots> [<modifier>] item override block <pos> <slot> from entity <sourceTarget> <sourceSlots> [<modifier>] item override entity <targets> <slot> with <item> [<count>] item override entity <targets> <slot> from block <sourcePos> <sourceSlots> [<modifier>] item override entity <targets> <slot> from entity <sourceTarget> <sourceSlots> [<modifier>] item fill block <pos> <slots> with <item> [<count>] item fill block <pos> <slots> from block <sourcePos> <sourceSlots> [<modifier>] item fill block <pos> <slots> from entity <sourceTarget> <sourceSlots> [<modifier>] item fill entity <targets> <slots> with <item> [<count>] item fill entity <targets> <slots> from block <sourcePos> <sourceSlots> [<modifier>] item fill entity <targets> <slots> from entity <sourceTarget> <sourceSlots> [<modifier>]

Arguments

Specifies the position of the block to be modified.

Template:Arg desc

Specifies one or more entities to modify.

Template:Arg desc

Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified.

Template:Arg desc

Similar to Template:Argument, but can contain multiple slots.

Template:Arg desc

Specifies the Minecraft:item modifier to apply on the chosen item.

Template:Arg desc

Specifies the item to be placed in the block or entity's inventory slot.

Template:Arg desc

Specifies the number of items to be placed in the block or entity's inventory slot.

Template:Arg desc

Specifies the position of the block to copy items from.

Template:Arg desc

Specifies an entity to copy items from.

Template:Arg descTemplate:Until

Specifies the inventory slot to copy the items from. Valid values depend on whether the source is block or an entity.

Template:Arg desc

Similar to Template:Argument, but can contain multiple slots.

Template:Arg desc

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 Minecraft: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 data pack: data/example/item_modifier/increase_count.json<syntaxhighlight lang="json">{

 "function": "minecraft:set_count",
 "count": 1,
 "add": true

}</syntaxhighlight>

• To increase the count of the item in your main hand without external files:
  • item modify entity @s weapon.mainhand {"function":"minecraft:set_count","count":1,"add":true}
• To put the item in your hand, on your head:
  • /item replace entity @s armor.head from entity @s weapon.mainhand

See also

• Template:Cmd — can also replace items in a container's or mob's inventory, or modify the drop chances of armor and weapons
• Template:Cmd — give items to players without specifying specific inventory slots or overwriting other items
• Template:Cmd — The Template:El equivalent