Minecraft Wiki

除另有声明,转载时均必须注明出处若簡繁轉換出錯,請以遊戲內為準请勇于扩充与修正内容有兴趣逛逛我们的微博沟通交流,欢迎到社区专页需要协助,请在告示板留言

了解更多

Minecraft Wiki
Advertisement
Disambig gray.svg  关于Java版中功能大致相同的命令,请见“命令/item”。
Information icon.svg
此特性为基岩版教育版独有。
Rose (texture) JE1.png
该页面所介绍的内容已从Java版中移除。

此命令已于Java版1.17/item命令取代。

replaceitem
需要的权限等级

1

限制条件

启用作弊

替换方块(箱子、熔炉等)或实体(玩家或生物)物品栏内的物品。

语法[]

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: EntityEquipmentSlotslot.containerslotId: int

指定要改变的物品栏槽位。有效值取决于要改变的方块或实体。
对于方块,必须为slot.container 槽位编号,其中槽位编号用具体的槽位编号数值代替。
  • 箱子发射器投掷器漏斗陷阱箱左上角的槽位被编号为0,而后从左到右、从上到下递增(例如,箱子的第一行槽位被从左至右编号为0至8)。大型箱子与大型陷阱箱被视为两个独立的容器方块。
  • 酿造台底部槽位从左至右编号为0至2,而其顶部槽位为3。烈焰粉的槽位为4。
  • 熔炉的槽位中输入槽位编号为0,燃料槽位为1,而输出槽位为2。
对于实体,必须为下列之一,其中槽位编号用具体的槽位编号数值代替:
槽位 槽位编号 限制
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至物品栏的槽位上限 玩家村民猪灵熊猫悦灵[新增:BE 1.19.0]漏斗矿车运输矿车命令方块矿车,以及驯服的羊驼
slot.saddle 槽位编号 任意值 仅驯服的物品名必须为空气
slot.armor 槽位编号 0至1 仅驯服的物品名必须属于马铠空气
slot.chest 槽位编号 0至14 仅驮箱子的
slot.equippable 槽位编号 0至1仅hasitem 0:仅物品名必须为空气
1:仅羊驼物品名必须属于马铠(马)、地毯(羊驼)或空气

itemName: Item

指定被放置于方块或实体的物品栏槽位内的物品。必须为物品ID,或具有物品形态的方块的ID

amount: int(可选)

指定被放置物品的数量。必须在1至64间(含),可以突破物品的堆叠限制。

data: int(可选)

指定被放置物品的物品数据。必须为一个在-2,147,483,648至2,147,483,647间(含,不输入逗号)的整数,且在对指定物品无效时被重置为0。若未指定,默认为0。

components: json(可选)

指定被放置物品的物品组件。类似于NBT标签,但仅支持minecraft:can_place_onminecraft:can_destroyminecraft:item_lockminecraft:keep_on_death

oldItemHandling: ReplaceMode(可选)

必须是下列之一:
  • destroy - 忽略指定槽位中的原始物品,直接进行替换。
  • keep - 如果一个物品占用了该槽位,则不进行替换。

效果[]

命令触发条件基岩版
任意参数未正确指定 执行失败
/replaceitem block ...指定的方块并非容器
指定的方块不拥有指定的槽位
/replaceitem entity ...<target: target> 无法解析指定实体(指定玩家必须在线)
目标实体没有指定的槽位(例如,僵尸没有slot.armor),或指定槽位无法被替换为指定物品
/replaceitem ... keepkeep模式下指定的槽位已拥有物品
任意执行成功时将指定槽位替换为指定物品(原物品丢失)

输出[]

命令版本条件成功次数/execute store success .../execute store result ...
任意基岩版执行失败0N/AN/A
/replaceitem block ...执行成功1N/AN/A
/replaceitem entity ...执行成功被成功替换物品的实体的数量N/AN/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.814w26a加入了/replaceitem命令。
1.1418w43a现在可以在物品展示框上使用。
1.1720w46a移除了/replaceitem,并加入了/item取代其功能。
携带版
1.0.51.0.5.0加入了/replaceitem命令。
1.1.01.1.0.0现在/replaceitem命令支持canplaceoncandestroy
基岩版
1.16.01.16.0.55/replaceitem加入了新参数destroykeep来指定替换模式。

参见[]

  • /data - 也能替换一个容器或实体物品栏中的物品,或改变盔甲与武器的掉落率。
  • /give - 不指定具体槽位、不覆盖原有物品地给予玩家物品。
Advertisement