Commands/replaceitem

From Minecraft Wiki
Jump to: navigation, search
This page contains information about features that have been removed in the latest development versions.
These features are present in the current version, but may be removed when the next update is released.
replaceitem
Restrictions

Operator

First introduced

Java Edition 1.8 (14w26a)
PE 1.0.5 (PE alpha 1.0.5.0)

Replaces items in the inventories of blocks (chest, furnaces, etc.) or entities (players or mobs) with the given item(s).

Syntax[edit]

  • Java Edition
replaceitem block <pos> <slot> <item> [<count>]
replaceitem entity <targets> <slot> <item> [<count>]
  • Bedrock Edition
replaceitem block <position: x y z> slot.container <slotId: int> <itemName: Item> [amount: int] [data: int] [components: json]
replaceitem entity <target: target> <slotType: EntityEquipmentSlot> <slotId: int> <itemName: Item> [amount: int] [data: int] [components: json]
replaceitem block <position: x y z> slot.container <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]
replaceitem entity <target: target> <slotType: EntityEquipmentSlot> <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]

Arguments[edit]

JE<pos>: block_pos
BE: position: x y z: CommandPosition

In Java Edition, it must be a block position composed of <x>, <y> and <z>, each of which must be an integer or tilde and caret notation.In Bedrock Edition, it must be a three-dimensional coordinates composed of <x>, <y> and <z>, each of which must be a floating-point number or tilde and caret notation.
Specifies the position of the block to be modified.

JE<targets>: entity
BE: target: target: CommandSelector<Actor>

Must be a player name, a target selector or a UUID[Java Edition only]
Specifies one or more entities to modify.

