Difference between revisions of "Slot Data"

From wiki.vg
Jump to navigation Jump to search
 
m (Add type links.)
 
(30 intermediate revisions by 20 users not shown)
Line 1: Line 1:
The '''slot''' data structure is how minecraft represents an item and its associated data in the [[Protocol|minecraft protocol]]
+
The '''Slot''' data structure is how Minecraft represents an item and its associated data in the [[Protocol|Minecraft Protocol]].
  
== Packets ==
+
=== Slot ===
  
* [[Protocol#Player_Block_Placement_.280x0F.29|0x0F player block placement]]
+
{| class="wikitable"
* [[Protocol#Window_click_.280x66.29|0x66 window click]]
+
! Name
* [[Protocol#Set_slot_.280x67.29|0x67 set slot]]
+
! Type
* [[Protocol#Window_items_.280x68.29|0x68 window items]] (as an array)
+
! Meaning
* [[Protocol#Creative_inventory_action_.280x6B.29|0x6B creative inventory action]]
+
|-
 +
| Present
 +
| {{Type|Boolean}}
 +
| True if there is an item in this position; false if it is empty.
 +
|-
 +
| Item ID
 +
| {{Type|Optional}} {{Type|VarInt}}
 +
| Omitted if present is false. The {{Minecraft Wiki|Java Edition data values#Blocks|item ID}}. Item IDs are distinct from block IDs; see [[Data Generators]] for more information
 +
|-
 +
| Item Count
 +
| {{Type|Optional}} {{Type|Byte}}
 +
| Omitted if present is false.
 +
|-
 +
| NBT
 +
| {{Type|Optional}} {{Type|NBT}}
 +
| Omitted if present is false. If 0 (TAG_End), there is no NBT data, and no further data follows. Otherwise the byte is the start of an NBT blob as shown below:
 +
|}
  
== Format ==
+
<pre>
 
+
   COMPOUND
The structure consists of at least a short, which gives the item/block ID [http://www.minecraftwiki.net/wiki/Block_ids#Block_IDs_.28Minecraft_Beta.29]. A value of <code>-1</code> signifies that the slot is empty, and no further data follows.
+
     LIST 'StoredEnchantments'
 
 
For non-empty slots, at least two further fields follow. These fields are a byte (item count) and a short (damage/block metadata)
 
 
 
For certain block IDs, [[#Enchantable_items|given below]], further data follows. First, a short gives the length of a proceeding byte array. A value of <code>-1</code> signifies no further data.
 
 
 
The byte array (if present) contains gzipped (that is RFC 1952 rather than RFC 1950) [[NBT]] data. The format of this data is as follows:
 
 
 
<code>
 
   COMPOUND: <nowiki>''</nowiki>
 
     LIST: 'ench'
 
 
       COMPOUND
 
       COMPOUND
         SHORT: 'id'
+
         STRING 'id'
         SHORT: 'lvl'
+
         SHORT 'lvl'
 
       END
 
       END
 
       COMPOUND
 
       COMPOUND
         ...etc
+
         ...
 
       END
 
       END
 +
      ...
 +
    END
 +
    INT 'Unbreakable'
 +
    ...
 
   END
 
   END
</code>
+
</pre>
  
Each of the inner, untagged COMPOUNDs represents an enchantment, with its ID[http://www.minecraftwiki.net/wiki/Enchantment#Enchantment_Types] and level given as child SHORT elements.
+
Note that on old versions, the enchantment id was sent as a SHORT, and not as a STRING.
  
== Enchantable items ==
+
Since 1.20.2 the root compound also has no name anymore. The NBT data starts with one byte indicating the type, followed by the type-specific data.
  
Every item that has a "damage bar" in-game is considered enchantable by the protocol, though the notchian server/client do not support enchantment of some items. These include: hoes, flint and steel, bows, fishing rods and shears.
+
See [[NBT]] for more information about the NBT format, and {{Minecraft Wiki|Player.dat format#Item structure|here}} for the contained information and its format. Note that tool durability is included in NBT, among other things.
  
<code>
+
== Examples ==
  0x103, #Flint and steel
 
  0x105, #Bow
 
  0x15A, #Fishing rod
 
  0x167, #Shears
 
 
 
  #TOOLS
 
  #sword, shovel, pickaxe, axe, hoe
 
  0x10C, 0x10D, 0x10E, 0x10F, 0x122, #WOOD
 
  0x110, 0x111, 0x112, 0x113, 0x123, #STONE
 
  0x10B, 0x100, 0x101, 0x102, 0x124, #IRON
 
  0x114, 0x115, 0x116, 0x117, 0x125, #DIAMOND
 
  0x11B, 0x11C, 0x11D, 0x11E, 0x126, #GOLD
 
 
 
  #ARMOUR
 
  #helmet, chestplate, leggings, boots
 
  0x12A, 0x12B, 0x12C, 0x12D, #LEATHER
 
  0x12E, 0x12F, 0x130, 0x131, #CHAIN
 
  0x132, 0x133, 0x134, 0x135, #IRON
 
  0x136, 0x137, 0x138, 0x139, #DIAMOND
 
  0x13A, 0x13B, 0x13C, 0x13D  #GOLD
 
</code>
 
  
Or, more simply:
+
<pre>
 +
  00                      | empty slot
 +
  01 01 01 00            | a stone block
 +
  01 01 01 03 12 34 56 78 | a stone block with (made-up) NBT data
 +
</pre>
  
<code>
+
[[Category:Protocol Details]]
        private static bool CanEnchant(short value)
+
[[Category:Minecraft Modern]]
        {
 
            return  (256 <= value && value <= 259) ||
 
                    (267 <= value && value <= 279) ||
 
                    (283 <= value && value <= 286) ||
 
                    (290 <= value && value <= 294) ||
 
                    (298 <= value && value <= 317) ||
 
                    value == 261 || value == 359 ||
 
                    value == 346;
 
        }
 
</code>
 

Latest revision as of 23:08, 24 February 2024

The Slot data structure is how Minecraft represents an item and its associated data in the Minecraft Protocol.

Slot

Name Type Meaning
Present Boolean True if there is an item in this position; false if it is empty.
Item ID Optional VarInt Omitted if present is false. The item ID. Item IDs are distinct from block IDs; see Data Generators for more information
Item Count Optional Byte Omitted if present is false.
NBT Optional NBT Omitted if present is false. If 0 (TAG_End), there is no NBT data, and no further data follows. Otherwise the byte is the start of an NBT blob as shown below:
  COMPOUND
    LIST 'StoredEnchantments'
      COMPOUND
        STRING 'id'
        SHORT 'lvl'
      END
      COMPOUND
        ...
      END
      ...
    END
    INT 'Unbreakable'
    ...
  END

Note that on old versions, the enchantment id was sent as a SHORT, and not as a STRING.

Since 1.20.2 the root compound also has no name anymore. The NBT data starts with one byte indicating the type, followed by the type-specific data.

See NBT for more information about the NBT format, and here for the contained information and its format. Note that tool durability is included in NBT, among other things.

Examples

  00                      | empty slot
  01 01 01 00             | a stone block
  01 01 01 03 12 34 56 78 | a stone block with (made-up) NBT data