命令/replaceitem

命令/infobox

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

语法

• Java版

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

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

• 基岩版

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

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

参数

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

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

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

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

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

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

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

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

其他能容纳物品但不拥有物品栏界面的方块（唱片机）的物品仅能被/data命令改变。

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

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

物品展示框内的物品仅能被用/data改变。

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

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

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

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

数据：整数（可选）^[仅Java版]

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

效果

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

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

示例

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

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

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

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

另见

/data — 也能替换一个容器或实体物品栏中的物品，或改变盔甲与武器的掉落率

/give — 不指定具体栏位、不覆盖原有物品地给予玩家物品

历史

Java版
1.8		14w26a			加入了/replaceitem命令。
Java版（即将到来）
1.14		18w43a			现在可以在物品展示框上使用。
携带版
1.0.5		build 1			加入了/replaceitem命令。
1.1		build 1			现在/replaceitem命令支持canplaceon和candestroy。