Difference between revisions of "Map generator/settings"

From Minetest Wiki
Jump to navigation Jump to search
(Cleaned the page a bit up and added information for other map generators as well. But the page is still _embarrisingly_ inaccurate. :-()
(Replaced content with "Settings for the map generator can be made in the minetest.conf file. You can choose different generators, enable dungeons, create flat maps and many...")
Tag: Replaced
 
(10 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{incomplete}}
 
 
''Warning: This page is not only incomplete, it is also astonishingly '''inaccurate'''. Take everything which is written on this page with a grain of salt.''
 
 
 
Settings for the [[Map Generator|map generator]] can be made in the [[minetest.conf]] file. You can choose different generators, enable dungeons, create flat maps and many more.
 
Settings for the [[Map Generator|map generator]] can be made in the [[minetest.conf]] file. You can choose different generators, enable dungeons, create flat maps and many more.
  
Example settings can be found in the [https://github.com/minetest/minetest/blob/master/minetest.conf.example#L334 minetest.conf.example] file.
+
A list of all map generator settings can be found in [https://github.com/minetest/minetest/blob/master/minetest.conf.example minetest.conf.example] or in the Advanced settings.
 
 
== Parameter overview ==
 
*<code>mg_name</code>: Type of main map generator
 
*<code>mg_flags</code>: A comma-seperated list of words (see below), each of them modifies the main map.
 
 
 
=== Available map generators ===
 
* <code>v6</code> - based on perlin noise (current default map generator)
 
* <code>v7</code> - based on perlin noise (successor of v6); currently in development
 
* <code>indev</code> - like v6 but with experimental features (e.g. floating islands)
 
* <code>math</code> - collection of geometrical shapes and fractals (not in latest stable version yet)
 
* <code>singlenode</code> - entire map is filled with [[air]]
 
 
 
=== Available flags ===
 
*<code>trees</code> - enables [[Biomes#Forest|forests]]
 
*<code>caves</code> - enables caves
 
*<code>flat</code> - ???
 
*<code>v6_biome_blend</code> - if provided, the transition between two biomes is “smooth” instead of hard.
 
*<code>v6_jungles</code> - enables [[Biomes#Jungle|jungles]]
 
*<code>dungeons</code> - enables [[Biomes#Dungeons|dungeons]]
 
*<code>nolight</code> - ???
 
 
 
== v6 and v7 specific options ==
 
These noise attributes are used for map generation parameters, such as ''mgv6_np_beach'', ''mgv7_np_heat'', and ''mgindev_np_terrain_higher''. Those parameters are used by v6 and v7. An example usage would be ''mgv6_np_apple_trees = 0, 1, (100, 100, 100), 342902, 3, 0.45''. These numbers are used in the order of: Offset, scale, (spread factor), seed offset, number of octaves, persistence.
 
 
 
=== v6 biome options ===
 
*<code>mgv6_np_terrain_base</code>
 
*<code>mgv6_np_terrain_higher</code>
 
*<code>mgv6_np_steepness</code>
 
*<code>mgv6_np_height_select</code>
 
*<code>mgv6_np_mud</code>
 
*<code>mgv6_np_beach</code>
 
*<code>mgv6_np_biome</code>
 
*<code>mgv6_np_cave</code>
 
*<code>mgv6_np_humidity</code>
 
*<code>mgv6_np_trees</code>
 
*<code>mgv6_np_apple_trees</code>
 
 
 
=== v7 biome options ===
 
*<code>mgv7_np_terrain</code>
 
*<code>mgv7_np_bgroup</code>
 
*<code>mgv7_np_heat</code>
 
*<code>mgv7_np_humidity</code>
 
 
 
== v6 specific options ==
 
*<code>mgv6_freq_desert</code>
 
*<code>mgv6_freq_beach</code>
 
 
 
== v6/v7 biome parameter description ==
 
=== Offset and Scale ===
 
Offset and scale should be left alone unless you know what you are doing, these define the average value and amplitude of the noise value output.
 
0, 1 is standard and matches the older Lua perlin functions whose scale and offset are always set to 0 and 1.
 
0, 1 means the noise value has an average value of 0 and varies very roughly between -1 and 1, although depending on octaves and persistence the output can occasionally be as large as -2 to 2.
 
 
 
=== Spread factor ===
 
Written as (x,y,z) e.g. (250,250,250). Those numbers are in nodes (or meters) and very roughly define the maximum scale of that perlin structure. So the spread factor of the biome perlin noise is very roughly the maximum size in nodes of the biomes. To make biomes twice as big try (500, 500, 500). These three numbers enable setting the maximum structure scale independently for x y and z. So you could create biomes stretched in the z direction by using (250, 250, 500).
 
 
 
=== Seed and Seeddiff ===
 
A perlin function needs a 'seed', this is just any old random whole number that acts as a seed to 'grow' a particular noise pattern, same seed same noise pattern.
 
 
 
Seeddiff = seed difference. Perlin functions that use 'seeddiff' instead of 'seed' are 'world dependant'. The value used as a seed is worldseed + seeddiff. Seeddiff creates perlin functions with different patterns but they also remain world dependant, meaning in different worlds you get different patterns but also in the same world you get the same pattern.
 
 
 
=== Number of octaves ===
 
More octaves means more details and more calculation.
 
 
 
=== Persistence ===
 
Persistence defines how strong the details are visible, it does not add more of them. A low persistence will cause the terrain to be smooth, a high (max. 1) causes strong ups and downs.
 
 
 
== math specific options ==
 
*<code>mg_mathgenerator</code> - select the type of map to be generated
 
Available types are:
 
*<code>sphere</code>: A sphere of radius 100.
 
*<code>mandelbox</code>: A mandelbox.
 
*<code>mengersponge</code>: A huge Menger sponge.
 
 
 
== indev specific options ==
 
*<code>mgindev_np_terrain_base</code>
 
*<code>mgindev_np_terrain_higher</code>
 
*<code>mgindev_np_steepness</code>
 
*<code>mgindev_np_mud</code>
 
*<code>mgindev_np_float_islands1</code>
 
*<code>mgindev_np_float_islands2</code>
 
*<code>mgindev_np_float_islands3</code>
 
*<code>mgindev_np_biome</code>
 
*<code>mgindev_float_islands</code> - Configure floating islands. A non-zero integer sets the minimum height of floating islands. A value of <code>0</code> disables the floating islands completely.
 

Latest revision as of 14:48, 22 January 2023

Settings for the map generator can be made in the minetest.conf file. You can choose different generators, enable dungeons, create flat maps and many more.

A list of all map generator settings can be found in minetest.conf.example or in the Advanced settings.