Minecraft:Commands/replaceitem

Template:For Template:Exclusive Template:Outdated Template:Infobox command Replaces the Minecraft:items in a specified slot of either a block's (Minecraft:chest, Minecraft:furnaces, etc.) or entity's (Minecraft:players or Minecraft:mobs) Minecraft: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

Specifies the position of the block to be modified.

Template:Arg desc

Specifies one or more entities to modify.

Template:Arg desc

Template:Argument, slot.container and Template:Argument

Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified. See Minecraft:Slot for details. Note that you can target a player's ender chest by using slot.enderchest.

slotId: int Template:Arg desc And it must be between -2147483648 and 2147483647 (inclusive).

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

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

Template:Arg desc And it should be between 1 and 64 (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 defaults to 0. If not specified, defaults to 0.

Template:Arg desc It must be between -2147483648 and 2147483647 (inclusive).

Specifies the Minecraft: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 Minecraft:Commands/give#Examples)

Template:Arg desc

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.

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
• To clear the first slot of every player's ender chest:
  • replaceitem entity @a slot.enderchest 0 air

History

See also

• Template:Cmd — the Template:El equivalent
• Template:Cmd — give items to players without specifying specific inventory slots or overwriting other items
• Template:Cmd (outdated) — can replace a slot of a mob's inventory

External links

• Template:Cite