Minecraft:Commands/replaceitem - Revision history

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T20:13:00Z

Fix template calls: add MC/ prefix

← Older revision		Revision as of 20:13, 9 April 2026
Line 1:		Line 1:
	{{For\|\|Item (disambiguation)}}		{{MC/For\|\|Item (disambiguation)}}
	{{~~exclusive~~\|Bedrock\|Education}}		{{MC/Exclusive\|Bedrock\|Education}}
	{{outdated\|edition=java\|This command was superseded by the {{~~cmd~~\|item}} command in Java Edition 1.17.}}		{{outdated\|edition=java\|This command was superseded by the {{MC/Cmd\|item}} command in Java Edition 1.17.}}
	{{Infobox command		{{Infobox command
	\|name=replaceitem		\|name=replaceitem
Line 16:		Line 16:

	== Arguments ==		== Arguments ==
	{{~~argument~~\|be=1\|position: x y z\|CommandPosition}}		{{MC/Argument\|be=1\|position: x y z\|CommandPosition}}
	: Specifies the position of the block to be modified.		: Specifies the position of the block to be modified.
	: {{~~arg~~ desc\|be=CommandPosition}}		: {{MC/Arg desc\|be=CommandPosition}}

	{{~~argument~~\|be=1\|target: target\|CommandSelector<Actor>}}		{{MC/Argument\|be=1\|target: target\|CommandSelector<Actor>}}
	: Specifies one or more entities to modify.		: Specifies one or more entities to modify.
	: {{~~arg~~ desc\|be=actor}}		: {{MC/Arg desc\|be=actor}}

	{{~~argument~~\|be=1\|slotType: EntityEquipmentSlot\|enum}}, <code>slot.container</code> and {{~~argument~~\|slotId: int\|int}}		{{MC/Argument\|be=1\|slotType: EntityEquipmentSlot\|enum}}, <code>slot.container</code> and {{MC/Argument\|slotId: int\|int}}
	: 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.		: 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.
	: <code>slotId: int</code> {{lcfirst:{{~~arg~~ desc\|be=int}}}} And it must be between -2147483648 and 2147483647 (inclusive).		: <code>slotId: int</code> {{lcfirst:{{MC/Arg desc\|be=int}}}} And it must be between -2147483648 and 2147483647 (inclusive).

	{{~~argument~~\|be=1\|itemName: Item\|enum}}		{{MC/Argument\|be=1\|itemName: Item\|enum}}
	: Specifies the item to be placed in the block or entity's inventory slot.		: Specifies the item to be placed in the block or entity's inventory slot.

	{{~~argument~~\|be=1\|amount: int\|int}}		{{MC/Argument\|be=1\|amount: int\|int}}
	: Specifies the number of items 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.
	: {{~~arg~~ desc\|be=int}} And it should be between 1 and 64 (inclusive).		: {{MC/Arg desc\|be=int}} And it should be between 1 and 64 (inclusive).

	{{~~argument~~\|be=1\|data: int\|int}}		{{MC/Argument\|be=1\|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 defaults 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 defaults to 0. If not specified, defaults to 0.
	: {{~~arg~~ desc\|be=int}} It must be between -2147483648 and 2147483647 (inclusive).		: {{MC/Arg desc\|be=int}} It must be between -2147483648 and 2147483647 (inclusive).

	{{~~argument~~\|be=1\|components: json\|Json::Value}}		{{MC/Argument\|be=1\|components: json\|Json::Value}}
	: Specifies the [[Minecraft:item components]]. Like data tags but supports only <code>minecraft:can_place_on</code>, <code>minecraft:can_destroy</code>, <code>minecraft:item_lock</code>, and <code>minecraft:keep_on_death</code> functions (see [[Minecraft:Commands/give#Examples]])		: Specifies the [[Minecraft:item components]]. Like data tags but supports only <code>minecraft:can_place_on</code>, <code>minecraft:can_destroy</code>, <code>minecraft:item_lock</code>, and <code>minecraft:keep_on_death</code> functions (see [[Minecraft:Commands/give#Examples]])
	: {{~~arg~~ desc\|be=Json::Value}}		: {{MC/Arg desc\|be=Json::Value}}

	{{~~argument~~\|be=1\|oldItemHandling: ReplaceMode\|enum}}		{{MC/Argument\|be=1\|oldItemHandling: ReplaceMode\|enum}}
	: Must be one of:		: Must be one of:
	:: <code>destroy</code> - Directly replaces items ignoring the original items in the specified slot.		:: <code>destroy</code> - Directly replaces items ignoring the original items in the specified slot.
Line 66:		Line 66:
	== Output ==		== Output ==

	{{Output table\|onlybe=1}}		{{MC/Output table\|onlybe=1}}
	{{Output table\|edition=be\|On fail\|0}}		{{MC/Output table\|edition=be\|On fail\|0}}
	{{Output table\|cmd=/replaceitem block ...\|On success\|1}}		{{MC/Output table\|cmd=/replaceitem block ...\|On success\|1}}
	{{Output table\|cmd=/replaceitem entity ...\|On success\|the number of entities whose items are successfully replaced}}		{{MC/Output table\|cmd=/replaceitem entity ...\|On success\|the number of entities whose items are successfully replaced}}
	{{Output table}}		{{MC/Output table}}

	==Examples==		==Examples==
Line 81:		Line 81:
	=== ''Java Edition'' ===		=== ''Java Edition'' ===
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java}}		\|{{MC/HistoryLine\|java}}
	\|{{HistoryLine\|\|1.8\|dev=14w26a\|Added {{~~cmd~~\|replaceitem\|link=none}}.}}		\|{{HistoryLine\|\|1.8\|dev=14w26a\|Added {{MC/Cmd\|replaceitem\|link=none}}.}}
	\|{{HistoryLine\|\|1.14\|dev=18w43a\|{{~~cmd~~\|replaceitem\|link=none}} can now be used on item frames.}}		\|{{HistoryLine\|\|1.14\|dev=18w43a\|{{MC/Cmd\|replaceitem\|link=none}} can now be used on item frames.}}
	\|{{HistoryLine\|\|1.17\|dev=20w46a\|Removed {{~~cmd~~\|replaceitem\|link=none}}. Replaced with {{~~cmd~~\|item replace}}.}}		\|{{HistoryLine\|\|1.17\|dev=20w46a\|Removed {{MC/Cmd\|replaceitem\|link=none}}. Replaced with {{MC/Cmd\|item replace}}.}}
	}}		}}

	=== ''Bedrock Edition'' ===		=== ''Bedrock Edition'' ===
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|pocket}}		\|{{MC/HistoryLine\|pocket}}
	\|{{HistoryLine\|\|1.0.5\|dev=alpha 1.0.5.0\|Added {{~~cmd~~\|replaceitem\|link=none}}.}}		\|{{HistoryLine\|\|1.0.5\|dev=alpha 1.0.5.0\|Added {{MC/Cmd\|replaceitem\|link=none}}.}}
	\|{{HistoryLine\|\|1.1.0\|dev=alpha 1.1.0.0\|<code>CanPlaceOn</code> and <code>CanDestroy</code> functions are now supported for {{~~cmd~~\|replaceitem\|link=none}}.}}		\|{{HistoryLine\|\|1.1.0\|dev=alpha 1.1.0.0\|<code>CanPlaceOn</code> and <code>CanDestroy</code> functions are now supported for {{MC/Cmd\|replaceitem\|link=none}}.}}
	\|{{HistoryLine\|bedrock}}		\|{{MC/HistoryLine\|bedrock}}
	\|{{HistoryLine\|\|1.16.0\|dev=beta 1.16.0.55\| Added new overload for {{~~cmd~~\|replaceitem\|link=none}} with an option for destroy or keep.}}		\|{{HistoryLine\|\|1.16.0\|dev=beta 1.16.0.55\| Added new overload for {{MC/Cmd\|replaceitem\|link=none}} with an option for destroy or keep.}}
	}}		}}

	== See also ==		== See also ==
	* {{~~cmd~~\|item}} — the {{el\|je}} equivalent		* {{MC/Cmd\|item}} — the {{MC/El\|je}} equivalent
	* {{~~cmd~~\|give}} — give items to players without specifying specific inventory slots or overwriting other items		* {{MC/Cmd\|give}} — give items to players without specifying specific inventory slots or overwriting other items
	* {{~~cmd~~\|setfixedinvslot}} (''outdated'') — can replace a slot of a mob's inventory		* {{MC/Cmd\|setfixedinvslot}} (''outdated'') — can replace a slot of a mob's inventory

	== External links ==		== External links ==
