Updated Texture Definition Files (markdown)

Texture-Definition-Files.md

@@ -1,3 +1,7 @@
+Texture definition files (the *-texture.txt files) provide three key sets of data:
+* What texture files are needed, and how they need to be loaded
+* Which textures are applied to each surface of each custom block, along with any modifiers to how those textures are used (e.g. tinting due to biome-specific shading, rotations, layering, etc).
+* In the event that the mod provides custom biomes, additional attributes needed to determine how biome-sensitive textures are rendered can be provided
 
 When texture packs are being used to color the blocks found in the map, it is necessary to describe the mapping of graphical data from the resources within the texture pack to the corresponding surfaces or faces of the blocks.  This mapping is done by the _texture mappings_ found in the _texture.txt_ internal resource file (this file can be found in the source code at https://github.com/webbukkit/DynmapCore/blob/master/src/main/resources/texture.txt).  Additional or custom texture mappings can be defined in the _custom-texture.txt_ file, which can be found in the _renderdata_ directory.  By default the _renderdata_ directory does not exist, and must be created under the _plugins/dynmap_ directory.  The format of both files is the same.