命令/replaceitem

replaceitem

需要的权限等级	未知
限制条件	无

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

语法

• Java版

replaceitem block <x> <y> <z> <栏位> <物品> [数量]

replaceitem entity <选择器> <栏位> <物品> [数量]

• 基岩版

replaceitem block <位置：x y z> <栏位类型：字符串> <栏位ID：整数> <物品名：字符串> [数量：整数] [数据值：整数] [成分：成分]

replaceitem entity <目标：目标> <栏位类型：字符串> <栏位ID：整数> <物品：字符串> [数量：整数] [数据值：整数] [成分：成分]

replaceitem block <位置：x y z> <栏位类型：字符串> <栏位ID：整数> <原物品处理：替换模式> <物品名：字符串> [数量：整数] [数据值：整数] [成分：成分]

replaceitem entity <目标：目标> <栏位类型：字符串> <栏位ID：整数> <原物品处理：替换模式> <物品：字符串> [数量：整数] [数据值：整数] [成分：成分]

参数

x y z（基岩版：位置：x y z）（仅block模式）

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

选择器（基岩版：目标：目标）（仅entity模式）

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

栏位（基岩版：栏位类型：字符串和栏位ID：整数）

指定要改变的物品栏栏位。有效值取决于要改变的方块或实体。

对于方块，必须为slot.container.栏位编号，其中栏位编号用具体的栏位编号数值代替。

• 箱子、发射器、投掷器、漏斗和陷阱箱左上角的栏位被编号为0，而后从左到右、从上到下递增（例如，箱子的第一行栏位被从左至右编号为0至8）。大型箱子与大型陷阱箱被视为两个独立的容器方块。
• 酿造台底部栏位从左至右编号为0至2，而其顶部栏位为3。
• 熔炉的栏位中输入栏位编号为0，燃料栏位为1，而输出栏位为2。

其他能容纳物品但不拥有物品栏界面的方块（唱片机、物品展示框）的物品仅能被/data^[仅Java版]命令改变。

对于实体，必须为下列之一，其中栏位编号用具体的栏位编号数值代替：

栏位	栏位编号	限制
armor.chest		仅盔甲架、生物及玩家（虽然并非所有生物会显示或利用这些物品）
armor.feet
armor.head
armor.legs
weapon.mainhand		对盔甲架和生物有效（虽然并非所有生物会显示或利用这些物品）。
weapon.offhand
enderchest.栏位编号	0至26	仅玩家
hotbar.栏位编号	0至8
inventory.栏位编号	0至26
horse.saddle[仅Java版] saddle[仅基岩版]		仅马、驴和骡；物品名必须为鞍
horse.armor[仅Java版] armor[仅基岩版]		仅马和羊驼；物品名必须属于马铠（马）或地毯（羊驼）
horse.chest.栏位编号[仅Java版] chest.栏位编号[仅基岩版]	2至16	仅驮箱子的驴和骡
villager.栏位编号[仅Java版]	0至7	仅村民

物品（基岩版：物品：字符串）

指定被放置于方块或实体的物品栏栏位内的物品。必须为物品ID，或具有物品形态的方块的ID（例如，minecraft:golden_sword^[仅Java版]）。

数量（基岩版：数量：整数）（可选）

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

数据：整数（可选）^{[仅基岩版]}

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

成分：成分（可选）‌‌^{[仅基岩版]}

与数据标签类似，但仅支持minecraft:can_place_on和minecraft:can_destroy标签（例：replaceitem entity @s slot.weapon.mainhand 0 iron_shovel 1 0 {"minecraft:can_destroy":{"blocks":["grass"]}}）。

原物品处理：替换模式（可选）^{[仅基岩版]}

必须是下列之一：

• destroy - 忽略指定栏位中的原始物品，直接进行替换。
• keep - 如果一个物品占用了该栏位，则不进行替换。

效果

当参数指定不正确、指定方块不是一个容器时，或当选择器无法解析为一个或多个实体时，或当目标实体没有指定的栏位时（例如，僵尸没有horse.armor），命令失败。

成功时，将指定栏位内的物品替换成指定的物品（原有的物品丢失）。

示例

• 将上方1格处的一个小型箱子右下角栏位内的物品替换成4棵云杉树苗：

replaceitem block ~ ~1 ~ slot.container.26 minecraft:spruce_sapling 4^[仅Java版]

• 将自己的快捷栏最右栏位内的物品替换成4棵云杉树苗：

replaceitem entity @s hotbar.8 minecraft:spruce_sapling 4^[仅Java版]

• 将所有人的副手内的物品换成空气：

replaceitem entity @a slot.weapon.offhand 0 air 1 0^{[仅基岩版]}

• 把自己物品栏右下角栏位内的物品换成空气：

replaceitem entity @s slot.inventory 26 air^{[仅基岩版]}

历史

Java版
1.8		14w26a			加入了/replaceitem命令。
1.14		18w43a			现在可以在物品展示框上使用。
携带版
1.0.5		alpha 1.0.5.0			加入了/replaceitem命令。
1.1.0		alpha 1.1.0.0			现在/replaceitem命令支持canplaceon和candestroy。
基岩版
1.16.0		beta 1.16.0.55			为/replaceitem加入了新参数destroy和keep来指定替换模式。

参见

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

命令

参见：Template:Commands/content [编辑]