initial commit

README

@@ -0,0 +1,84 @@
+README file for Plantlife mod, by Vanessa Ezekowitz
+---------------------------------------------------
+
+Plantlife is a combined form of my Flowers, Jungle Grass, and Poison Ivy mods 
+and has been significantly rewritten and re-organized.  This mod supplies all 
+three of these components and should be 100% compatible with mods that used the 
+old versions.
+
+Its purpose is to add various kinds of flowers, cotton plants, water foliage, 
+poison ivy, and jungle grass in a few sizes.  All of these are spawned as 
+normal nodes and can be collected and used in any recipes that depend on the 
+old mods.
+
+Spawning of plandts is sensitive to the amount of available light.  Flowers, 
+cotton, and waterlilies only spawn when there at least a signficant amount of 
+light.  Seaweed will grow only in dimly-lit areas.  Jungle grass and poison ivy 
+also grow in the daytime, but require less light than flowers.
+
+------------------------------------------------------------------------------
+
+Important details:
+
+Configuration: Any of the three components of this mod can be disabled by 
+editing plants/init.lua, near the beginning of the file, and changing one or 
+more of these lines to false:
+
+local enable_flowers = true
+local enable_junglegrass = true
+local enable_poisonivy = true
+
+Dependencies: Just the game's default stuff.
+
+Recommends: Nothing in particular.
+
+Conflicts: This mod should not be installed alongside the original Flowers, 
+Jungle Grass, or Poison Ivy mods.  If those exist, delete them, as this mod 
+supplies all of their functionality.
+
+Software Requirements: This mod was written for Minetest 0.4.4 or later, but it 
+should work on pretty much any old or recent 0.4.x version.  It will not work 
+with 0.3.x since that version does not support modding.
+
+------------------------------------------------------------------------------
+
+Crafting:
+
+Only Flowers have crafting recipes.  For a flower pot, put three
+clay bricks in the crafting grid in a "v" shape like so (yields 1):
+
+	- - -
+	B - B
+	- B -
+
+To put a flower into a pot, just put one of each into the crafting grid.
+
+------------------------------------------------------------------------------
+
+Notes:
+
+Flowers has been completely rewritten, almost from scratch, using the most 
+recent and advanced features the game engine has to offer.  It should be 
+significantly faster than the original Ironzorg Flowers mod.  Flowers and 
+cotton spawn on grass only, seaweed spawns on water or grass close to the 
+shoreline, or on very small stone islands in water.  Waterlilies of course 
+spawn on water.
+
+There are four different sizes of jungle grasses, all of which yield a single 
+junglegrass object when gathered (so all four sizes may be used where jungle 
+grass is called for).  The largest size uses the game's standard jungle grass 
+node, while the others are defined by this mod.
+
+Junglegrass will spawn on grass, sand, desert sand and the tops of papyrus and 
+cactus (though rarely), and will do so anywhere in the map.  Grass on the 
+ground will grow and eventually disappear (die), while grass in the desert will 
+grow and eventually turn into dry shrubs.
+
+Poison Ivy will spawn on grass and in some cases, on vertical surfaces 
+including trees and jungle trees where they meet the dirt or grass.  Ivy 
+previously spawned on the ground taller/thicker or start climbing up said 
+vertical surfaces and trees.
+
+At present, the poison ivy presents little more than an annoyance - they can 
+only be cut down and either re-planted or thrown away.  No damage is done by 
+harvesting them, yet. ;-)