JE: <slot>: item_slot
BE: slotType: EntityEquipmentSlot: EquipmentSlot, slot.container and <slotId: int>: int

Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified.
In Bedrock Edition, slotId: int must be a 32-bit integer number. And it must be between -2147483648 and 2147483647 (inclusive).
For blocks, must be container.<slot_number> (BE: slot.container <slotId: int>) where <slot_number> or <slotId: int> is replaced with a number specifying the slot.
  • Chests, dispensers, droppers, hoppers, and trapped chests are numbered 0 for the top-left slot and then increase first horizontally, then vertically (so, for example, a chest's top row slots are numbered 0 to 8 from left to right). Double chests and double trapped chests are treated as two single container blocks.
  • A brewing stand's bottom slots are numbered 0 to 2 from left to right, its top slot is 3 and the fuel slot is 4.
  • A furnace's slots are numbered 0 for the input slot, 1 for the fuel slot, and 2 for the output slot.
Other blocks which hold items but don't have inventory GUIs (flower pots and jukeboxes) can only be changed with /data.
For entities, must be one of the following, where slot number or slot id is replaced with a number specifying the slot:
Slot Slot Numbers Restrictions
armor.chest(BE: slot.armor.chest <slotId: int>) any number‌[Bedrock Edition only] armor stands, mobs, and players only (though not all mobs will show or make use of the items)
armor.feet(BE: slot.armor.feet <slotId: int>) any number‌[Bedrock Edition only]
armor.head(BE: slot.armor.head <slotId: int>) any number‌[Bedrock Edition only]
armor.legs(BE: slot.armor.legs <slotId: int>) any number‌[Bedrock Edition only]
weapon.mainhand(BE: slot.weapon.mainhand <slotId: int>) any number‌[Bedrock Edition only]
weapon.offhand(BE: slot.weapon.offhand <slotId: int>) any number‌[Bedrock Edition only]
container.<slot_number>(BE: slot.container <slotId: int>) 0–53 players, item frames[Java Edition only] (slot 0), and minecarts only
enderchest.<slot_number>
(BE: slot.enderchest <slotId: int>)
0–26 players only
hotbar.<slot_number>
(BE: slot.hotbar <slotId: int>)
0–8
inventory.<slot_number>
(BE: slot.inventory <slotId: int>)
0–26
horse.saddle
(BE: slot.saddle <slotId: int>)
any number‌[Bedrock Edition only] horses, donkeys, and mules only; <item> or itemName: Item must be a saddle
horse.chest[Java Edition only] donkeys, and mules only; <item> must be a chest
horse.armor
(BE: slot.armor <slotId: int>)
any number‌[Bedrock Edition only] horses and llamas only; <item> or itemName: Item must be a type of horse armor (if a horse) or a carpet (if a llama)
horse.<slot_number>
(BE: slot.chest <slotId: int>)
0–14 donkeys and mules with chests only
villager.<slot_number>
(BE: slot.inventory <slotId: int>)
0–7 villagers only

JE<item>: item_stack
BE: itemName: Item: CommandItem

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

JE<count>: integer
BE: amount: int: int

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

BE: data: int: int

Must be a 32-bit integer number. It must be between -2147483648 and 2147483647 (inclusive).
Specifies the item data for the item(s) to be placed in the block or entity's inventory slot. Values which are invalid for the specified item id will default to 0. If not specified, defaults to 0.

BE: components: json: Json::Value

Must be a JSON Object.
Specifies the item components. Like data tags but supports only minecraft:can_place_on, minecraft:can_destroy, minecraft:item_lock, and minecraft:keep_on_death functions (see Commands/give#Examples)

BE: oldItemHandling: ReplaceMode

Must be one of:
destroy - Directly replaces items ignoring the original items in the specified slot.
keep - Does not replace items if an item occupies that slot.

Result[edit]

CommandTriggerJava EditionBedrock Edition
anythe arguments are not specified correctly Unparseable Failed
<count> exceeds the stack limit of the specified item Failed Successful
/replaceitem block ...if the specified block is not a container Failed
if the specified block does not have the specified slot
/replaceitem entity ...if <targets> or target: target fails to resolve to one or more entities (named players must be online)
if none of the targets have the specified slot (for example, zombies don't have horse.armor)
if specified item cannot be place into the specified slot of any targeted entity(for example, place a stone into armor.chest of a player)
/replaceitem ... keepif an item occupies the specified slot in keep mode N/A
anyOn successReplaces the items in the specified slot with the specified items (previous items in that slot are lost).

Output[edit]

CommandEditionSituationSuccess Count/execute store success .../execute store result ...
anyJava EditionOn fail000
/replaceitem block ...On success111
/replaceitem entity ...On success11the number of entities whose items are successfully replaced
anyBedrock EditionOn fail0N/AN/A
/replaceitem block ...On success1N/AN/A
/replaceitem entity ...On successthe number of entities whose items are successfully replacedN/AN/A

Examples[edit]

  • To replace the items in the bottom-right slot of a single chest two block above with four spruce saplings:
    • replaceitem block ~ ~2 ~ container.26 minecraft:spruce_sapling 4[Java Edition only]
    • replaceitem block ~ ~2 ~ slot.container 26 sapling 4 1[Bedrock Edition only]
  • To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings:
    • replaceitem entity @p hotbar.8 minecraft:spruce_sapling 4[Java Edition only]
    • replaceitem entity @p slot.hotbar 8 sapling 4 1[Bedrock Edition only]

History[edit]

Java Edition
1.814w26aAdded /replaceitem.
1.1418w43a/replaceitem can now be used on item frames.
Upcoming Java Edition
1.1720w46aRemoved /replaceitem. Replaced with /item replace.
Pocket Edition
1.0.5alpha 1.0.5.0Added /replaceitem.
1.1.0alpha 1.1.0.0CanPlaceOn and CanDestroy functions are now supported for /replaceitem.
Bedrock Edition
1.16.0beta 1.16.0.55 Added new overload for /replaceitem with an option for destroy or keep.

See also[edit]

  • /blockdata — can also replace items in a container
  • /entitydata — can also replace items in a 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