Files
Purpur/docs/source/biomes.rst
William Blake Galbreath 2344ba2047 Add docs for biomes.yml
2020-02-28 19:08:07 -06:00

39 lines
1.7 KiB
ReStructuredText

=============
Biomes.yml
=============
This page details the biome specific options found in biomes.yml
.. |br| raw:: html
.. contents::
:depth: 1
:local:
Biomes
===============
spawn-data
~~~~~~~~~~
* **description**: Spawn data is a map of key->value pairs for each entity and it's natural spawn settings per biome. The
value consists of 3 integers representing the weight, minimum group, and maximum group.
Weight represents the chance the entity has to spawn. It's not really a percent chance, it's the number of chances this
entity gets in the rng roll. Take the `ocean` biome, for example. If you add up all the weights for all the entities
you get a total of 540. Enderman has a weight of 10 here, so it gets 10/540 chance of winning the rng roll.
There are still other rules to be met before a mob is spawned. Each entity has their own set of rules, which can be
learned by researching the official minecraft wiki or google. But, for example, lets say a water location was chosen
to spawn a mob at random and enderman won the rng roll. The enderman will _not_ spawn because it's in water. This tick
the spawn chance gets skipped and nothing spawns. The rng roll happens every tick until the mob cap has been reached, so
keep all this in mind when creating your weights.
The minimum and maximum group values are exactly as they sound. It is the number of mobs of this type that will spawn
from this attempt.
.. note::
The default biomes.yml file matches perfectly with the vanilla gameplay. If you find something not right, please let me
know on discord.
More biome specific customizations are planned for the future.