Introduction

Note

BiomeGenerationSettings and subsequently all worldgen api from BiomesAPI is not compatible with PacketHandlers, you have to physically set your biomes in the world for them to modify world generation!

BiomesAPI exposes Minecraft’s underlying world generation system. World generation takes place in both biomes and dimensions but is primarily bound to biomes themselves.

When we say worldgen, we are referring to how Minecraft blocks are placed in the world and how the game looks in a particular biome. This includes things like the terrain, vegetation, and structures that are generated in a biome.

Unlike Bukkit’s ChunkGenerator, terrain generation is inherently tied to biomes themselves, although you may reuse the same biome generation logic across multiple biomes.

Puzzle Pieces

A biome’s generation is described by three kinds of components, which BiomesAPI wraps separately:

• Carvers cut caves, canyons, and ravines into already-generated terrain.
• Configured features describe what to generate, such as an ore vein or a tree, by pairing a feature with its configuration.
• Placed features wrap a configured feature with placement rules that decide where and how often it generates.

These come together in biome generation settings, which is attached to a custom biome.