Editing 40d:World generation

:''For information on advanced parameters, see [[Advanced World Generation]].''

To begin playing Dwarf Fortress, you must first '''create a world''' to play in. When you enter the world creation screen, you are presented with a screen full of options:

== World creation options ==

[[Image:Worldgen_advanced.png | none | frame | 500px | Opening world generation screen.]]

Once you choose "Design New World With Parameters" you will be brought to the parameters screen. (Choosing "Create New World Now! instantly creates a new world with the parameters which are listed second in the world_gen.txt file). Pushing {{k|Enter}} will start creating a world using the default (or selected) parameters. At the upper left hand corner, you will notice several settings. Here is a quick overview:

* '''[[#Title|Title]]''' - Where the title of your parameter type will be displayed
* '''[[#Seed|Seed]]''' - A random or predetermined number to be used in the process of world creation.
* '''Dimensions''' - The size of your world
* '''Random Name''' - The name of your world. In this example, the world's name will be generated randomly.

=== Title ===

This is just a name for your world generation template. Once you have multiple templates, you can [[#Parameter selection|select]] the template you wish to use using the arrow keys or the numeric keypad.

* To edit the name of your parameter template, press the {{k|t}} key.

=== Seed ===

Generating [http://www.random.org/ a true random number] is an impossible task for a computer. Typically, a pseudo-random number generator uses a specially selected mathematical sequence to create what appears to be a random number. By feeding the same seed as another player directly into the generator, a player starts world generation at the same point in the sequence, which theoretically should result in an identical world for both players. ''(Click the following link for more information on [http://en.wikipedia.org/wiki/Random_seed random seeds.])''

* To use a random seed, press the {{K|S}} key. To use a specific seed, press the {{k|s}} key.

=== Name ===

This is where the name for your world will be displayed.  You can enter a name or choose to have one randomly generated.

* To change the name of your world press the {{k|n}} key, and type in a name. 
* To have the game select a name for your world press the {{K|N}} key.

=== Parameter selection ===

On the right hand side of the screen will be a list for all of your saved parameter templates. By default, there are five parameter sets labeled '''<tt>LARGE</tt>''', '''<tt>MEDIUM</tt>''','''<tt>SMALL</tt>''','''<tt>SMALLER</tt>''', and '''<tt>POCKET</tt>'''.  Smaller worlds are generated more quickly, but have less civilizations and less chance of generating an [[embarkment]] site with the combination of features you'd like.  You can change the world size to something other than a square using the keys {{k|i}}, {{k|u}}, {{k|p}}, and {{k|o}}.  Note that only available world widths/heights are 17, 33, 65, 129, and 257; even directly editing the <tt>world_gen.txt</tt> file will not let you use other sizes than these.

You can select which parameter set you would like to use for world creation using the arrow keys ( {{K|&uarr;}}  and {{K|&darr;}} ) and the page-up-/page down keys, or the numeric keypad ( {{k|8}} {{k|2}} {{k|9}} {{k|3}} ). 

* To save your current settings as a parameter set, press {{K|F6}}. 
* To reset the parameters to the default settings, press {{K|F1}}. 
* To create a new set of parameters, press {{k|a}}. To delete the current set of parameters, press {{k|d}}. To copy the current set of parameters, press {{k|c}}.

=== Options ===

{| border = 1
|- bgcolor=lightgrey
! Key !! Function !! Description
|-
| <center>{{k|a}}</center> || New parameter set || Create a new parameter set
|-
| <center>{{k|d}}</center> || Delete parameter set || Delete the currently selected parameter set
|-
| <center>{{k|c}}</center> || Copy parameter set || Creates a copy of the currently selected parameter set
|-
| {{K|&uarr;}} {{K|&darr;}} {{K|PgUp}} {{K|PgDown}} ({{k|8}} {{k|2}} {{k|9}} {{k|3}}) || Navigate the parameter sets || {{k|8}} and {{k|2}} &rarr; move up and down 
{{k|9}} and {{k|3}} &rarr; page up and down
|-
| <center>{{k|t}}</center> || Enter title || Edits the name of your parameter set
|-
| <center>{{K|N}}</center> || Use random name || Sets your world to generate a random name upon creation
|-
| <center>{{k|n}}</center> || Enter custom name || Prompts the user to input a name for their world
|-
| <center>{{K|S}}</center> || Use random seed || Uses a random seed to generate a world.
|-
| <center>{{k|s}}</center> || Enter custom seed || Prompts the user to input a custom seed for world creation
|-
| <center>{{K|F1}}</center> || Load world parameters || Resets the world parameters to their default values
|-
| <center>{{K|F6}}</center> || Save world parameters || Saves the world parameters under the current [[#Title | title]]
|-
| <center>{{K|e}}</center> || Enter advanced parameters || Lets you edit advanced options for generating the world
|}

== World generation ==

When you are ready to create your world, push {{k|Enter}}. You may be prompted to save your parameters if you have changed them from the default. The generator then begins to generate a world based on fractal algorithms. The process of creating a world can be very time-consuming, as any invalid maps are thrown out upon detection. Do not be surprised if it generates over a hundred separate worlds before creating one that is acceptable. Generating a world with advanced parameters that are very far from the default can cause many worlds to be generated and rejected for not meeting the requirements.

[[Image:Worldgen advanced progress.png | none | frame | 400px | World creation screenshot.]]

[[Image:Worldgen_advanced_finished.png | none | frame | 400px | World creation screenshot.]]

When the world is created, you will be given the option to export the map to a graphic file by pressing {{k|p}}. This will create a '''large''' BMP format [[CP437|ASCII]] graphic of the created world. You can run the compress_bitmaps.bat batch file that comes included with the game (as of 33g) in the main dwarf fortress folder to convert the bitmap files to about 90% smaller .png files.

[[Image: | none | frame | 400px | Example exported map image.]]

When you are finished, press {{k|Enter}} or {{k|Space}} to return to the title screen.


=== Batch processing ===

==== In Windows ====

You can use this example to use the [[command line]] to create many worlds at once, without all the hassle. Copy the following code and save it as a batch (.BAT) file. This file will create 7 regions using random names and random seeds. It will also automatically output the parameters and an ASCII and detailed map for each of your worlds.

:'''Note:''' ''Make sure you don't already have region 1-7 in your save directory.''

<pre>
for /L %%i in (1,1,7) do start /wait /high dwarfort -gen %%i RANDOM MEDIUM
</pre>

:'''Note:''' ''If you are using a version of Dwarf Fortress that includes a space in the .exe name, use the following command to achieve the same results.

<pre>
for /L %%i in (1,1,7) do start /wait /high "" "dwarf fortress" -gen %%i RANDOM MEDIUM
</pre>

:'''Note:''' ''If you are typing this into a command prompt rather than making a batch file use %i rather %%i''

==== In Linux ====

Copy the following code into a file, and then make sure it can be executed by doing the [http://en.wikipedia.org/wiki/Unix_shell shell] command <tt>chmod +x filename</tt>.  It should be placed in the same directory as <tt>dwarfort.exe</tt>, and also be run in that directory.

:'''Note:''' ''Make sure you don't already have region 1-7 in your save directory.''

<pre>
#!/bin/sh

for i in `seq 1 7`; do
    ./df -gen $i RANDOM MEDIUM
done
</pre>

You can also type (or copy-and-paste) this file into a interactive shell (if you use [http://en.wikipedia.org/wiki/Bash Bash]).  If you type it in by hand, you can leave out the line with <tt>#!</tt> and the following blank line, since they won't do anything.

=== How World Generation Works ===

You may be curious about what's happening behind the scenes while your world is being generated, these are the steps the program goes through:

:'''Note:''' ''Information on this list is largely taken from the [http://www.gamasutra.com/view/feature/3549/interview_the_making_of_dwarf_.php?page=7 10 page interview] of [[Toady]] at Gamasutra''
# '''Preparing Elevation/Setting Temperature:''' Fractal maps are generated, laying out basic information about the world:
#* Four main maps, used to generate biomes:
#** Elevation: A process called Midpoint Displacement is used to plot out the lay of the land.
#** Temperature: The temperature map is biased according to latitude and elevation.
#** Rainfall: Later in the simulation, this map is biased according to factors such as [http://en.wikipedia.org/wiki/Rain_shadow rain shadow].
#** Drainage: This tells how quickly [[water]] drains from an area.
#* Four others:
#** Vegetation: How dense the vegetation is in an area. This is later edited during history generation as [[civilization]]s log away at forests.
#** Salinity: Differentiates saltwater/freshwater [[marsh]]es and other such things. Areas below a certain elevation (oceans) automatically get a salinity of 100.
#** Savagery: How dangerous wildlife is in an area.
#** Good/Evil: This affects the type of wildlife in an area.
# '''Creating Biomes:''' Biomes are created based on elevation, temperature, rainfall, and drainage (for instance, if rainfall is >=66/100 and drainage is less than 50, then an area is a swamp).
# '''Running Rivers:''' Now erosion and the creation of [[river]]s are simulated. 
#* To quote [[Toady]]:  "It picks out the bases of the mountains (mountains are all squares above a given elevation), then it runs temporary river paths out from there, preferring the lowest elevation and digging away at a square if it can't find a lower one, until it get to the ocean or gets stuck. This is the phase where you see the mountain being worn away during world creation. I have it intentionally center on a mountain at that point so you can watch. ... This will generally leave some good channels to the ocean, so it runs the real rivers after this."
# '''Forming Lakes:''' Lakes are created and rivers are finalized.
#* River loops created by the previous step are fixed.
#* Flow amounts are calculated to determine which rivers are tributaries.
#* Rivers are also named during this step.
# '''Forming Regions:''' Now the generator looks at the major [[biome]] that occupies each square, and forms [[regions]], or connected areas on the map that contain the same major biome type. Each region gets its own name via the [[Random Name Generator]].
# '''Growing Vegetation:''' Vegetation populations are calculated for each area.
# '''Verifying Terrain:''' At this time, the world is probably checked for consistency.
# '''Recounting Legends:''' The history of the world is simulated up to the end year or until the 'Percentage Beasts Dead for Stoppage'-parameter is met.
# '''Finalization:''' World generation variables are reviewed and finalized.
# '''Upon Exit:''' All world information is exported to a "region" folder in 'data/save/'

====Rejects====

Rejects can occur at any step up to terrain verification. They are the result of certain world variables going outside of ideal conditions, and result in the currently generating world being "tossed out" and another rolled up. 

The number of potential rejects is arbitrary, so if you are using a slow computer, or simply don't want to wait through world generation, you can download one of the [[Pregenerated Worlds]]. However, some find watching their world unfold to be a worthwhile experience. Also note that as Dwarf Fortress rises in versions, world generation will most likely become more interesting, particularly once overland armies are implemented.

{{World}}
[[Category:World]]