Editing 40d:Advanced world generation

[[World generation]] allows advanced options for customizing worlds. These [[World tokens|parameters]] are not all well understood, so please contribute here as you experiment. [http://www.bay12games.com/forum/index.php?topic=20512.0 This forum post] has additional information on the parameters.


= Advanced Parameters =

To access advanced parameters, press 'e' when at the screen for creating new worlds with parameters screen. This will bring you to an editable list of various guidelines the world-gen process will use when creating your new world.

Parameter sets are stored in ''world_gen.txt'' in the ''\data\init'' folder, using [[world tokens]]. You can copy and paste other player's sets of parameters into your ''world_gen.txt'' to use their parameter sets, and some are provided at [[Pregenerated worlds]]. Another place to find parameter sets is the [http://www.bay12games.com/forum/index.php?topic=20638.0 Worldgen cookbook] thread on the official forums.

== Seed Parameters ==

==== Use Seed ====
This determines the seed number that will be used by the random-number generator in determining the randomness factors that go into creating your world. 

==== Use History Seed ====
Same as above but instead of determining terrain and world structure it handles historical figures and event outcomes. Some experimenting will need to be done to see if the same seed and a different World seed produce different events and figures. 

==== Use Name Seed ====
Same as above but used to determine the randomly selected name used by the program. 

== Terrain Parameters ==

==== &lt;REGION-QUALITY> &lt;X/Y>-Variaton ====

The variation parameters control how much or how little elevation, rainfall, temperature, drainage, volcanism, and savagery change over distance along the world's X-axis (west-east) and Y-axis (north-south).  High values will cause the things to change quickly over short distances, while small values means that it will take some distance for these to change.  Setting all of these to their maximum value (1600) will make it more likely that lots of different [[biome]]s will fit into a single fortress [[location|site]]. ('''NOTE''': Increasing variance increases the number of subregions generated, so you'll likely need to increase the ''Maximum Number of Subregions'' parameter to prevent too many (or all) worlds from being [[World generation#Rejects|rejected]], or reduce the world size if the maximum of 5,000 subregions is reached).

Setting an X variance to 0 will cause the elevation/rainfall/etc to be exactly the same for any world-spanning west-east strip of the world.  Setting a Y variance to 0 will do the same, but for north-south strips.  If you set both the X and Y variance for something (say elevation) to 0, then a single elevation will be randomly picked and applied to the entire world, resulting in one vast plain or ocean.

==== &lt;REGION-QUALITY> Weighted Ranges ====

Elevation, rainfall, temperature, drainage, volcanism, and savagery can vary from 0 to 100 (with a later noted exception for elevation).  The weighted ranges parameters let you decide how common or rare different range of these value will be, with the five available ranges being 0-20, 20-40, 40-60, 60-80, and 80-100.  For example, with the weighted temperature ranges, you could choose for 50% 0-20 and 50% 80-100, to have a world made up entirely of freezing [[tundra]]/[[glacier]]s and burning [[desert]]s, or you could set it to 100% 40-60, to have the entire world be temperate.

The value used for each range is not a percentage, but a relative weight: you add up all the values for a particular quality and then divide that sum into each individual value to get a percentage.  Some examples (with "0" meaning "None"):

{| border = 1
|- bgcolor=lightgrey
! Weights !! Percentages
|-
| 1, 1, 1, 1, 1 || 20%, 20%, 20%, 20%, 20%
|-
| 2, 1, 1, 1, 1 || 33%, 16%, 16%, 16%, 16%
|-
| 1, 0, 0, 0, 1 || 50%,  0%,  0%,  0%,  50%
|-
| 0, 0, 1, 0, 0 || 0%, 0%, 100%, 0%, 0%
|}

'''Note on elevation''': The values the game uses for elevation don't actually stop at 100, but rather 400.  For the Elevation Weighted Ranges parameters, 100 means "100% of the maximum possible elevation", 40 mean "40% of the maximum possible elevation", and so on.

==== Minimum Savagery/Maximum Savagery ====
Defines the minimum and maximum savagery per tile.
* 0 -  32: Benign
*33 -  65: Neutral 
*66 - 100: Savage

Humans and Dwarves will not settle in savage areas.

Note that this setting is closely tied to the savagery squares settings.  If you increase this number beyond 25 or so but do not increase the minimum number of mid- and high-savagery squares for your map you will have endless world rejects.  The opposite is also true.  If you specify a large number of high-savagery squares and no low-savagery squares and then set the above Minimum Savagery/Maximum Savagery percentage to 0, you will also have endless map rejects.

==== Minimum Volcanism/Maximum Volcanism ====

From what I have found out so far I can say [[igneous extrusive layer]] are only found in areas with a volcanism higher than 90. [[Volcanoes]] are only placed on tiles with a volcanism of 100.

==== Minimum Volcano Number ====

Places [[volcanoes]] on tiles with a volcanism of 100.  If there are not enough viable tiles the world is rejected.

==== Minimum Mountain Peak Number ====

Places [[mountain]] peaks on tiles with an pre-erosion elevation of at least 380.  If there are not enough viable tiles the world is rejected.

I'm not exactly sure what effect the peaks have but I suppose they withstand erosion better.

==== Minimum Initial &lt;TERRAIN TYPE> Square Count ====

Sets the absolute minimum number of &lt;TERRAIN TYPE> tiles on the map, pre-erosion.  If the number is too few for any one of these, the map will be [[World generation#Rejects|rejected]] and things will start over.  This is a fairly powerful tool and is very closely related to the mesh sizes and weights if you use them.  Remember that as you change the meshes, you also have to change these since your ratios will be very different!

==== Minimum Initial &lt;TERRAIN TYPE> Region Count ====

Sets the absolute minimum number of &lt;TERRAIN TYPE> regions on the map at the start, pre-erosion.  If the number is too few for any one of these, the map will be [[World generation#Rejects|rejected]] and things will start over.  Regions are the contiguous clusters of one terrain type.  If you set this to be large, then aside from generating tons and tons of rejects, you'll get a map that's got a very broken appearance.

==== Minimum Final &lt;TERRAIN TYPE> Region Count ====

Sets the absolute minimum number of &lt;TERRAIN TYPE> tiles on the map, post-erosion.  If the number is too few for any one of these, the map will be [[World generation#Rejects|rejected]] and things will start over.  The difference between this and the above trait is dependent on what terrain type it is.  Mountains get eaten and fractured by rivers and erosion.  So, you should probably expect to GAIN mountain regions after erosion.  Marshes tend to grow as rivers and lakes cut away at other terrains, so they become more contiguous and reach around other barriers.  You should expect to LOSE marsh regions after erosion.

==== Erosion Cycle Count ====

Higher numbers make the [[mountain]]s less steep and [[river]] canyons deeper.

==== Minimum Number of &lt;REGION-QUALITY> Squares ====

A world will be [[World generation#Rejects|rejected]] if there are less than the number of required squares for each different region type.  This can lead to a ''huge'' number of rejections, so you might want to turn these all down to zero.

== Historical Parameters ==

==== End Year ====

Used to determine when the program will cease its generation and allow for play. As of right now other factors prevent the generator from getting to this date and is often cut off long before reaching it.  If you want to play a game while two particular civilizations are at war, you can create a world, look through its history, then regenerate the world with the exact same seed and history seed, but set the End Year parameter to the year the war started.

==== Population Cap after Civ Creation ====

How many creatures can exist in the game once civilizations have been added into generation.

==== Percentage Beasts Dead for Stoppage ====

Determines how many [[megabeast]]s need to be dead before the world gen stops creating history. Is one likely cause for why the generator rarely reaches the entered End Date.

==== Year to Begin Checking Megabeast Percentage ====

Determines when the game begins checking for the above precentage to see when the game should stop generating the world. 

==== Cull Unimportant Historical Figures ====

Instead of listing every event that happens, this option removes those events without related importance to the wider world, effectively reducing the number of events reviewable in the legends screen. 

==== Reveal All Historical Events ====

Determines whether all events are open to review in the legends screen when you choose to begin a game. Setting this to no would require the usual exploration, talking, and engraving searching as before. 

== Creature Parameters ==

==== Maximum Natural Cave Size ====

Determines the size and depth of caves formed by world-gen. A cave with a greater "size" will be deeper and more sprawling, and therefore have more and more dangerous creatures.  It is believed that large caves increases the lifespan of [[megabeast]]s.

==== Number of Mountain Caves ====

Determines the number of caves to be placed in mountain regions. It is believed that large number of caves increases the lifespan of [[megabeast]]s.

==== Number of Non-Mountain Caves ====

Determines the number of caves to be placed in other regions. It is believed that large numbers of caves increases the lifespan of [[megabeast]]s.

==== Make Caves Visible ====

Makes caves visible on the world location selection screen.

==== Number of Civilizations ====

Determines how many civilizations will be seeded into the generated world. Five is the typical number to produce the usual Dwarves, Humans, Elves, Goblins, and Kobolds. 

* Error Code: Not enough entity placement locations: Decrease the Number of Civilizations, edit the settings so proper biomes are generated or generate bigger map.

==== Playable Civilization Required ====

If set, all worlds where the no playable civilization has been placed at the beginning of history are rejected.

* Error Code: No controllable entity definitions available: Add some high (mountain) elevations to the map. Dwarf civ's will only appear on these tiles.

= Influencing Non-parameterized Features =

== Reducing [[Aquifers]] ==

It is believed that there will be many less aquifers if you make sure that there are no oceans (set ''Elevation Weighted Ranges'' 0-20 and 20-40 to 0/None to ensure that the minimum elevation is above 100, and set ''Minimum Ocean Edges'' to 0/None).  High drainage will also reduce aquifers, but with the side effect of reducing [[lake]]s and [[swamp]]s.  Also, widespread high draining might lead to too many worlds being [[World generation#Rejects|rejected]].

Or you could just [[modding|mod]] the <tt>[[raw file|raw/objects/matgloss_stone_layer.txt]]</tt> file and remove all of the [[Matgloss tokens|[AQUIFER]]] tokens.

= Experimenting with Parameters =

To experiment with the parameters and to effectively see why rejections are coming back because of changes to the parameters, first you need to edit your init.txt and set
[LOG_MAP_REJECTS:NO] to YES. This will create a text document that will describe why each copy of the generated world is rejected. 

By going back and forth between this document and the parameters, you can begin to get an idea as to why endless cycles of rejected worlds come up. As you experiment please share your findings under each heading.

You can also directly edit the world_gen.txt file in \data\init to get around limits in the Advanced world generator.  For example, you are limited to having 5000 max subregions, but if you go into the aforementioned file, you can go over this limit.  This is especially useful when you encounter map rejects that say, for example, too many subregions.

== World Painter Parameters ==

{|{{prettytable}}
|-style="background:#dddddd"
!Icon !!Biome !!Elevation !!Rainfall !!Drainage
|-
|{{Biome|~|≈|#0000FF|#0000FF}}
|[[Ocean|Water]] ||0-99 ||Any ||Any
|-
|{{Biome|~|≈|#FFFF00|#FFFF00}}
|[[Sand]] [[Desert]] ||rowspan="13"|100-299 ||rowspan="4"|0-9 ||0-32
|-
|{{Biome|,|´|#808000|#808080}}
|Rock [[Desert]] ||33-49
|-
|{{Biome|n|∩|#808080|#808000}}
|[[Desert]] [[Badlands]] A ||50-65
|-
|{{Biome|V|√|#808000|#808000}}
|[[Desert]] [[Badlands]] B ||66-100
|-
|{{Biome|.|ⁿ|#00FF00|#00FF00}}
|[[Grassland]] ||rowspan="2"|10-19 ||0-49
|-
|{{Biome|n|∩|#00FF00|#00FF00}}
|[[Hills]] ||50-100
|-
|{{Biome|"|ⁿ|#00FF00|#00FF00}}
|[[Savanna]] ||rowspan="2"|20-32 ||0-49
|-
|{{Biome|n|∩|#00FF00|#00FF00}}
|[[Hills]] ||50-100
|-
|{{Biome|"|"|#008000|#008000}}
|[[Marsh]] ||rowspan="3"|33-65 ||0-32
|-
|{{Biome|"|γ|#00FF00|#00FF00}}
|[[Shrubland]] ||33-49 
|-
|{{Biome|n|∩|#00FF00|#00FF00}}
|[[Hills]] ||50-100
|-
|{{Biome|⌠|⌠|#008000|#008000}}
|[[Swamp]] ||rowspan="2"|66-100 ||0-32
|-
|{{Biome|↑|↨|#00FF00|#00FF00}}
|[[Forest]] * ||33-100
|-
|{{Biome|⌂|⌂|#808080|#808080}}
|Low [[Mountain]] ||300-332 ||Any ||Any
|-
|{{Biome|▲|▲|#808080|#808080}}
|[[Mountain]] ||333-365 ||Any ||Any
|-
|{{Biome|▲|▲|#C0C0C0|#C0C0C0}}
|High [[Mountain]] ||366-399 ||Any ||Any
|-
|{{Raw Tile|^|#808080|#000000}}
|[[Peak]] ||400{{verify}} ||Any ||Any
|}


<nowiki>*</nowiki> The forest regions can be changed between conifer, to broadleaf types by varying the temperature (to around > 65, depending on rain value).

The magma value (at 100%) can produce volcanoes if painted on the same tile as a mountain.

[[Category:World]]
[[Category:Guides]]