Line 106:		Line 106:

	== Navigation ==		== Navigation ==
	{{Navbox commands}}		{{MC/Navbox commands}}

	de:Befehl/replaceitem		de:Befehl/replaceitem

SyncBot: Remove broken links to missing pages

2026-04-09T15:45:03Z

Remove broken links to missing pages

← Older revision		Revision as of 15:45, 9 April 2026
Line 1:		Line 1:
	{{For\|\|Item (disambiguation)}}		{{For\|\|Item (disambiguation)}}
	{{exclusive\|Bedrock\|Education}}		{{exclusive\|Bedrock\|Education}}
	{{outdated\|edition=java\|This command was superseded by the {{cmd\|item}} command in ~~[[Minecraft:~~Java Edition 1.17]].}}		{{outdated\|edition=java\|This command was superseded by the {{cmd\|item}} command in Java Edition 1.17.}}
	{{Infobox command		{{Infobox command
	\|name=replaceitem		\|name=replaceitem
Line 7:		Line 7:
	\|cheat=y		\|cheat=y
	}}		}}
	Replaces the [[Minecraft:item]]s in a specified slot of either a [[Minecraft:block\|block']]s ([[Minecraft:chest]], [[Minecraft:furnace]]s, etc.) or ~~[[Minecraft:Entity\|~~entity's]] (~~[[Minecraft:~~players]] or ~~[[Minecraft:~~mobs]]) [[Minecraft:inventory]], with a specified item.		Replaces the [[Minecraft:item]]s in a specified slot of either a [[Minecraft:block\|block']]s ([[Minecraft:chest]], [[Minecraft:furnace]]s, etc.) or entity's (players or mobs) [[Minecraft:inventory]], with a specified item.

	== Syntax ==		== Syntax ==
Line 83:		Line 83:
	\|{{HistoryLine\|java}}		\|{{HistoryLine\|java}}
	\|{{HistoryLine\|\|1.8\|dev=14w26a\|Added {{cmd\|replaceitem\|link=none}}.}}		\|{{HistoryLine\|\|1.8\|dev=14w26a\|Added {{cmd\|replaceitem\|link=none}}.}}
	\|{{HistoryLine\|\|1.14\|dev=18w43a\|{{cmd\|replaceitem\|link=none}} can now be used on ~~[[Minecraft:~~item ~~frame]]s~~.}}		\|{{HistoryLine\|\|1.14\|dev=18w43a\|{{cmd\|replaceitem\|link=none}} can now be used on item frames.}}
	\|{{HistoryLine\|\|1.17\|dev=20w46a\|Removed {{cmd\|replaceitem\|link=none}}. Replaced with {{cmd\|item replace}}.}}		\|{{HistoryLine\|\|1.17\|dev=20w46a\|Removed {{cmd\|replaceitem\|link=none}}. Replaced with {{cmd\|item replace}}.}}
	}}		}}
