Difference between revisions of "Slot Data"

From wiki.vg
Jump to: navigation, search
(Format: We shouldn't call the NBT data "metadata", as people already use that to refer to the damage)
(Removed packet list)
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 ==
 
 
 
* [[Protocol#Entity_Equipment_.280x05.29|0x05 Entity Equipment]]
 
* [[Protocol#Player_Block_Placement_.280x0F.29|0x0F Player Block Placement]]
 
* [[Protocol#Spawn Dropped Item (0x15)| 0x15 Spawn Dropped Item]]
 
* [[Protocol#Window_click_.280x66.29|0x66 Window Click]]
 
* [[Protocol#Set_slot_.280x67.29|0x67 Set Slot]]
 
* [[Protocol#Window_items_.280x68.29|0x68 Window Items]] (as an array)
 
* [[Protocol#Creative_inventory_action_.280x6B.29|0x6B Creative Inventory Action]]
 
  
 
== Format ==
 
== Format ==

Revision as of 17:53, 16 December 2012

The slot data structure is how Minecraft represents an item and its associated data in the minecraft protocol

Format

The structure consists of at least a short, which gives the item/block ID [1]. A value of -1 signifies that the slot is empty, and no further data follows.

If the block ID is not -1, three more fields follow. These fields are a byte (item count), a short (item damage), and another short (length of optional NBT data).

If the short (length of NBT data) is -1, there is no NBT data, and no further data follows. Otherwise, a byte array will follow.

The byte array contains gzipped (that is RFC 1952 rather than RFC 1950) NBT data. The format of this data is as follows:

 COMPOUND: ''
   LIST: 'ench'
     COMPOUND
       SHORT: 'id'
       SHORT: 'lvl'
     END
     COMPOUND
       ...etc
     END
 END

Each of the inner, untagged COMPOUNDs represents an enchantment, with its ID[2] and level given as child SHORT elements.

Examples

 ff ff                            | empty slot
 01 16 01 00 00 ff ff             | a diamond pickaxe
 01 16 01 00 00 00 04 CA FE BA BE | a diamond pickaxe with (made-up) NBT data