Commands/replaceitem

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

Syntax

 * Java Edition


 * Bedrock Edition

Arguments

 * Specifies the position of the block to be modified.
 * Specifies the position of the block to be modified.


 * Specifies one or more entities to modify.
 * Specifies one or more entities to modify.


 * ,  and
 * Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified.
 * $$,   And it must be between -2147483648 and 2147483647 (inclusive).
 * ⇭⇭⇭⇭⇭,   And it must be between -2147483648 and 2147483647 (inclusive).


 * For blocks, must be  (BE:  ) where  or  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.
 * For entities, must be one of the following, where slot number or slot id is replaced with a number specifying the slot:


 * {| class="wikitable" data-description="Slot information"

!Slot !Slot Numbers !Restrictions
 * (BE: )
 * any number
 * rowspan=6|armor stands, mobs, and players only (though not all mobs will show or make use of the items)
 * (BE: )
 * any number
 * (BE: )
 * any number
 * (BE: )
 * any number
 * (BE: )
 * any number
 * (BE: )
 * any number
 * (BE: )
 * align="center"|0–53
 * players, item frames (slot 0), and minecarts only
 * (BE: )
 * align="center"|0–26
 * rowspan=3|players only
 * (BE: )
 * align="center"|0–8
 * (BE: )
 * align="center"|0–26
 * (BE: )
 * any number
 * horses, donkeys, and mules only;  or   must be a saddle
 * donkeys, and mules only;  must be a chest
 * (BE: )
 * any number
 * horses and llamas only;  or   must be a type of horse armor (if a horse) or a carpet (if a llama)
 * (BE: )
 * align="center"|0–14
 * donkeys and mules with chests only
 * (BE: )
 * align="center"|0–7
 * villagers only
 * }
 * donkeys, and mules only;  must be a chest
 * (BE: )
 * any number
 * horses and llamas only;  or   must be a type of horse armor (if a horse) or a carpet (if a llama)
 * (BE: )
 * align="center"|0–14
 * donkeys and mules with chests only
 * (BE: )
 * align="center"|0–7
 * villagers only
 * }
 * donkeys and mules with chests only
 * (BE: )
 * align="center"|0–7
 * villagers only
 * }
 * }


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


 * 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.


 * 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.
 * 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.


 * Specifies the item components. Like data tags but supports only,  ,  , and   functions (see Commands/give)
 * Specifies the item components. Like data tags but supports only,  ,  , and   functions (see Commands/give)
 * Specifies the item components. Like data tags but supports only,  ,  , and   functions (see Commands/give)


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

Examples

 * To replace the items in the bottom-right slot of a single chest two block above with four spruce saplings:
 * To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings:
 * To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings:
 * To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings: