Add docs for biomes.yml

docs/source/biomes.rst

@@ -0,0 +1,38 @@
+=============
+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.

docs/source/configuration.rst

@@ -10,6 +10,8 @@ This page details the various configuration settings exposed by Purpur in the pu
    :depth: 1
    :local:
 
+If you are looking for details on biome specific settings found in biomes.yml click here :doc:`biomes`.
+
 If you want information on settings in paper.yml, spigot.yml, and bukkit.yml you should see
 their respective documentation pages.
 

docs/source/index.rst

@@ -24,4 +24,5 @@ changes to suit our server that are deemed too wild to be included directly upst
 
     configuration
     permissions
+    biomes
     contact