Difference between revisions of "Inventory"

From wiki.vg
Jump to navigation Jump to search
(Undo revision 16950 by DrunkMoon (talk))
Tag: Undo
(→‎Crafting table: Revert to old slot assignments which turned out to be correct)
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Minecraft displays the '''player inventory''' differently, according to how the window was opened. Ranges of slot indices vary in meaning between different “windows”. The [[Protocol#Open Window|Open Window]] packet indicates which window is being opened according to:
+
Minecraft displays the '''player inventory''' differently, according to how the window was opened. Ranges of slot indices vary in meaning between different “windows”. The [[Protocol#Open_Screen|Open Screen]] packet indicates which window is being opened according to:
  
 
<div style="float:right;">__TOC__</div>
 
<div style="float:right;">__TOC__</div>
 
 
{| class="wikitable"
 
{| class="wikitable"
 
  |-
 
  |-
Line 38: Line 37:
 
  |-
 
  |-
 
  | 7
 
  | 7
 +
| minecraft:crafter_3x3
 +
| General-purpose 3-by-3 square inventory, used by the {{Minecraft Wiki|Crafter}}
 +
|-
 +
| 8
 
  | minecraft:anvil
 
  | minecraft:anvil
 
  | {{Minecraft Wiki|Anvil}}
 
  | {{Minecraft Wiki|Anvil}}
 
  |-
 
  |-
  | 8
+
  | 9
 
  | minecraft:beacon
 
  | minecraft:beacon
 
  | {{Minecraft Wiki|Beacon}}
 
  | {{Minecraft Wiki|Beacon}}
 
  |-
 
  |-
  | 9
+
  | 10
 
  | minecraft:blast_furnace
 
  | minecraft:blast_furnace
 
  | {{Minecraft Wiki|Blast Furnace}}
 
  | {{Minecraft Wiki|Blast Furnace}}
 
  |-
 
  |-
  | 10
+
  | 11
 
  | minecraft:brewing_stand
 
  | minecraft:brewing_stand
 
  | {{Minecraft Wiki|Brewing stand}}
 
  | {{Minecraft Wiki|Brewing stand}}
 
  |-
 
  |-
  | 11
+
  | 12
 
  | minecraft:crafting
 
  | minecraft:crafting
 
  | {{Minecraft Wiki|Crafting table}}
 
  | {{Minecraft Wiki|Crafting table}}
 
  |-
 
  |-
  | 12
+
  | 13
 
  | minecraft:enchantment
 
  | minecraft:enchantment
 
  | {{Minecraft Wiki|Enchantment table}}
 
  | {{Minecraft Wiki|Enchantment table}}
 
  |-
 
  |-
  | 13
+
  | 14
 
  | minecraft:furnace
 
  | minecraft:furnace
 
  | {{Minecraft Wiki|Furnace}}
 
  | {{Minecraft Wiki|Furnace}}
 
  |-
 
  |-
  | 14
+
  | 15
 
  | minecraft:grindstone
 
  | minecraft:grindstone
 
  | {{Minecraft Wiki|Grindstone}}
 
  | {{Minecraft Wiki|Grindstone}}
 
  |-
 
  |-
  | 15
+
  | 16
 
  | minecraft:hopper
 
  | minecraft:hopper
 
  | {{Minecraft Wiki|Hopper}} or {{Minecraft Wiki|minecart with hopper}}
 
  | {{Minecraft Wiki|Hopper}} or {{Minecraft Wiki|minecart with hopper}}
 
  |-
 
  |-
  | 16
+
  | 17
 
  | minecraft:lectern
 
  | minecraft:lectern
 
  | {{Minecraft Wiki|Lectern}}
 
  | {{Minecraft Wiki|Lectern}}
 
  |-
 
  |-
  | 17
+
  | 18
 
  | minecraft:loom
 
  | minecraft:loom
 
  | {{Minecraft Wiki|Loom}}
 
  | {{Minecraft Wiki|Loom}}
 
  |-
 
  |-
  | 18
+
  | 19
 
  | minecraft:merchant
 
  | minecraft:merchant
 
  | {{Minecraft Wiki|Villager}}, {{Minecraft Wiki|Wandering Trader}}
 
  | {{Minecraft Wiki|Villager}}, {{Minecraft Wiki|Wandering Trader}}
 
  |-
 
  |-
  | 19
+
  | 20
 
  | minecraft:shulker_box
 
  | minecraft:shulker_box
 
  | {{Minecraft Wiki|Shulker box}}
 
  | {{Minecraft Wiki|Shulker box}}
 
  |-
 
  |-
  | 20
+
  | 21
 
  | minecraft:smithing
 
  | minecraft:smithing
 
  | {{Minecraft Wiki|Smithing Table}}
 
  | {{Minecraft Wiki|Smithing Table}}
 
  |-
 
  |-
  | 21
+
  | 22
 
  | minecraft:smoker
 
  | minecraft:smoker
 
  | {{Minecraft Wiki|Smoker}}
 
  | {{Minecraft Wiki|Smoker}}
 
  |-
 
  |-
  | 22
+
  | 23
 
  | minecraft:cartography
 
  | minecraft:cartography
 
  | {{Minecraft Wiki|Cartography Table}}
 
  | {{Minecraft Wiki|Cartography Table}}
 
  |-
 
  |-
  | 23
+
  | 24
 
  | minecraft:stonecutter
 
  | minecraft:stonecutter
 
  | {{Minecraft Wiki|Stonecutter}}
 
  | {{Minecraft Wiki|Stonecutter}}
 
  |}
 
  |}
 +
  
 
{{Need Info|Most of the inventories new to 1.14 have buttons, which are ''probably'' implemented using [[Protocol#Click Window Button]].  This needs to be confirmed and the button IDs should be checked.}}
 
{{Need Info|Most of the inventories new to 1.14 have buttons, which are ''probably'' implemented using [[Protocol#Click Window Button]].  This needs to be confirmed and the button IDs should be checked.}}
Line 198: Line 202:
 
  | hotbar
 
  | hotbar
 
  |}
 
  |}
 
{{warning2|It is possible to receive different "Number Of Slots" parameters than those two.  In vanilla, using /setblock four times around a chest and then opening the middle chest will open a window with 5*27 chest slots.  Some custom servers will send chest inventories with other sizes, usually ranging from 1 row to 6 rows.  These may be used for custom GUIs.  It is thus important to correctly use the "Number Of Slots" parameter in the open window packet to determine the number of rows in the chest, rather than hardcoding what constitutes a regular chest or a large chest.}}
 
  
 
{{-}}
 
{{-}}
Line 225: Line 227:
 
  | hotbar
 
  | hotbar
 
  |}
 
  |}
 
{{warning2|If the "Number Of Slots" parameter is not set to 0, the opened window will behave like a container window.}}
 
  
 
{{-}}
 
{{-}}
Line 256: Line 256:
 
  | hotbar
 
  | hotbar
 
  |}
 
  |}
 
{{warning2|If the "Number Of Slots" parameter is inferior to 3, placing an item in a slot may crash the client.}}
 
  
 
{{-}}
 
{{-}}
Line 266: Line 264:
 
The GUI that appears when a blast furnace is opened.  Same layout as a furnace; however, the recipe book displays blast furnace recipes instead of regular furnace recipes.
 
The GUI that appears when a blast furnace is opened.  Same layout as a furnace; however, the recipe book displays blast furnace recipes instead of regular furnace recipes.
  
{| class="wikitable" {{added}}
+
{| class="wikitable"
 
  |-
 
  |-
 
  ! Slot range
 
  ! Slot range
Line 294: Line 292:
 
The GUI that appears when a smoker is opened.  Same layout as a furnace; however, the recipe book displays smoker recipes instead of regular furnace recipes.
 
The GUI that appears when a smoker is opened.  Same layout as a furnace; however, the recipe book displays smoker recipes instead of regular furnace recipes.
  
{| class="wikitable" {{added}}
+
{| class="wikitable"
 
  |-
 
  |-
 
  ! Slot range
 
  ! Slot range
Line 338: Line 336:
 
  | hotbar
 
  | hotbar
 
  |}
 
  |}
 
{{warning2|If the "Number Of Slots" parameter is inferior to 9, placing an item in a slot may crash the client.}}
 
  
 
{{-}}
 
{{-}}
Line 347: Line 343:
 
[[File:EnchantmentTable-slots.png|thumb|Enchantment table slots]]
 
[[File:EnchantmentTable-slots.png|thumb|Enchantment table slots]]
  
The inventory of an enchantment table.  The enchant buttons trigger a [[Protocol#Enchant item|Enchant item]] packet.
+
The inventory of an enchantment table.
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 631: Line 627:
 
[[File:1.14-cartography-slots.png|thumb|Cartography table slots]]
 
[[File:1.14-cartography-slots.png|thumb|Cartography table slots]]
  
The GUI that appears when a cartography table is opened.
+
The inventory that appears when a cartography table is opened.
  
{| class="wikitable" {{added}}
+
{| class="wikitable"
 
  |-
 
  |-
 
  ! Slot range
 
  ! Slot range
Line 659: Line 655:
 
[[File:1.14-grindstone-slots.png|thumb|Grindstone slots]]
 
[[File:1.14-grindstone-slots.png|thumb|Grindstone slots]]
  
{| class="wikitable" {{added}}
+
The inventory that appears when a grindstone is opened.
 +
 
 +
{| class="wikitable"
 
  |-
 
  |-
 
  ! Slot range
 
  ! Slot range
Line 685: Line 683:
 
[[File:1.14-lectern.png|thumb|Lectern UI]]
 
[[File:1.14-lectern.png|thumb|Lectern UI]]
  
This is a regular container, unlike with held books opened via [[Protocol#Open Book]].
+
The interface that appears when a lectern with a book is opened. The book is shown through the same interface as the one of [[Protocol#Open_Book|Open Book]], minus the extra controls.
  
{{Need Info|Is the player inventory also included on this?}}
+
The player inventory is not included.
  
  
{| class="wikitable" {{added}}
+
{| class="wikitable"
 
  |-
 
  |-
 
  ! Slot range
 
  ! Slot range
Line 697: Line 695:
 
  | 0
 
  | 0
 
  | book
 
  | book
|-
 
| 1–27
 
| main inventory?
 
|-
 
| 28–36
 
| hotbar?
 
 
  |}
 
  |}
  
Line 710: Line 702:
 
[[File:1.14-loom-slots.png|thumb|Loom slots]]
 
[[File:1.14-loom-slots.png|thumb|Loom slots]]
  
{| class="wikitable" {{added}}
+
The inventory that appears when a loom is opened.
 +
 
 +
{| class="wikitable"
 
  |-
 
  |-
 
  ! Slot range
 
  ! Slot range
Line 739: Line 733:
 
[[File:1.14-stonecutter-slots.png|thumb|Stonecutter slots]]
 
[[File:1.14-stonecutter-slots.png|thumb|Stonecutter slots]]
  
{| class="wikitable" {{added}}
+
The inventory that appears when a stonecutter is opened.
 +
 
 +
{| class="wikitable"
 
  |-
 
  |-
 
  ! Slot range
 
  ! Slot range
Line 759: Line 755:
 
{{-}}
 
{{-}}
  
 +
== Smithing Table==
 +
[[File:1.20-smithing-table-slots.png|thumb|Smithing Table slots]]
 +
 +
The inventory that appears when a smithing table is opened.
 +
 +
{| class="wikitable"
 +
|-
 +
! Slot range
 +
! Description
 +
|-
 +
| 0
 +
| template
 +
|-
 +
| 1
 +
| base item
 +
|-
 +
| 2
 +
| additional item
 +
|-
 +
| 3
 +
| result
 +
|-
 +
| 4–30
 +
| main inventory
 +
|-
 +
| 31–39
 +
| hotbar
 +
|}
 +
 +
{{-}}
 +
 +
[[Category:Protocol Details]]
 
[[Category:Minecraft Modern]]
 
[[Category:Minecraft Modern]]

Latest revision as of 13:49, 22 March 2024

Minecraft displays the player inventory differently, according to how the window was opened. Ranges of slot indices vary in meaning between different “windows”. The Open Screen packet indicates which window is being opened according to:

Type Name Description
0 minecraft:generic_9x1 A 1-row inventory, not used by the notchian server.
1 minecraft:generic_9x2 A 2-row inventory, not used by the notchian server.
2 minecraft:generic_9x3 General-purpose 3-row inventory. Used by Chest, minecart with chest, ender chest, and barrel
3 minecraft:generic_9x4 A 4-row inventory, not used by the notchian server.
4 minecraft:generic_9x5 A 5-row inventory, not used by the notchian server.
5 minecraft:generic_9x6 General-purpose 6-row inventory, used by large chests.
6 minecraft:generic_3x3 General-purpose 3-by-3 square inventory, used by Dispenser and Dropper
7 minecraft:crafter_3x3 General-purpose 3-by-3 square inventory, used by the Crafter
8 minecraft:anvil Anvil
9 minecraft:beacon Beacon
10 minecraft:blast_furnace Blast Furnace
11 minecraft:brewing_stand Brewing stand
12 minecraft:crafting Crafting table
13 minecraft:enchantment Enchantment table
14 minecraft:furnace Furnace
15 minecraft:grindstone Grindstone
16 minecraft:hopper Hopper or minecart with hopper
17 minecraft:lectern Lectern
18 minecraft:loom Loom
19 minecraft:merchant Villager, Wandering Trader
20 minecraft:shulker_box Shulker box
21 minecraft:smithing Smithing Table
22 minecraft:smoker Smoker
23 minecraft:cartography Cartography Table
24 minecraft:stonecutter Stonecutter


Huh.png The following information needs to be added to this page:
Most of the inventories new to 1.14 have buttons, which are probably implemented using Protocol#Click Window Button. This needs to be confirmed and the button IDs should be checked.

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.

The default inventory window, which is never explicitly opened by the server, has 10 unique slots.

Rectangular regions are always indexed starting with the upper-left corner and scanning across rows. If a window has a crafting region, the output slot is always slot 0 followed immediately by the input region.

Each window type is described in the following sections. All slot index ranges are inclusive and reflect the indices observed in the Minecraft protocol.

For the window properties (additional data in each window, e.g. smelting progress or enchantments), refer to the table in the Window Property packet.

Using -1 as slot index and as window id will set the cursor item (the stack dragged with the mouse).

Player Inventory

Inventory slots

This is the inventory window that the player can always open, typically by pressing E since Beta 1.4. Before, you had to press I.

Slot range Description
0 crafting output
1–4 2×2 crafting input (1 + x + 2 * y)
5–8 armor (head, chest, legs, feet)
9–35 main inventory
36–44 hotbar
45 Offhand slot

Note that this is different from inventory items stored in a player.dat file. This may help: https://gist.github.com/459a1691c3dd751db160

Chest

Chest slots

This is the window that is opened when the player right-clicks on a single chest block.

Slot range Description
0–26 chest
27–53 main inventory
54–62 hotbar
Double/large chest slots

Large chest

This is the window that is opened when the player right-clicks on a double chest block (two adjacent chest blocks).

Slot range Description
0–53 chest
54–80 main inventory
81–89 hotbar

Crafting table

Crafting table slots

This is the window that is opened when the player right-clicks on a workbench.

Slot range Description
0 crafting output
1–9 3×3 crafting input (1 + x + 3 * y)
10–36 main inventory
37–45 hotbar

Furnace

Furnace slots

The window that appears when a furnace is right-clicked.

Slot range Description
0 ingredient
1 fuel
2 output
3–29 main inventory
30–38 hotbar

Blast Furnace

Blast Furnace slots

The GUI that appears when a blast furnace is opened. Same layout as a furnace; however, the recipe book displays blast furnace recipes instead of regular furnace recipes.

Slot range Description
0 ingredient
1 fuel
2 output
3–29 main inventory
30–38 hotbar

Smoker

Smoker slots

The GUI that appears when a smoker is opened. Same layout as a furnace; however, the recipe book displays smoker recipes instead of regular furnace recipes.

Slot range Description
0 ingredient
1 fuel
2 output
3–29 main inventory
30–38 hotbar

Dispenser

Dispenser/dropper slots

The inventory that appears when a dispenser or dropper is opened.

Slot range Description
0–8 3×3 dispenser contents (x + 3 * y)
9–35 main inventory
36-44 hotbar

Enchantment Table

Enchantment table slots

The inventory of an enchantment table.

Slot range Description
0 item to enchant
1 lapis lazuli slot
2–28 main inventory
29–37 hotbar

Brewing stand

Brewing stand slots

The GUI that appears when a brewing stand is opened.

Slot range Description
0-2 bottles/potions
3 potion ingredient
4 blaze powder
5-31 main inventory
32-40 hotbar

Villager trading

Merchant slots

The GUI that appears when a villager is right-clicked. Note that if the villager only requires one item, you can put it in either (or both) slots.

Slot range Description
0-1 input items
2 result
3–29 main inventory
30–38 hotbar

Beacon

Beacon slots

The window that appears when a beacon is right-clicked.

Slot range Description
0 payment item
1–27 main inventory
28–36 hotbar

Anvil

Anvil slots
Slot range Description
0 first item
1 second item
2 result
3–29 main inventory
30–38 hotbar

Hopper

Hopper slots

The window that appears when a hopper or hopper minecart is opened.

Slot range Description
0-4 hopper slots
5–31 main inventory
32–40 hotbar

Shulker box

Shulker box slots

This is the window that is opened when the player right-clicks on a shulker box chest.

Slot range Description
0–26 box slots
27–53 main inventory
54–62 hotbar

Llama

Llama slots

The inventory that appears when a tamed llama is right-clicked and has a chest, or when the player's inventory is opened while riding a tamed llama. Depending on the value of the strength field, the number of chest rows may vary (max is 5, so 15 slots).

Warning.png There still is a saddle slot, even though it cannot be used and is invisible.

Warning.png Slot positions within the llama inventory vary - slot 2 may be at (1,0) or at (0,1) depending on the number of columns.

Slot range Description
0 saddle
1 carpet
2-(2+3*Strength) llama inventory
(2+3*Strength)+1-(2+3*Strength)+27 player inventory
(2+3*Strength)+28-(2+3*Strength)+35 hotbar

Horse

Horse slots

The window for when a tamed horse is right-clicked or the player's inventory is opened while riding a horse.

Slot range Description
0 saddle
1 armor
2–28 main inventory
29–37 hotbar

Donkey

Donkey slots

The inventory that appears when a tamed donkey (or mule?) is right-clicked, or when the player's inventory is opened while riding a tamed donkey or mule.

Warning.png There still is an armor slot, even though it cannot be used and is invisible.

Slot range Description
0 saddle
1 armor
2–16 donkey inventory
17–43 (2-28 if unchested) player inventory
44–52 (29-37 if unchested) hotbar

Cartography Table

Cartography table slots

The inventory that appears when a cartography table is opened.

Slot range Description
0 map
1 paper
2 output
3–29 main inventory
30–38 hotbar

Grindstone

Grindstone slots

The inventory that appears when a grindstone is opened.

Slot range Description
0 first item
1 second item
2 result
3–29 main inventory
30–38 hotbar

Lectern

Lectern UI

The interface that appears when a lectern with a book is opened. The book is shown through the same interface as the one of Open Book, minus the extra controls.

The player inventory is not included.


Slot range Description
0 book

Loom

Loom slots

The inventory that appears when a loom is opened.

Slot range Description
0 banner
1 dye
2 pattern
3 result
4–30 main inventory
31–39 hotbar

Stonecutter

Stonecutter slots

The inventory that appears when a stonecutter is opened.

Slot range Description
0 input
1 result
2–28 main inventory
29–37 hotbar

Smithing Table

Smithing Table slots

The inventory that appears when a smithing table is opened.

Slot range Description
0 template
1 base item
2 additional item
3 result
4–30 main inventory
31–39 hotbar