From: Perttu Ahola <celeron55@gmail.com>
Date: Thu, 22 Mar 2012 14:12:33 +0000 (+0200)
Subject: Describe format of nodes in doc/mapformat.txt
X-Git-Url: http://81.2.79.47:8989/gitweb/?a=commitdiff_plain;h=424b36d469e99d5d1bd9bb136477d0dc442376dd;p=zefram%2Fminetest%2Fminetest_engine.git

Describe format of nodes in doc/mapformat.txt
---

diff --git a/doc/mapformat.txt b/doc/mapformat.txt
index fd892c9d..db161986 100644
--- a/doc/mapformat.txt
+++ b/doc/mapformat.txt
@@ -271,6 +271,7 @@ zlib-compressed node data:
   u8[4096]: param0 fields
   u8[4096]: param1 fields
   u8[4096]: param2 fields
+- The location of a node in each of those arrays is (z*16*16 + y*16 + x).
 
 zlib-compressed node metadata list
 - content:
@@ -316,6 +317,22 @@ foreach num_name_id_mappings
 
 EOF.
 
+Format of nodes
+----------------
+A node is composed of the u8 fields param0, param1 and param2.
+
+The content id of a node is determined as so:
+- If param0 < 0x80,
+    content_id = param0
+- Otherwise
+    content_id = (param0<<4) + (param2>>4)
+
+The purpose of param1 and param2 depend on the definition of the node.
+
+The name-id-mapping
+--------------------
+The mapping maps node content ids to node names.
+
 Node metadata format
 ---------------------