Update readme with fixes and stuff.

readme.md

@@ -19,10 +19,15 @@ nodes in the landscape.
 
 ## features
 
-- jungle dirt is replaced by dirt with grass
-- dirt with dry grass is replaced by dirt with grass
-- dirt with snow is replaced by dirt with grass
-- dry grass is replaced with grass
+- Player placed blocks are properly colored.
+- Saplings that grow into trees color correctly.
+- separate palette to color leaves and grass.
+- should not break with texture packs, but you'll lose texture
+  pack specific leaf and grass textures.
+- jungle dirt is replaced by dirt with grass.
+- dirt with dry grass is replaced by dirt with grass.
+- dirt with snow is replaced by dirt with grass.
+- dry grass is replaced with grass.
 
 ## bugs
 
@@ -34,5 +39,31 @@ nodes in the landscape.
 ## palette
 
 The large palette image is generated with:
-  `convert textures/default_luscious_palette.png -filter point -resize 256x256 textures/palette_large.png`
 
+```
+  convert textures/luscious_grass_palette.png -filter point \
+   -resize 256x256 textures/luscious_grass_palette_large.png
+```
+
+## Installation
+
+Create a new world, enable this mod. Do not use this mod in an existing
+world, ever.
+
+## How does this work?
+
+The biome data is available in a special thread when mapgen emerges
+new map blocks. This mod captures the biome heat and humidity values
+right as mapgen creates them and stores them permanently for later
+use. This is why you need to have a `luscious` folder in the world
+folder. In this folder, we store the heat & humidity param2 values
+for each node that needs coloring in an X-Z map (Y is discarded as
+biome data does not use Y and is not 3d noise, it's only 2D).
+
+Once the biome data is known, we can retrieve it to set the correct
+p2 values when a player places any of the nodes that need coloring, or
+when a tree grows. This is also why the biome data needs to be stored
+on disk - otherwise it would be lost. The storage of the biome data
+is reasonably small - it is stored compressed and uses about 600 bytes
+or so per x, z chunk, which is small compared to the actual map.sqlite
+size. The data increases the size of your world by about 12% or so.