minetest-mm/mods/biome_lib
root a8d9bba4b3 update 2021-05-16 11:33:49 +02:00
..
locale update 2020-10-25 20:54:52 +01:00
API.txt update 2021-05-16 11:33:49 +02:00
LICENSE update 2020-10-25 20:54:52 +01:00
README.md update 2021-05-16 11:33:49 +02:00
api.lua update 2021-05-16 11:33:49 +02:00
block_queue_checks.lua update 2021-05-16 11:33:49 +02:00
compat.lua update 2021-05-16 11:33:49 +02:00
description.txt update 2020-10-25 20:54:52 +01:00
growth.lua update 2021-05-16 11:33:49 +02:00
init.lua update 2021-05-16 11:33:49 +02:00
mod.conf update 2021-04-05 14:46:21 +02:00
search_functions.lua update 2021-05-16 11:33:49 +02:00
settingtypes.txt update 2021-05-16 11:33:49 +02:00

README.md

Biome Lib

This library's purpose is to allow other mods to add growing things to the map in a straightforward, simple manner. It contains all the core functions needed by mods and modpacks such as More Trees, Tiny Trees, Plantlife, and others.

Spawning of plants is optionally sensitive to the amount of available light, elevation, nearness to other nodes, plant-to-plant density, water depth, and a whole host of controls.

All objects spawned or generated using this mod use Perlin noise to stay within simple biomes, rather than just letting everything just spread around the map randomly.

This library also features a basic temperature map, which should blend in nicely with SPlizard's Snow Biomes mod (the same Perlin settings are used, with the assumption that the edge of a snow biome is 0° Centigrade).

Both mapgen-based spawning and ABM-based spawning is supported. Growing code is strictly ABM-based. L-system trees can be spawned at mapgen time via the engine's spawn_tree() function and are quite fast.

It is primarily intended for mapgen v6, but it should work fine when used with mapgen v7.

Dependencies: nothing, but if you don't use minetest_game, you'll need to supply some settings (see API.txt).

Recommends: Plantlife Modpack, More Trees

API: This mod supplies a small number of very powerful functions. They are, briefly:

  • biome_lib:register_generate_plant()
  • biome_lib:spawn_on_surfaces()
  • biome_lib:grow_plants()
  • biome_lib:find_valid_wall()
  • biome_lib:is_node_loaded()

For a complete description of these functions as well as several of the internal variables within the mod, see API.txt.

Configuration: This mod has several variables you can set in your minetest.conf to change things a bit, from the default nodes it uses, to the debug log level and the block queue behavior. For a list with complete descriptions, see settingtypes.txt.