better control over entity update transmission

[blank.git] / doc / protocol

diff --git a/doc/protocol b/doc/protocol
index 43c14dae4933a0ad9de335dd7cf2bebd0f52d58b..432a3e9413d6604e75808424ab35bb29fd7bdf96 100644 (file)
--- a/doc/protocol
+++ b/doc/protocol
@@ -85,3 +85,47 @@ Payload:
         0 chunk coords of the player, 3x 32bit signed int
        12 pos/vel/rot/ang of the player, 13x 32bit float
 Length: 64
+
+
+Spawn Entity
+------------
+
+Sent by the server to notify the client of an entity entering spawn range.
+
+Code: 5
+Payload:
+         0 entity ID, 32bit unsigned int
+         4 entity's skeleton ID, 32bit unsigned int
+         8 chunk coords of the entity, 3x 32bit signed int
+        20 pos/vel/rot/ang of the entity, 13x 32bit float
+        72 bounding box of the entity, 6x 32bit float
+        96 flags, 32bit bitfield with boolean values
+           1: world collision
+       100 entity name, max 32 byte UTF-8 string
+Length: 132
+
+
+Despawn Entity
+--------------
+
+Sent by the server to notify the client of an entity leaving spawn range.
+
+Code: 6
+Payload:
+       0 entity ID, 32bit unsigned int
+Length: 4
+
+
+Entity Update
+-------------
+
+Sent by the server to notify the client of updated entity properties.
+Contained entities must be ordered by ascending entity ID.
+
+Code: 7
+Payload:
+        0 number of entities, 32bit int, 1-7
+        4 chunk coords of the entity, 3x 32bit signed int
+       16 pos/vel/rot/ang of the entity, 13x 32bit float
+       68 next entity...
+Length: 4 + multiple of 64, max 452