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 <位置:x y z> ...... entity <目标:目标> ...
... <栏位类型:字符串> <栏位ID:整数> ...
... [<原物品处理:替换模式>] <物品名:字符串> [<数量:整数>] [<数据值:整数>] [<物品组件:json>]

参数[]

位置:x y z(仅block模式)

指定要改变的方块的位置。可用波浪号来指定一个相对于命令执行处的位置。

目标:目标(仅entity模式)

指定要改变的实体。必须为一个玩家名或目标选择器

栏位类型:字符串栏位ID:整数

指定要改变的物品栏栏位。有效值取决于要改变的方块或实体。
对于方块,必须为slot.container 栏位编号,其中栏位编号用具体的栏位编号数值代替。
  • 箱子发射器投掷器漏斗陷阱箱左上角的栏位被编号为0,而后从左到右、从上到下递增(例如,箱子的第一行栏位被从左至右编号为0至8)。大型箱子与大型陷阱箱被视为两个独立的容器方块。
  • 酿造台底部栏位从左至右编号为0至2,而其顶部栏位为3。烈焰粉的栏位为4。
  • 熔炉的栏位中输入栏位编号为0,燃料栏位为1,而输出栏位为2。
  • 物品展示框虽为实体,但使用container.0代表其展示的物品。
其他能容纳物品但不拥有物品栏界面的方块(唱片机物品展示框)的物品仅能被/data[仅Java版]命令改变。


对于实体,必须为下列之一,其中栏位编号用具体的栏位编号数值代替:
栏位 栏位编号 限制
slot.armor.chest 盔甲架生物玩家(虽然并非所有生物会显示或利用这些物品)
slot.armor.feet
slot.armor.head
slot.armor.legs
slot.weapon.mainhandslot.weapon 盔甲架生物有效(虽然并非所有生物会显示或利用这些物品)。
slot.weapon.offhand
slot.enderchest 栏位编号 0至26 玩家
slot.hotbar 栏位编号 0至8
slot.inventory 栏位编号 0至26 玩家漏斗矿车运输矿车
slot.saddle 、驴和骡;物品名必须为空气
slot.armor 羊驼物品名必须属于马铠(马)或地毯(羊驼)
slot.chest 栏位编号 0至14 仅驮箱子的驴和骡

物品名:字符串

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

数量:整数(可选)

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

数据值:整数(可选)

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

物品组件:json(可选)

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

原物品处理:替换模式(可选)

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

效果[]

命令触发条件基岩版
任意参数未正确指定 执行失败
/replaceitem block ...指定的方块并非容器
指定的方块不拥有指定的槽位
/replaceitem entity ...<目标:目标> 无法解析指定实体(指定玩家必须在线)
目标实体没有指定的栏位(例如,僵尸没有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