Minecraft:Commands/item: Difference between revisions
More actions
Sync: updated from Minecraft |
Sync: updated from Minecraft |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{for|the {{BE}} equivalent|Commands/replaceitem}} | {{for|the {{BE}} equivalent|Commands/replaceitem}} | ||
{{Exclusive|Java}} | {{Exclusive|Java}} | ||
{{Update| | {{Update|Result with slot_source error in [[Minecraft:Java 26.3]]}} | ||
{{Infobox command | {{Infobox command | ||
|name=item | |name=item | ||
| Line 17: | Line 17: | ||
: <code>'''item override''' (block <pos>|entity <targets>) <slots> '''with''' <item> [<count>]</code> | : <code>'''item override''' (block <pos>|entity <targets>) <slots> '''with''' <item> [<count>]</code> | ||
: <code>'''item override''' (block <pos>|entity <targets>) <slots> '''from''' (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]</code> | : <code>'''item override''' (block <pos>|entity <targets>) <slots> '''from''' (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]</code> | ||
:: Similar to {{cd|'''item replace'''}}, but can fill items across multiple slots. When there are more target slots than source slots, the extra target slots are cleared. See {{slink||Arguments}} and [[Minecraft:Slot]] for more details.{{upcoming|je 26.3}}<code>'''item fill''' (block <pos>|entity <targets>) <slots> '''with''' <item> [<count>]</code> | :: Similar to {{cd|'''item replace'''}}, but can fill items across multiple slots. When there are more target slots than source slots, the extra target slots are cleared. See {{slink||Arguments}} and [[Minecraft:Slot]] for more details.{{upcoming|je 26.3}} | ||
: <code>'''item fill''' (block <pos>|entity <targets>) <slots> '''with''' <item> [<count>]</code> | |||
: <code>'''item fill''' (block <pos>|entity <targets>) <slots> '''from''' (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]</code> | : <code>'''item fill''' (block <pos>|entity <targets>) <slots> '''from''' (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]</code> | ||
:: Similar to {{cd|'''item override'''}}, but instead of clearing extra target slots, items from the source slots are repeated to fill all target slots.{{upcoming|je 26.3}} | :: Similar to {{cd|'''item override'''}}, but instead of clearing extra target slots, items from the source slots are repeated to fill all target slots.{{upcoming|je 26.3}} | ||
| Line 88: | Line 89: | ||
: {{arg desc|je=item_slot}} | : {{arg desc|je=item_slot}} | ||
{{argument|slots|item_slots}} | {{argument|slots|item_slots}}{{Until|Java 26.3}} | ||
{{argument|slots|slot_source}}{{Upcoming|Java 26.3}} | |||
: Similar to {{argument|slot}}, but can contain multiple slots. | : Similar to {{argument|slot}}, but can contain multiple slots. | ||
: {{arg desc|je=item_slots}} | : {{arg desc|je=item_slots}}{{Until|Java 26.3}} | ||
: {{arg desc|je=slot_source}}{{Upcoming|Java 26.3}} | |||
{{argument|modifier|loot_modifier}} | {{argument|modifier|loot_modifier}} | ||
| Line 102: | Line 106: | ||
{{argument|count|integer}} | {{argument|count|integer}} | ||
: Specifies the number of items to be placed in the block or entity's inventory slot. | : Specifies the number of items to be placed in the block or entity's inventory slot. | ||
: {{arg desc|je=integer|min=1|max=99}}<!--unparseable if bigger than 99, failed if bigger than the max stack size--> | : {{arg desc|je=integer|min=1|max=99}}<!--unparseable if bigger than 99, failed if bigger than the max stack size. | ||
--> | |||
{{argument|sourcePos|block_pos}} | {{argument|sourcePos|block_pos}} | ||
| Line 116: | Line 121: | ||
: {{arg desc|je=item_slot}} | : {{arg desc|je=item_slot}} | ||
{{argument|sourceSlots| | {{argument|sourceSlots|slot_source}}{{Upcoming|Java 26.3}} | ||
: Similar to {{argument|sourceSlot}}, but can contain multiple slots. | : Similar to {{argument|sourceSlot}}, but can contain multiple slots. | ||
: {{arg desc|je= | : {{arg desc|je=slot_source}}{{Upcoming|Java 26.3}} | ||
== Result == | == Result == | ||
Latest revision as of 11:09, 19 August 2026
Template:For Template:Exclusive Template:Update Template:Infobox command Manipulate or copy Minecraft:items in the Minecraft:inventories of Minecraft:blocks (Minecraft:chests, Minecraft:furnaces, etc.) or Minecraft:entities (Minecraft:players or Minecraft:mobs).
Syntax
item modify (block <pos>|entity <targets>) <slot> <modifier>- Modifies the items in the specified slot with the specified Minecraft:item modifier.
item replace (block <pos>|entity <targets>) <slot> with <item> [<count>]- Replaces the items in the specified slot with the specified items.
item replace (block <pos>|entity <targets>) <slot> from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>]- Copies the source items to the target slot and optionally modifies it with the
modifier.
- Copies the source items to the target slot and optionally modifies it with the
item override (block <pos>|entity <targets>) <slots> with <item> [<count>]item override (block <pos>|entity <targets>) <slots> from (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]- Similar to Template:Cd, but can fill items across multiple slots. When there are more target slots than source slots, the extra target slots are cleared. See Template:Slink and Minecraft:Slot for more details.Template:Upcoming
item fill (block <pos>|entity <targets>) <slots> with <item> [<count>]item fill (block <pos>|entity <targets>) <slots> from (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]- Similar to Template:Cd, but instead of clearing extra target slots, items from the source slots are repeated to fill all target slots.Template:Upcoming
Syntax displayed in various ways
Simplified tree: item ...... modify <TARGET> <slot> <modifier>... replace <TARGET> <slot>... with <item> [<count>]... from <SOURCE> <sourceSlot> [<modifier>]
... override <TARGET> <slots>... fill <TARGET> <slots>... with <item> [<count>]... from <SOURCE> <sourceSlots> [<modifier>]
- where substituted arguments are:
<TARGET>=(block <pos>|entity <targets>)<SOURCE>=(block <sourcePos>|entity <sourceTarget>)
Minimised: item (modify (block <pos>|entity <targets>) <slot> <modifier>|replace (block <pos>|entity <targets>) <slot> (with <item> [<count>]|from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>])|(override|fill) (block <pos>|entity <targets>) <slots> (with <item> [<count>]|from (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]))
Maximised: item modify block <pos> <slot> <modifier>item modify entity <targets> <slot> <modifier>item replace block <pos> <slot> with <item> [<count>]item replace block <pos> <slot> from block <sourcePos> <sourceSlot> [<modifier>]item replace block <pos> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>]item replace entity <targets> <slot> with <item> [<count>]item replace entity <targets> <slot> from block <sourcePos> <sourceSlot> [<modifier>]item replace entity <targets> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>]item override block <pos> <slot> with <item> [<count>]item override block <pos> <slot> from block <sourcePos> <sourceSlots> [<modifier>]item override block <pos> <slot> from entity <sourceTarget> <sourceSlots> [<modifier>]item override entity <targets> <slot> with <item> [<count>]item override entity <targets> <slot> from block <sourcePos> <sourceSlots> [<modifier>]item override entity <targets> <slot> from entity <sourceTarget> <sourceSlots> [<modifier>]item fill block <pos> <slots> with <item> [<count>]item fill block <pos> <slots> from block <sourcePos> <sourceSlots> [<modifier>]item fill block <pos> <slots> from entity <sourceTarget> <sourceSlots> [<modifier>]item fill entity <targets> <slots> with <item> [<count>]item fill entity <targets> <slots> from block <sourcePos> <sourceSlots> [<modifier>]item fill entity <targets> <slots> from entity <sourceTarget> <sourceSlots> [<modifier>]
Arguments
- Specifies the position of the block to be modified.
- Template:Arg desc
- Specifies one or more entities to modify.
- Template:Arg desc
- Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified.
- Template:Arg desc
Template:ArgumentTemplate:Until
Template:ArgumentTemplate:Upcoming
- Similar to Template:Argument, but can contain multiple slots.
- Template:Arg descTemplate:Until
- Template:Arg descTemplate:Upcoming
- Specifies the Minecraft:item modifier to apply on the chosen item.
- Template:Arg desc
- Specifies the item to be placed in the block or entity's inventory slot.
- Template:Arg desc
- Specifies the number of items to be placed in the block or entity's inventory slot.
- Template:Arg desc
- Specifies the position of the block to copy items from.
- Template:Arg desc
- Specifies an entity to copy items from.
- Template:Arg descTemplate:Until
- Specifies the inventory slot to copy the items from. Valid values depend on whether the source is block or an entity.
- Template:Arg desc
Template:ArgumentTemplate:Upcoming
- Similar to Template:Argument, but can contain multiple slots.
- Template:Arg descTemplate:Upcoming
Result
Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table
Output
Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table
Examples
- To replace the items in the bottom-right slot of a single chest two block above with four spruce saplings:
/item replace block ~ ~2 ~ container.26 with minecraft:spruce_sapling 4
- To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings:
/item replace entity @p hotbar.8 with minecraft:spruce_sapling 4
- To replace the item in the offhand of the selected player with the item in their main hand:
/item replace entity @s weapon.offhand from entity @s weapon.mainhand
- To put a brown Minecraft:banner on a player's head
/item replace entity @s armor.head with minecraft:brown_banner
- To increase the count of the item in your main hand:
/item modify entity @s weapon.mainhand example:increase_count- file in a data pack:
data/example/item_modifier/increase_count.json<syntaxhighlight lang="json">{
"function": "minecraft:set_count", "count": 1, "add": true
}</syntaxhighlight>
- To increase the count of the item in your main hand without external files:
item modify entity @s weapon.mainhand {"function":"minecraft:set_count","count":1,"add":true}
- To put the item in your hand, on your head:
/item replace entity @s armor.head from entity @s weapon.mainhand
History
See also
- Template:Cmd — can also replace items in a container's or mob's inventory, or modify the drop chances of armor and weapons
- Template:Cmd — give items to players without specifying specific inventory slots or overwriting other items
- Template:Cmd — The Template:El equivalent
Minecraft:de:Befehl/item Minecraft:es:Comandos/item Minecraft:fr:Commandes/item Minecraft:ja:コマンド/item Minecraft:pt:Comandos/item Minecraft:ru:Команды консоли/item Minecraft:zh:命令/item