命令/item

item

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

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

语法

item ...

... block <x> <y> <z> ... 或 ... entity <选择器> ...

... <栏位> ...

... copy block <x> <y> <z> <栏位> [物品修饰器]

... copy entity <选择器> <栏位> [物品修饰器]

... modify <物品修饰器>

... replace <物品> [数量]

参数

x y z：block_pos

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

选择器：entity

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

栏位：item_slot

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

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

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

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

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

栏位	栏位编号	限制
armor.chest		仅盔甲架、生物及玩家（虽然并非所有生物会显示或利用这些物品）
armor.feet
armor.head
armor.legs
weapon.mainhand
weapon.offhand
container.<slot_number>	0–53	仅玩家、运输矿车及物品展示框（仅栏位编号为0时有效）
enderchest.<slot_number>	0–26	仅玩家
hotbar.<slot_number>	0–8
inventory.<slot_number>	0–26
horse.saddle		仅马、驴和骡；物品必须为鞍，设为空气以移除
horse.chest		仅驮箱子的驴、骡和羊驼；设为空气以移除
horse.armor		仅马和羊驼；物品必须属于马铠（马）或地毯（羊驼），设为空气以移除
horse.<slot_number>	0–2	仅驮箱子的羊驼
horse.<slot_number>	0–14	仅驮箱子的驴和骡
villager.<slot_number>	0–7	仅村民和猪灵

物品：item_stack

指定被放置于方块或实体的物品栏栏位内的物品。必须为物品ID，或物品形态的方块的ID（例如minecraft:gold_block）。

数量：integer

指定被放置的物品的数量。

物品修饰器

指定使用的物品修饰器。

效果

命令	触发条件	Java版
任意	参数未正确指定	无法解析
	当<数量>超过了指定物品的堆叠限制时	执行失败
/item block ...	当目标方块不是一个容器时	执行失败
	当目标方块没有指定栏位时
/item entity ...	当<选择器>无法解析为一个或多个实体时（被指定的玩家必须在线）
	当目标实体没有指定的栏位时(如僵尸没有horse.armor栏位)
	当指定物品无法放置于目标实体的指定栏位时（如在玩家的armor.chest栏位放置石头）
任意	执行成功时	将指定栏位内的物品替换成指定的物品（原有的物品丢失）。

输出

命令	版本	条件	成功次数	/execute store success ...	/execute store result ...
任意	Java版	失败	0	0	0
/item block ...		成功	1	1	1
/item entity ...		成功	1	1	成功替换物品的实体数量

示例

• 将上方2格处的一个小型箱子右下角栏位内的物品替换成4棵云杉树苗：
  • item block ~ ~2 ~ container.26 replace minecraft:spruce_sapling 4
• 将最近玩家的快捷栏最右栏位内的物品替换成4棵云杉树苗：
  • item entity @p hotbar.8 replace minecraft:spruce_sapling 4

历史

Java版（即将到来）
1.17		20w46a			加入了/item以取代/replaceitem 。

参见

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

参考

命令

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