更改：命令/item

2021年11月22日 (一) 21:11的版本

此特性为Java版独有。

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`		仅马、驴和骡；`物品`必须为鞍，设为空气以移除^[1]
`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版
任意	参数未正确指定	无法解析
任意	`<count>`超过了指定物品的堆叠限制	执行失败
`/item (modify\|replace) block ...`	目标方块不是一个容器
`/item (modify\|replace) block ...`	目标方块没有指定栏位
`/item (modify\|replace) entity ...`	`<选择器>`无法解析为一个或多个实体（被指定的玩家必须在线）
	目标实体没有指定的栏位(如僵尸没有`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` 。
1.17		21w19a			更改了语法。

参见

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

参考

↑ MC-205220

命令

[1] MC-205220

[1]

@@ 第1行： / 第1行： @@
+{{for|基岩版和教育版中功能大致相同的命令|命令/replaceitem}}
 {{exclusive|java}}
-{{snapshot|java}}
 {{Infobox command
-|item
+|name=item
+|oplevel=2
-|op
-|1.17|20w46a
 }}
-修改方块（箱子、熔炉等）或实体（玩家或生物）物品栏内的物品。
+修改[[方块]]（[[箱子]]、[[熔炉]]等）或[[实体]]（玩家或生物）物品栏内的[[物品]]。
 == 语法 ==
 : <code>'''item''' ...</code>
-:: <code>... '''block''' <''x''> <''y''> <''z''> ...</code> ''or'' <code>... '''entity''' <''选择器''> ...</code>
+:: <code>... '''modify''' (block <pos>|entity <targets>) <slot> <modifier></code>
-::: <code>... <''栏位''> ...</code>
+:: <code>... '''replace''' (block <pos>|entity <targets>) <slot> ...</code>
-:::: <code>... '''copy''' block <''x''> <''y''> <''z''> <''栏位''> [''物品修饰符'']</code>
+::: <code>... '''with''' <item> [<count>]</code>
-:::: <code>... '''copy''' entity <''选择器''> <''栏位''> [''物品修饰符'']</code>
+::: <code>... '''from''' (block <pos>|entity <targets>) <slot> [<modifier>]</code>
-:::: <code>... '''modify''' <''物品修饰符''></code>
-:::: <code>... '''replace''' <''物品''> [''数量'']</code>
 == 参数 ==
+{{argument|pos|block_pos}}
-<code>''x y z''</code>：[[参数类型#minecraft:block_pos|block_pos]]
-: 指定要改变的方块的位置。可用[[命令#波浪号|波浪号]]来指定一个相对于命令执行处的位置。
+: 指定要改变的方块的位置。
+: {{arg desc|je=block_pos}}
+{{argument|targets|entity}}
-<code>''选择器''</code>：[[参数类型#minecraft:entity|entity]]
-: 指定要改变的实体。必须为一个玩家名或[[#目标选择器|目标选择器]]。
+: 指定要改变的实体。
+: {{arg desc|je=entity|amount=multiple|type=entities}}
+{{argument|slot|item_slot}}
-<code>''栏位''</code>：[[参数类型#minecraft:item_slot|item_slot]]
 : 指定要改变的物品栏栏位。有效值取决于要改变的方块或实体。
@@ 第58行： / 第57行： @@
 |
 |-
-|<code>container.<slot_number></code>
+|<code>container.<''栏位编号''></code>
 |align="center"|0–53
 |仅[[玩家]]、[[运输矿车]]及[[物品展示框]]（仅<code>''栏位编号''</code>为0时有效）
 |-
-|<code>enderchest.<slot_number></code><br>
+|<code>enderchest.<''栏位编号''></code><br>
 |align="center"|0–26
 |rowspan=3|仅[[玩家]]
 |-
-|<code>hotbar.<slot_number></code><br>
+|<code>hotbar.<''栏位编号''></code><br>
 |align="center"|0–8
 |-
-|<code>inventory.<slot_number></code><br>
+|<code>inventory.<''栏位编号''></code><br>
 |align="center"|0–26
 |-
@@ 第84行： / 第83行： @@
 |仅[[马]]和[[羊驼]]；<code>''物品''</code>必须属于[[马铠]]（马）或[[地毯]]（羊驼），设为[[空气]]以移除
 |-
-|<code>horse.<slot_number></code><br>
+|<code>horse.<''栏位编号''></code><br>
 |align="center"|0–2
 |仅驮箱子的[[羊驼]]
 |-
-|<code>horse.<slot_number></code><br>
+|<code>horse.<''栏位编号''></code><br>
 |align="center"|0–14
 |仅驮箱子的驴和骡
 |-
-|<code>villager.<slot_number></code><br>
+|<code>villager.<''栏位编号''></code><br>
 |align="center"|0–7
 |仅[[村民]]和[[猪灵]]
 |}
+{{argument|item|item_stack}}
-<code>''物品''</code>：[[参数类型#minecraft:item_stack|item_stack]]
-: 指定被放置于方块或实体的物品栏栏位内的物品。必须为[[数据值#物品ID|物品ID]]，或物品形态的[[数据值#方块ID|方块的ID]]（例如<code>minecraft:gold_block</code>）。
+: 指定被放置于方块或实体的物品栏栏位内的物品。
+: {{arg desc|je=item_stack}}
+{{argument|count|integer}}
-<code>''数量''</code>：[[参数类型#minecraft:integer|integer]]
 : 指定被放置的物品的数量。
+: {{arg desc|je=integer|min=1|max=64}}
+{{argument|modifier|resource_location}}
-<code>''物品修饰符''</code>
-: 指定使用的[[物品修饰符]]。
+: 指定使用的[[物品修饰器]]。
+: {{arg desc|je=resource_location}}
 == 效果 ==
@@ 第110行： / 第112行： @@
 {{Result table|onlyje=1}}
 {{Result table|参数未正确指定|unparseable}}
-{{Result table|当<code><数量></code>超过了指定物品的堆叠限制时|fail}}
+{{Result table|<code><count></code>超过了指定物品的堆叠限制|fail}}
-{{Result table|cmd=/item block ...|当目标方块不是一个容器时|fail}}
+{{Result table|cmd=/item (modify&#124;replace) block ...|目标方块不是一个容器}}
-{{Result table|当目标方块没有指定栏位时}}
+{{Result table|目标方块没有指定栏位}}
-{{Result table|cmd=/item entity ...|当<code><选择器></code>无法解析为一个或多个实体时（被指定的玩家必须在线）}}
+{{Result table|cmd=/item (modify&#124;replace) entity ...|<code><''选择器''></code>无法解析为一个或多个实体（被指定的玩家必须在线）}}
-{{Result table|当目标实体没有指定的栏位时(如僵尸没有<code>horse.armor</code>栏位)}}
+{{Result table|目标实体没有指定的栏位(如僵尸没有<code>horse.armor</code>栏位)}}
-{{Result table|当指定物品无法放置于目标实体的指定栏位时（如在玩家的<code>armor.chest</code>栏位放置石头）}}
+{{Result table|指定物品无法放置于目标实体的指定栏位（如在玩家的<code>armor.chest</code>栏位放置石头）}}
-{{Result table|cmd=|succeed|将指定栏位内的物品替换成指定的物品（原有的物品丢失）。}}
+{{Result table|cmd=|succeed|将指定栏位内的物品替换成指定的物品（原有的物品丢失）}}
 {{Result table}}
@@ 第123行： / 第125行： @@
 {{Output table}}
 {{Output table|edition=je|失败|0|0|0}}
-{{Output table|cmd=/item block ...|成功|1|1|1}}
+{{Output table|cmd=/item (modify&#124;replace) block ...|成功|1|1|1}}
-{{Output table|cmd=/item entity ...|成功|1|1|成功替换物品的实体数量}}
+{{Output table|cmd=/item (modify&#124;replace) entity ...|成功|1|1|成功替换物品的实体数量}}
 {{Output table}}
 == 示例 ==
 * 将上方2格处的一个小型箱子右下角栏位内的物品替换成4棵云杉树苗：
-** <code>item block ~ ~2 ~ container.26 replace minecraft:spruce_sapling 4</code>
+** <code>/item replace block ~ ~2 ~ container.26 with minecraft:spruce_sapling 4</code>
 * 将最近玩家的快捷栏最右栏位内的物品替换成4棵云杉树苗：
-** <code>item entity @p hotbar.8 replace minecraft:spruce_sapling 4</code>
+** <code>/item replace entity @p hotbar.8 with minecraft:spruce_sapling 4</code>
 == 历史 ==
-{{History|java upcoming}}
+{{History|java}}
-{{History||1.17|snap=20w46a|加入了<code>/item</code>。}}
+{{History||1.17|snap=20w46a|加入了<code>/item</code>以取代{{cmd|replaceitem|}}。}}
+{{History|||snap=21w19a|更改了语法。}}
 {{History|foot}}
 == 参见 ==
 * {{cmd|data}} - 也能替换一个容器或实体物品栏中的物品，或改变盔甲与武器的掉落率。
-* {{cmd|give}} - 不指定具体栏位、不覆盖原有物品地给予玩家物品。
+* {{cmd|give}} - 给玩家物品，但不指定具体的栏位或覆盖原有物品。
 == 参考 ==
@@ 第146行： / 第149行： @@
 {{Commands}}
+[[en:Commands/item]]
+[[de:Befehl/item]]

Minecraft Wiki

更改：命令/item

2021年11月22日 (一) 21:11的版本

目录

语法

参数

效果

输出

示例

历史

参见

参考