summaryrefslogtreecommitdiff
path: root/readme.md
diff options
context:
space:
mode:
Diffstat (limited to 'readme.md')
-rw-r--r--readme.md162
1 files changed, 162 insertions, 0 deletions
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..6d62342
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,162 @@
+## Crops - more farming crops mod for minetest
+
+Copyright (C) 2015 - Auke Kok <sofar@foo-projects.org>
+
+This minetest mod expands the basic set of farming-related crops that
+`minetest_game` offers. A list of crops/crafts is below.
+
+## Configuration
+
+A default configuration file, `crops_settings.txt` will be added
+to your world folder that contains suggested `easy`, `normal` (the
+default) and `difficult` settings for this mod. You can currently tune
+the ABM interval/chance, and required light level for plant growth.
+
+## Hydration mechanic
+
+This feature is disabled in the `easy` setting.
+
+Plants need water. Plants need more water when they grow. This mod
+implements mechanics of plant hydration and what happens when you
+over-water or not water your plants properly: Plants may wither or
+soak, and if they wither/soak too much, the plant will get damaged.
+
+You can see that plants are under stress visually. When a plant
+withers, there will be particles that are steam/smoke-like floating
+upwards from the plant. When a plant is over-watered, water bubbles
+can be seen at the plant base. These are implemented as particles.
+
+In the default difficulty settings, plants don't accrue enough damage
+to kill the plant. But at difficult settings, withering will end up
+resulting in plant death, or the loss of crop entirely. At default
+settings, plants will yield significantly less harvest if not taken
+care of! So if you do decide to not water your plants, make sure you
+don't let them sit around for days and harvest them as soon as they
+are ripe to limit the effects.
+
+Environment factors can influence hydration: nearby water, night time
+moisture. And of course, the watering can. The watering can holds
+20 watering charges, and it takes 3-4 charges to water a plant from
+completely dry to maximum wetness. Some plants will want more water,
+some will do better with less, so make sure you use a hydrometer to
+measure plant humidity. Recipes for the watering can and hydrometer
+are listed below.
+
+## Plants
+
+1. Melons and pumpkins
+
+Melon plants grow from melon seeds. Once a plant is mature (there
+are 5 stages) it will spawn a melon block adjacent to the plant.
+The melon block can be harvested by punching, and yields 3-5
+melon slices. The melon slice can be crafted to a melon seed.
+
+Pumpkins grow from pumpkin seeds, and are harvested to yield a
+pumpkin block. Each block can be cooked to yield one or more
+roast pumpkin chunks, which can be eaten. You can also craft
+the blocks to seeds. A pumpkin plant will only yield limited amounts
+of pumpkins. After a while they automatically wither.
+
+2. Corn.
+
+Corn plants are 2 blocks high, and yield corn cobs. These can be
+cooked to corn-on-the-cob, or processed to make corn seed (corn
+kernels, basically).
+
+Digging a mature plant yields the corn cob. A harvested corn plant
+"wilts", and needs to be dug away to make the land usable, or can
+be left as ornamental 2-block plant. Digging either top or bottom
+block works in all cases.
+
+3. Tomatoes.
+
+Tomatoes appear to work simple enough, until you harvest them
+the first time: The plant stays! However, after the 3rd to 5th
+harvest, the plant wilts and needs to be removed, since no more
+tomatoes will grow on the plant. Per harvest you can get 1-2
+tomatoes only. You can craft the tomatoes to tomato seeds, as
+expected.
+
+4. Potatoes.
+
+The plants themselves don't drop anything. Only if the plant matures
+can you dig potatoes from the soil. If you can reach the soil from the
+side you can save yourself one dig by digging the soil as that will
+remove the plant from the top, but otherwise you need to dig twice:
+once to remove the plant, once to dig out the potatoes.
+
+You get 3-5 potatoes. Each potato gives one (set of) "potato eyes"
+which are the clones that can grow back to potatoes. Be careful not
+to dig the plant when there's flowers! You have to wait until the soil
+below shows potatoes. It's fairly easy to see the difference, though.
+
+5. Green Beans
+
+These green beans are unnaturally green, but there's so many
+of them that grow on a vine! Sadly, these beans don't grow beans
+unsupported, so you stick some sticks together to make a beanpole,
+something like this way:
+
+empty empty empty
+stick empty stick
+stick empty stick
+
+There, that should help the viney bean plant to grow to 2 meters
+high. It has remarkable purple flowers, that pop all over the plant
+just before the beans grow.
+
+Sadly, once the beans are picked, this plant turns into an unusable
+mess that makes it hard for the next plant to grow on the beanpole,
+so you salvage the beanpole's sticks after harvesting in order to
+make more beanpoles again. It's a bit of work, but worth it, these
+beans are delicious!
+
+
+## Cooking / Crafting
+
+The corn cobs can be cooked directly to make Corn-on-the-Cob.
+
+This mod includes a bowl recipe. The bowl is made from clay lumps,
+which results in an unbaked clay bowl that needs to be baked in an
+oven to be usable:
+
+empty empty empty
+clay_lump empty clay_lump
+empty clay_lump empty
+
+Pumpkin blocks can be cooked whole, and yield roasted pumpkin. It's
+okay as food, but it takes a lot of work.
+
+You can fill these bowls (or any group:food_bowl) with vegetables to
+craft an uncooked vegetable stew:
+
+empty empty empty
+grean_beans potato tomato
+empty clay_bowl empty
+
+The uncooked vegetable stew obviously needs to be cooked as well in
+an oven. The resulting Vegetable Stew bowl gives a lot of hears back,
+which is worth the effort.
+
+The watering can can be made as follows:
+
+steel_ingot empty empty
+steel_ingot empty steel_ingot
+empty steel_ingot empty
+
+To fill the watering can, left click any block of water. To use,
+left click a plant. The damage bar on the icon indicates the fill
+level of the watering can.
+
+The hydrometer can be crafted like this:
+
+mese_crystal_fragment empty empty
+empty steel_ingot empty
+empty empty steel_ingot
+
+Left-click any plant with the hydrometer, and the charge bar indicates
+the humidity level of the plant: a dry plant will have 0% humidity
+and be a small red bar or no bar at all, and a soaked plant will
+have a full green bar. Be careful though! Some plants prefer to be
+at mid-level (yellow) instead of full wetness!
+