Commands/replaceitem

replaceitem
Permission level required	2 ‌ 1 ‌
Restrictions	Cheat only

Replaces the items in a specified slot of either a block's (chest, furnaces, etc.) or entity's (players or mobs) inventory, with a specified item.

Syntax

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

position: x y z: CommandPosition

Specifies the position of the block to be modified.

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.

target: target: CommandSelector<Actor>

Specifies one or more entities to modify.

Must be a player name or a target selector.

slotType: EntityEquipmentSlot: enum, 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. See Slot for details.

slotId: int must be a 32-bit integer number. And it must be between -2147483648 and 2147483647 (inclusive).

itemName: Item: enum

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

amount: int: int

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 should be between 1 and 64 (inclusive).

data: int: int

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.

Must be a 32-bit integer number. It must be between -2147483648 and 2147483647 (inclusive).

components: json: Json::Value

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)

Must be a JSON Object.

oldItemHandling: ReplaceMode: enum

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

Command	Trigger	Bedrock Edition
any	the arguments are not specified correctly	Unparseable
	amount: int is lower than 1 or higher than 64.	Failed
/replaceitem block ...	the specified block is not a container
	the specified block does not have the specified slot
/replaceitem entity ...	<targets> or target: target fails to resolve to one or more entities (named players must be online)
	All selected entities meets one or more of the following conditions: It doesn't have the specified slot (for example, zombies don't have horse.armor) Specified item cannot be place into the specified slot of its(for example, place a stone into armor.chest of a player)
/replaceitem ... keep	an item occupies the specified slot in keep mode
any	Otherwise	Successful

Output

Command	Edition	Situation	Success Count	/execute store success ...	/execute store result ...
any	Bedrock Edition	On fail	0	N/A	N/A
/replaceitem block ...		On success	1	N/A	N/A
/replaceitem entity ...		On success	the number of entities whose items are successfully replaced	N/A	N/A

Examples

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

History

Java Edition
1.8		14w26a			Added /replaceitem.
1.14		18w43a			/replaceitem can now be used on item frames.
1.17		20w46a			Removed /replaceitem. Replaced with /item replace.
Pocket Edition
1.0.5		alpha 1.0.5.0			Added /replaceitem.
1.1.0		alpha 1.1.0.0			CanPlaceOn and CanDestroy functions are now supported for /replaceitem.
Bedrock Edition
1.16.0		beta 1.16.0.55			Added new overload for /replaceitem with an option for destroy or keep.

See also

• /item — the Java Edition equivalent
• /give — give items to players without specifying specific inventory slots or overwriting other items
• /setfixedinvslot (outdated) — can replace a slot of a mob's inventory
• /setfixedinvslot (outdated) — can replace items of a mob's inventory

Commands 

View at: Template:Commands/content [edit]