Bukkit

Configuration

Variables

These are all of the variables in this plugin's config.yml file:

Regions

A region is a collection of biomes that all have the same behaviour when it comes to growing plants. By grouping biomes together into regions, we are able to re-use information in multiple biomes. For instance, you could group the desert, desert hills and desert mountains biomes into a single region which has the same plant growth throughout.

Regions are defined in the configuration file in a numbered list, starting with the index 0. Each region added to the list should be indexed by the next largest integer. If a region is not labelled in this way, it's definition will not be loaded by the plugin.

Biomes

Each region must have a list of biomes that is included in that region. All of the biomes listed will have the region's plants grow in it. This is a list of all of the valid biomes and their keywords:

Plants

Each region needs to have a list of plants that grow in the region defined. The list should be in square brackets, use the correct keywords for each plant and be comma separated. A list of all the currently implemented plants and their keywords can be found here:

	Plant	Keyword	Growing Conditions
	Tall grass	"grass"	On top of a grass block
	Fern	"fern"	On top of a grass block
	Dead bush	"dead_bush"	On top of a sand block
	Cactus	"cactus"	Oh top of a sand block with air around it
	Sugar cane	"sugar_cane"	On top of sand or dirt block with a water source next to it
	Dandelion	"dandelion"	On top of a grass block
	Poppy	"poppy"	On top of a grass block
	Blue Orchid	"blue_orchid"	On top of a grass block
	Allium	"allium"	On top of a grass block
	Azure Bluet	"azure_bluet"	On top of a grass block
	Red Tulip	"red_tulip"	On top of a grass block
	Orange Tulip	"orange_tulip"	On top of a grass block
	White Tulip	"white_tulip"	On top of a grass block
	Pink Tulip	"pink_tulip"	On top of a grass block
	Oxeye Daisy	"oxeye_daisy"	On top of a grass block

There are some plant keywords that have a more complicated behaviour:

• "tulip": will grow either a red, orange, white or pink tulip with equal probability

Probabilities

Each region needs to have a list of probabilities that is equal in length to it's list of plants. The probability at each index corresponds to the plant at the same index for the region. The sum of all the probabilities must equal one, or the plugin will throw an exception and fail to load.

Example

This is an example of a valid configuration file:

delay: 1
period: 1
chunks: 1
regions:
  0:
    biomes: [plains]
    weight: 1.0
    plants: [grass, fern]
    probabilities: [0.75, 0.25]
  1:
    biomes: [desert]
    weight: 0.5
    plants: [dead_bush, cactus]
    probabilities: [0.5, 0.5]

With this configuration file, the plugin has the following behaviour:

• The plugin will activate after begin loaded for 1 server tick.
• The plugin will activate after every 1 server tick thereafter.
• The plugin will attempt to grow a plant in 1 chunk every server tick. It may not always succeed.
• The plugin will only grow plants in plains and desert biomes.
• Plants will grow twice as fast in the plains biome than the deset biome.
• In the plains biome, 75% of the time tall grass will grow and 25% of the time a fern will grow.
• In the desert biome, 50% of the time a dead bush will grow and 50% of the time a cactus will grow.