命令/item

  关于基岩版和教育版中功能大致相同的命令，请见“命令/replaceitem”。

item

需要的权限等级	2
限制条件	无

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

语法

item ...

... modify (block <pos>|entity <targets>) <slot> <modifier>

对指定槽位的物品施加指定的物品修饰器。

... replace (block <pos>|entity <targets>) <slot> ...

将指定槽位的物品替换为...

... with <item> [<count>]

...替换为指定的物品。

... from (block <pos>|entity <targets>) <slot> [<modifier>]

...从其他位置复制。

参数

<pos>：block_pos

指定要改变的方块的位置。

必须为方块坐标，包括<X>、<Y>和<Z>，每个值都必须是整数或者含有波浪号与脱字号标记。

<targets>：entity

指定要改变的实体。

必须为玩家名、目标选择器或UUID。

<slot>：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.<槽位编号>	0–53	仅玩家、运输矿车及物品展示框（仅槽位编号为0时有效）
enderchest.<槽位编号>	0–26	仅玩家
hotbar.<槽位编号>	0–8
inventory.<槽位编号>	0–26
horse.saddle		仅马、驴和骡；物品必须为鞍，设为空气以移除
horse.chest		仅驮箱子的驴、骡和羊驼；设为空气以移除
horse.armor		仅马和羊驼；物品必须属于马铠（马）或地毯（羊驼），设为空气以移除
horse.<槽位编号>	0–2	仅驮箱子的羊驼
horse.<槽位编号>	0–14	仅驮箱子的驴和骡
villager.<槽位编号>	0–7	仅村民和猪灵

<item>：item_stack

指定被放置于方块或实体的物品栏槽位内的物品。

必须为物品参数（不支持物品标签）。

<count>：integer

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

必须为32位整型数值。且必须在1和64（含）之间。

<modifier>：resource_location

指定使用的物品修饰器。

必须为命名空间ID。

效果

命令	触发条件	Java版
任意	参数未正确指定	无法解析
/... with <item> <count>	<count>超过了指定物品的堆叠限制
/item modify ... /item ... from ...	指定<modifier>不存在	执行失败
/item (modify|replace) block ... /... from block ...	目标方块不是一个容器
	目标方块没有指定槽位
	<sourcePos>或<pos>未被加载或在世界外
/item (modify|replace) entity ... /... from entity ...	<targets>或<sourceTarget>无法解析为一个或多个实体（被指定的玩家必须在线）
	目标实体没有指定的槽位(如僵尸没有horse.armor槽位)
	指定物品无法放置于目标实体的指定槽位（如在玩家的armor.chest槽位放置石头）
任意	执行成功时	将指定槽位内的物品替换成指定的物品（原有的物品丢失）

输出

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

示例

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

历史

Java版
1.17		20w46a			加入了/item以取代/replaceitem 。
		21w19a			更改了语法。

参见

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

参考

命令

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

语言

• Deutsch
• English
• español