关于Java版中功能大致相同的命令，请见“命令/item”。
替换方块（箱子、熔炉等）或实体（玩家或生物）物品栏内的物品。
语法[]
replaceitem block <position: x y z> slot.container <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> <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]
参数[]
position: x y z（仅block模式）
- 指定要改变的方块的位置。可用波浪号来指定一个相对于命令执行处的位置。
target: target（仅entity模式）
- 指定要改变的实体。必须为一个玩家名或目标选择器。
slotType: EntityEquipmentSlot、slot.container和slotId: int
- 指定要改变的物品栏槽位。有效值取决于要改变的方块或实体。
- 对于方块，必须为
slot.container 槽位编号，其中槽位编号用具体的槽位编号数值代替。
- 对于实体，必须为下列之一，其中槽位编号用具体的槽位编号数值代替：
槽位 槽位编号 限制 slot.weapon.mainhand 槽位编号任意值 仅盔甲架、生物及玩家（虽然并非所有生物会显示或利用这些物品） slot.weapon.offhand 槽位编号slot.armor.head 槽位编号（头盔）slot.armor.chest 槽位编号（胸甲）slot.armor.legs 槽位编号（护腿）slot.armor.feet 槽位编号（靴子）slot.enderchest 槽位编号0至26 仅玩家 slot.hotbar 槽位编号0至8 slot.inventory 槽位编号0至物品栏的槽位上限 仅玩家、村民、猪灵、熊猫、悦灵、漏斗矿车、运输矿车、命令方块矿车，以及驯服的马、驴、骡和羊驼 slot.saddle 槽位编号任意值 仅驯服的马、驴和骡；物品名必须为鞍或空气 slot.armor 槽位编号0至1 仅驯服的马；物品名必须属于马铠或空气 slot.chest 槽位编号0至14 仅驮箱子的驴和骡 slot.equippable 槽位编号0至1仅 hasitem0：仅马、驴和骡；物品名必须为鞍或空气
1：仅马和羊驼；物品名必须属于马铠（马）、地毯（羊驼）或空气
itemName: Item
amount: int（可选）
- 指定被放置物品的数量。必须在1至64间（含），可以突破物品的堆叠限制。
data: int（可选）
- 指定被放置物品的物品数据。必须为一个在-2,147,483,648至2,147,483,647间（含，不输入逗号）的整数，且在对指定物品无效时被重置为0。若未指定，默认为0。
components: json（可选）
- 指定被放置物品的物品组件。类似于NBT标签，但仅支持
minecraft:can_place_on、minecraft:can_destroy、minecraft:item_lock和minecraft:keep_on_death。
oldItemHandling: ReplaceMode（可选）
- 必须是下列之一：
destroy- 忽略指定槽位中的原始物品，直接进行替换。keep- 如果一个物品占用了该槽位，则不进行替换。
效果[]
| 命令 | 触发条件 | 基岩版 |
|---|---|---|
| 任意 | 参数未正确指定 | 无法解析 |
amount: int小于1或大于64 | 执行失败 | |
/replaceitem block ... | 指定的方块并非容器 | |
| 指定的方块不拥有指定的槽位 | ||
/replaceitem entity ... | <target: target> 无法解析指定实体（指定玩家必须在线） | |
目标实体没有指定的槽位（例如，僵尸没有slot.armor），或指定槽位无法被替换为指定物品 | ||
指定槽位无法放入指定物品（例如玩家的armor.chest无法放入石头） | ||
/replaceitem ... keep | keep模式下指定的槽位已拥有物品 | |
| 任意 | 执行成功时 | 将指定槽位替换为指定物品（原物品丢失） |
输出[]
| 命令 | 版本 | 条件 | 成功次数 | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| 任意 | 基岩版 | 执行失败 | 0 | N/A | N/A |
/replaceitem block ... | 执行成功 | 1 | N/A | N/A | |
/replaceitem entity ... | 执行成功 | 被成功替换物品的实体的数量 | N/A | N/A |
示例[]
- 将上方1格处的一个小型箱子右下角槽位内的物品替换成4棵云杉树苗：
replaceitem block ~ ~1 ~ slot.container 26 minecraft:sapling 4 1
- 将自己的快捷栏最右槽位内的物品替换成4棵云杉树苗：
replaceitem entity @s slot.hotbar 8 minecraft:sapling 4 1
- 将所有人的副手内的物品换成空气：
replaceitem entity @a slot.weapon.offhand 0 air 1 0
- 把自己物品栏右下角槽位内的物品换成空气：
replaceitem entity @s slot.inventory 26 air 1 0
历史[]
| Java版 | |||||
|---|---|---|---|---|---|
| 1.8 | 14w26a | 加入了/replaceitem命令。 | |||
| 1.14 | 18w43a | 现在可以在物品展示框上使用。 | |||
| 1.17 | 20w46a | 移除了/replaceitem，并加入了/item取代其功能。 | |||
| 携带版 | |||||
| 1.0.5 | 1.0.5.0 | 加入了/replaceitem命令。 | |||
| 1.1.0 | 1.1.0.0 | 现在/replaceitem命令支持canplaceon和candestroy。 | |||
| 基岩版 | |||||
| 1.16.0 | 1.16.0.55 | 为/replaceitem加入了新参数destroy和keep来指定替换模式。 | |||
参见[]
语言