]> git.lizzy.rs Git - dragonfireclient.git/blobdiff - doc/world_format.txt
Handle particle spawners in env and delete expired ids
[dragonfireclient.git] / doc / world_format.txt
index 105fbb63ee7b4c060808c3c1362d4b419502b08e..a4fb3d8f23ac5dd732d9848f476cd97e269fd62c 100644 (file)
@@ -47,8 +47,9 @@ in the base64 encoding.
 
 Format (since 0.4.13) of password hash is #1#<salt>#<verifier>, with the
 parts inside <> encoded in the base64 encoding.
-<verifier> is an RFC 5054 compatible SRP-2048-SHA1 verifier
-of the given salt, password, and the player's name lowercased.
+<verifier> is an RFC 2945 compatible SRP verifier,
+of the given salt, password, and the player's name lowercased,
+using the 2048-bit group specified in RFC 5054 and the SHA-256 hash function.
 
 Example lines:
 - Player "celeron55", no password, privileges "interact" and "shout":
@@ -250,7 +251,7 @@ NOTE: Zlib data is in such a format that Python's zlib at least can
       directly decompress.
 
 u8 version
-- map format version number, this one is version 22
+- map format version number, see serialisation.h for the latest number
 
 u8 flags
 - Flag bitmasks:
@@ -296,13 +297,26 @@ if content_width == 2:
 
 zlib-compressed node metadata list
 - content:
+if map format version <= 22:
   u16 version (=1)
   u16 count of metadata
   foreach count:
     u16 position (p.Z*MAP_BLOCKSIZE*MAP_BLOCKSIZE + p.Y*MAP_BLOCKSIZE + p.X)
     u16 type_id
     u16 content_size
-    u8[content_size] (content of metadata)
+    u8[content_size] content of metadata. Format depends on type_id, see below.
+if map format version >= 23:
+  u8 version (=1) -- Note the type is u8, while for map format version <= 22 it's u16
+  u16 count of metadata
+  foreach count:
+    u16 position (p.Z*MAP_BLOCKSIZE*MAP_BLOCKSIZE + p.Y*MAP_BLOCKSIZE + p.X)
+    u32 num_vars
+    foreach num_vars:
+      u16 key_len
+      u8[key_len] key
+      u32 val_len
+      u8[val_len] value
+    serialized inventory
 
 - Node timers
 if map format version == 23:
@@ -378,8 +392,9 @@ The name-id-mapping
 --------------------
 The mapping maps node content ids to node names.
 
-Node metadata format
----------------------
+Node metadata format for map format versions <= 22
+---------------------------------------------------
+The node metadata are serialized depending on the type_id field.
 
 1: Generic metadata
   serialized inventory