Terrain Generation

The terrain generation system is extremely complex and intricate.

"Terrain Generation" is the term for all the parts of the world that are created by the game that are blocks. This includes, but is not limited to, soil, mountains, lakes, trees, and ruins.

Stages of terrain generation

The following steps are an overview, the next section will have a much more in depth explanation of these stages.

1. generate noise maps for various properties.
2. landforms, these are chosen based on a landform noise map.
3. rock strata, this is the stage where the type of rock in a region is chosen partly based on a geologic province noise map.
4. caves, chunks are populated with caves.
5. block layers, layers placed on top of the current ground, e.g. soil, snow, and grass.
6. deposits, ores and other things in the stone are placed.
7. structures, this adds ruins, trader carts, treasure chests, and more.
8. ponds, bodies of water.
9. vegetation and patches, plants that are randomly found in groups, cattails, horsetail, and flowers. It also adds trees.
10. finalize, this finishes the process, processing light in a chunk, spawning animals, and adding snow.

Technical

Each stage is defined in the Survival base mod.

Noise maps

VS utilizes three methods for generating noise: weighted octave, Perlin, and normalized simplex noise. Each one behaves differently. In total, seven [1] noise maps are created at this stage.

• Climate
• Flower
• Bush
• Forest
• Beach
• Geologic province
• Landform

These maps are utilized by later stages to provide randomness to terrain.

Landforms

These are the shapes the land takes. There are many different landforms that can generate and some utilize more than one noise map, mostly the climate map. Each landform's properties are defined in the game assets. There are several optional properties, but all landforms must specify:

• Octaves
• Octave thresholds
• Terrain Y key positions
• Terrain Y key thresholds

Octaves defines how rough or smooth terrain is.

Rock strata

Rocks are generated in layers and those layers are grouped by their type: sedimentary, metamorphic and igneous.

Sedimentary group doesn't have to be generated. If it does, sedimentary stones lie above all metamorphic and igneous stones.

Metamorphic group doesn't have to be generated. If it does, metamorphic stones rest below all sedimentary layers and above all igneous layers.

Igneous group will always be generated. Igneous stones always start at the mantle, at the bottom of the map, and stretch upwards until it reaches metamorphic or sedimentary layers, or the surface.

Certain kinds of rocks have special spawning rules.

• Basalt, despite being an igneous stone, can be generated above any layer, including sedimentary and metamorphic stones.
• Halite spawns in underground domes of substantial size.
• Marble spawns in veins in phyllite and slate.
• Obsidian spawns in veins in basalt.
• Suevite is found only in craters, surrounding meteoric iron veins.

Caves

Caves

Block layers

In this stage, layers of blocks such as snow and grass are generated.

Deposits

Deposits are handled in GenDeposits.cs in the Survival Mod. The code for deposits handles more than just ores in rocks. There are many steps in the process of generating ores.

1. All assets in worldgen/deposits/ are loaded and parsed.
   1. The generator goes over all deposits and adds them to a list.
   2. If there are any child deposits, they are registered.
2. A deposit shape distortion map is created. This is used when initializing deposits.
3. The generator goes over all registered deposits.
   1. Each deposit variant is initialized with a random seed and the deposit shape distortion map. This init process is the same for all deposits and is used only to simplify the code.
   2. If the deposit variant uses an ore map, one is created for it. Each kind of deposit gets its own ore map.
   3. If there are any child deposits that also use an ore map, one is created for the child deposit.

This is the end of what is done in GenDeposits. When a new world region is generated, GenDeposits calls .OnMapRegionGen on each deposit variant.

1. Region generation begins by updating the vertical distortion ore maps for the region.
2. Each deposit variant then generates ore in the region.

GenDeposits.OnMapRegionGen is relatively simple because most of the generation work is given to each variant. What actually happens when a variant generates a region is dependent on which ore generator is used, of which there are several.

Structures

In this stage, trader carts, ruins (underground as well as above ground), and vugs (crystal-bearing rock cavities) are generated.

Vegetation and patches

In this stage, wild crops are generated.