Map generator

The map generator is the Minetest component that generates the map. This page concentrates on terrain generation. For the biomes (block surface, vegetation and such), head over to Biomes.

Overview

This complex program, integrated into the game, can generate procedurally the map, which is the world the player evolves in. It is based on Perlin noises, functions which allow associating to each point a random yet consistent value.

Generators

Introduction

There is a number of different map generators. It is possible to choose between them when creating a map. Some mods may change them radically, also all map generators allow for a lot of configuration in the advanced settings menu.

All map generators have biomes. In all map generators except v6 these biomes can be defined by mods using the Biome API. The v6 map generator is special because its biomes are completely predefined and can't be changed trivially.

Important: v5 and v6 are not legacy map generators. “v5”, “v6” and “v7” are names, not version numbers. All mapgens included in Minetest are officially supported and updated.

Overview

• v5: Unrealistic yet interesting landscape with frequent floating blobs and extreme terrain overhangs, and deep oceans. The weirdness has an appeal to some
• v6: Simple hills, cliffs and plateaus, rather flat and small-scale mapgen. No terrain overhangs. All biomes are predefined and linked to the terrain
• v7: Very widespread landscape, tall mountains with overhanging terrain and far plains. Frequent large water canals at sea level
• carpathian: Complex and realistic mountains with multiple variants, sometimes reaching extreme heights separated are low and very flat plains
• valleys: Many hills, mountains and valleys containing river water flowing downhill
• flat: (Almost) a perfectly flat world
• fractal: Map is based on a fractal of your choice; highly configurable
• singlenode: Empty world

Detailed information

v5

Notable for its unique and somewhat strange terrain shape and occasional floating islands which often look like blobs. Extreme overhanging terrain is not uncommon and the landscape is sometimes realistic, sometimes strange and challenging. The oceans can sometimes reach extreme depths as well. While the landscape is not exactly realistic, this mapgen is intentionally included in Minetest because its uniqueness and weirdness also has a special appeal to some.

The biomes have to defined by mods first, otherwise it will be a stone-only landscape. The same is true for all other mapgens except v6.

Landscapes are based on 3D Perlin noise.

v6

Notable for rather flat and simple hills and cliffs. The landscape is rather simple, the hills are not very high and there are no natural terrain overhangs (ignoring caves). The weirdness of v5 is eliminated.

This is the only map generator with predefined biomes: Grasslands/forest, jungle, desert, taiga, tundra and gravel. The biomes can't be modified by mods. Because of the nature of v6, the biomes are much simpler than in the other map generators, and a couple of blocks found in the other map generators can't be found in v6 maps (for example: Silver Sand, Acacia Tree, Orange Coral).

Generated entirely using 2D Perlin noise.

v7

Generates a very large-scale environment with large biomes, plains and biomes. One of the most unique features in this map generator are the broad and deep water canals (called “ridges”) at sea level, but they can be disabled. Like in v5, the biome have to be defined by mods first. This mapgen also has the unique feature of supporting floating islands high in the sky (→Map generator features), but they are disabled by default.

Uses 2D and 3D Perlin noise. It is the default selection since Minetest 0.4.15.

carpathian

This mapgen is not yet in Minetest 0.4.16, but will be in a future release. Vast and relatively flat plains, rolling hills and complex, realistic mountain ranges dominate the landscape. Mountains come in several forms. In mountain ranges, ridges and terraced mountains can form. Rarely there are extremely big mountains and rarely there are fjords.

valleys

Generates a landscape featuring many hills, mountains and valleys. The valleys often contain rivers with River Water. The rivers are very different than in v7, since they are not at ocean level and actually flow downhill. Another unique feature of this mapgen is

flat

Generates a perfectly flat world (ignoring structures and caves) with biomes. It can be configured to add occasional hills and lakes.

fractal

Generates a map based on a fractal. It creates by far the weirdest terrain shapes, but its results are mostly predictable.

By default, a map based on the Mandelbrot set is generated. It is possible to choose one of many fractals which are based on the Mandelbrot and Julia set, which is chosen in the advanced settings menu (technical setting name “mgfractal_fractal”). Changing this setting will yield wildly different results; if you want to make most of this mapgen, make sure to play around with the advanced settings a bit.

singlenode

Generates an empty world.

To be precise: By default, this produces a world with only air everywhere. For subgames it is possible to replace the air with a different block.

It is useful for mapgen mods which define their own map generation: first, air is generated, then the mod applies its own functions which generates the terrain.

Gallery

Here are examples of landscapes generated with the different map generators (using Minetest Game):

• 

  v5

• 

  v6

• 

  v7

• 

  carpathian

• 

  valleys

• 

  flat

• 

  fractal

• 

  singlenode

See also

• Map generator features
• Biomes
• Map Generator Evolution