Line 108:		Line 108:
	{{Navbox commands}}		{{Navbox commands}}

	~~[[Minecraft:~~de:Befehl/replaceitem]]		de:Befehl/replaceitem
	~~[[Minecraft:~~ja:コマンド/replaceitem]]		ja:コマンド/replaceitem
	~~[[Minecraft:~~pt:Comandos/replaceitem]]		pt:Comandos/replaceitem
	~~[[Minecraft:~~ru:Команды консоли/replaceitem]]		ru:Команды консоли/replaceitem
	~~[[Minecraft:~~uk:Команди консолі/replaceitem]]		uk:Команди консолі/replaceitem
	~~[[Minecraft:~~zh:命令/replaceitem]]		zh:命令/replaceitem

imported>LauraFii: /* History */ split

2025-11-04T07:48:42Z

History: split

New page

{{For||Item (disambiguation)}}
{{exclusive|Bedrock|Education}}
{{outdated|edition=java|This command was superseded by the {{cmd|item}} command in [[Minecraft:Java Edition 1.17]].}}
{{Infobox command
|name=replaceitem
|oplevel=1
|cheat=y
}}
Replaces the [[Minecraft:item]]s in a specified slot of either a [[Minecraft:block|block']]s ([[Minecraft:chest]], [[Minecraft:furnace]]s, etc.) or [[Minecraft:Entity|entity's]] ([[Minecraft:players]] or [[Minecraft:mobs]]) [[Minecraft:inventory]], with a specified item.

== Syntax ==
: <code>replaceitem block <position: x y z> slot.container <slotId: int> <itemName: Item> [amount: int] [data: int] [components: json]</code>
: <code>replaceitem entity <target: target> <slotType: EntityEquipmentSlot> <slotId: int> <itemName: Item> [amount: int] [data: int] [components: json]</code>
: <code>replaceitem block <position: x y z> slot.container <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]</code>
: <code>replaceitem entity <target: target> <slotType: EntityEquipmentSlot> <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]</code>

== Arguments ==
{{argument|be=1|position: x y z|CommandPosition}}
: Specifies the position of the block to be modified.
: {{arg desc|be=CommandPosition}}

