World Generation

Generating terrain is an essential feature of any voxel game. WillowVox Engine provides a few world generation classes to help you get started.

WorldGen is the base world generation class which every other world generation class must derive from. This page will cover the base WorldGen class, but I would highly recommend checking out the other world generation classes.

Include

To include WorldGen, use #include <WillowVox/world/WorldGen.h>

Functions

There is one constructor and two other functions for the base WorldGen class. These can be overridden to customize world generation.

Constructor

WorldGen(int seed)

Arguments:

int seed: The seed to use for generation.

GenerateChunkData

virtual void GenerateChunkData(ChunkData& chunkData)

This function is responsible for setting all the blocks in the chunk data passed to it. By default, it loops through all the blocks and calls GetBlock with the world position of each block. This shouldn’t need to be overridden unless you need highly specialized generation.

Arguments:

ChunkData& chunkData: A reference to the chunk data being generated.

GetBlock

virtual uint16_t GetBlock(int x, int y, int z)

This function decides what block to pick for the world position passed to it. By default, it simply returns 0 (air).

Arguments:

int x: The world x position of the block being generated.

int y: The world y position of the block being generated.

int z: The world z position of the block being generated.

Returns: uint16_t: The block ID of the block decided on by this function.

Public Variables

m_seed

The seed used for world generation.

Derived Classes

• NoiseWorldGen
• TerrainGen

Header File Code

class WILLOWVOX_API WorldGen
{
public:
    WorldGen(int seed) : m_seed(seed) {}

    virtual void GenerateChunkData(ChunkData& chunkData)
    {
        int i = 0;
        for (int x = 0; x < CHUNK_SIZE; x++)
        {
            for (int y = 0; y < CHUNK_SIZE; y++)
            {
                for (int z = 0; z < CHUNK_SIZE; z++)
                {
                    chunkData.m_voxels[i] = GetBlock(x + chunkData.m_offset.x, 
                        y + chunkData.m_offset.y, z + chunkData.m_offset.z);
                    i++;
                }
            }
        }
    }

    virtual uint16_t GetBlock(int x, int y, int z)
    {
        return 0;
    }

    int m_seed;
};