Difference between revisions of "Object Data"

From wiki.vg
Jump to: navigation, search
(formatting)
(Undo revision 7212 by Fenhl (talk) Undoing Fenhl's mistake, please check within IRC next time.)
Line 1: Line 1:
In the [[Protocol#Spawn Object|Spawn Object]] packet, additional metadata about the spawned entity may be provided. The length and contents of this extra data depend on the type of object being spawned. No matter what, the server must send at least one integer to the client, although 0 is a valid value. If a number other than zero is provided (for all entities), the following data is appended to the end of the object data (as of [[Protocol version numbers|15w31a, protocol 49]] this data is always required):
+
== Object Data ==
 +
 
 +
In the "Spawn Object/Vehicle" packet, additional metadata about the spawned entity may be provided. The length and contents of this extra data depend on the type of object being spawned. No matter what, the server must send at least one integer to the client, although 0 is a valid value. If a number other than zero is provided (for all entities), the following data is appended to the end of the object data (as of [[Protocol version numbers|15w31a, protocol 49]] this data is always required):
  
 
{| class="wikitable"
 
{| class="wikitable"
|-
+
|- class="row0"
! Field name
+
! class="col0" | Field Name
! Field type
+
! class="col1" | Field Type
! Example
+
! class="col2" | Example
! Notes
+
! class="col3" | Notes
|-
+
|- class="row2"
| Speed X
+
| class="col0 centeralign" | Speed X
| Short
+
| class="col1 centeralign" | Short
| <code>0</code>
+
| class="col2 centeralign" | <code>0</code>
| The speed of the object, same units as [[Protocol#Entity Velocity|Entity Velocity]]
+
| class="col3" | The speed of the object, same units as [[Protocol#Entity Velocity|Entity Velocity]]
|-
+
|- class="row2"
| Speed Y
+
| class="col0 centeralign" | Speed Y
| Short
+
| class="col1 centeralign" | Short
| <code>0</code>
+
| class="col2 centeralign" | <code>0</code>
| The speed of the object, same units as [[Protocol#Entity Velocity|Entity Velocity]]
+
| class="col3" | The speed of the object, same units as [[Protocol#Entity Velocity|Entity Velocity]]
|-
+
|- class="row2"
| Speed Z
+
| class="col0 centeralign" | Speed Z
| Short
+
| class="col1 centeralign" | Short
| <code>0</code>
+
| class="col2 centeralign" | <code>0</code>
| The speed of the object, same units as [[Protocol#Entity Velocity|Entity Velocity]]
+
| class="col3" | The speed of the object, same units as [[Protocol#Entity Velocity|Entity Velocity]]
|}
+
|}
  
 
== Meaning of int field ==
 
== Meaning of int field ==
  
=== Minecarts (id 10) ===
+
 
 +
=== Minecarts (id 10)===
  
 
The int value itself specifies the minecart's functionality:
 
The int value itself specifies the minecart's functionality:
  
 
{| class="wikitable"
 
{| class="wikitable"
|-
+
|- class="row0"
! Value
+
! class="col0" | Value
! Minecart functionality
+
! class="col1" | Minecart functionality
|-
+
|- class="row1"
| 0
+
| class="col0 centeralign" | 0
| Empty (ride-able) minecart
+
| class="col1 centeralign" | Empty (ride-able) minecart
|-
+
|- class="row2"
| 1
+
| class="col0 centeralign" | 1
| Chest minecart
+
| class="col1 centeralign" | Chest minecart
|-
+
|- class="row3"
| 2
+
| class="col0 centeralign" | 2
| Furnace (powered) minecart
+
| class="col1 centeralign" | Furnace (powered) minecart
|-
+
|- class="row4"
| 3
+
| class="col0 centeralign" | 3
| TNT minecart
+
| class="col1 centeralign" | TNT minecart
|-
+
|- class="row5"
| 4
+
| class="col0 centeralign" | 4
| Spawner minecart
+
| class="col1 centeralign" | Spawner minecart
|-
+
|- class="row6"
| 5
+
| class="col0 centeralign" | 5
| Hopper minecart
+
| class="col1 centeralign" | Hopper minecart
|-
+
|- class="row7"
| 6
+
| class="col0 centeralign" | 6
| Command Block minecart
+
| class="col1 centeralign" | Command Block minecart
|}
+
|}
  
 
=== Item Frame (id 71) ===
 
=== Item Frame (id 71) ===
  
 
{| class="wikitable"
 
{| class="wikitable"
|-
+
|- class="row0"
! Field name
+
! class="col0" | Field Name
! Field type
+
! class="col1" | Field Type
! Example
+
! class="col2" | Example
! Notes
+
! class="col3" | Notes
|-
+
|- class="row1"
| Orientation
+
| class="col0 centeralign" | Orientation
| Int
+
| class="col1 centeralign" | int
| <code>3</code>
+
| class="col2 centeralign" | <code>3</code>
| 0–3: South, West, North, East
+
| class="col3" | 0-3: South, West, North, East
|}
+
|}
  
 
=== Falling Block (id 70) ===
 
=== Falling Block (id 70) ===
  
 
{| class="wikitable"
 
{| class="wikitable"
|-
+
|- class="row0"
! Field name
+
! class="col0" | Field Name
! Field type
+
! class="col1" | Field Type
! Example
+
! class="col2" | Example
! Notes
+
! class="col3" | Notes
|-
+
|- class="row1"
| Block type
+
| class="col0 centeralign" | Block Type
| Int
+
| class="col1 centeralign" | int
| <code>12</code>
+
| class="col2 centeralign" | <code>12</code>
| <code>BlockID | (Metadata << 0x10)</code>
+
| class="col3" | <code>BlockID | (Metadata << 0x10)</code>
|}
+
|}
  
 
=== Splash Potions (id 73) ===
 
=== Splash Potions (id 73) ===
  
 
{| class="wikitable"
 
{| class="wikitable"
|-
+
|- class="row0"
! Field name
+
! class="col0" | Field Name
! Field type
+
! class="col1" | Field Type
! Example
+
! class="col2" | Example
! Notes
+
! class="col3" | Notes
|-
+
|- class="row1"
| Entity ID
+
| class="col0 centeralign" | Entity ID
| Int
+
| class="col1 centeralign" | int
| <code>64</code>
+
| class="col2 centeralign" | <code>64</code>
| Potion data value
+
| class="col3" | Potion data value
|}
+
|}
  
For more information on potion data values, see {{Minecraft Wiki|Data values#Potions}}.
+
For more information on potion data values, see [http://www.minecraftwiki.net/wiki/Data_values#Potions].
  
 
=== Fishing Float (id 90) ===
 
=== Fishing Float (id 90) ===
 +
{| class="wikitable"
 +
! Field Name !! Field Type !! Example !! Notes
 +
|-
 +
| Owner || int ||  || The entity ID of the owner
 +
|}
 +
  
{| class="wikitable"
 
! Field name
 
! Field type
 
! Example
 
! Notes
 
|-
 
| Owner
 
| Int
 
|
 
| The entity ID of the owner
 
|}
 
  
=== Projectiles ([[Entities#Objects|Any projectile]]) ===
+
=== Projectiles ([[Entities#Objects|Any projectile]])===
  
 
This includes ghast fireballs, arrows, and fishhooks (probably more).
 
This includes ghast fireballs, arrows, and fishhooks (probably more).
  
 
{| class="wikitable"
 
{| class="wikitable"
|-
+
|- class="row0"
! Field name
+
! class="col0" | Field Name
! Field type
+
! class="col1" | Field Type
! Example
+
! class="col2" | Example
! Notes
+
! class="col3" | Notes
|-
+
|- class="row1"
| Entity ID
+
| class="col0 centeralign" | Entity ID
| Int
+
| class="col1 centeralign" | int
| <code>64</code>
+
| class="col2 centeralign" | <code>64</code>
| The entity ID of the thrower
+
| class="col3" | The entity ID of the thrower
|}
+
|}

Revision as of 14:59, 7 January 2016

Object Data

In the "Spawn Object/Vehicle" packet, additional metadata about the spawned entity may be provided. The length and contents of this extra data depend on the type of object being spawned. No matter what, the server must send at least one integer to the client, although 0 is a valid value. If a number other than zero is provided (for all entities), the following data is appended to the end of the object data (as of 15w31a, protocol 49 this data is always required):

Field Name Field Type Example Notes
Speed X Short 0 The speed of the object, same units as Entity Velocity
Speed Y Short 0 The speed of the object, same units as Entity Velocity
Speed Z Short 0 The speed of the object, same units as Entity Velocity

Meaning of int field

Minecarts (id 10)

The int value itself specifies the minecart's functionality:

Value Minecart functionality
0 Empty (ride-able) minecart
1 Chest minecart
2 Furnace (powered) minecart
3 TNT minecart
4 Spawner minecart
5 Hopper minecart
6 Command Block minecart

Item Frame (id 71)

Field Name Field Type Example Notes
Orientation int 3 0-3: South, West, North, East

Falling Block (id 70)

Field Name Field Type Example Notes
Block Type int 12 BlockID | (Metadata << 0x10)

Splash Potions (id 73)

Field Name Field Type Example Notes
Entity ID int 64 Potion data value

For more information on potion data values, see [1].

Fishing Float (id 90)

Field Name Field Type Example Notes
Owner int The entity ID of the owner


Projectiles (Any projectile)

This includes ghast fireballs, arrows, and fishhooks (probably more).

Field Name Field Type Example Notes
Entity ID int 64 The entity ID of the thrower