{{argument|be=1|target: target|CommandSelector<Actor>}}
: Specifies one or more entities to modify.
: {{arg desc|be=actor}}

{{argument|be=1|slotType: EntityEquipmentSlot|enum}}, <code>slot.container</code> and {{argument|slotId: int|int}}
: 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.
: <code>slotId: int</code> {{lcfirst:{{arg desc|be=int}}}} And it must be between -2147483648 and 2147483647 (inclusive).

{{argument|be=1|itemName: Item|enum}}
: Specifies the item to be placed in the block or entity's inventory slot.

{{argument|be=1|amount: int|int}}
: Specifies the number of items to be placed in the block or entity's inventory slot.
: {{arg desc|be=int}} And it should be between 1 and 64 (inclusive).

{{argument|be=1|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 defaults to 0. If not specified, defaults to 0.
: {{arg desc|be=int}} It must be between -2147483648 and 2147483647 (inclusive).

{{argument|be=1|components: json|Json::Value}}
: Specifies the [[Minecraft:item components]]. Like data tags but supports only <code>minecraft:can_place_on</code>, <code>minecraft:can_destroy</code>, <code>minecraft:item_lock</code>, and <code>minecraft:keep_on_death</code> functions (see [[Minecraft:Commands/give#Examples]])
: {{arg desc|be=Json::Value}}

{{argument|be=1|oldItemHandling: ReplaceMode|enum}}
: Must be one of:
:: <code>destroy</code> - Directly replaces items ignoring the original items in the specified slot.
:: <code>keep</code> - Does not replace items if an item occupies that slot.

== Result ==

{{Result table|onlybe=1}}
{{Result table|The command is incomplete, or any argument is not specified correctly.||unparseable}}
{{Result table|<code>amount: int</code> is lower than 1 or higher than 64.||fail}}
{{Result table|cmd=/replaceitem block ...|The specified block is not a container.}}
{{Result table|The specified block does not have the specified slot.}}
{{Result table|cmd=/replaceitem entity ...|<code><targets></code> or <code>target: target</code> fails to resolve to one or more entities (named players must be online).}}
{{Result table|All selected entities meet one or more of the following conditions:
* It doesn't have the specified slot (for example, zombies don't have <code>horse.armor</code>).
* Specified item cannot be place into the specified slot of its (for example, place a stone into armor.chest of a player).}}
{{Result table|cmd=/replaceitem ... keep|An item occupies the specified slot in <code>keep</code> mode.|N/A}}
{{Result table|cmd=|succeed}}
{{Result table}}

== Output ==

{{Output table|onlybe=1}}
{{Output table|edition=be|On fail|0}}
{{Output table|cmd=/replaceitem block ...|On success|1}}
{{Output table|cmd=/replaceitem entity ...|On success|the number of entities whose items are successfully replaced}}
{{Output table}}

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

== History ==
=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.8|dev=14w26a|Added {{cmd|replaceitem|link=none}}.}}
|{{HistoryLine||1.14|dev=18w43a|{{cmd|replaceitem|link=none}} can now be used on [[Minecraft:item frame]]s.}}
|{{HistoryLine||1.17|dev=20w46a|Removed {{cmd|replaceitem|link=none}}. Replaced with {{cmd|item replace}}.}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|pocket}}
|{{HistoryLine||1.0.5|dev=alpha 1.0.5.0|Added {{cmd|replaceitem|link=none}}.}}
|{{HistoryLine||1.1.0|dev=alpha 1.1.0.0|<code>CanPlaceOn</code> and <code>CanDestroy</code> functions are now supported for {{cmd|replaceitem|link=none}}.}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.16.0|dev=beta 1.16.0.55| Added new overload for {{cmd|replaceitem|link=none}} with an option for destroy or keep.}}
}}

== See also ==
* {{cmd|item}} — the {{el|je}} equivalent
* {{cmd|give}} — give items to players without specifying specific inventory slots or overwriting other items
* {{cmd|setfixedinvslot}} (''outdated'') — can replace a slot of a mob's inventory

== External links ==

* {{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/commands/commands/replaceitem?view=minecraft-bedrock-stable|title=<code>/replaceitem</code> Command|website=Microsoft Learn|date=October 11, 2023}}

== Navigation ==
{{Navbox commands}}

[[Minecraft:de:Befehl/replaceitem]]
[[Minecraft:ja:コマンド/replaceitem]]
[[Minecraft:pt:Comandos/replaceitem]]
[[Minecraft:ru:Команды консоли/replaceitem]]
[[Minecraft:uk:Команди консолі/replaceitem]]
[[Minecraft:zh:命令/replaceitem]]