From 12d65cc67230558b014eec9b78e71bcfb8af9411 Mon Sep 17 00:00:00 2001
From: Dylan T <odigiman@gmail.com>
Date: Fri, 6 Dec 2019 11:54:48 +0000
Subject: [PATCH] Update README.md

---
 README.md | 49 +++++++++++++++++++++++++++++++------------------
 1 file changed, 31 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index 7e0e612..c9727e6 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,9 @@
 # BedrockData
 Blobs of data generated from Minecraft: Bedrock Edition used by PocketMine-MP
 
-### `required_block_states.json`
-This file contains data defining all the needed block states in MCPE's StartGamePacket. The format is as follows:
-<details><summary>Show</summary>
-<pre>
-"prefix": {
-   "block_id": [
-       /* all of the needed metadata variants (or states in the future) */
-       0,
-       1,
-       2,
-       3
-   ]
-}
-</pre>
-</details>
+### `required_block_states.nbt`
+This file contains a network-format NBT list of all the blockstate permutations needed by MCPE's `StartGamePacket`.
+It's provided as-is directly from `StartGamePacket` sent by the current vanilla server.
 
 ### `block_id_map.json`
 This file contains a mapping of all block stringy IDs to legacy numeric IDs (which are still used internally, and still needed by third party developers for conversion and for items).
@@ -23,6 +11,28 @@ This file contains a mapping of all block stringy IDs to legacy numeric IDs (whi
 #### Note
 Where a block's legacy ID is > 255, its item ID is `255 - legacyBlockId`. This means prismarine stairs = -2 and so on.
 
+### `r12_to_current_block_map.nbt`
+This file contains a list of mappings from legacy pre-1.13 blockstates to states of the current version.
+This data is obtained by plugging the legacy states into `BlockPalette` in the vanilla BDS using a mod, and writing the resulting NBT state obtained.
+<details><summary>Schema</summary>
+
+```
+TAG_List: value={
+   "old" => TAG_Compound: value={
+      "name" => TAG_String: value="minecraft:example" //legacy string ID pre-1.13
+      "val" => TAG_Short: value=0 //legacy block metadata pre-1.13
+   }
+   "new" => TAG_Compound: value={
+      "name" => TAG_String: value="minecraft:new_example" //this might be different to the legacy ID in future versions!
+      "states" => TAG_Compound: value={
+         //list states here
+      }
+   }
+}
+```
+
+</details>
+
 ### `item_id_map.json`
 This file contains a mapping of all item stringy IDs to legacy numeric IDs.
 
@@ -32,8 +42,11 @@ This file defines all the known banner pattern types and their crafting requirem
 ### `recipes.json`
 This file defines all crafting-table, furnace and chemistry recipes. This includes recipes for the smoker, cartography table etc.
 
-#### Note
-Brewing recipes are **not** included because Mojang don't see fit to send these over network.
-
 ### `creativeitems.json`
 This file contains an ordered list of items which appear in the vanilla creative inventory with Education Edition and Experimental Gameplay enabled.
+
+### `biome_definitions.nbt`
+This file contains a network-format NBT blob containing biome definitions obtained from `BiomeDefinitionListPacket`.
+
+### `entity_identifiers.nbt`
+This file contains a network-format NBT blob containing entity identifier mappings obtained from `AvailableActorIdentifiersPacket`.