Editing 40d:Quickstart guide

This guide is intended to be used in conjunction with a save file downloadable [http://dffd.wimbli.com/file.php?id=728 here] (5 meg download). By downloading it and unzipping it to your Dwarf Fortress directory you will be able to jump straight into a game where the first few hurdles have been overcome - a world has been generated, a location for the fort been selected, the starting skills and items have been bought, and the basic components of the fort completed.

This guide aims to explain what the graphics represent, how the menu and interface system works, and guide you through ordering your dwarves to perform a few simple tasks.

This guide and associated save file was created using version '''v0.28.181.40d'''.

==What you will see when you load the game==
[[Image:Qs01.png]]

The game will begin paused (don't unpause yet), centered on the [[meeting hall]] where all 7 of your starting [[dwarves]] are currently relaxing. The screen is divided into three sections. On the left is the active window, this is where you will see dwarves move around and where you issue orders. In the middle is the menu window. On the right is the fort view which gives you an overall view of the level (it's effectively a zoomed-out version of the active window).

You can rearrange this screen by pressing {{k|Tab}}. Press it a few times to enlarge the active window to maximum so we can have a look around.

[[Image:Qs02.png]]

Now we can see what is on the right of our meeting hall - it's unexplored underground space, shown by the large black area with scattered grey percentage signs and commas. The brown line is where I've ordered the miners to dig a new, explatory passage which I hope will find some minerals, gems or such. We'll cover how to order miners [[#Designation menu|below]].

By using the numpad keys you can move the active screen around and explore. What you will discover is compiled below, with key points highlighted.

[[Image:Qs03.png]]

The grey line that run roughly down the center of the image is the side of the mountain, you can see I've carved the fort straight into the side of it. On the lower left is a greenish area with a few blue patches. This is a mixture of grass, bushes, trees, and water. As opposed to the grey tiles in the centre which represent bare rock.

On the top left you will notice a lot of small dots and a blue haze. This is empty space. Although Dwarf Fortress may appear to be a 2D game, it is in fact 3D. You are currently looking at a top-down perspective of one [[z-level]]. If you were to move the active window down one level the empty space would become ground and the ground would become unexplored underground space. You can move the screen up and down by pressing {{k|<}} and {{k|>}} respectively (don't forget to hold on {{k|Shift}}!).

That's enough looking around, it's time to ...

==Meet your dwarves==
====Dwarves====
You currently have 7 dwarves and I've set up their skills and even given them nicknames to help you keep them sorted.
*'''Sue''' is a [[miner]]. Because mining is an important task I've disabled all her other labors so all she will do is mine - if you don't have any mining work designated for her to do she will return to the meeting hall.
*'''Matthew''' is a miner exactly the same as Sue.
*'''Jane''' is a [[woodworker]]. She carries a [[battleaxe]] she uses to chop down [[tree]]s and can then carve them into usable products at the [[carpenter's workshop]]. She also has a few skill points in [[Axedwarf]], just in case you need to [[draft]] her into the [[military]].
*'''Daniel''' is a stoneworker. She has several skill points in [[mason]]ry so she can carve rock thrones, tables, doors and other such things. She also has a few skill points in [[mechanic]]s so she can build rock [[mechanism]]s, which are required to create [[trap]]s and some [[machine]]s.
*'''Rachel''' is a craftdwarf. She has plenty of points in [[stone crafter|stone crafting]] so she can make trade goods before the Autumn [[caravan]] arrives. She also has a few points in [[bone carving]] so could make bone or shell armour from any creatures you kill.
*'''Juliet''' is a [[fisherdwarf]]. He will spend most of his time at ponds or creeks catching [[fish]]/[[turtle]] and leaving them on the shore to [[rot]].
*'''Olon''' is a [[farmer]]. He can plant [[seed]]s at the farm and [[brew]] the mature plants into [[alcohol]] or [[cook]] them into [[food]].

====Creatures====
You also have:
*1 [[cat]], which will hunt [[vermin]] for you.
*2 [[dog]]s, which will hang around in the meeting hall most of the time. They will attack [[invader|intruders]] if they get close, or can be [[kennel|trained]], or [[assign animal|leashed up]] to guard the entrance.
*A [[horse]] and a [[mule]]. If you purchase a male horse from a trade caravan then you could start breeding horses for [[meat]], large stacks of [[bone]] (good for making practice crossbow [[bolt]]s), and [[leather]]; however mules never breed (not in DF, not in RL).

====Items====
Most of your supplies are still in the [[wagon]]. You have:
*Plenty of food and alcohol.
*An [[anvil]].
*A few [[seed]]s.

==Unpause the game==
[[Image:Qs04.png|right]]
That's enough introductions, time to get the game going. Once you unpause you will notice the dwarves scatter. Before saving the game I created a food [[stockpile]] in the pantry, most of the dwarves have gone to haul the food from the wagon to inside. Whereas Juliet is going to fish, and the miners will begin mining.

There are, however, several things I left unfinished for you to practice on. So let's hit {{K|Tab}} to bring the menu window back. I'll be referring to it from now on, and generally it's easier to play with it there constantly.

<br clear="all" />

==Set tasks in workshops==
We've got a Craftdwarf's Workshop all setup and ready to go but currently there are no work tasks there and Rachel is just going to ignore it. To find the workshop, press {{k|r}} to enter the <tt>View Rooms/Buildings</tt> menu, use {{K|Page Down}} twice to get the Crwaftdwarf's Workshop in view, then use {{k|&#8593;}} {{k|&#8595;}} to highlight the workshop.  Press {{k|t}} to zoom to the workshop, and the {{K|Space}} to get back to the main menu.

We want to use the <tt>Set Building Tasks/Preferences</tt> menu, {{k|q}}. Once you hit {{k|q}} a yellow cursor will appear, simply move it around until you have the craft workshop selected.

[[Image:Qs05.png]]

Now the menu window displays the options for that building. Each different kind of building will have a different set of options. We want to {{k|a}}dd a new task. We are presented with a list of tasks (figure below) to choose from. Our miners have left plenty of rock lying around, so let's select that, {{k|g}}.

[[Image:Qs06.png]]

We get yet another list of tasks (figure below). Select ''Make rock Crafts'' by pressing {{k|Enter}} or {{k|c}}.

[[Image:Qs06b.png]]

It has returned us to the first menu which will now have one task listed. 

[[Image:Qs06c.png]]

We may as well add the other three kinds of rock goods, and then set them to repeat by pressing {{k|r}}. 

[[Image:Qs06d.png]]

If a task is set to repeat then once it's completed it returns to the end of the task list, instead of being removed from the list. So now Rachel will sit in her shop constantly producing goods.

There is one other step though: making sure she doesn't get distracted by other jobs.
<br clear="all" />
==Setting job preferences==
By setting your dwarves to only perform one or two different labors you can ensure they spend all their time completing that job instead of running all round the fortress like headless chickens, trying to do everything at once.

First you need to find the dwarf in question. Now you can either use the <tt>{{k|v}}iew units</tt> option and hunt around the map until you locate the dwarf, or you can do it the smart way. Open up the <tt>{{k|u}}nit list</tt> and you'll get a screen like this one:

[[Image:Qs07.png]]

Now scroll down to the dwarf you want and press <tt>Zoom {{k|c}}reature</tt>. This will centre the screen on the unit and open the <tt>{{k|v}}iew units</tt> mode. So you'll see this:

[[Image:Qs08.png]]

From here we can get a lot of information on the dwarf. At the moment we're looking at {{k|g}}eneral, but there is also {{k|i}}nventory, {{k|p}}references, and {{k|w}}ounds. Go to {{k|p}}references and you will get a new menu with new options, as shown below:

[[Image:Qs09a.png]]

If you press {{k|l}}abor then you will see a list of all possible tasks that a dwarf can perform. The first page of this list is shown in this screenshot:

[[Image:Qs09b.png]]

Scroll using numpad {{k|+}} and {{k|-}} until you find the "Hauling" tasks on the 4th page:

[[Image:Qs09c.png]]

Now press {{k|Enter}} to turn each one off and it should end up looking like this:

[[Image:Qs09d.png]]

<br clear="all" />

==Using the job manager==
<div style="display:inline; float:right; align:center;"><gallery widths="200px" heights="80px" perrow="1">
Image:Qs10.png|Fig 10: Open the job list
Image:Qs11.png|Fig 11: Open the job manager and select <tt>New order</tt>
Image:Qs12.png|Fig 12: The job orders list
Image:Qs13.png|Fig 13: The job manager with one job displayed
</gallery></div>
I've already created a stockpile next to the craft shop for the finished goods to be put in. There is one flaw at the moment though - each good takes up an entire tile! What we want to do is create some wooden [[bin]]s to store the items in, this has the added advantage that when the merchants arrive you only need to haul a few bins to the depot to trade the contents, instead of hauling each item individually.

Anyway, open the <tt>{{k|j}}ob list</tt> and you will see figure 10.

This details all the jobs currently underway and who is doing them. We're not too concerned with this information though, what we want is to get at the sub-menu <tt>job {{k|m}}anager</tt>, which you can see at the bottom of the image. Open that up and you will see figure 11, a blank screen! 

Not surprising, as we haven't used it yet to allocated jobs. Press {{k|q}} to start a new job and you will get a list of <u>all</u> possible jobs that can happen in a fort (figure 12). There are a ''lot''.

Luckily we can search for what we want, so type in <tt>wood bin</tt> to shorten the list of jobs. Use {{k|&#8593;}} {{k|&#8595;}} to highlight <tt>Construct wooden Bin</tt> and select it using {{k|Enter}}. It will ask you how many, 5 sounds like a good number to me. After that it will return to the original job manager, except now it will have one new job as shown in figure 13.

The job manager automatically generates the job in the appropriate workshops. We have one carpenters workshop so it will generate 5 "produce wooden bin" orders. If we had 5 carpenters workshops it would produce one in each shop. Note that we don't currently have 5 logs available so soon Jane will start canceling tasks as quickly as the job manager creates them. You will need to designate more trees to be cut down (explained [[#Designation menu|below]]).
<br clear="all" />

==Defining rooms==
<div style="display:inline; float:right; align:center;"><gallery widths="200px" heights="80px" perrow="1">
Image:Qs14.png|Fig 14: Select a dining table and make it a room
Image:Qs15.png|Fig 15: Size the room
Image:Qs16.png|Fig 16: The dining table now forms the centre of a room, and the menu now displays the room options
</gallery></div>
Sometimes it isn't enough to place furniture to make it usable, but you also need to define a room from it. Bedrooms, tombs, meeting halls, and plenty more have to be created this way. In our fortress our [[dining room]] has plenty of tables and chairs for eating, but isn't actually a dining room yet.

Open up the <tt>Set Building Tasks/Preferences</tt> menu, {{k|q}}, again and move the cursor to one of the tables in the dining room (figure 14). It doesn't matter which one.

You will notice that this building has quite a different menu to the craft shop we looked at earlier. Press {{k|r}} to make this table into a room, then use the {{k|+}} {{k|-}} keys to get it to the maximum size (figure 15).

Press {{k|Enter}} to accept and it will return to the building menu, which now has new options because it is a room instead of a table (figure 16). Since we want this to be a public dining hall we don't need to change any of these options, so you can press {{k|Space}} to finish.
<br clear="all" />

==Using farms==
<div style="display:inline; float:right; align:center;"><gallery widths="200px" heights="80px" perrow="1">
Image:Qs17.png|Fig 17: Two farms below the main fort
Image:Qs18.png|Fig 18: Select a farm and decide which crops to grow.
</gallery></div>
If you used the {{k|>}} to explore the [[z-level]] below the main fort you may have discovered this little room just below the pantry (figure 17).

This is two farms built in the arable sand layer, but no seeds have been planted yet. Once again use <tt>Set Building Tasks/Preferences</tt> menu, {{k|q}}, to get to the farm options (figre 18). 

You will see a list of 4 different crops. At the moment we only have seeds for [[plump helmet]]s and [[sweet pod]]s. So choose which you want to plant in each farm. '''But!''' note that there are 4 different [[season]]s. The current menu is only displaying spring so press {{k|b}} {{k|c}} {{k|d}} to get to summer, autumn and winter respectively and choose which crop to plant in each season.
<br clear="all" />

==Designation menu==
<div style="display:inline; float:right; align:center;"><gallery widths="200px" heights="80px" perrow="1">
Image:Qs19.png|Fig 19: The designation menu
Image:Qs20.png|Fig 20: Select <tt>Mine</tt> and set the first point on the exposed wall
Image:Qs21.png|Fig 21: Set the second point somewhere in the unmined space
Image:Qs22.png|Fig 22: Select <tt>Up staircase</tt> and place it
Image:Qs23.png|Fig 23: Move up one z-level and place a <tt>Down staircase</tt>
</gallery></div>
The {{k|d}}esignation menu is one of the most important in the game. It allows you to mine out new areas of your fort, chop down trees, gather plants, etc. We want to define a new shaft for our idle miner, so select {{k|d}}ig (figure 19).

Now scroll the cursor to where you want to begin the shaft and press {{K|enter}}. Obviously we want to start it at a wall the miner can reach! (Figure 20)

Then scroll to where you want it to finish and press enter again. A brown line will appear like in figure 21.  Note that you can designate entire rectangles to be mined, not just a single line like I did.

Now let's create a [[staircase]] to access the next level up. First designate an up-stair on the current level (figure 22): press {{k|u}}, then {{K|Enter}} twice.

And now the tricky bit - move up one level ({{k|<}}) and designate a down staircase ''directly above it'' (figure 23) by doing {{k|j}}, then {{K|Enter}} twice.

To get Jane the woodworker to chop down trees, go to the outdoors west of the indoor rooms, select {{k|t}} from the designation menu, press {{K|Enter}} to select one corner of a rectangle, use the arrow keys to move to the opposite corner of the desired rectangle, and press {{K|Enter}} again; all of the trees inside of the rectangle will be highlighted to indicate that they've been designated for cutting.  If you've selected too many trees you might later need to turn off Jane's Wood Cutting labor to get her to stop cutting trees and start making bins out of the trees she's already cut.

===Digging, [[warm stone]], and [[magma]]===

As you mine through the mountain, you'll eventually encounter the error message:

:<tt>Digging designation canceled: warm stone located.</tt>

Stone is warm because it's right next to magma, either right beside it on the same [[z-level]], above it on the next level, or below it on the lower level.  In the first two cases digging away the warm stone will cause magma to come flooding out.

Note that you'll only get the error message if a digging designation which you placed on an unexplored area crosses warm stone.  If you place a digging designation on explored/known stone which is warm ''then your dwarfs will dig it out, possibly unleashing a flood of magma''.  Fortunately, known warm stone is displayed by a flashing yellow "☼" on red background while designating a digging area.  However, that's all the warning you'll get, so be careful.

<br clear="all" />

==Creating workshops==
<div style="display:inline; float:right; align:center;"><gallery widths="200px" heights="80px" perrow="1">
Image:Qs24.png|Fig 24: Rotting turtles surrond a pond
Image:Qs25a.png|Fig 25a: The <tt>Site building</tt> menu
Image:Qs25b.png|Fig 25b: The workshop sub-menu
Image:Qs26.png|Fig 26: Placing the fishery
</gallery></div>
Juliet has been busy catching turtle, unfortunately he's been too busy to clean and gut them, so they've been rotting on the pond side (figure 24). 

We want to build a [[fishery]] nearby to fix this problem. First open the <tt>Site a {{k|b}}uilding</tt> menu and you will see a list of all possible buildings (figure 25A). Scroll down until you reach {{k|w}}orkshops, select that and you will get a sub-menu of all the workshops (figure 25B).

Once you select fishery a 3x3 block will pop up on the active window, representing how big the workshop is and where you want to build it. At the moment there is a tree in the way (figure 26), so move around until you find some clear ground close to the pond.

Once you have placed it you will be asked which materials you want to construct it out of. At this stage it doesn't really matter, but I suggest Andesite since it's closest (excluding the wood logs).


But this isn't enough. For one of your dwarves to actually construct the workshop ''they need to have the labor enabled that relates to that building'' ... and at the moment no one has [[fish cleaner]] nor [[fish dissector]] enabled. You need to select another dwarf and change his labors to include [[fish cleaner|fish cleaning]], as explained [[#Setting job preferences|above]]. Preferably not Juliet (since the Fishing task takes precedence over almost all other tasks) nor any other dwarf that is busy with important tasks.

Once the fishery is complete you will need to set the task <tt>{{k|p}}rocess raw fish</tt> at the workshop, and set it to repeat. Pretty soon you'll be churning out a good supply of meat to feed your fort. Also, since Juliet is catching [[turtle]] you will also get a nice little supply of [[shell]]s that Rachel can then craft into goods.
<br clear="all" />

==Conclusion==
Well, that's most of the basics covered. Next up I suggest you dig out an area near the pantry and build a [[still]] and a [[kitchen]] so you can begin brewing alcohol and cooking food (although plenty of food can be eaten raw). When the trade caravan arrives you will want to consult the [[trading]] page to learn how to trade with them. 

I hope you have fun exploring the area, building some proper defences to hold off [[invader]]s, and dealing with an expanding [[population]] and the greater problems that they bring.

[[Category:Guides]]