Minecraft Inventory Slot Numbers
The Inventory is the pop-up menu that a player uses to manage items they carry. From this screen, a player can equip armor, craft items on a 2x2 grid, and equip tools, blocks, and items on the Hotbar displayed at the bottom of the screen. A player's Minecraft skin is displayed here as well. 1 Overview 2 Creative mode inventory 3 Trivia 4 Video The inventory is opened and closed by pressing the. /replaceitem entity @etype=ArmorStand,c=1 slot.armor.head minecraft:redstoneblock 1 0 This will set a redstone block in the head slot of the closest armor stand. The slot number is calculated starting at 0, counting up through the window's unique slots, and then counting through the players inventory. For all windows, the slot in the upper-left corner of the player's inventory is slot n where n is the number of unique slots, and slot number -999 is always used for clicking outside the window. Is it possible to test for the amount of a specific item in a players inventory in the latest snapshots? For example I need to see if a player has 2 arrows in his inventory so a separate command block stops giving them more.
This page contains information about features that have been removed in the latest development versions.Restrictions | |
---|---|
First introduced | Java Edition 1.8 (14w26a) |
Replaces items in the inventories of blocks (chest, furnaces, etc.) or entities (players or mobs) with the given item(s).
Syntax[edit]
- Java Edition
replaceitem block <pos> <slot> <item> [<count>]
replaceitem entity <targets> <slot> <item> [<count>]
- Bedrock Edition
replaceitem block <position: x y z> slot.container <slotId: int> <itemName: Item> [amount: int] [data: int] [components: json]
replaceitem entity <target: target> <slotType: EntityEquipmentSlot> <slotId: int> <itemName: Item> [amount: int] [data: int] [components: json]
replaceitem block <position: x y z> slot.container <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]
replaceitem entity <target: target> <slotType: EntityEquipmentSlot> <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]
Arguments[edit]
JE: <pos>
: block_pos
BE: position: x y z
: CommandPosition
- In Java Edition, it must be a block position composed of <x>, <y> and <z>, each of which must be an integer or tilde and caret notation.In Bedrock Edition, it must be a three-dimensional coordinates composed of <x>, <y> and <z>, each of which must be a floating-point number or tilde and caret notation.
- Specifies the position of the block to be modified.
JE: <targets>
: entity
BE: target: target
: CommandSelector<Actor>
- Must be a player name, a target selector or a UUID[Java Edition only].
- Specifies one or more entities to modify.
JE: <slot>
: item_slot
BE: slotType: EntityEquipmentSlot
: EquipmentSlot, slot.container
and <slotId: int>
: int
- Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified.
- In Bedrock Edition,
slotId: int
must be a 32-bit integer number. And it must be between -2147483648 and 2147483647 (inclusive).
container.<slot_number>
(BE: slot.container <slotId: int>
) where <slot_number> or <slotId: int> is replaced with a number specifying the slot.- Chests, dispensers, droppers, hoppers, and trapped chests are numbered 0 for the top-left slot and then increase first horizontally, then vertically (so, for example, a chest's top row slots are numbered 0 to 8 from left to right). Double chests and double trapped chests are treated as two single container blocks.
- A brewing stand's bottom slots are numbered 0 to 2 from left to right, its top slot is 3 and the fuel slot is 4.
- A furnace's slots are numbered 0 for the input slot, 1 for the fuel slot, and 2 for the output slot.
/data
.Slot | Slot Numbers | Restrictions |
---|---|---|
armor.chest (BE: slot.armor.chest <slotId: int> ) | any number[Bedrock Edition only] | armor stands, mobs, and players only (though not all mobs will show or make use of the items) |
armor.feet (BE: slot.armor.feet <slotId: int> ) | any number[Bedrock Edition only] | |
armor.head (BE: slot.armor.head <slotId: int> ) | any number[Bedrock Edition only] | |
armor.legs (BE: slot.armor.legs <slotId: int> ) | any number[Bedrock Edition only] | |
weapon.mainhand (BE: slot.weapon.mainhand <slotId: int> ) | any number[Bedrock Edition only] | |
weapon.offhand (BE: slot.weapon.offhand <slotId: int> ) | any number[Bedrock Edition only] | |
container.<slot_number> (BE: slot.container <slotId: int> ) | 0–53 | players, item frames[Java Edition only] (slot 0), and minecarts only |
enderchest.<slot_number> (BE: slot.enderchest <slotId: int> ) | 0–26 | players only |
hotbar.<slot_number> (BE: slot.hotbar <slotId: int> ) | 0–8 | |
inventory.<slot_number> (BE: slot.inventory <slotId: int> ) | 0–26 | |
horse.saddle (BE: slot.saddle <slotId: int> ) | any number[Bedrock Edition only] | horses, donkeys, and mules only; <item> or itemName: Item must be a saddle |
horse.chest [Java Edition only] | donkeys, and mules only; <item> must be a chest | |
horse.armor (BE: slot.armor <slotId: int> ) | any number[Bedrock Edition only] | horses and llamas only; <item> or itemName: Item must be a type of horse armor (if a horse) or a carpet (if a llama) |
horse.<slot_number> (BE: slot.chest <slotId: int> ) | 0–14 | donkeys and mules with chests only |
villager.<slot_number> (BE: slot.inventory <slotId: int> ) | 0–7 | villagers only |
JE: <item>
: item_stack
BE: itemName: Item
: CommandItem
Minecraft Player Inventory Slot Numbers
- Specifies the item to be placed in the block or entity's inventory slot.
JE: <count>
: integer
BE: amount: int
: int
- Must be a 32-bit integer number. In Java Edition, it must be between -2147483648 and 2147483647 (inclusive). And it must be between 1 and 64 (inclusive).
- Specifies the number of items to be placed in the block or entity's inventory slot.
BE: data: int
: int
- Must be a 32-bit integer number. It must be between -2147483648 and 2147483647 (inclusive).
- Specifies the item data for the item(s) to be placed in the block or entity's inventory slot. Values which are invalid for the specified item id will default to 0. If not specified, defaults to 0.
BE: components: json
: Json::Value
- Must be a JSON Object.
- Specifies the item components. Like data tags but supports only
minecraft:can_place_on
,minecraft:can_destroy
,minecraft:item_lock
, andminecraft:keep_on_death
functions (see Commands/give#Examples)
BE: oldItemHandling: ReplaceMode
- Must be one of:
destroy
- Directly replaces items ignoring the original items in the specified slot.keep
- Does not replace items if an item occupies that slot.
Result[edit]
Command | Trigger | Java Edition | Bedrock Edition |
---|---|---|---|
any | the arguments are not specified correctly | Unparseable | Failed |
<count> exceeds the stack limit of the specified item | Failed | Successful | |
/replaceitem block ... | if the specified block is not a container | Failed | |
if the specified block does not have the specified slot | |||
/replaceitem entity ... | if <targets> or target: target fails to resolve to one or more entities (named players must be online) | ||
if none of the targets have the specified slot (for example, zombies don't have horse.armor ) | |||
if specified item cannot be place into the specified slot of any targeted entity(for example, place a stone into armor.chest of a player) | |||
/replaceitem ... keep | if an item occupies the specified slot in keep mode | N/A | |
any | On success | Replaces the items in the specified slot with the specified items (previous items in that slot are lost). |
Output[edit]
Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
any | Java Edition | On fail | 0 | 0 | 0 |
/replaceitem block ... | On success | 1 | 1 | 1 | |
/replaceitem entity ... | On success | 1 | 1 | the number of entities whose items are successfully replaced | |
any | Bedrock Edition | On fail | 0 | N/A | N/A |
/replaceitem block ... | On success | 1 | N/A | N/A | |
/replaceitem entity ... | On success | the number of entities whose items are successfully replaced | N/A | N/A |
Examples[edit]
Minecraft Inventory Slot Numbers
- To replace the items in the bottom-right slot of a single chest two block above with four spruce saplings:
replaceitem block ~ ~2 ~ container.26 minecraft:spruce_sapling 4
[Java Edition only]replaceitem block ~ ~2 ~ slot.container 26 sapling 4 1
[Bedrock Edition only]
- To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings:
replaceitem entity @p hotbar.8 minecraft:spruce_sapling 4
[Java Edition only]replaceitem entity @p slot.hotbar 8 sapling 4 1
[Bedrock Edition only]
History[edit]
Java Edition | |||||
---|---|---|---|---|---|
1.8 | 14w26a | Added /replaceitem . | |||
1.14 | 18w43a | /replaceitem can now be used on item frames. | |||
Upcoming Java Edition | |||||
1.17 | 20w46a | Removed /replaceitem . Replaced with /item replace . | |||
Pocket Edition | |||||
1.0.5 | alpha 1.0.5.0 | Added /replaceitem . | |||
1.1.0 | alpha 1.1.0.0 | CanPlaceOn and CanDestroy functions are now supported for /replaceitem . | |||
Bedrock Edition | |||||
1.16.0 | beta 1.16.0.55 | Added new overload for /replaceitem with an option for destroy or keep. |
See also[edit]
/data
— can also replace items in a container, or a mob's inventory/give
— give items to players without specifying specific inventory slots or overwriting other items/blockdata
(outdated) — can also replace items in a container/entitydata
(outdated) — can also replace items in a mob's inventory, or modify the drop chances of armor and weapons