Dwarf Fortress Wiki - User contributions [en]

v0.34 Talk:Skill

2014-04-14T19:26:26Z

Doktoro Reichard: /* What is a profession? */ - rsp

A rusty novice qualifies to work in a mason's workshop that is set to only accept dabbling dwarves. Perhaps this information could be mentioned, with testing of course. Also, what does "Permanent skill loss" mean? Will a dwarf suffering from permanent skill loss never be able to work above a certain level, or is there a just a decrease in experience that is recoverable through training? --[[User:Introprospector|Introprospector]] 00:13, 5 March 2012 (UTC)

== Non-fortress sentients observed changing profession ==

In case it's ever of interest to anybody, "NPCs" (by which I mean sentients who aren't part of your fortress) appear to change profession according to the same rules as fortress dwarves -- an unarmed Goblin Recruit entered my map in an ambush group and turned into a Wrestler after engaging some animals in hand-to-hand. [[User:Chaos|Chaos]] 05:21, 12 May 2012 (UTC)

== What is a profession? ==

The wiki redirects "Profession" to this page, but this page doesn't describe professions, except through a few incidental references.

:Although "Profession" isn't a game term, its meaning can either mean the Skills a dwarf can have or the [[Job|jobs]] they are enabled to do. It is my opinion that the term Profession does relate more to the assignment of jobs than the skills, in the sense a dwarf can be infinitely skilled in everything and still just be allowed to farm plump helmets. I'll fix the redirect.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 19:26, 14 April 2014 (UTC)

v0.34:The Non-Dwarf's Guide to Rock

2014-04-11T19:21:01Z

Doktoro Reichard: Undo revision 198518 by Latias1290 (talk)

{{quality|Exceptional|18:21, 22 May 2012 (UTC)}}{{av}}

Wondering what that new kind of rock your dwarves just struck is good for? Possibly nothing, but when you're just getting started it can be tough to tell the trash from the treasure. The following table summarizes the types of stone and ore found in Dwarf Fortress; it does not include [[gem]]s.

The ''Uses'' column lists any special uses or properties of this particular stone type; if no uses are listed, you can always use the stone for general construction and crafting. Note that many "low-value" materials are still ''very'' useful in a Dwarf Fortress. "Colors" are useful for color coding or [[style project|creative aesthetic uses]].

For more detailed and expanded information, see the [[Stone]], [[Ore]], [[Metal|Metals & Alloys]], [[Vein|Veins & Clusters]], and [[Smelting]] pages, or the article on any particular stone, metal or ore.

During the game, you can press {{key|z}} and then navigate to "stone". The list there covers all types of rocks and ores, and tells you what rocks can be smelted into.

==Table of Rocks==

''(Some materials are worth an additional comment; these are numbered, with footnotes below the table.)''

{|class="sortable" border = 1 cellspacing="0" cellpadding="5"

| align="center" style="background:#f0f0f0;"|'''Name'''
| align="center" style="background:#f0f0f0;"|'''Type'''
| align="center" style="background:#f0f0f0;"|'''Uses'''
| class="unsortable" align="center" style="background:#f0f0f0;"|'''Appearance*'''
|-
| [[Raw adamantine|Adamantine, raw]]||ore, special1||Becomes [[Adamantine]]1, by far the most valuable substance||{{Raw Tile|£|3:7:1}} {{Raw Tile|*|3:1}}
|-
| [[Alabaster]]||stone||Low-value stone; used for making [[plaster]]||{{Raw Tile|^|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Native aluminum|Aluminum, native]]||ore, high-value||Smelt into [[Aluminum]], a high-value decorative [[metal]]||{{Raw Tile|^|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Alunite]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Andesite]]||layer stone||Low-value stone||{{Raw Tile|8|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Anhydrite]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|v|7:7:1}} {{Raw Tile|•|7:0}}
|-
| [[Basalt]]||layer stone||Low-value [[magma-safe]] stone||{{Raw Tile|#|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Bauxite]]||stone||Low-value [[magma-safe]] stone; only source of some high-value gems||{{Raw Tile|+|4:7:0}} {{Raw Tile|•|4:0}}
|-
| [[Bismuthinite]]||ore, rare||Ingredient of [[bismuth bronze]]||{{Raw Tile|%|7:7:1}} {{Raw Tile|*|7:0}}
|-
| [[Bituminous coal]]||stone||Smelt into [[Fuel]], flammable||{{Raw Tile|¤|0:7:1}} {{Raw Tile|¤|0:1}}
|-
| [[Borax]]||stone||Low-value stone||{{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Brimstone]]||stone||Low-value stone||{{Raw Tile|%|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Calcite]]||stone||[[Flux]], mid-value [[magma-safe]] stone||{{Raw Tile|"|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Cassiterite]]||ore, uncommon||Smelt into [[Tin]], a low-value metal; ingredient of [[Bronze]]s; [[magma-safe]]||{{Raw Tile|£|6:7:0}} {{Raw Tile|*|6:0}}
|-
| [[Chalk]]||layer stone||[[Flux]], mid-value stone||{{Raw Tile|¦|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Chert]]||layer stone|| Low-value [[magma-safe]] stone||{{Raw Tile|=|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Chromite]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|=|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Cinnabar]]||stone||Low-value stone||{{Raw Tile|£|4:7:1}} {{Raw Tile|*|4:1}}
|-
| [[Claystone]]||layer stone||Low-value stone||{{Raw Tile|,|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Cobaltite]]||stone||Low-value stone||{{Raw Tile|£|1:7:1}} {{Raw Tile|*|1:1}}
|-
| [[Conglomerate]]||layer stone||Low-value stone||{{Raw Tile|8|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Native copper|Copper, native]]||ore, low-value||Smelt into useful [[Copper]]; ingredient of [[Bronze]]s||{{Raw Tile|£|6:7:0}} {{Raw Tile|*|6:0}}
|-
| [[Cryolite]]||stone||Low-value stone||{{Raw Tile|-|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Dacite]]||layer stone||Low-value stone||{{Raw Tile|.|0:7:1}} {{Raw Tile|•|7:0}}
|-
| [[Diorite]]||layer stone||Low-value stone||{{Raw Tile|¦|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Dolomite]]||layer stone||[[Flux]], mid-value [[magma-safe]] stone||{{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Gabbro]]||layer stone||Low-value [[magma-safe]] stone; only source of some [[ore]]s & [[gem]]s||{{Raw Tile|¦|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Galena]]||ore||Smelt into [[Lead]], a low-value metal, with a 50% chance2 for [[Silver]]; [[magma-safe]]||{{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Garnierite]]||ore, uncommon||Smelt into [[Nickel]], a low-value [[magma-safe]] metal ||{{Raw Tile|£|2:7:1}} {{Raw Tile|*|2:1}}
|-
| [[Gneiss]]||layer stone||Low-value stone||{{Raw Tile|=|7:7:1}} {{Raw Tile|•|7:0}}
|-
| [[Native gold|Gold, native]]||ore||Smelt into [[Gold]], a high-value [[metal]]||{{Raw Tile|£|6:7:1}} {{Raw Tile|*|6:1}}
|-
| [[Granite]]||layer stone||Low-value stone; only source of some ores; relatively rich in content||{{Raw Tile|¦|7:0}} {{Raw Tile|•|7:0}}
|-
| [[Graphite]]||stone||Flammable||{{Raw Tile|o|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Gypsum]]||stone||Low-value stone; used for making [[plaster]]||{{Raw Tile|#|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Hematite]]||ore||Smelt into [[Iron]], a mid-value metal; ingredient for [[Steel]]; [[magma-safe]]||{{Raw Tile|£|4:7:0}} {{Raw Tile|*|4:0}}
|-
| [[Horn silver]]||ore||Smelt into [[Silver]], a mid-value metal||{{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Hornblende]]||stone||Low-value stone||{{Raw Tile|"|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Ilmenite]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|.|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Ice]]3||stone/water3||Frozen Water||{{Raw Tile|¦|3:3:1}} {{Raw Tile|•|3:1}}
|-
| [[Jet]]||stone||Low-value stone||{{Raw Tile|¦|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Kaolinite]]||stone||Low-value [[magma-safe]] stone; used for making [[porcelain]]||{{Raw Tile|=|4:7:0}} {{Raw Tile|•|4:0}}
|-
| [[Kimberlite]]||stone|| Low-value stone; only source of [[Faint yellow diamond|diamond]]s||{{Raw Tile|%|1:7:0}} {{Raw Tile|•|1:0}}
|-
| [[Lignite]]||stone||Smelt into [[Fuel]], flammable||{{Raw Tile|*|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Limestone]]||layer stone||[[Flux]], mid-value stone||{{Raw Tile|¦|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Limonite]]||ore, high-value||Smelt into [[Iron]], a mid-value metal; ingredient for [[Steel]]||{{Raw Tile|£|6:7:1}} {{Raw Tile|*|6:1}}
|-
| [[Magnetite]]||ore, high-value||Smelt into [[Iron]], a mid-value metal; ingredient for [[Steel]]; [[magma-safe]]||{{Raw Tile|~|0:7:1}} {{Raw Tile|*|0:1}}
|-
| [[Malachite]]||ore, low-value||Smelt into useful [[Copper]]; ingredient of [[Bronze]]s||{{Raw Tile|£|2:7:0}} {{Raw Tile|*|2:0}}
|-
| [[Marble]]||layer stone||[[Flux]], mid-value stone||{{Raw Tile|¦|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Marcasite]]||stone||Low-value stone||{{Raw Tile|%|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Mica]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|v|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Microcline]]||stone||Low-value stone||{{Raw Tile|%|3:7:1}} {{Raw Tile|•|3:1}}
|-
| [[Mudstone]]||layer stone||Low-value stone||{{Raw Tile|˜|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Obsidian]]||layer stone||High-value [[magma-safe]] stone;Sharpenable hard rock (used to create stone [[short sword]]s); signifies nearby [[magma]] if not a layer||{{Raw Tile|¦|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Olivine]]||stone||Low-value [[magma-safe]] stone; may contain [[Platinum]]||{{Raw Tile|%|2:7:0}} {{Raw Tile|•|2:0}}
|-
| [[Orpiment]]||stone||Low-value stone||{{Raw Tile|-|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Orthoclase]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|%|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Periclase]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|,|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Petrified wood]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|%|4:7:1}} {{Raw Tile|•|4:1}}
|-
| [[Phyllite]]||layer stone||Low-value stone||{{Raw Tile|-|0:7:1}} {{Raw Tile|•|7:0}}
|-
| [[Pitchblende]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|*|5:7:0}} {{Raw Tile|•|5:0}}
|-
| [[Native platinum|Platinum, native]]||ore, high-value||Smelt into [[Platinum]], a highest-value decorative [[metal]]||{{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Puddingstone]]||stone|| Low-value stone||{{Raw Tile|T|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Pyrolusite]]||stone||Low-value stone||{{Raw Tile|%|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Quartzite]]||layer stone||Low-value [[magma-safe]] stone||{{Raw Tile|-|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Realgar]]||stone||Low-value stone||{{Raw Tile|%|4:7:1}} {{Raw Tile|•|4:1}}
|-
| [[Rhyolite]]||layer stone||Low-value stone||{{Raw Tile|,|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Rock salt]]||layer stone||Low-value stone||{{Raw Tile|#|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Rutile]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|`|5:7:0}} {{Raw Tile|•|5:0}}
|-
| [[Saltpeter]]||stone||Low-value stone||{{Raw Tile|x|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Sandstone]]||layer stone||Low-value [[magma-safe]] stone||{{Raw Tile|#|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Satinspar]]||stone||Low-value stone; used for making [[plaster]]||{{Raw Tile|-|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Schist]]||layer stone||Low-value stone||{{Raw Tile|`|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Selenite]]||stone||Low-value stone; used for making [[plaster]]||{{Raw Tile|;|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Serpentine]]||stone||Low-value stone||{{Raw Tile|˜|2:7:0}} {{Raw Tile|•|2:0}}
|-
| [[Shale]]||layer stone||Low-value stone||{{Raw Tile|.|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Siltstone]]||layer stone||Low-value stone||{{Raw Tile|%|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Native silver|Silver, native]]||ore||Smelt into [[Silver]], a mid-value metal||{{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Slade]]||stone, special||Not workable by dwarves||{{Raw Tile|¦|0:1}} {{Raw Tile|*|0:1}}
|-
| [[Slate]]||layer stone||Low-value stone||{{Raw Tile|%|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Sphalerite]]||ore, uncommon||Smelt into [[Zinc]], a low-value metal; ingredient for [[Brass]]||{{Raw Tile|£|0:7:1}} {{Raw Tile|*|0:1}}
|-
| [[Stibnite]]||stone||Low-value stone||{{Raw Tile|%|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Sylvite]]||stone||Low-value stone||{{Raw Tile|=|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Talc]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|||7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Tetrahedrite]]||ore, low-value||Smelt into useful [[Copper]]; ingredient of [[Bronze]]s; has a 20% additional chance2 of [[Silver]]; smelt into [[Billon]]||{{Raw Tile|£|0:7:1}} {{Raw Tile|*|0:1}}
|}

:''(* Each stone is one of 16 [[color scheme|colors]] in the game. Different un-mined stone of the same color have a different symbol to distinguish between them. Once mined, the individual stones themselves can sometimes look identical if the color is the same. Use {{k|k}} to loo{{k|k}} at items or the terrain for specific information.)''

'''Notes:'''
# '''Adamantine''' is not exactly like other metals, although it works almost the same. It has a value multiplier of x300 (yes, three ''hundred''). See [[adamantine]] for a full discussion of this unusual and wondrous material.
# '''% chance''' for additional metals: when [[Galena]] and [[Tetrahedrite]] are smelted, they produce (respectively) four lead or copper bars, 100% of the time. They also produce 0-4 ''additional'' bars of the second metal, with the percent chance to produce each additional bar listed above.
# '''Ice''' has some ''very'' unusual properties in Dwarf Fortress, and can be disastrous if misused. See article on [[ice]] for a more complete discussion.

===The Value of Rocks & Metals===
You won't find the terms "low-value" or "highest-value" used in the game, but they're handy here for rough comparison. "[[Value]]s" are all relative to each other, on a common scale. The "material value" number multiplies any final product that is created with that material by that number. An average generic statue (base value 25) is worth much more than an average generic throne (base value 10), but a throne carved from raw [[native gold|gold nuggets]] (10 x 30 = 300) will be worth far more than a common-stone statue (25 x 1 = 25). ''(Note - "[[quality]]" also factors in to total value of a final product, as do some other considerations, but those are outside the scope of this intro article).'' Bottom line - when in doubt, go for the more valuable stuff.

Common '''stones''' ''(the vast majority)'' have a value multiplier of x1, mid-value ''(all [[flux]] stones like marble)'' are x2, and high-value ''([[obsidian]] only)'' is x3. This affects things like stone tables and doors, statues or stonecrafts - anything made from stone. Metal [[ore]]s have varying values, from 2-40, and can either be treated as stone or smelted into bars of metal.

For '''metals''', low-value ''(like copper or nickel)'' is x2. Mid-value ''(silver or iron)'' is around x10, high-value ''(gold, steel)'' is x30, and highest-value ''(platinum, aluminum)'' is x40.

Note that the raw mined ore and the smelted pure metal often have different value multipliers, but not always. [[Alloy]]s like brass or bronze are often more valuable than the sum of their pure metal ingredients, and have a true spectrum of values between 3-23. ''(Alloy values are not listed in this article.)''

Any metal can be crafted into decorations, furniture, or buildings. Only copper, bronzes, iron, steel, and adamantine can make weapons, armor, and picks, with silver also able to be forged into melee weapons.

''(For comparison, all [[wood]] has a value of x1, equal to common stone.)''



See also:
:* [[Exploratory mining]]

{{Category|Guides}}{{Category|Stone|*}}

User talk:Latias1290

2014-04-10T19:00:38Z

Doktoro Reichard: /* Recent changes to the Non Dwarf's Guide to Rock */ new section

Hi! Wanted to ask me a question? You came to the right place. 
When you want to post something, please post new stuff at the ''bottom'' of the page. You can use the Add topic button for that. 
When you post something, remember to put <nowiki>~~~~</nowiki> at the end of the post. Or, if you have a custom setup, like I do, you can use <nowiki>~~~</nowiki>. But usually you want to use the quad tidle, not the tri one. 
{{User:Latias1290/Sig/src|18:02|February 06, 2014}}

== Double redirects ==

I know there are a lot of double redirects on this wiki, but they're supposed to work (a couple don't for some reason, but most of them work fine). Basically, keeping HFS pointing to cv:HFS saves us trouble when we create the DF2014 namespace and set "cv" to point to it instead. ([[DF:REDIR|This]] is a better explanation, although outdated.)

However, I agree that we shouldn't need so many double redirects. I'm currently working on a way to make Mediawiki automatically jump to the cv: page without needing to create a redirect, so hopefully that'll solve this problem.

Also, thanks for your various fixes/corrections around the wiki :) --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:00, 8 January 2014 (UTC)

You may be interested in the discussion [[DF talk:Versions#Revisiting Redirects|here]]. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:47, 8 January 2014 (UTC)

== Re: [[User:Latias1290/construction2|Using templates with special characters in parameters]] ==

It ''is'' possible to use pipes (<code>|</code>) and equals signs, although it's tricky. Things like this usually work just fine, since Mediawiki parses the inner template before the outer one:
<pre>{{template1|{{template2|param}}}}</pre>
e.g. <code><nowiki>{{key|{{char|50}}}}</nowiki></code> gives {{key|{{char|50}}}}

Using things like tables is trickier, and usually requires the use of a separate template, {{tl|!}}, which produces a pipe character. (There is also {{tl|!-}}, which produces {{!-}}). Using these keeps Mediawiki from interpreting the pipe as a separator, which lets you use it in a parameter.

Also, if you use equals signs in a parameter, like this:
<pre>{{template|1 + 1 = 2}}</pre>
You need to either use {{tl|1==}} instead of the equals sign or specify the parameter (<code>{{{1}}}</code>) explicitly, i.e.:
<pre>{{template|1=1 + 1 = 2}}</pre>
(The reason the first one doesn't work is because Mediawiki interprets the content before the = sign as the parameter name, passing the template a parameter named "1 + 1" with "2" as the value. The second option forces it to use "1" as the parameter name and "1 + 1 = 2" as the value. [https://www.mediawiki.org/wiki/Help:Templates#Numbered_parameters This page] has more information about this, if you're interested.)

It's messy (and harder to read), but it does work. My personal recommendation in this situation to avoid having to escape a lot of pipes is to create ''two'' templates – one for a header, and one for a footer. (Usually just a header is necessary, since a footer is often just a </div> that doesn't really need a separate template).

—[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:37, 5 February 2014 (UTC)

== Infinite vs unlimited finite ==

The distinction is a rather pedantic mathematical one. While there are indeed infinitely many different numbers of mechanisms you can embed in a lever, all of those numbers are themselves finite, so it's not correct to say (as the article did) "they can be used to stack an infinite number of [[mechanism]]s". According to my sources, this distinction is a common cause of confusion among first-year University maths students. --[[User:Bjh21|bjh21]] ([[User talk:Bjh21|talk]]) 20:50, 8 February 2014 (UTC)
:Ah, I get what you mean now. You indeed cant physically have an infinite amount of mechs on a lever :P {{User:Latias1290/Sig/src|20:53|February 08, 2014}}

== [[User:Latias1290/menucustom.js|JS]] ==

I ended up abandoning that because it became too cluttered and complex to do much with. Feel free to decipher what it does if you like. Part of the reason it's so unreadable is because I was trying to reduce its size, before I realized Mediawiki automatically minifies Javascript over a certain length.
* <code>window</code> contains all Javascript globals in the current page/window (equivalent to Lua's <code>_G</code>). For example, alert and window.alert are the same thing. I usually use "window" when I want to force the use of a global variable instead of a local one.
* <code>_le</code> is the same thing as window.LE. I use it to "export" things to the global namespace - since everything is inside a big function (a closure), variables I define there belong to that function's scope and aren't accessible to any outside code. Anything I put in _le, however, is accessible, since I have <code>window.LE = _le</code> near the end of the function. I could have used LE instead of _le - it doesn't make a difference.
* A() is complicated. I use it to assign properties to _le (e.g. instead of <code>_le.x = 2</code>, I use <code>A('x', 2)</code>). Here's a fully-documented version:
<pre>
function A(a,b){
/* Assigns properties to '_le'. Polymorphic.
A(String a, mixed b): Assigns _le[a] to b
A(Object a): Performs A(key, value) for each {key:value} pair in 'a'
*/
if(!b){ // THIS IS BAD. It should be "if(b!==undefined)"
// 'b' is not defined, so assign all key-value pairs in 'a' (an object) to _le
if (typeof a != 'object') return; // if 'a' isn't an object, it doesn't have keys, so looping won't work. This only happens with things like A('foo')
for(i in a){ // Loop through keys of 'a' - 'i' is the key
if(i in {}) continue; // if i is a property of an empty object, skip it. This should never happen unless you add properties to the Object constructor.
_le[i] = a[i] // Assign property 'i' of 'a' to the same property of '_le'. In this loop, effectively assigns all properties of 'a' to '_le'.
}
}
else _le[a]=b; // b _is_ defined, so set _le[a] to 'b'
return A; // returns A so it can be called again, if necessary
}
-----
The following lines are equivalent:
A('a', 1); A('b', 2);
A({a:1, b:2});
A('a', 1)('b', 2);
</pre>
* OPTS_MD is "metadata", which I was eventually going to use for a settings manager. It doesn't do anything, so you can remove it if you like.
* You can probably remove the jQuery loading - the wiki now uses 1.8, which works just fine. I can add this for you if you like (admins can edit user JS pages :) )
* OPTS contains options, and DEFAULT_OPTS contains the defaults. OPTS merges data from DEFAULT_OPTS and LE_USER_OPTS (if it exists), with LE_USER_OPTS taking priority. (This is also what update_opts does)
* I have no idea why I used O() instead of accessing the options directly.
* PM is a plugin manager, which I meant to use to simplify adding new features. It actually made them more complicated and less readable, particularly since I gave everything unhelpful variable names (see point #1)
* LELL is supposed to be a way to run events when the menu loads, but it doesn't work (it actually causes errors when the page loads, but I suspect that's a result of loading jQuery). It also doesn't do anything, as far as I know, so it can be removed too.
I can try to explain other things too, if it helps (assuming I can figure them out).
—[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 16:50, 23 March 2014 (UTC)

== AAAAAA??? ==

Your edit of decoration: http://dwarffortresswiki.org/index.php?title=DF2012:Decoration&diff=195815&oldid=195779
is rather poorly explained. I think you _meant_ that you changed the spelling to conform with in-game use? "Civilisation" is a perfectly valid spelling of the word, just not the one used by the game itself.--[[User:Larix|Larix]] ([[User talk:Larix|talk]]) 18:12, 24 March 2014 (UTC)
:Actually I always thought "civilizations" was the right spelling but after some quick "research" just now I found out both are correct {{User:Latias1290/Sig/src|18:56|March 24, 2014}}

== Recent changes to the Non Dwarf's Guide to Rock ==

Your "Fortune?" Column adds little to what exists on the Uses column and at most, some of its content could be merged into the Uses column.

For instance, you're being highly redundant in stating that all Flux stone can be used to make steel, mainly because any Non Dwarf will need to look into the Flux page to know what Flux is and hot to use it to make steel.

As I understand the work you might have had in adding the information, I was wondering if you had a good reason to add such column instead of undoing it without warning. --[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 19:00, 10 April 2014 (UTC)

v0.34 Talk:Noise

2014-04-08T00:11:42Z

Doktoro Reichard: /* Where does noise originate? */

==Where does noise originate?==
In most jobs, the dwarf performing the action stands beside the object of the action. Does the noise originate at the dwarf or at the wall/tree/etc? [[User:Xolroc|Xolroc]] ([[User talk:Xolroc|talk]]) 13:33, 7 April 2014 (UTC)

:From the wording on the page, as the dwarf wields (or in most cases, is) the noise-producing apparatus, noise is centered on the working dwarf in question. It however seems to be a slight mute point (no pun intended) because negative [[Thoughts]] made by noise are negligible and you can place your dormitory far away from any noise source without much consideration or planning. --[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 00:11, 8 April 2014 (UTC)

v0.34 Talk:Necromancer

2014-03-23T17:23:23Z

Doktoro Reichard: /* vampire necromancers: is it possible */

== Please verify ==

All my Fortress Mode edits are entirely from personal experience across approx. ten forts in three world gens. Can anyone verify? --[[User:Vietarmis|Vi Et Armis]] 15:17, 29 March 2012 (UTC)

== Hiding necromancers? ==

So randomly some corpses have started animating yet no necromancer is nearby it seems. I'm in a good region and have had no announcements except Urist McHauler cancels store barrel: Interrupted by Kea corpse.
Perhaps Necromancers can ambush?

What else could cause undeath?
--[[User:Merreton|Merreton]] 02:16, 15 May 2012 (UTC)

:I believe necromancers are capable of hiding and raising corpses while sneaking. Since you're in a good region that rules out the corpses raising themselves, and I don't think good regions produce mists or clouds, so there's no other answer. -- [[Special:Contributions/108.69.177.161|108.69.177.161]] 02:47, 10 May 2012 (UTC)

::I can confirm this; my fortress faced an early siege which (apparently) consisted of only a single Elf Corpse. The SIEGE indicator vanished when my military defeated the Elf, but things kept on animating. Later on, I noticed lines in combat log showing that a Human necromancer had been hanging around (in hiding) after the end of the official Siege, and raising corpses. -- [[Special:Contributions/24.138.132.123|24.138.132.123]] 02:47, 31 May 2012 (UTC)

:Yes, necromancers can hide. I've seen it with sieges, although not as separate ambushes. Even while hidden it still prints into the combat log ('the necromancer is fighting! the x corpse is fighting!') when they raise the dead, so it's easy to know if this is the cause, although that's probably a bug. -- [[User:Qazmlpok|Qazmlpok]] 17:22, 31 May 2012 (UTC)

== Tower Distance ==
Do we have any direct evidence that a tower more than 10 or 11 region tiles away will send necros/zombies to a fortress? In my own experience, the "Tower" designation only shows up if you embark within 11 region tiles of the tower, and I do not recall getting attacked when more than 11 but less than 21 region tiles away. I don't have firm data on the 11-20 region tile distance, however. [[User:Krenshala|Krenshala]] 18:22, 21 July 2012 (UTC)

-I have been attacked by a Necromancer's zombies [[Not him, he did not come]]
from the Northern tip of the map while I was in the South, which was much further then 20 tiles.

== Clarification ==

"If you attack one of your own reanimated corpses, all of your reanimated companions will become neutral and will no longer follow you."

The word 'all' being bolded for this page has me concerned and curious, does this apply to zombies that are summoned later by yourself as well? -- [[User:Morekouto|Morekouto]] 03:28, 1 August 2012 (UTC)

No, it stops all current undead followers from following you. You can get them back, but you have to re-kill them, and re-raise them, or find new bodies. --[[User:Struck Down|Struck Down]] 04:40, 14 August 2012 (UTC)

== Speed cap in adventure mode? ==

After becoming a necro in adventure mode, I noticed my speed started dropping off quickly, and wasn't linked to my items or attributes. The highest speed I can manage is about 1300 with my character completely naked, with superhuman agility and strength.

Yeah my adventurer went from 1610 to 1290 speed in about a week ingame time in one shot. It also seems that you don't need to eat or sleep anymore either. Those are pretty crucial details for this page. I'm playing v 34.11. Also have highest agility and strength possible for a dwarf. --[[Special:Contributions/77.190.67.208|77.190.67.208]] 01:12, 17 December 2012 (UTC)

Same thing happened to me. It also seems to affect adventurers who contract vampirism. I also messed with the tokens and removed the [no phys att gain] in the files for both becoming a necromancer and even placed [no phys att rust] in with the human file in the creatures folder, and it still didn't allow me to increase my speed at all for either. Hope this helps.

== Drowning ==

Do necromancers drown while in water? I know that werebeasts (when transformed) and vamps dont't. But, I was swimming in the sewers for a quest (living hell, kept seeing drowning sign and I thought I would die) and even though it said drowning, I didn't seem to drown, even after being under for quite a while.

Thanks for the help.

I just took my necromancer for a swim and he drowned alright.--[[Special:Contributions/77.190.67.208|77.190.67.208]] 01:22, 17 December 2012 (UTC)

== Adventurer Civ Relations? ==

As of my writing this, the Adventure Mode section of this page mentions the following:

"while a necromancer can still be friendly to mortals, its minions will attack everything in sight. This attack will cause the civilization to label you as an enemy for your undead minions' actions."

I strongly believe that your zombie minions attacking any individual don't label you as an enemy to that civilization. I have brought several dozen animated corpses to a hamlet and and have had no problem engaging in conversation with the townsfolk there, even as they were being slaughtered by my companions. I wanted to change it right now, but I thought it would be better to have others verify this before I post anything.

Also, if you have living AND dead companions simultaneously, they will both fight each other, but never actually target you. However, if you attack a corpse companion, ALL of your allies, living and dead, will no longer follow you. Living companions will become hostile to you, making you an enemy of each civilization they belonged to.

Again, just putting this here first to be peer-reviewed.

--[[User:RedReign|RedReign]] ([[User talk:RedReign|talk]]) 02:03, 18 May 2013 (UTC)

== Vampire Necromancers: Is it possible? ==

i've been trying in vain to become a vampire with my human necromancer. i've hunted down four different vampires and drunk alot (maybe 50 units of blood) with the lowest disease resistance i could get. am i just being a moron, or is this actually impossible? im running 0.34.11

My current adventurer is a vampire necromancer, but he became a vampire first.

'''No, the order has to be Vampire > Necromancer. Necromancers don't drink, so consuming vampire blood has no effect.'''

:Actually that last statement is incorrect. Necromancers don't '''need''' to drink, sleep or eat, but they can and will, if you give the order. A Necromancer that later becomes a Vampire is possible (actually I have done it).--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 17:23, 23 March 2014 (UTC)

== Elven/Goblin Necromancer impossible ==

Because elves and goblins are immortal, they don't seek to become necromancers, and so none will be generated in world gen.

I believe this also prohibits elven/goblin adventurers from getting the 'raise corpse' acquired power, as I failed to acquire it after I read several 'secrets of life ad death' books and the slab.

Wondering if anyone knows a workaround, perhaps in the raws?

-- PS. Right, further poking about in the raws revealed this:

[INTERACTION:EXAMPLE SECRET]
...
[I_TARGET:A:CREATURE]
[IT_LOCATION:CONTEXT_CREATURE]
'''[IT_REQUIRES:MORTAL]'''
[IT_REQUIRES:CAN_LEARN]
[IT_REQUIRES:CAN_SPEAK]
...

So, to become a necromancer, you must be mortal.
I would guess that either adding a [MAXAGE:###:###] tag to your creatre raw, or removing the [IT_REQUIRES:MORTAL] tag from the Interaction would be a workaround.

Would be interested to know if you can apply this in a live game.

-- PPS.

From my testing, it appears that neither adding a MAXAGE nor removing [IT_REQUIRES:MORTAL] seems to work ('''In a live setting!'''). Would appreciate seperate confirmation and other possible solutions.

'''Have you generated a new world after editing the RAWs? That is necessary for changes to take effect.'''

v0.34:Adventurer mode

2014-03-18T01:48:14Z

Doktoro Reichard: /* What creatures of night can I become? */ - Correcting possible incorrection

{{Quality|Masterwork|00:47, 29 September 2013 (UTC)}}
{{av}}

:''This is a detailed reference guide for Adventurer Mode. For a tutorial see the [[Adventure mode quick start|Adventure Mode Quickstart Guide]].
:''See [[Adventure Mode quick reference]] to quickly look up key commands.

In '''Adventurer Mode''' (also called "adventure mode") you create a single adventurer ([[dwarf]], [[human]], or [[elf]]) who starts out somewhere in one of your generated worlds. You can receive [[quest]]s, venture into the wilderness to find [[cave]]s, shrines, lairs, abandoned towers, and other [[Site|towns and settlements]]. You can even visit your abandoned [[fortress]]es and find whatever riches were left to be guarded by the [[creature]]s that sealed their fate.

Unlike [[Fortress mode]], Adventurer Mode is a sort of advanced [http://en.wikipedia.org/wiki/Sandbox_game open world] version of [http://en.wikipedia.org/wiki/Rogue_%28computer_game%29 rogue] or [http://en.wikipedia.org/wiki/Nethack nethack] taking place in the same procedurally generated worlds used for Fortress Mode, but you control a single character in a turn-based manner rather than manage a group of creatures acting in real time.

=World Selection=

You can play Adventurer mode in any world that has a civilization with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token (which are elf, dwarf, and human in unmodded raws) but as of the current version only human civilizations have towns, NPC fortresses, or shops {{v|0.34.07}}. Elves simply live in the forest with nothing but a few named trees to mark their homes, while Mountainhomes that dwarves live in tend to just be a few dwarves in open space. As a result you need at least one human civilization if you want quests or anything but basic wilderness survival. Alternately, you can alter the other races to also use human towns -- see the talk page under "Dwarven Fortresses."

If you have previously built a fort in the world that you select, your adventurer will be able to go visit it. However, the fort must be abandoned because you will not be able to start an adventure mode game in the same world with an active fortress mode game. Note, though, that you can always save your fortress mode game, duplicate the save folder (copy ''regionX'' to ''regionX-copy'' or something), abandon the fortress in the copy of the world, then start adventure mode in the new clone world.

=Character Creation=

==Race and Civilization==

Any race with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token is playable in adventure mode. In an unmodded game, this means [[Dwarves]], [[Elves]], and [[Human|Humans]]. All three races can complete the same quests.

*'''Humans''' Always originate from one of the villages in the world. begin with bronze or iron weapons and can use any of the items sold by shopkeepers (who, for the time being, are only found in human towns and only sell human-sized clothing/armor). They also start with the widest variety of weapon skills.

*'''Human Outsiders''' Human Outsiders are humans that aren't from that world or any of its villages. They simply appear in the wilderness, a stranger to all. You may always play as an outsider, even if the world is otherwise completely uninhabited. Outsiders can only start with Spear User and Knife User as weapon skills, and they cannot start with Armor User or Shield User. They also start out literally naked with no clothing, but can wear any human-sized armor that they trade for, steal, or loot. "Outsiders" of other races can be played if you add the [[Entity_token#Gameplay|INDIV_CONTROLLABLE]] token to the race's entity definition.

*'''Dwarves''' have the advantage of being able to go into a [[Martial trance|martial trance]] when fighting multiple foes at once. This gives them many combat bonuses, which aids their survival greatly. They are the only race which can start with steel weapons, but they wear "small" sized clothing (like goblins and elves) which means that they're unable to wear human clothing and armour found in shops. Goblin amour will fit them so its usually easy enough to find some armour since you'll run into a lot of hostile goblins during quests. They can start with almost all of the same weapon skills as civilized humans. Most human-sized weapons (such as long swords) must be wielded two-handed by dwarves, due to their size.

*'''Elves''' start with very weak wooden weapons and have a more limited list of weapon skills during character creation. They have the advantage that they have higher natural speed. Elves also have the AT_PEACE_WITH_NATURE tag. This makes all wildlife passive towards them. Like dwarves they wear small sized clothing so will have the same problem finding suitable armour in shops.

*'''Kobolds''' can be played only if there are no other civilizations and there are kobolds. They are very small and weak in combat and a huge challenge compared to the other races. They wear even smaller armour than the other races and armour will be impossible to find for them, unless you are absurdly lucky and run into armoured kobolds.

If no civilization for the given race exists in a world you can only play as an outsider.

== Status ==

Determines the number of starting skill and attribute points, which does not change based on race:
*'''Peasant:''' 15 attribute, 35 skill
*'''Hero:''' 35 attribute, 95 skill
*'''Demigod:''' 105 attribute, 161 skill
The number of skill points is less significant than the number of attribute points because the time it takes to go from Peasant to Demigod in skill terms is much less than what it would take to go from Peasant to Demigod in attribute terms.

== Starting Attributes ==

[[Attribute|Attributes]] are divided into Body and Soul attributes. This section provides some guidance for allocating attributes as it relates to adventurer mode.

=== Body ===

*'''Strength''': Alters the damage you inflict in melee regardless of weapon used. Increases muscle size. This increased muscular layer helps prevent damage, although this is a pretty minor effect. Increasing strength, at least in adventurers, increases movement speed (albeit not as much as agility) due to better carrying capacity.
*'''Agility''': This attribute is directly related to a character's Speed and is also used in combat skills. Agility is really, really important as being faster than the enemies allows you to get more hits in before they can fight back and lets you run away more easily.
*'''Toughness''': Reduces physical damage inflicted on you. Also relates to defensive combat skills.
*'''Endurance''': Reduces the rate at which the adventurer becomes exhausted. Becoming exhausted causes you to collapse, helpless and immobile and can cause you to pass out.
*'''Recuperation''': Increases the rate of wound healing. Not as important as Toughness. Recuperation isn't that useful in adventurer mode since you usually have as much time to rest as you need assuming you can escape a situation alive.
*'''Disease Resistance''': Reduces the risk of disease. Useful for fighting enemies who use poisoned weapons.

=== Soul ===

Some of these are useful for adventure-mode-applicable skills, but some are totally useless except as dump stats.

*'''Analytical Ability''': Useful only for Knapping. Might as well reduce it to very low.

*'''Focus''': Affects Archer, Ambusher, Observer.

*'''Willpower''': Affects Fighter, Crutch Walker and Swimmer. Willpower is really important as it governs how easily you'll pass out from extreme pain. Low willpower is a death sentence if you are seriously wounded, as you'll pass out and have your head caved in. Broken bones currently cause enough pain that even very high willpower usually won't keep you concious. For non bone injuries however willpower can keep you going long enough to kill enemies, or at least get away from them.

*'''Creativity''': Completely useless.

*'''Intuition''': Only helps with Observer, which aids in spotting concealed enemies and ambushes. A useless skill since you rarely see these in adventure mode.

*'''Patience''':Currently useless.

*'''Memory''': Memory aids greatly in mapping out areas as the higher your memory the longer you'll remember an area. As you explore you'll forget previously explored areas, causing them to appear blank, as if you had never been there. If you have low enough memory you'll forget areas of large locations like underground catacombs while you're still in them, making finding your way very confusing, as things like the exit wont be visible anymore until you find it again. Best to have at least average memory.

*'''Linguistic Ability''': Currently useless.

*'''Spatial Sense''': Important. Affects combat skills, Ambusher, Crutch Walker, Swimmer, Observer, Knapping.

*'''Musicality''': Completely useless. Use this as a dump stat.

*'''Kinaesthetic Sense''': Affects most combat skills, walking with crutches and swimming.

*'''Empathy''': Might increase chance of persuading people to join you.{{Verify}}

*'''Social Awareness''': Increases the number of followers you can have at a given "fame" level. Normally you start with a limit of two. Increasing this stat by one level raises that to three. Your fame still plays a bit part in whenever you can recruit followers or not.

=== Attribute Advancement Cap ===

Adventure mode attributes are capped at double the starting value or the starting value plus the racial average, whichever is greater. Humans, for example, have a racial average strength of 1,000. If a human adventurer starts with an ''above average'' strength of 1,100, then his strength will ultimately be capped at 2,200. Had this human started with a ''below average'' strength of 900, then his strength would be capped at 1,900 instead. For the purpose of maximizing final attributes, this makes it important to start with as many attributes in the ''superior'' range as possible (more attributes per point allocated), while avoiding taking any penalties to even remotely important attributes (big attribute deductions per point recovered). As a consequence of the attribute cap, demigod adventurers will always have a much higher potential for advancement than mere peasants and heroes.

== Starting Skills ==

Not all races have the same sets of skills available at character creation time, but keep in mind that all starting [[skill]]s, as well as ones not available at character creation, can be improved through use in game. [[Reader]] is an exception to this.

This section will specifically address starting skills as they relate to adventure mode. For a full description of combat skills see [[Combat skill]]. Other skills that you can't start with, but which can be increased in game (such as Butchery) are described elsewhere.

=== Weapon ===

The weapon you start out with will be based on which of these, plus the unarmed combat skills, is the highest. In other words, even if Swordsman is your highest weapon skill, you won't start with a sword if your Wrestler or Striker skills are better. Usually the best choice anyway is to specialize in just one melee weapon skill. Regardless of weapon skills, a '''large copper dagger''' will always be included in the starting equipment, which is handy for throwing at enemies that are just a step away or finishing off a foe pinned down by a stuck weapon.

Not all races/civilizations can start with all of these skills. (For example, Dwarves can't start with Bowman or Lasher).

Note that different races have different names for their weapon skills. Axegoblin, Axedwarf etc.

Crossbowman is a exception. Dwarves call this skill Marksdwarf, although bow skill is referred to as Bow Dwarf as you'd expect. Elite Axe and Hammer dwarves are refered to as Lords.

*'''Axeman''': allows characters to use axes, great axes, and halberds more effectively.
*'''Bowman''': skill allows characters to use bows more effectively.
*'''Crossbowman''': allows characters to use crossbows more effectively.
*'''Hammerman''': allows characters to use crossbows in melee, mauls, and war hammers more effectively.
*'''Knife User''' - allows characters to use large daggers and knives more effectively.
*'''Lasher''' - allows characters to use whips and scourges more effectively.
*'''Maceman''' - allows characters to use flails, maces, and morningstars more effectively.
*'''Pikeman''' - allows characters to use pikes more effectively.
*'''Spearman''' - allows characters to use spears more effectively.
*'''Swordsman''' - allows characters to use blowguns and bows in melee, long swords, scimitars, short swords, and two-handed swords more effectively.

=== General Combat ===

These two skills can be raised rather quickly in game and so you probably want to skip spending any points on them at the start.

*'''Fighter''' - This increases with, and contributes to, melee combat whether armed or unarmed. It appears that the purpose of it is to allow melee experience to contribute to melee combat in general regardless of weapon. Repeatedly wrestling (grabbing and releasing) even a small creature will raise this skill.
*'''Archer''' - This increases with, and contributes to, ranged combat including throwing. It works similarly to Fighter except for ranged attacks. It can be easily raised by repeatedly throwing rocks, making it advisable for archers to practice their marksmanship with rock throwing before using up the more finite and expensive forms of ammunition. Shooting at a wall with adjacent upward ramp one level below and picking back projectiles is also a good idea (such places often happen to be in castles). See the FAQ section on [[#powerleveling|powerleveling]] for information on raising bowman/marksman skills.

=== Defensive ===

These skills are critical for survival. Starting out with good ability in one (especially Shield User or Armor User) if not all is strongly advised.

*'''Shield User''' - Ability to block attacks with shields. Starting with even novice skill in this means that the adventurer will start with a shield. This is a no brainier unless you're creating a two handed weapon user.
*'''Armor User''': A higher level of this skill reduces the encumbrance penalties of armour, allowing you to move faster when wearing it. It also affects how well armour protects you and this makes a huge difference. Unskilled armour users gain little protection. This is noticeable as you'll begin seeing far more combat reports about hits either striking you though armour, (you managed to use your armour to lessen the force of the blow) or being deflected by your armour (you used your amour to avoid the hit entirety) as your skill rises and you learn to actually use your armour to deflect hits. It is highly advised to train your armour skill before entering battle with it as the speed penalties of lower levels can be a serious handicap.
*'''Dodger''' - Ability to dodge out of the way of attacks. Dodger is incredibly important and will allow you to avoid many, many hits that would have otherwise injured you. Especially important when you are fighting unarmoured and can't afford a battle axe in the chest. Boost this to talented or at least close to it.

=== Unarmed Combat and Improvised Weapons ===

While some of them come in handy at times, they can generally be raised fairly easily in game, especially Wrestler and Thrower.

*'''Wrestler''' - Ability to grapple, restrain, take-down, throw opponents, etc. Higher skill means all of these moves succeed more often. See [[#Wrestling and Unarmed Attacks]] for details. Can be raised very easily in game.
*'''Striker''' - Punching ability. Turns handy when weapons get stuck and there is no time to wrest them back.
*'''Kicker''' - Kicking ability. Same as Striker. Kicks tend to cause a lot more damage than punches and cave in heads often.
*'''Biter''' - Biting ability. Biting is surprisingly effective even with non animal races as after biting you can shake opponents around by your teeth, causing great damage and possibly ripping off body parts.
*'''Thrower''' - Throwing any miscellaneous object including rocks, knives, axes, swords, heads, etc. Skill affects accuracy and damage caused.
*'''Misc. Object User''' - Ability to beat things to death with anything that comes at hand, from bags to coins to their own severed body parts. Also somewhat more commonly used for shield bashing. This skill affects combat with any object, from a rock to a beehive. there are no separate skills for different items

=== Movement and Awareness ===

*'''[[Observer]]''' - Helps one to notice things like ambushes, enemies who are "sneaking" (stealth movement), and traps. Detection range increases with skill, but up to a maximum of 3 tiles away. Hard to train. Adding some points here is advisable.
*'''[[Swimmer]]''' - Allows movement through water without drowning. A Novice swimmer can swim but will revert to being unable to swim if stunned, which happens when falling even 1 z-level into the water, or possibly after an unfriendly encounter with a creature in the water. An Adequate swimmer can swim normally (not drown) while stunned. For this reason, ''starting out as an Adequate swimmer is advisable.'' If you don't, at least start as Novice and go get some swimming practice right away.
*'''[[Ambusher]]''' - The skill of {{K|S}}neaking around unobserved. This can be raised fairly easily by sneaking around while traveling from place to place when speed is not important. At lower skill levels, speed is greatly reduced, but the penalty gradually reduces until negated at Legendary skill and it's possible to sneak at full movement rate. Chance of detection is also reduced at higher skill levels; a more skilled ambusher can remain in close combat for longer without being detected. It is worth noting that ambusher only is checked once the adventurer is 3 tiles or closer to the enemy - at 4 tiles and up, you will remain hidden from the enemy even if you have no skill in Ambusher, as long as you are sneaking.

=== Crafting ===

These allow your character to create things. There is only one skill currently available in an unmodified game.

*'''[[Knapper]]''' - The fine art of sharpening rocks by banging them together in a clever manner. The resulting rocks become sharp rocks which do more damage when thrown and can be used for things requiring a sharp edge like butchering. Easy to raise in game and doing so helps with Kinesthetic and Spatial Sense.

=== Other ===

*'''[[Reader]]''' - Allows you to read books, signs, and writing in Adventurer mode. Novice level is required in order to become a [[Necromancer]]. There is no way to increase this skill. Adding more points is a waste, as novice allows you to read anything.
*'''[[Butcher]]''' - The art of turning corpses into piles of delicious prepared brains and meat for food. You cannot allocate points here during character creation, but that's OK since skill doesn't really affect anything anyway.

= Gameplay =

== Common UI Concepts ==
{{KeyConventions|3}}

== Moving Around ==

=== Local Movement ===
[[File:adventure-local-map.png|thumb|400px|The local travel screen. The lower left shows a small overview map of the area. The upper right shows a small area 1 z-level above the adventurer in the middle. The adventurer is standing in front of the door to a house full of humans, and visibility behind the house is obscured. In the upper left is a small box showing the direction to various sites (which may be quite far away).]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Move
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Move
|-
| {{k|Alt}} and a direction key
| Move carefully / Deliberately enter dangerous terrain
|-
| {{k|<}} or {{k|Shift}}+{{key|5}} (num lock off)
| Ascend
|-
| {{k|>}} or {{k|Ctrl}}+{{key|5}} (num lock off)
| Descend
|-
| {{k|.}}
| Wait for a step
|-
| {{k|s}}
| Stand or lie down
|-
| {{k|S}}
| Sneak
|}

Unless your character is an outsider, you will start out in a human town or hamlet; in the standard tileset the @ sign is your character. In the lower left-hand corner of the screen is a mini-map, with the @ sign showing your relative location to other things in the town/hamlet. The ▐ symbols are small collections of buildings.

The directional keys allow movement. Diagonal movement is particularly important especially when chasing or running away from things.

Use {{k|Alt}}+direction to enter water, jump off of cliffs, or otherwise attempt to enter anything that you can't enter using normal movement commands. Note that when entering water it's best to enter the actual water and not the open space over the water as, in the later case, you will fall in causing you to become stunned which may lead to drowning.

Hitting {{k|.}} allows you to stay in one place and wait for other things to move.

Use {{k|s}} to sit/lie down. Moving while laying down (crawling) will let you move past NPCs which are standing in your way. Also note that you will frequently get knocked to the ground in combat, and if you don't hit {{k|s}} to stand back up then you will crawl slowly along the ground, giving your opponent a lot of opportunity to attack you.

{{k|S}}neak will allow you to move around invisibly, limited by your Ambusher skill and the Observer skill of nearby creatures. The closer you get to a creature, the more likely you are to be detected. Your movement rate will also be very slow at low Ambusher skill levels while sneaking. If you are within observation range of anything then you will be unable to go into stealth mode. Hiding somewhere you can't be seen (such as the inside edge of a murky pool, if you can swim) will allow you to go into stealth mode when creatures are around. Stealth mode will also allow you to move onto/through townsfolk.

=== Fast Travel ===
[[Image:adventurer-fast-travel.png|thumb|400px|Fast Travel screen. A fort is on the west side, and a town is on the east side of the map. The regional map is displayed on the far right.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|T}}
| Fast Travel
|-
| {{k|>}}
| Exit fast travel mode
|}

Entering Fast Travel mode will allow you to move large distances in a single keypress. Of course, the same amount of time will go by and you can also be interrupted (ambushed) while moving in fast travel mode.

See the [[Map legend]] for information on what the map symbols mean. Settlements are indicated by {{Tile|■|7:0:1}} tiles and you can find houses by exiting fast travel while standing on one of these tiles. Yellow tiles of the same shape {{Tile|■|6:0:1}} indicate the presence of shops rather than houses.

Pressing {{K|m}} will put a fully zoomed-out map on the right side of the screen, with your current location marked by a blinking "X". When seeking out a quest, move in the direction of the quest site until the blinking "X" is on top of the symbols indicated in the Adventure Log (you can press {{K|Q}} at any time to look at it again).

Along the top of the map is a line showing the sky, and the position of the sun and/or moon from west to east. This primarily helps you determine how long you have before it gets dark at which point you won't be able to see very far and will be more vulnerable to attack.

While in the fast travel screen you can:

* {{k|c}} - Display/hide clouds/weather
* {{k|m}} - Display/hide the regional map on the right
* {{k|Q}} - Display the Quest log
* {{k|Z}} - Display the sleep menu

Other commands are not available until you exit fast travel with {{k|>}}.

== Status and Information ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|l}}
| Look around
|-
| {{k|Space}}
| Advance/Clear Messages
|-
| {{k|a}}
| View Announcements
|-
| {{k|z}}
| Status
|}

=== Looking Around ===

If you're not sure what a tile is, the {{k|l}}ook command will tell you. In addition to being useful for identifying tiles and creatures, you can also view creatures' equipment and what items are sitting on the ground in a given tile. If in doubt, try the look command.

Move the cursor to the tile you want to look at using direction keys and {{k|Shift}}+direction. It's possible to look up and down z-levels (assuming you have line of sight) using the {{k|<}} and {{k|>}} keys. This, for example, allows you to find out if any flying creatures are above you. Hit {{k|Esc}} to exit look mode and go back to movement mode.

=== Messages ===

The game makes frequent use of messages on the screen to tell you what is going on. If there are a lot of these you may need to use {{k|Space}} to display the rest of the messages that won't fit on the screen. You can always go back and view old messages by pressing {{k|a}}.

=== Status Screen ===

This screen shows your skills, attributes, wounded body parts, health (along with more detailed descriptions of your wounds), lets you view your description, and change your nickname if you want.

=== Saving the Game ===

Hit the {{k|Esc}} key at any time and select {{DFtext|Save Game}} to save your game. You can then come back to it later by using the {{DFtext|Continue Playing}} option in the main menu.

== Searching and Manipulating ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|u}}
| Interact with building, furniture, or mechanism
|-
| {{k|L}}
| Search the nearby area very carefully
|}

The {{k|u}} key can be used to do stuff like pull levers in your abandoned forts. It is also used to lower and raise the bucket when standing right next to a well so you can get water to refill your waterskin with.

{{k|L}} will perform a thorough search of the area that you're standing in, possibly revealing some small creatures.

== Managing Equipment ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|i}}
| Show Inventory
|-
| {{k|d}}
| Drop an item
|-
| {{k|g}}
| Get (pickup) an item off the ground
|-
| {{k|p}}
| Put an item into a container
|-
| {{k|r}}
| Remove an item you are wearing or from a container
|-
| {{k|w}}
| Wear an item
|-
| {{k|I}}
| Interact with an object in an advanced way. (unstick a weapon, refill waterskin etc)
|}

=== Inventory ===

Press {{k|i}} to display a list of what you are currently carrying. Press {{k|-}} {{k|+}} to scroll the list. This list will show you if items are being worn, held in hands, stuck on your body, or are inside a container. Detailed information about an object can be viewed by pressing the key associated with the item.

=== Getting/Dropping Things ===

You can {{k|d}}rop items in your inventory, as well as {{k|g}}et items on the ground on the same tile that you are standing on. If there is more than one item a menu will be listed. Press {{k|-}} {{k|+}} to scroll the list if the list is too long to fit on the screen.

{{k|g}} will also allow you to ignite foliage/any flammable objects adjacent to you. Fires aren't as devastating as one might imagine, but they will cause (most)enemies to path around them, making your crowd control slightly more effective when taking on multiple enemies. As an added bonus, it will also surely piss off the elves.

=== Containers ===

Items can be placed into containers with {{k|p}} and removed with {{k|r}}.

=== Wearing ===

Items can be worn using {{k|w}} and removed using {{k|r}} (the same command used for removing from containers). If an item you want to wear does not show up as an option, then it means you are already wearing too many items in the location used by that item. Try {{K|r}}emoving items in that location and then wear them again in order of priority. You also must put on equipment in an order that makes sense,. for example a shirt first ''then'' the armor, not the other way around. Armour must also be put on in a sensible manner with flexible layers such as chainmail first then rigid plate armour second. After all who in real life would wear chainmail over a hard plate?

''Note that "large" or "small" clothing items are too big / small for your race'' (e.g. a '''large''' giant cave spider silk sock). If you have that problem, try getting clothing from a different source.

After acquiring [[armor]] from one source or another, you'll most likely want to equip it. To do this, first make sure it is in your possession--not on the ground. You can then {{key|w}}ear it, granted you don't already have too much on that equipment slot already. You can {{key|r}}emove or {{key|d}}rop inferior equipment as necessary.

See [[Armor]] for more information on wearing things. One thing to note in particular, DF allows you to wear more than one item in the same location in many situations, for example a copper mail shirt and a copper breastplate. The thin, flexible chain can be worn under the breastplate, but not the other way around.

=== Wielding ===

There is no command for wielding items such as [[weapon]]s in specific hands. Instead, they are automatically equipped when you either {{k|g}}et them from the ground or {{k|r}}emove them from your [[backpack]] - provided the hand that would wield them is free. So in order to change [[weapon]]s or [[shield]]s you should drop items or place them into containers (such as your backpack) until your hands are free, then get items from the floor or remove them from containers which will place them in your hands. For example, put all items into backpack, remove sword from backpack, remove shield from backpack. The items will end up in the right and left hand. Simply remember the {{k|r}}emove command and the {{k|p}}ut into container command.

While normally one would only be able to equip one item in each hand, removing items from your inventory results in them being wielded regardless of whether one's hands are full. This is especially useful with shields, as every shield will contribute a block chance to each incoming attack.

It should be noted that the world of DF seems to have a lot of left handers, so do not be surprised if your character holds the weapon with the left hand and the [[Armor#Shields and Bucklers|shield]] with the right hand.

=== Advanced Interaction ===

The {{k|I}} key allows "complex interaction" with objects in your inventory.

This is used for removing arrows and weapons stuck in wounds which will appear in your inventory when they become stuck in you. Removing stuck arrows can cause bleeding so it is not always a good idea mid combat, but stuck objects will slow you down as you are encumbered by their weight. It s best to remove them as soon as possible when it is safe and you are not in danger of bleeding to death.

Advanced interaction can also be used to steal enemy equipment. Use [[wrestling]] to grab hold of a piece of enemy equipment, such as their weapon, or a helmet protecting their squishy brain and it will appear in the advanced interaction menu. Simply select it and choose "gain possession". if successful you'll take it from them. This can be very useful in battle.

This command is particularly useful for getting water. When standing next to a well you press the {{k|u}} key to lower, then raise the bucket, yielding 10 units of water in the bucket. Then you can press the {{k|I}} key to fill your waterskin from the full bucket (alternatively you can press the {{k|e}} key to drink directly from the bucket).

Advanced interactions can be used next to a campfire to heat things, such as any frozen liquids you have in your inventory(or snow lying on the ground) and need to drink. You can refill waterskins. from a nearby liquid source as well

== Time and Weather ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|D}}
| Date/Time
|-
| {{k|P}}
| Temperature
|-
| {{k|W}}
| Weather
|}

The game has a day/night cycle with time passing as various actions take place.

When using quick travel mode, the top line of the screen will indicate the position of the sun in the sky with a yellow "☼"; further to the right of the screen is earlier in the day and further to the left is later in the day.

In local travel mode you'll have to use the {{k|W}} command.

At night you won't be able to see nearly as well and you will be more vulnerable to ambush.

The game also has weather and temperature. The most common weather you'll experience is rain. Rain is shown as blue moving dots on the local travel screen and will unsurprisingly cause everything outside to become wet. Wet vegetation cannot be set on fire and you cannot light campfires in rain. Temperature is important because if it happens to drop below freezing while you're swimming through water, you'll instantly die from being encased in the ice.

Therefore you might want to keep an eye on the temperature while swimming, especially if it's getting cold.

Also, unlike fortress mode, rivers/other bodies of water can be liquid during the day, and freeze at night. The cycles of freezing can also be erratic from day to day.

Freezing weather can also freeze liquids in your inventory solid, making them undrinkable. If your water freezes and you are thirsty, try hunting down nearby enemies and slicing them up so you can drink their warm, unfrozen blood instead.

== Sleep ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Z}}
| Sleep
|}

Eventually your character will become {{DFtext|Drowsy|3:1}} and this will get worse until you get sufficient sleep.

Sleep does not necessarily have to coincide with night, but if you're traveling alone when night comes you'll be in danger of being attacked by [[Bogeymen]]. To avoid this while traveling solo you need to make it to shelter before nightfall and sleep the night away inside a building or abandoned lair. Enter a building, use {{K|k}} to talk to a human, and ask for permission to stay the night. Next press {{K|Z}} to sleep, {{K|d}} to sleep until dawn, then {{K|Enter}} to confirm. ('''NOTE''': If you stay the night in a castle, you have to sleep in the keep which houses the lord/lady of the castle. Sleeping inside the castle but outside the keep still leaves you vulnerable to attack.) Sleeping on an ocean beach also prevents bogeymen from attacking. ('''NOTE''': You can disable bogeymen by generating a world using [[advanced world generation]] and setting "Number of Night creatures" to 0)

Though sleeping inside can be safe, it's also limiting: any quest site you want to go to has to be within a daytime's round-trip time of a safe habitation, and you have to make your way to there by hopping from one habitation to the next, sleeping at each along the way. A way to avoid this is to travel with companions. If you have any companions with you then Bogeymen won't attack you. You'll still have to sleep at night, though, both to avoid sleep deprivation and because there's no visibility at night. You can still be ambushed at night by wildlife, but that's much less likely than being ambushed by Bogeymen when traveling alone. If you find yourself alone at night with nowhere safe to sleep, the safest bet is to keep traveling until dawn, even if that means running around in circles. You will eventually feel unwell from sleep deprivation, but this can take a considerable amount of time. You can make up for lost sleep once you've found your way to safety.

Note that sleeping in lairs, shrines, and labyrinths makes you safe from ambush, assuming that you or someone else has killed whatever was living there. If you have sufficient shrines/lairs/etc between you and your goal and they are either uninhabited or inhabited by things you are capable of killing then you can travel from lair to lair using each lair as a safe lodging. This is much safer than sleeping out in the open, day or night, even with companions.

If no other options are available, completely surrounding yourself with campfires will keep night marauders at bay as they cannot pass through the fires; the fires will go out after several hours and enable you to move on. The bogeymen or other enemies may be outside your line of sight, which will prevent you from firing arrows or throwing things at them. In this case, you will have to stand up and lie down {{K|s}} repeatedly until the enemies wander into your range, the fires go out and the enemies can path to you, or dawn breaks.

== Food and Drink ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|e}}
| Eat or drink something
|}

The easiest way to stay hydrated and full when starting out is by finding and fighting something weak (say, a vulture, or a raccoon, or a fox). You will almost certainly end up covered in blood. You can drink any liquid covering you using 'e' and then simply selecting the fluid - perhaps a little salty in real life, but in Dwarf Fortress it works. The corpse can then be butchered {{k|x}} for edible parts, to cure your hunger - the first two problems are solved.

Note that drinking vampire blood will turn you into a vampire instantly.

Make sure to eat or drink regularly even if you're not hungry or thirsty, as you can only eat or drink three times in a row: after that you'll need to rest,or wait until you can consume another meal. If you find yourself in need of both food and hydration, make sure to take care of the most urgent problem first, as if you are moderately hungry but severely dehydrated and eat three times, you might be already dead by the time you can drink again.

== Combat ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Attack adjacent hostile creature
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Attack adjacent hostile creature
|-
| {{k|A}}
| Attack an adjacent creature.
|-
| {{k|A}} then {{k|Enter}}
| Wrestle an adjacent creature.
|-
| {{k|f}}
| Fire a projectile
|-
| {{k|t}}
| Throw an item
|-
| {{k|C}}
| Open combat preferences interface
|}

[[Combat]] is the fine art of using physical force to cause injury and death, and it is particularly fun in Dwarf Fortress.

=== Melee Attacks ===

Hostile creatures can be attacked using a non-aimed attack by simply advancing towards your enemy using the arrow keys. Doing a non-aimed attack will also free up any stuck weapon.

Any creature can be attacked by standing next to it and pressing {{k|Shift}}+{{k|A}}. Attacking a friendly or unconscious creature (which includes wild animals for elves) will further require a confirmation, given using {{k|alt}}+{{k|y}}.

Attacking a creature with {{k|A}} will allow you to make an '''aimed attack'''. You must first select the body part that you want to attack. Look at the difficulty rating for various possible attacks. Impossible attacks will be impossible to land and Easier attacks will be very easy to land. The difficulty rating for an attack does not change depending on your weapon skill. Based on player experiences, a Grand Master weapon user can almost always land a "Tricky" strike, while a Novice generally cannot. Attacks on various locations will also have limits on how "squarely" they can land (due to being out of reach, for example). Square and very square attacks will deal more damage.{{Verify}} Attacks which "can't land squarely" are generally still effective.

Attacks aimed at the head are the most effective; a single attack to the cranium with a weapon will usually put an end to the fight. Aimed attacks are especially useful for dismembering opponents. Opponents who are missing a foot will fall over, thereby greatly lowering their speed, and giving you an immediate edge in the fight. Cutting off both hands also highly recommended for obvious reasons. After all, a field full of armless, one-legged enemies can be a big experience booster for your companions.

Aimed attacks are also especially helpful when fighting giant beasts. Some enemies like giant desert scorpions have lots of redundant body parts, and random attacks waste valuable time on low priority areas while the scorpion is busy injecting venom into the whole party. Very large enemies, like giants and hydras, are too tall for effective strikes at the head. Fighting such beasts with random attacks will prove mostly futile until the monster has been knocked over, either due to spinal injuries or loss of feet. Lastly, aimed attacks allow you to grab trophies that are not available via butchering. For example, a minotaur's horns can be cut off during a fight, but since its a humanoid, most adventurers will refuse to butcher its corpse after the fight.

=== Ranged Attacks ===

To attack with a ranged weapon press the {{k|f}} key with a ranged weapon (bow, crossbow, etc.) equipped on one hand and select the square where you want to attack. Note that you need to have some sort of ammo, corresponding to the type of ranged weapon you are using (for example, bows use arrows, crossbows use bolts). Otherwise, a message stating "You have nothing left to fire." is displayed in brown. Similarly use the {{k|t}} key to throw any random object in the same manner. Random objects appear to make a random attack if they happen to have more than one possible type.{{Verify}} For example, if you throw a sword it may hit with a blunt impact, a stabbing impact, or a slicing impact. Throwing crossbow bolts with sufficient throwing skill and strength seems to have an effect similar to firing them, although less powerful. On the plus side, you will never lose ammo if you throw it.

It is not possible to aim for specific body parts with ranged or thrown attacks.

Throwing is generally a good skill to have for any adventurer, as it allows you to slow down fleeing foes, both on the ground and in the air without the need of equipping a (cross)bow. Just like {{k|l}}ooking, you can use throwing to view and hit enemies multiple Z levels away from you. If you're lucky, you can simply land a hit that causes the flying enemy to give in to pain, and then let gravity do the rest of the work. Even if the fall doesn't kill them, they will most likely be stunned long enough for you to run up and slaughter them.

=== Wrestling and Unarmed Attacks ===

:''Main article: [[Wrestling]]''

'''[[Wrestling]]''' (grappling) can be performed by standing next to an enemy and pressing {{k|A}} followed by {{k|Enter}} to switch to wrestling. You can wrestle any enemy. Wrestling works somewhat like a targeted attack. Once you grab a creature by some body part, you may be able to make another wrestling attempt that will allow you to perform a throw or takedown.

For a detailed list of moves such as takedowns, throws, choke holds, etc, see [[Wrestling]].

It's also possible to punch, kick, and bite. These are not in the wrestling menu but are performed like normal targeted attacks with {{k|A}}.

=== Weapons ===

[[Weapon]]s are basically divided into axe, sword, spear, pike, mace, whip, bow and hammer, with various versions of these taking up the gray area.

=== Wounds ===

If you get wounded during combat, there's not much that you can do except perhaps run before you get more wounded. Your wounds will heal over time, so just travel around or sleep in a safe place. Some wounds however may never heal, leaving you permanently crippled. Obtaining a crutch may help with this. Or if you are not already a vampire, then you can get bitten by a werebeast during full moon, which will heal all injuries once per month.

If you have some bolts or arrows stuck in your body, they can be removed by using the complex interaction menu {{k|I}}. Select the stuck bolt or arrow from the list and then pull it out with {{k|a}} You'll probably start bleeding after you pull it out, but the bleeding is rarely anything to worry about.

=== Combat Preferences ===

At any time during gameplay (Except travel mode), you can press {{k|C}} to open the Combat Preferences menu. There are three different preferences you can set: Attack, Dodge and Charge Defense. These have a few different preferences each:

*'''{{k|a}}ttack'''
**'''According to Opponent''' - The default setting. When set to this, charging happens more or less frequently, depending on the difference in size between you and the opponent. Bigger opponents get charged less, smaller more often. Can be very risky, since a random charge against a huge opponent is likely to get you knocked down and stunned. In the same vein, charging when close to obstacles or other environmental hazards is very dangerous, potentially fatal, if the enemy dodges you.
**'''Strike''' - This setting ensures that you never charge an opponent, but rather just swing your weapon at them. This carries less risk than the above, but you're never going to knock anyone down without hitting their legs or spine. Very preferable against large opponents.
**'''Charge''' - When set to this, you ALWAYS charge. When faced with numerous small enemies (Bogeymen in particular), this can be extremely useful, but remember to switch back when facing something bigger. Charging a large dragon is almost a certain death sentence.
**'''Close Combat''' - With this setting, all your auto-attacks are grapples. Generally not very useful, since the random nature of it tends to prevent you from actually doing any damage with it, but if you continually auto-attack a harmless creature with it your wrestling-skill will be legendary in no time.

*'''{{k|d}}odge'''
**'''Move Around''' - This means you can jump away from attacks, physically moving in a random direction. While this lets you dodge attacks more often, it can also result in you jumping into a wall or down a lake. If you're fighting in really tight spaces, you might want to switch it off.
**'''Stand Ground''' - As can be expected, you stand your ground. No jumping around, which is useful in the above situation, but risky in the open. If you have room for jumping around, go with Move Around, but otherwise this could be a good idea.

*'''{{k|c}}harge Defense'''
**'''According to Opponent''' - Again, the default setting. You're more likely to stand still against small enemies charging, but will probably prefer moving away from larger ones. Somewhat risky, in that even a somewhat small enemy can stun you by charging.
**'''Dodge Away''' - With this, you'll dodge away from charging enemies, if you can. It's not a sure bet, but it's very much worth it against enemies who like to charge. This is probably the most preferable mode, since you're not losing a whole lot by dodging a small foe charging, but dodging an angry night beast can save you from a world of pain.
**'''Stand Ground''' - If you're certain of your physical superiority to the opponent, you can safely choose this. Standing your ground like a real man/woman might feel hardcore, but getting knocked down in a fight can be extremely dangerous. It probably has some use against bogeymen though, since they're quite small. If you really are much bigger than the enemy, you'll end up knocking THEM down. Most of the time though, charges heavily favor the attacker, so dodging away is probably preferable.

Using Combat Preferences properly can actually save your hide, so it's worth fiddling with. Just don't forget that you've fiddled with them, since a malplaced charge or dodge could end up killing you.

== Talking ==
[[File:adventurer-talking.png|thumb|400px|Talking to someone in Adventurer mode.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|k}}
| Talk to somebody
|}

Now that you know how to kill people, you may also want to know how to talk to and otherwise interact with them in a less violent manner. While this is less entertaining, it can sometimes be useful.

Press {{k|k}} to enter tal{{k|k}} mode. Move the cursor over a being and a list of language-capable beings on that tile will be shown in the lower left of the screen. If there is more than one creature on the tile, you can select the one you want to talk to using the {{k|-}}/{{k|+}} keys. Hit {{k|Enter}} to begin the conversation.

Normally you will need to Greet someone first, then you will have the following options when it comes to subjects of discussion:
*'''Trade''' - Attempt to initiate [[#Shops|trade]]. This only works for NPCs in shops.
*'''Join''' - Ask the individual to join you as one of your [[#Companions|Companions]]. Soldiers will join you 100% of the time if you don't already have too many companions, but the chance of regular townsfolk joining you will be highly impacted by your reputation.
*'''Surroundings''' - Ask about sites and things in the general geographical area. This may reveal hidden sites (such as lairs) on the map, and may also reveal bits of history such as, "in 123 Urist McSucker founded Boatmurdered". This can be selected repeatedly to reveal multiple facts about the area.
*'''Capital''' - Ask where the capital of the current civilization is. As with the "Surroundings" topic, a random bit of the capital's history will also be given.
*'''Service''' - Ask for a [[#Quests|quest]].
*'''Profession''' - Ask the individual about their profession. If the person is willing to '''Join''' you, they will add a line such as, "How I long for some excitement in my life..."
*'''Family''' - Ask about a random family member. If the person has more than one family member then selecting this option repeatedly will eventually reveal all of them. Like "Surroundings", this can also reveal bits of information about history such as, "Gor Lorthor was my son. In 123, Gor Lorthor was struck down by Trogdor the Burninator."
*'''Accuse of being a night creature''' - If the individual is a vampire in hiding, then they will become hostile to all around them and will fight you. Note, if said vampire has a cult (vampire law-givers usually seem to) the cultists will reveal themselves as well and become hostile to any non-vampire (the one the cult is based around, that is), non-cultist they see, including you.
*'''Report success/spread news''' - This option will only appear once you have completed a quest. Selecting it will cause you to regale people with tales of your amazing adventures, increasing your fame/reputation level. After you have done this once, with one person, the option will not appear again anywhere in any conversation until another quest has been completed. Apparently, everyone is telepathic, and won't want to hear the same story again.
*'''Goodbye''' - End the conversation.

Sometimes other options may also appear. Experiment with them and see what happens.

== Companions ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|c}}
| View companion interface
|}

Companions are the guys who follow you around after you've asked them to Join and they've accepted. Your character will have a limit on the maximum number of companions that is based on fame/reputation level and the ''Social Awareness'' attribute. With average social awareness and the maximum level of fame, the limit is 19 companions.

You can use the {{k|c}} key to open up a list showing your companions and their relative position to you. This can be useful if one of them runs off somewhere and you want to find them. You can select specific companions who are in visual range in order to view them. This is the same as viewing them with {{k|l}}ook.

Short of using special utilities and hacks, you can't change your companions' equipment. When they die you can loot their corpses however. (One devious and evil way to get equipment is to intentionally get your companions killed and then take their stuff.)

However, if they survive long enough/are trained well enough they seem to be capable of leveling stats or skills in some way, and are susceptible to having title or job title changed as well.

Your companions will continue to follow you and fight hostile creatures around you until they either die or are left behind by entering fast travel mode while they are too far away from you. Companions with missing feet and legs will attempt to hobble along behind you. If you need to ditch '''ALL''' of your companions, retire your adventurer in a settlement, and start playing that adventurer again. You will lose all companions by doing this(as well as resetting your thirst/hunger/sleep needs.)

If you keep losing your companions while traveling through rivers, try going to a spot where the river becomes a "minor river(single dark blue line.)" Brooks are obviously also safe to cross.

== Civilization ==

Civilizations are organized groups of creatures (generally of the same race) which build sites such as towns.

=== Towns ===

Humans live in towns comprised of buildings and often a paved road. Human villages are highly modular. The small 5x5 buildings are citizen houses and shops.

Towns appear on the fast travel map as {{Tile|■|7:0:1}} or {{Tile|■|6:0:1}} symbols which are small collections of buildings. Yellow buildings indicate the presences of shops where you can trade. The buildings can be spaced rather far apart, so even when you get your @ on top of a {{Tile|■|7:0:1}} it might take some wandering about in local travel mode to find a building.

Once you find a building, step through the door. It should have multiple U's, each of which is a human.

=== Fortresses ===

Humans also live in fortresses which appear on the fast travel map as large buildings. You can't walk over them. Instead you must move over to what looks like the entrance, exit fast travel with {{k|>}}, and walk toward the direction of the fortress.

Fortresses, if they haven't been abandoned, will be populated by soldiers, a Lord or Lady of some sort, and possibly others. If they have been abandoned then they may be overrun by various wild animals. They do not contain shops.

If control of a civilization has been taken over by a Demon, the fortress may be empty except for that demon, who acts as the Lord. He will behave as any human lord. Sometimes in an abandoned fort you might also find a demon that is a prisoner, who you can actually recruit without any significant amount of fame. If they can be trusted or not is more or less up for debate, but it is still better than Urist McFaceplant.

=== Other Sites ===

'''Note:''' Currently, only humans have civilization sites.

Elves live out in the forest, literally. Although defined to specific regions on the map, they have no structural wealth whatsoever. Some trees are named.

Dwarves live underground. Their entrances are large square pits with stairs around the perimeter, and a row of leading down into the fortress halls at the bottom. The main halls are wide and have pillars near the walls, long and occasionally turn corners. Different levels in the fortress are marked by a row of ramps with two pillars on the side (walk towards the side of the ramp that has the pillars) and, although the number of floors in a fortress can vary, they are usually little and only become deep if the lay of the land above is variable. There are two-tile-wide hallways, empty 5x5 rooms, and scant Dwarves in these pre-fab fortresses. It's obvious the computer is playing a completely different game than you are in [[Fortress mode]]!

Goblins live in [[obsidian]] towers, usually found built in twos, though they both don't necessarily have to be built up. One could be a "tower," one could be an over-glorified "basement." There is probably a temple nearby, completely similar to human temples. Goblin towers have tight 1-wide hallways, spacious and empty rooms, and strange hall extensions that end in remote cross-like dead-ends. Like dwarf fortresses, there is rarely anything in a Goblin tower asides from Goblins, and they have a strange tendency not to attack non-Goblin visitors. They seem to have lots of children.

You may come across what the map defines as a "Goblin" city that is actually populated by Humans or Dwarves living in or around the towers.

=== Shops ===

==== Trading (barter) ====
In human towns (not hamlets or castles), you can find [[building|shops]]. Once you're inside of a shop and right next to any of the NPCs, you can use {{K|k}} to talk to him/her, then select trade. Use {{K|Enter}} to select which items to trade, left/right arrow keys to switch between the list of shop items and your items, and up/down arrow keys to scroll through the lists. Once done, press {{K|t}} to trade. The shopkeeper won't get angry if you're not offering enough in trade, so you can start offering just a few items, keep trying again with a little more until the trade is accepted. Once the trade is accepted all of the items you offered will be on the floor underneath you.

After buying an item, you must pick it up manually from somewhere in the shop. {{K|l}}ook around for an item without $ signs around it. If NPCs are standing directly over the items you just bought, go prone with the {{K|s}} key so you can move onto the same space as them and pick them up.

Due to some limitations, there are only "human town" shopkeepers in a pre-fab Adventure mode civilization.

====Theft====
You may also pick up the item before buying it, but you should never walk out of a shop carrying an unbought item, as that is theft. It is punishable by death if you are caught, and excommunication if you are not. On any occasion when you have stolen goods from a store, i.e. goods bounded by the $$ signs, the game requires you to exit the site ''and'' move a considerable distance before allowing you to quick travel. This may make a getaway more difficult if your adventurer is not already faster than anyone else. This only applies to goods in stores; killing townsfolk and taking their personal things, including those of the shopkeep still only requires exiting the site. The moment you are out of sight, you will be able to warp out as usual. Theft and murder remain within entities; even depopulating one country and stealing all its things will not generate ill response in another country.

In recent versions, you may find towns that are entirely deserted. In this case, you can steal from their shops with no consequences. You can also steal items from a fortress without any consequences, but it is unknown if you can do this if there is someone else in the room to see you. {{verify}}

'''Note that if you steal anything, then nobody in that civilization will talk to you anymore, making it impossible for you to get new quests, use the shops, or get new companions.''' 

==== Selling and buying with money ====
In addition to bartering, you can sell items to a shop for coins, then use the coins to buy stuff at another shop. Just select the items you want to sell or buy, and then set a price using the following buttons:
* {{k|a}}sking for money for your goods.
* {{k|o}}ffering money for their goods.

Shopkeepers are used to adventurers with inflated ideas about the value of their goods, so it may be simplest to ask for 9000☼ for your goods, or offer 1☼ for theirs and suggest a {{k|t}}rade. The shopkeeper will counteroffer with the actual value of the goods, and will be quite delighted to accept a {{k|t}}rade at the price they've just quoted to you. You can then purchase things with your store credit.

When you end the trade session ({{k|esc}}), the items you sold will be dropped at your feet, and the balance of your coins and the items you bought will appear in your hands.

====Managing coins====
You will find that coins from one civilization are nearly worthless in other civilizations. This will typically result in adventurers carrying around lots of now useless coins. Coins can and will encumber your adventurer, eventually reducing your speed. To reduce that effect you can try to exchange your copper and silver coins for gold ones as well as sell all of your loot directly for gold coins. Remember, merchants will always try to pay you in higher denomination currency first but will resort to lower value coins if they run out of anything higher. First, check the merchant's chest to see how much of each type of coins they have.

Coin values are as follows:
* Copper Coin = 1☼
* Silver Coin = 5☼
* Gold Coin = 15☼

To receive the maximum amount of gold coins from that merchant, make sure the amount "they owe you" during the trade is equal to (total amount of gold coins the shop has)*15☼ . If you are selling loot, simply make sure you only trade this worth of goods, and move on to other merchants for the rest. If you wish to exchange copper and silver coins for gold, buy random goods from the merchant until their price is around this value and then sell back all of the goods for their original value but in gold.

Alternatively, you can take your excess coinage and use it to purchase [[Gem|large gems]] at a trinket shop. Large gems make good investments because they are 1) light, 2) variably priced, and 3) equally valuable between different civilizations.
A few goods are strictly superior to all forms of coinage as a store of value, most notably giant cave spider silk items. A suitably sneaky (or powerful) adventurer can murder a few dwarves or goblins for such items for trade and sale for human goods. Giant cave spider silk is a non-renewable resource in a given world - please harvest responsibly.

==== Where to get items to sell ====
The best place to get items to sell is at bandit camps, after you've slaughtered all the bandits. You can loot the clothes and equipment off of the corpses of the bandits (and off your fallen companions, too), plus at the very center of camp there'll be a few scattered weapons and a few bags/chests containing various goods.

The next best way to get items to sell is to kill non-talking monsters, butcher their corpses (see below for how), and pick up the edible bits. Butchered bits from the corpses of people (dwarves, elves, humans, etc) can sometimes be found in monster lairs and these seem to be just as desired by shopkeepers as the products you gain from your own butchering.

Another good early source of income can be bags left in abandoned houses/shops, which usually contain plants and food. No one will complain, and the plants inside can be sold at about 2☼ each plus the value of the bag.

At the bottom of the list comes {{k|L}}ooking Carefully and selling any small creatures you might find. However, shops will not accept live creatures unless they are in cages. Some rocks, piles of sand, and other things found on the ground nearly everywhere can also be sold for 1☼ each.

You can also try filling your backpack from river - it can hold up to 100 units of water which is worth 100☼ total. After your sell it, water will drop to the floor as a pool, and backpack can be refilled instantly and for free from there. In fact, you can infinitely fill any container from any pool/pile of any liquid/powder, so if you happen to find some precious substance like [[sunshine]] or [[dwarven sugar]], money won't be a problem for you anymore. This may be considered an [[exploit]] by some, though.

Another devious method is to go outside the shop, {{k|g}}rab handfuls of mud and throw it into your backpack, then sell them for 1☼ each. The merchants will gladly buy your rare and valuable mud despite the unlimited free mud just outside their shop.

== Quests ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Q}}
| Adventure (Quest) log (tasks, map, et cetera...)
|}

Once you have a quest, press {{K|Q}} to look at them (this screen is called the Adventure Log). The world map is on the left, with your current location highlighted by a blinking "O", while on the right is the list of your quests. You can select a quest and press {{K|z}} to find the location of the quest site: the blinking "O" will move to the quest site, with a green line drawing the path you need to take. Pressing {{K|m}} will tell you the species of the monster you're supposed to kill. You can also use the arrow keys to move the "O" around to examine the surrounding terrain and sites.

Note that once you complete a quest that you can report your success to ''any'' human. Once you tell one human, everyone in the same civilization will know about it. The Adventure Log will tell you to report back to a particular hamlet/town/castle, but you can safely ignore that.

If you're having trouble finding the site on the fast travel map for some reason, exit quick travel mode by pressing {{K|>}}. In the upper left-hand corner of the screen will be a box with symbols running down the left-hand side. At the top of the box will be the symbol of your quest site, with the compass direction to the site at to its right, and "TSK" to the right of the direction indicating an unfinished quest at that site. You can then go back into fast travel mode and head in that direction.

Once you get to the quest site, you'll be unable to enter it when using quick travel mode. Attempting to do so will give the message "You cannot travel through the [site]". You must exit quick travel mode by pressing {{K|>}} and move the rest of the way using the normal movement mode. The box in the upper left-hand corner will tell you the direction to go. When you complete the quest the "TSK" will be gone from the site's line in the box, and looking at the Adventure Log ({{K|Q}}) will show "Report Death of ..." instead of "Kill ...". You then have to move off the site using the slow travel method before entering quick travel mode again with {{K|T}} (trying to do so on the site will tell you "You cannot travel until you leave this site".)

The difficulty of the quests a certain civilization will give you goes up as your fame/reputation with that civilization increases. This is important to remember, you may want to increase your adventurer's skills or gather more companions in between quests to keep up with the rising difficulty level.

==Crafting==
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|x}}
| Perform action (butcher, create item...)
|}

Adventurers can perform limited crafting, (also known as "reactions"). To access the crafting menu, press {{k|x}}.

'''[[Knapper|Knapping]]''' allows an adventurer to sharpen a rock. '''Knapping does not work with stones in containers, only ones on the ground or in your hand.''' Stones can only be {{k|d}}ropped if the stone type does not naturally exist in the biome you are in, so to use ground stones it is worthwhile to {{k|T}}ravel far from the area you {{k|g}}ot the stones. Otherwise, you can place both stones into your hands. This can be achieved by {{k|d}}ropping whatever is held in your left and right hands, then {{k|g}}etting small stones from the ground. Next, press {{k|x}} to open the action menu, and press {{k|c}}reate and then {{k|→}} to select "Make sharp stone". You will be prompted to choose a rock to sharpen ("tool stone"), and then the hammerstone. The tool stone will be replaced in your hand by a sharp version.

'''Butchering''' acts similarly to Fortress Mode's [[Butchery]] by converting a corpse into edible products, bones, and skin. A corpse must be {{k|d}}ropped onto the ground to be butchered, or held in one hand. With a sharp object (such as a dagger or knapped stone or even a bolt/arrow) in your hand or on the same tile of the corpse, press {{k|x}}, {{k|b}}, and {{k|→}} to select the corpse, and then the sharp tool. The corpse will be replaced by its butchering returns.

These are the only reactions possible in an unmodified game though others can be added through modding.

== FAQ ==

===How do I get past NPCs which are in my way?===
Press {{K|s}} to sit, then move to roll between their legs. Once you're done press {{K|s}} to stand again.

===How do I find an entrance to the underworld?===
You cannot find caves by asking for quests. Instead, repeatedly ask NPCs about the surroundings, and they might tell you about the location of a cave. If this doesn't show any caves, travel to a hamlet/town/castle some distance away and try again. If you ever get lost, you can quickly get back to the surface by traveling under a village and retiring there. When you unretire, you'll be aboveground.

===I keep getting maimed and killed! How can I fight without getting seriously hurt?===
The best defense is a good offense. If you let your enemies attack you, you're (unsurprisingly) likely to get hurt eventually.
* Try to ''avoid fighting difficult enemies until you get some armor''. Don't fight enemies at all unless you're sure you can beat them. If you're unsure, you're probably going to get hurt.
* If you have good speed, try to ''fight enemies one-by-one'' - keep moving backwards and only attack when you're within range of just one enemy.
* If you have a slashing weapon, try to ''chop parts off of your enemy'' - it makes them stop fighting for a turn, allowing you to keep attacking them without being attacked in exchange. Chopping off limbs will also weaken your enemies - taking their arms can prevent them from using weapons, taking their legs can make them slow and knock them down.
* Remember that ''it's better to let your enemy come to you, than to go to your enemy''. You have to either move or attack. If you move, you can't attack, so if you move within range to attack your enemy, you allow them to have the first strike (unless you're much faster than them). On the other hand, if you let them move within range of you, then you get to have the first strike. If your enemy is one space away from you, use that as an opportunity to throw a knife or a rock at them; worst case, they will get a bruise or a cut; best case, they will start the melee severely crippled. If you're fast enough, then you can simply step back after getting in that first hit, and they'll have to spend their turn approaching you again. Lather, rinse, repeat.
* Follow the advice under [[#Combat Preferences|Combat Preferences]].

===How can I obtain armor as quickly as possible?===
* Here's the evil way. If you don't mind causing an entire civilization to be hostile to you (preventing trade, etc. with that civ):
** It's relatively easy to obtain some armor by killing a sleeping soldier in a fort and taking his stuff.
** Most villagers are pretty easy to kill and while their stuff isn't usually too valuable it is worth something. Instead of killing animals you can go around killing villagers and taking their stuff, then travel to another civilization that doesn't know (or maybe care) how evil you are in order to trade.
** Don't try this in the beginning if the next civilization over is more than a day or so away. You need to be able to flee to another country in order to escape justice and continue to quest/trade.
* Raid friendly fortress keeps and the dungeons of towns. They don't mind parting with just a few pieces of armor. Beware in the dungeon, you're not the only one attracted to shiny things.
* Pick companions with good equipment so you can "inherit" it when they get killed. Letting them do all of the fighting for a while might help speed up this process. While this might be kind of evil, it's not as evil as the first option and will cause you much less trouble. Even better: if you have Adequate in Swimmer, you can take a dip in the water and they will follow suit.

<div id="powerleveling"></div>

===How do I increase my skills and attributes? (Power-leveling)===

Here are some techniques for raising your skills, very rapidly in some cases.

Most of these skill-raising techniques involve repeatedly entering the same keystrokes. To assist with this you can use a [[Main:Macro|Macro]] to make entering the same sequence of keystrokes over and over again much easier.

Increasing skills increases associated attributes which may in turn benefit other skills. For example, sharpening rocks using {{k|x}} will increase Knapping which will increase a number of attributes that help with combat skills. See [[Attribute#Skills_by_Associated_Attributes|Skills and Associated Attributes]] for a mostly complete list.

*'''Fighting and Wrestling''' - A good way to raise your Fighting and Wrestling skills and related attributes is to go find a small, relatively harmless animal and wrestle with it repeatedly. You can wrestle using {{k|A}} followed by {{k|Enter}}. Continually grabbing and releasing a creature is sufficient to raise your skill, and you can do it indefinitely with the same animal as it won't be injured. Wrestling will increase Kinesthetic Sense, Spatial Sense, and to a lesser extent, Endurance. You may also somewhat increase Dodging and Shield User this way as the creature takes swipes at you.It's possible to change your {{k|C}}ombat preferences for attacking and dodging to ''Close Combat'' and ''Stand Ground'', respectively, allowing you to simply walk into the helpless critter to wrestle it. (Standing your ground prevents you from moving to dodge attacks, so your wrestling can continue uninterrupted.) You will, however, perform occasional throws and take-downs as long as the creature remains standing, which may result in their bleeding to death. If you can wrangle a creature incapable of blood-loss in a high-FPS area (such as a crab on a frozen beach), you can easily raise all associated skills and attributes to Legendary and Superhuman in the course of a few minutes.
*'''Shield User, Armor User, and Dodging''' - In addition to wrestling the creature, you can also sit back and let it attack you to raise your defensive skills. If you have metal armor, then a small animal like a gopher can't do any real damage to you when it hits. Also, to place emphasis more heavily on shield blocking, you can change your attack {{K|C}}ombat preference to ''Stand Ground''. The wrestling-a-crab-on-a-frozen-beach method also works fantastically for this.
*'''Weapon Skills and Fighting''' - Once your defensive skills are getting up there and your agility is high enough to make your speed 1300+, you might want to try fighting bogeymen to increase your weapon skill. Just make sure to fight them one at a time while running away. If you don't know what a bogeyman is yet then you are probably not ready to try this. Also, doing difficult targeted shots will gain more experience and keep the training dummy alive longer.
*'''Throwing and Archery''' - Throwing rocks with {{k|t}} will raise your Throwing and Archery skills. Throwing objects at creatures, while not as completely devastating as it once was, can still come in handy. (In early 31.xx, somebody killed a bronze colossus by throwing a fluffy wambler at its head. We can only hope the wambler survived.) Although throwing is a way to raise Archery without wasting ammunition, there is a non-wasteful method that additionally increases bow/crossbow skills.The most efficient way to level via throwing is to forgo using a macro and separate training into two phases: {{k|g}}etting and {{k|t}}hrowing. First, find a tile with an indefinite amount of throwable objects (e.g., snow, rocks, mud, etc). Then, sequentially mash {{k|g}} and whatever key the rocks are assigned to until both your forearms explode. Rest. Then, sequentially mash {{k|t}}, followed by some consistent key assigned to your rocks, then {{k|enter}}, until you've emptied your inventory. Rest. Rinse and repeat. (You may wish to empty your inventory beforehand such that the rocks are assigned to a key close to {{k|t}}, allowing you to keep one hand on {{k|enter}} and another on {{k|t}}.)
*'''Marksman, Bowman, and Archery''' - Raising the bow and crossbow weapon-specific skills is best done by shooting at a wall or cliff with no floor directly beneath it. If bolts or arrows hit a wall that has floor/ground on the same z-level, then the ammunition will be destroyed. ''However'', ammunition that falls at least one z-level after hitting a wall will remain intact. So, simply find something like a hill inside a castle, stand on it, then shoot at a wall which is on the same z-level you are. The arrows will hit the wall and fall one z-level to the ground, remaining intact. You can then {{k|g}}et the arrows and {{k|f}}ire them at the wall again from the hill, ad infinitum. You can also stand next to a wall that's two or more z-levels high, aiming at the wall one z-level up by hitting {{k|<}} after hitting {{k|f}}. Whatever method you employ, the key is that the arrow needs to fall at least one z-level after hitting a wall to remain intact. Using a macro will speed this up greatly.
*'''Ambushing and Swimming''' - An efficient way to raise Ambushing is to sneak over large stretches of land, possibly in preference to fast {{k|T}}raveling. Ideally, this would be done in a biome containing sparse vegetation and few threatening creatures to blunder into and reduce FPS (e.g., a frozen beach).Although less efficient for raising only Ambushing, it's also possible to sneak and swim at the same time, thus combining their training. ''Just make sure you start with at least Novice or Adequate in swimming'', or you'll find swimming practically impossible to train. Swimming can very quickly improve your Strength, Agility, and Endurance. Additionally, if you can safely drown and then recover (e.g., by moving under a bridge and then back before suffocating), this will raise both Toughness and Endurance at a ''ridiculous'' pace-- a single step spent drowning will raise both attributes by a fifth of a point apiece.
*'''Observer''' - You can't really power-level this skill as it is slow and difficult to train, which is why you're advised to sink some points into it during character creation. However, one way to train it appears to be sleeping or walking around in the wilderness, allowing yourself to be repeatedly ambushed. This is, however, inherently dangerous. Running away from these encounters would probably be faster than slaying your assailants, if not generally safer for your character (but not for your companions, hoh boy).Successfully detecting traps found in tombs and catacombs (performed automatically) will also raise Observer. However, without decent skill to begin with, you'll be torn to pieces by the many traps you'll fail to see. Otherwise, once you've found one or more traps, it's possible to grind experience by sleeping/waiting an hour, thus resetting the traps. Rinse and repeat.
*'''Spatial and Kinesthetic Sense''' - While sharpening rocks with {{k|x}} will improve your Knapping skill, it more importantly increases your Spatial Sense and Kinesthetic Sense attributes, which affect a number of other skills. Knapping can be combined with throwing via a macro to keep your inventory from filling up.
*'''Other Stats''' - Other useful stats like Strength, Agility, and Toughness will increase significantly as the fighting and defense skills increase, so you don't need to do anything other than what you'd normally be doing to increase these.

===I managed to escape but my limbs are chopped off. Now what?===

'Tis but a scratch!

Unfortunately, there is only one way to get them back, and that is by being bitten by a [[werebeast]] and surviving until the next full moon. But as long as you have at least one leg and one arm left you can actually do pretty well. First, get a crutch from somewhere, such as a general store, and make sure it's in one of your hands. Once you do that you should be able to {{k|s}}tand back up again. You will notice that your speed is now much slower than before.

Now go find someplace reasonably safe and walk back and forth until your Crutch Walking skill gets up to Legendary or above. You will notice your speed increasing as your skill levels up until your speed is completely back to normal. As a bonus you'll probably see some stat increases as well. You can continue to dodge with a crutch just as well as before.

You can wield a sword, shield, and crutch all in one hand, so even if you are missing an arm then you're all set. If you are missing both arms but still have both legs then unfortunately you'll be limited to biting, dodging, and wrestling with legs. If you're missing both arms and one leg then your movement will be limited and you'll be limited to biting and wrestling with your one remaining leg. And if all limbs are missing then you'll be limited to rolling around on the ground biting things.

Though you might actually be able to do surprisingly well as a Legendary Biter, especially if you powerlevel your strength to the point where you can shake things around by the teeth ripping limbs off, if you lose both legs then your character is going to be severely limited just due to the poor movement rate, so at that point it's probably best to opt for retirement or a glorious death in battle.

=== How do I keep my companions from running off after random wildlife? ===

In unmodified games, only human companions are typically available and humans currently seem to have the philosophy that all wildlife MUST DIE AN IMMEDIATE BRUTAL DEATH ASAP. While there's currently no way to order them to ignore wildlife and other neutral creatures, you can modify the ''raw\objects\entity_default.txt'' file and add the [[Creature token#A|[AT_PEACE_WITH_WILDLIFE]]] to the entity definition for humans. This will cause humans to have an elf-like attitude toward wildlife, and vice versa. Humans will then avoid killing animals and animals will not run away from humans, also giving you somewhat of an advantage when hunting as a human. However, this does mean you'll have to confirm attacks against animals with {{k|alt}}-{{k|y}}, among other things. (It's still preferable to each of your companions getting one-shotted by hooved, precision kicks to the face... damn horses.)

Animals... either you love them and they love you, or they must die a horrible death right now.

===What creatures of night can I become?===

You basically have four different choices.

Firstly, you can become a [[necromancer]].
* That gives you some traits of an undead. Namely, you don't need to eat, sleep or drink, don't tire or age, zombies or mummies don't attack you and your physical stats are permanently fixed.
* The last one means it's wise to train them beforehand.
* You also can raise dead from the {{K|x}} menu. Depending on the flavor of your spell, zombies can be slow, very slow or not slow at all. They will be listed as companions.
* To become a necromancer, find a necromancer tower and obtain a book or slab containing secrets of life and death from there, then read it. Note that most of the books are useless. In younger worlds necromancers may not have built their towers yet, in which case they'll be hanging at a zombie bandit camp, slab under the arm.

Secondly, you can become a [[vampire]].
* That gives you most traits of an undead. In addition to the listed above, you don't feel pain, don't breathe and immune to most syndromes.
* Your strength, agility and toughness are doubled.
* They're still fixed forever, so, again, be prepared.
* Despite not needing to drink water, you have a hunger for warm blood. To satisfy it, beat someone or something unconscious and {{K|e}}at their blood. However, if you become a necromancer after {{verify}} becoming a vampire, you will not need to drink blood.
* To become a vampire, defeat one in combat and drink his blood.

Thirdly, you can become a [[werebeast]].
* This gives you the (uncontrolled) ability to transform into a powerful half-man, half-beast on a full moon.
* There's a fixed list of animals on which the werebeast is based, including goat, llama, lizard, horse, monitor, buffalo, moose, tortoise, camel, kangaroo, ape, gecko, bear, hyena, warthog, iguana, skink, shrew, elk, skunk, pig, raccoon, panda, mole, badger, armadillo, mammoth and more.
* Most importantly, upon transformation (both ways) all your wounds, including missing limbs, are instantly healed.
* You don't show any abnormalcy outside of beast form. You are still mortal.
* When in beast form, everything is hostile to you, you don't need to drink, eat, sleep or breathe, don't feel pain, don't tire and are immune to some syndromes.
* One randomly chosen metal is ten times as deadly to you than usual. All other materials deal you half damage.
* Werebeast's size is several times their base animal size, but no less than 80000. This means all armor will be too small for you while in beast form. But you can still use a shield.
* Also, some werebeasts are truly gigantic — weremammoth has a size of 9000000, on par with demons.
* To become a werebeast, make one bite you. It has to be in the beast form.
* You cannot be a werebeast and a vampire at the same time.

And finally, you can become a mist [[zombie]].
* This makes you undead. In addition to vampire traits, you can see without eyes and can't die via blood loss or beheading. Note that you don't have health point limit raised zombies have.
* You become permanently hostile to everyone except other undead.
* Your strength and toughness are tripled and fixed. Train beforehand.
* Depending on the flavor of zombie virus, your speed may or may not drop to 20% or 60% of its normal value.
* To become a mist zombie, find a mist/fog cloud that zombifies creatures and delve headdeep into it.
* You cannot become a vampire or a werebeast if you are already a zombie. The other way, however, is fine.

=See Also=
*[[Main:Adventure Mode quick reference|Adventure Mode Quick Reference]]
*[[Main:Adventure mode quick start|Adventure Mode Quickstart Guide]]

{{Getting Started}}
{{Category|Adventurer mode}}
{{Category|Interface}}

v0.34:Trading

2014-03-15T00:49:58Z

Doktoro Reichard: Undo revision 197650 by 173.21.244.39 (talk) It's random. After 12 years in the same fortress I can attest to that.

{{quality|Exceptional|07:56, 19 January 2011 (UTC)}}{{av}}

'''Trading''' in Dwarf Fortress first occurs in the first [[Calendar|autumn]] after establishing your fortress, with the arrival of the [[dwarf|Dwarven]] [[Trading#Caravans|caravan]]. Trading is a good way to acquire resources that are not available or are rare in the local area. It also allows for more freedom in selecting starting gear or purchase of additional skills for the expedition party, because items can always be obtained through trade later.

'''Trader''' is the term used at your [[trade depot]] to refer to your fortress representative when dealing with merchants in a visiting caravan ({{key|r}} - "''Trader requested at Depot"''). As a [[profession]], the term applies to visiting merchants and dwarves whose highest [[skill]] is [[Appraiser]].

== Trade Depot ==
{{Main|Trade depot}}
Building a [[trade depot]] is a pre-requisite for trade with caravans that arrive at your fortress.

While it may be convenient to build a Trade Depot outside at first, it is usually a really good idea to move it inside or build walls, bridges and other fortifications around it to protect caravans and your goods from animals (guzzlers), [[thief|thieves]] and [[goblin]]s.

Everything that is on your map belongs to you, except:
* the items that are on merchant animals and wagons
* the items that are on the trade depot (they belong to the caravan until they are moved out of it)
* items worn by non-fortress units are initially forbidden, but can be claimed via unforbidding and dumping them

==Trading Flowchart ==
{{:Trading/Flowchart}}

==Trader to depot==
Before you can begin trading, your fortress's representative trader must be at the [[trade depot]]. Select the [[trade depot]] with {{K|q}} and then {{k|r}}equest the trader. Be sure that {{k|b}} reads "Only broker may trade" if you want your [[broker]] to represent your fortress. If it reads "Anyone can trade", a random, probably unskilled dwarf will volunteer to conduct the trade. Pressing {{k|b}} will toggle this setting. Once your trader has arrived, select the depot again with {{k|q}} and enter the {{k|t}}rade menu. In the trade menu select the items to offer from the right and the desired items from the left. All caravans have a weight limit which cannot be exceeded, and the allowed additional weight is displayed in the lower right corner. If the acting trader has at least Novice or better [[Appraisal]] skill, the value of all items will be displayed. Once the proposal is ready, press {{K|t}} to propose the trade, but merchants will not agree unless they make adequate profit. Be sure to use '''trade''', not '''offer''' {{K|o}}, as this will make a gift of the selected items. The amount of acceptable profit is determined by the trader's [[Broker skills|skills]] and the merchant's mood, described below. Merchants may attempt to propose counteroffers if they do not accept the proposal, which can then be accepted, rejected, or further amended by the trader.

With more experienced traders or pleased merchants, even marginally profitable trades can be successful, and counterproposals can be rejected safely, offering the same trade again. Note however that a low profit margin for the traders may not be desirable - it has been suggested that both export and profit numbers influence the size of next years caravan and, in the case of the dwarven caravan, immigration numbers.{{Verify}}

Goods brought by caravans rarely have base quality higher than superior, and decorations on a good rarely exceed superior as well.

== Trading cue colors ==

* {{DFtext|Brown|6:0}} Items have been created (or modified) by your fortress. They can be traded away or offered as a gift.
* {{DFtext|Gray|7:0}} Items were created by another source. They can be traded, but if one of these items has been selected, the entire selection cannot be offered as a gift.
* {{DFtext|Purple|5:0}} Items are under a no-export mandate. If they are traded away it will result in disciplinary action (see [[justice]]) against the dwarf that brought the item to the depot.
* {{DFtext|Green|2:0}} Items have just been gifted to the caravan and they will not trade it back.
* {{DFtext|Red|4:0}} Items have been seized from another caravan and cannot be traded as is; you will need to decorate them or turn them into other items for them to become "valid" trading items.

Note that containers (barrels, bins, etc) will be displayed according to the origin of the ''container'', not the contents. So a foreign barrel holding locally-produced beer will display as foreign (white). Once you {{k|v}}iew the container, the locally-made contents are displayed as local (brown).

== Merchant mood ==
If your trader has Novice or better [[Judge of intent]] skill, there will be a line added below the merchant's dialogue describing the caravan's attitude. Their attitude rises with successful trades (especially if they get lots of profit) and falls when you propose deals they don't like.

* (trader) seems ecstatic with the trading
* (trader) seems very happy about the trading
* (trader) seems pleased with the trading
* (trader) seems willing to trade (Default, at least for humans)
* (trader) seems to be rapidly losing patience
* (trader) is not going to take much more of this
* (trader) is unwilling to trade

The happier you make a merchant, the less profit margin he will demand in a trade. If merchants reach the lowest level, no further trade will be possible, and they will immediately pack up and leave your depot. Since annoyed traders are more likely to reject deals, you should be generous in initial negotiations. Skilled negotiators seem less likely to offend traders with unsuccessful deals.

An easy way to capitalize on this mood system is to perform several partial trades. First trade for a few items, offering goods twice the value of the items you ask for (e.g. offer 2000☼ for 1000☼ of his stuff). This will likely make the merchant ecstatic about trading with you. Exit the trade screen, unpause briefly, and then return to trading with a vengeance. With the merchant in such a good mood, he is more likely to counteroffer than reject a trade outright.

== Seizing items ==

Pressing {{K|s}} from the trade menu will seize the selected items of the merchant's. If you seize goods from a caravan, the merchant will respond "Take what you want. I can't stop you." and then leave immediately without the seized goods. Items cannot be seized from the dwarven caravan, and other races will not buy goods stolen from one of their caravans (then marked in red) unless they are tricked into asking for them via counteroffer, or the items are "laundered" by decoration or used to create other goods. Seizing goods will hurt diplomatic relations, but is not grounds for an automatic [[siege]].

Pressing the seize button while no goods are selected will result in the merchant interpreting your seizure as a joke. This apparently does nothing to benefit or hinder your trading.

As a side note, if you deconstruct your trade depot with a caravan in it, all the caravan's items will drop to the ground, to be readily hauled away by your Dwarves. This does not mark the items as stolen, and the caravan will leave. However, ''next'' year's caravan is partly based on the profits from the previous year - so if you are relying on that race's caravans for needed items, you're hurting yourself in the long run.{{Verify}}

Another way to steal without marking as stolen is to forbid the trade depot just before they leave, causing them to leave their goods at the depot.{{Verify}}

If you establish your hospital at the moment the first elven caravan arrives, or if you add the first coffers to it, your dwarves will take all of the cloth and thread they can carry off of the elves.

Note that the civilization attached to a particular caravan will keep track of the value of items the caravan was carrying when they set out to trade, and they will compare this value with the value of items they return home with. Regardless of what method you use to confiscate items from a caravan, even if you came to possess the goods through no fault of your own (an [[ambush]] killed the caravaners, for example) the parent civilization may decide that you stole from them and send a [[siege]] instead of a caravan the following year. It is prudent to take measures to protect caravans visiting your lands!

==Offering items==

{{key|o}} You can also give away items, as gifts to the leaders of the [[civilization]] you are trading with. This presumably helps relations between yourself and the other faction, though there is not yet a clear correlation between the value of the offerings and the improvement to relations. The exact effects of offerings on trading are unknown but it is believed due to the offerings' net trade value being counted towards the traders' profit, possibly with a modifier (possibly a multiplier of more than 1 as a bonus or less than 1 to compensate for the improved relations){{Verify}}, which in turn increases the quantity and variety of trade goods brought by next year's caravan. Also the [[King]] requires offerings to be made before his arrival. You cannot offer items that were not made at your fortress; the traders do not want your spare [[Goblinite]] clothes..

Unless you are looking for [[fun]], under no conditions should you offer or trade items which are wooden or used wood in their creation (glass, for example) to [[elves]], as this will insult the traders, and may cause them to leave or even damage relations enough to provoke a war between you and the elven civilization you traded with. They will be equally insulted by you trading back their wood-related items.

== Miscellaneous Trading Advice ==
* Thieves and thieving critters tend to follow caravans. Expect assaults and intruders.
* Be careful about asking traders to bring lots of individual lightweight items (such as meat and fish) as it can result in traders taking a very long time to unload their goods. Unless the path to your depot is extremely long, though, this is unlikely to cause significant problems.{{Verify}}
** On a similar note, if you have sold a large number of low value goods (such as all the loincloths and cloaks scrounged from a siege,) it can take a caravan ''months'' to pack it all up, to the point where they're still on the depot when the next one comes. An incoming caravan can occupy the same depot and trade with you, but if they both try to go through your entry tunnel at the same time they will become gridlocked against each other, resulting in the destruction of wagons and loss of trade opportunities.
* Create your trading depot inside your fort, preferably in the beginning. Place a 3-tile wide path (which must be free of obstructions such as stairways, traps, minecart tracks and boulders) to the entrance of the fort and position war dogs along it (chains do not block wagons); this will help to protect the traders and keep the depot close to your supplies.
* All caravans will bring extra food (meat and edible plants), wooden logs, and cloth/leather (for making clothes) if the supplies of your fortress are low enough, independent of whether or not you requested them. This does not apply in the case that the weight limit is exceeded by (other) items you requested. The supply situation, as observed by traders, is based solely on the number of unforbidden items in your fortress, stockpiled or not; thus, it is possible to trick caravans into thinking your supplies are low by [[forbid]]ding all of your relevant stocks immediately prior to their arrival.
**In order to '''avoid''' this behavior, you should make sure that, for each dwarf in your fortress, you have the following ''unforbidden'' items:
*** 5 pieces of food - meat, fish, plants, or "other" in your [[Status]] screen (even though "other" includes inedible items)
*** 1 wood log
*** 5 pieces of cloth, pieces of leather, or complete sets of [[wear|pristine]] clothing (shirt+pants+shoe)
* Define your trade depot as a burrow. When traders arrive, you can add your broker or another dwarf, perhaps one you want to train in trading, to the burrow. They will head to the depot immediately, and stay there until you remove them from the burrow.
* Each trade you make (regardless of value) will increase your trader's skills by 50, distributed among Comedian, Flatterer, Intimidator, Judge of Intent, Negotiator, and Persuader. Each skill seems to gain around 5-15 points, but the sum will always be 50. The skill gain occurs as soon as the "t" button is pressed - if the offer is rejected, the dwarf will still gain 50 points. If the same offer is subsequently accepted, no additional skill will be gained.
* Selecting "only broker may trade" ensures that you will start negotiations with a decently-skilled trader, but also requires a significant wait while your broker makes his way to the depot (possibly months if he is "[[on break]]"). Selecting "anyone can trade" will result in a poorly-trained trader arriving immediately. Once your fortress is producing enough goods to buy out the caravan, waiting for your broker is unnecessary; allowing your commoners to trade spreads out the trading skill gains and eliminates the micromanagement of trying to get your broker to the depot in a timely manner.

== Caravans ==
Each friendly race will send a caravan per year, linked to one season, which is autumn for dwarves, summer for humans, spring for elves, and winter for goblins. It is rare for your civilization to be on peaceful terms with goblins, however. In the first year, only a dwarven caravan will arrive, although it will only arrive in late autumn, about a month later than in previous versions. Caravans will only show up if that race considers the fortress site accessible (as denoted on the embark screen), with the exception of dwarves, who always arrive unless they are [[extinct]].{{verify}} Caravans appear to enter the map from a random direction which does not coincide with the relative direction of the originating [[civilization]], and they may appear from different directions or z-levels each year. Caravans may leave without trading if it takes too long to reach the trade depot. Caravans will embark on their journey back exactly one month after their arrival, whether they have succeeded in reaching the depot or not.

Note that if traders or their animals are prevented from leaving, they will eventually go [[insane]].

Also worth mention is the pathing behavior of the entire caravan. If one member of the caravan reaches a block in their chosen path (i.e. a raised drawbridge that was lowered when they entered the map) the entire caravan will re-path, instead of encountering the obstacle one by one. This behavior can be useful when attempting to free "stuck" wagons--a trader on foot encountering an obstacle will cause the stuck wagons to turn around and path to a different exit, if available.

==== [[Dwarves]] ====
:''"Greetings from the mountainhome. Your efforts are legend there. Let us trade!"''

The dwarven caravan:
* arrives in [[Calendar|autumn]].
* carries metal bars, [[leather]], weapons and armor, food and booze, and more. Dwarves alone may bring [[steel]] and steel goods. They can still bring steel (and steel goods) and [[pig iron]] bars even if they do not have access to [[iron]], but will not bring iron products.
* is heavily guarded.
* sends a liaison who will speak with the [[Expedition leader]], [[Mayor]], [[Baron]], [[Count]], or [[Duke]] to negotiate an import-export agreement (unless the [[Monarch]] is present).
* influences the number of immigrants received (if the caravan leaves intact).
* will not cause sieges when repeatedly destroyed or lost.
* is the only caravan to arrive during a fortress' first year.
* always arrives regardless of embark location unless the dwarven civilization is [[extinct]].
* cannot have its goods seized from the trade menu.
* may not arrive if your civilization lacks any notable figures.

==== [[elf|Elves]] ====
[[Image:Evil_elves.png|thumb|400px|A typical elven caravan.]]
:''"Greetings. We are enchanted by your more ethical works. We've come to trade."''

The elven caravan:
* arrives in the [[Calendar|spring]].
* carries [[cloth]], [[rope]]s, various above-ground seeds, [[plant]]s and their byproducts, [[log]]s, [[wood]]en goods & [[weapon]]s, clothing and [[armor]], and may carry tame exotic [[creature]]s.
* unguarded
* does not accept some items in trade:

Elven traders do not like to be offered any tree byproducts. Forbidden items include:

* [[Wood]]en items (including subterranean mushrooms such as [[tower-cap]]s)
* Items derived from wood - [[ash]] and [[charcoal]], as well as [[lye]], [[potash]], and [[pearlash]]
* Items made from clear and crystal [[glass]] (due to the [[pearlash]] used) - green glass appears to be perfectly acceptable
* Items [[decoration|decorated]] with any of the above materials
* [[Obsidian]] shortswords (since they have wooden handles)
* [[Soap]] (made with [[lye]])

Offering or trading forbidden items will cause the mood of the trader to drop rapidly, causing them to refuse to trade any more that season and leave immediately. Additionally you will be called uncouth, crude, and barbaric for not understanding their customs.

However, [[stone]] and [[metal]] items, even when [[charcoal]] is used in production, are acceptable (since the elves are unfamiliar with metalworking, and do not know that charcoal is used to make metal items). Items made from [[silk]] are acceptable, as are all non-wooden plant-derived products such as [[cloth]] and [[thread]]. Items made of bone (totems too), horn, shell or leather are acceptable, so are meat and fish. You can also transport your goods to the [[trade depot]] in a wooden [[bin]], as long as you do not try to sell the bin. Living animals are acceptable, as long as the [[cage]] or [[trap]] is not made of [[wood]].

Be especially careful with reselling decorated items from other caravans, as non-wood/glass items may have decorations of wood or clear/crystal glass. All such items that elven caravans sell are also unacceptable to sell back to elves, as the dwarves have no means of proving that they were made in an "elf kosher" way.

Because they do not utilize wagons, elven caravans have a much smaller weight limit than dwarven and human ones, making trading heavy items like furniture problematic.

:''"Once a beautiful tree, and now? It is a rude bauble, fit only for your kind."''

==== [[Human]]s ====
:''"Greetings. The craftsdwarfship of the dwarves is unparalleled. Let's make a deal!"''

The human caravan:
* arrives in [[Calendar|summer]].
* carries metal bars, sand, [[leather]], cloth, wood, food and booze, ropes, waterskins, quivers, backpacks, metal weapons and clothing and armor, cages and a few domestic animals.
* carries only large-sized clothing, which is unusable by dwarves.
* is moderately guarded.

==== [[Goblin]]s and [[Kobold]]s ====
A goblin caravan will only arrive if you mod the game, primarily because their entity lacks the [[entity token]]s needed to make use of pack animals and wagons. That, and one of the tokens (presumably babysnatcher) makes them hostile to all non-goblin civilizations. These same caveats apply to kobolds.

The goblin caravan:
*will arrive every season, four times per year
*unguarded
*brings mostly food and cloth
*does not send a liaison or a guild representative
*does not make import/export agreements

== Diplomats ==
[[Diplomat]]s may be sent by other civilizations to speak to your [[noble]] dwarves (and they ''will'' speak to those dwarves, even if they have to wait at their bedside in the hospital for months after the caravan has left). Diplomats generally appear on the map edge around the time that civilization's caravan would arrive. Meeting with a diplomat may allow you to request specific items for the next caravan to bring (at a premium price), take requests for production for the next caravan (for which the merchants will pay a premium), or sign a cease-fire to end hostilities.

Current trade agreements can be viewed through the Civilization menu ({{k|c}}). These trade agreements are cleared when a diplomat of the corresponding civilization enters the screen, so they are generally not accessible after the caravan has arrived.

In the event that your leader is replaced, killed, or taken by a [[strange mood]], the diplomat may decide to leave your fortress [[stymied|"unhappy"]]. Curiously, this will '''not''' occur if your leader is otherwise unable to perform the "conduct meeting" task. You can currently lock a diplomat in a room and he will wait years to attend the meeting your noble is constantly conducting (and all subsequent diplomats appear to wait in line for the first to finish); this behavior is presumably a bug.{{bug|3027}}

An unhappy diplomat will naturally prevent you from creating trade agreements and ending hostilities, however it is not currently known what other effects this has on relations with that civilization. Whether the diplomat successfully met with your leader or just gave up, a diplomat who has decided to leave but is prevented from reaching the map edge will eventually go [[insane]].

== Destruction ==
If caravans are destroyed (intentionally or unintentionally), the items may remain for use. Traders caught in a [[cave-in]] will flee as if they were attacked, but will leave all the items dropped by the caravan behind. Pack animals carrying items are affected just like a normal tamed [[mule]] and must be killed in the cave-in for them to drop items on the ground. It is however much more likely that the pack animals will only be stunned or rendered unconscious, and flee shortly after recovering from the hit.

While caravans can defend themselves, they don't like being ambushed. An encounter with unfriendly creatures resulting in the death of any merchant or pack animal will cause them to retreat and forget about trading with you for the season. Repeated caravan destruction (intentional or unintentional) will strain diplomatic relations and may result in a [[siege]].

Ambushing or seizing a caravan and letting a survivor escape seems to have a more detrimental effect than simply annihilating the whole caravan.

== Caravan Delay ==
If a caravan has arrived at your trade depot and is unable to leave for about two months after they finished packing up their goods, the merchants and animals will go insane. This can result in a bunch of merchants attacking your dwarves, or just standing around moping until they starve to death. It is not known for certain if this hurts diplomatic relations, but most likely it's the same as any case where the entire caravan fails to return home.

If you have locked the caravan into your fortress to hold out against a siege, it's a good idea to station a squad of soldiers near the trade depot in case the merchants [[Insanity#Types|go berserk]]. You may also want to make the depot a restricted area to encourage civilians to go around it. Alternatively, you can design the trade depot using drawbridges, so that it can be sealed off from the rest of the fortress during a siege.

If you want the merchants to leave safely, you can build four or more tunnels to each corner of the map, connected to your fortress only by drawbridges. As long as there is no other way to enter and exit your fortress, invaders and merchants will both go towards any tunnel that you activate. You can lock the merchants into the trade depot, and then open a tunnel entrance on one side of the map to make the invaders head towards that tunnel. When they get close to it, you can close it, and then open the entrance on the other side of the map, and let the traders out of the depot. If your fortress and depot are in the middle of the map, this will give the traders quite a head-start to get away.

Merchants can leave the map from any map edge-- including underground map edges. If an unobstructed path through your fortress reaches an edge, then blocking an overland path will cause the merchants to travel underground. This can be useful, if you're suffering a prolonged siege; it can also be dangerous, if your underground regions are less secure than your surface.

Caravan guards cannot be starved, dehydrated, or driven to insanity if prevented from leaving, their employers and animals will however.

If an large amount of items is sold / offered to the caravan, it may take a while to load it all, especially if you chose to keep your precious bins and traded your items individually.

== Bugs ==

*Aggressive, untrainable creatures (captured goblins, for example) cannot be traded; when a dwarf attempts to move the caged animal to the Depot, the creature is set free.
*If your [[hospital]] isn't already stocked with the specified amount of thread/cloth, your dwarves will carry off as much from the caravan as they need to fill it. {{Bug|66}}
*Caravans show up very late in the season. {{Bug|1756}}
*One outgoing trade caravan can run into another incoming trade caravan, leading to them getting stuck in the entrance to your fortress, wagons breaking, trade failing, and other problems. Rarely, this can even happen out in the open, when they are surrounded by plenty of space to maneuver. {{Bug|5687}}
*[[Unfortunate accident|Killed]] caravan guards can't be [[slab|memorialized]] {{Bug|5755}}
*If a caravan attempts to leave in late Winter/early Spring, they may try to path over any large frozen body of water. If the water thaws while the caravan is on it, the caravan will become magically stuck in mid-air for the majority of the year (until the water refreezes). At this point, if they are still alive, they will leave the map normally.
*When merchants leave with an animal, the merchants seem to be dragging their beast of burden instead of leading it. If the animal is incapacitated but not dead, the merchant will continue to walk at the same speed, dragging the unconscious beast
*If a merchant's chosen map edge exit is guarded by a hostile creature (including those on a [[restraint]]), the merchant will wander back and forth repeatedly and eventually go insane rather than path to an alternate exit.

== Loyalty cascade ==
{{main|Faction#Loyalty cascade|l1=Faction}}
If you order your military to kill merchants from your own civilization, a bizarre result of the the way loyalty is handled makes the members of your military who attacked the traders become enemies of your civilization, but members of your fort's government (dwarves of this [[faction]] are referred to as ''separatists''). As enemies, they attack your other dwarves (''citizens''), but as members of the fort, they still follow orders. Allowing citizen militia dwarves to attack the separatists will give them opposite loyalties of the separatists, (i.e. loyal to civ, not to fort), or ''loyalists'', who do '''not''' follow orders. And then, if a separatist or loyalist kill a citizen, they become enemies of the civ '''and''' fort, making them ''Renegades'', who are essentially complete enemies of the citizens.

To prevent the cascade from spreading, order the original separatists away from the fortress and let them fight amongst themselves. If the results are renegades, it is okay to allow other dwarves to kill them (by stationing them nearby). If the results are separatists/loyalists, then you will need to separate them somehow.

== Exploits ==

*Deconstructing the Depot will cause merchants to leave your fortress and abandon any goods in the Depot because items are not available until the building is fully deconstructed. However any animals they had caged will still belong to the merchants and only become friendly, you won't actually own them. According to Toady One, this is actually working as intended, and is not really an exploit or bug: "...the reckoning comes when they return with lesser value, and it has the same negative effect (it'll be listed as a disaster rather than an intentional seizing -- the depot could be destroyed, for instance -- but it counts for the same value if I remember). The overall wording could be changed and the interaction could be deepened to recognize this or that, but it's working as intended."[http://www.bay12games.com/dwarves/mantisbt/view.php?id=293#c8393]

*If you wait some time (2-3 months{{verify}}), you can "claim" animals by linking a lever to the cage and opening it, the animals will be released in a tamed state. Check the {{k|u}}nit screen before releasing them; if the creatures still show as Merchant creatures, they will wander off the map when released; if they show as Tame creatures, they will stay once released.

v0.34:Adventurer mode

2014-03-14T09:49:45Z

Doktoro Reichard: /* Ranged Attacks */

{{Quality|Masterwork|00:47, 29 September 2013 (UTC)}}
{{av}}

:''This is a detailed reference guide for Adventurer Mode. For a tutorial see the [[Adventure mode quick start|Adventure Mode Quickstart Guide]].
:''See [[Adventure Mode quick reference]] to quickly look up key commands.

In '''Adventurer Mode''' (also called "adventure mode") you create a single adventurer ([[dwarf]], [[human]], or [[elf]]) who starts out somewhere in one of your generated worlds. You can receive [[quest]]s, venture into the wilderness to find [[cave]]s, shrines, lairs, abandoned towers, and other [[Site|towns and settlements]]. You can even visit your abandoned [[fortress]]es and find whatever riches were left to be guarded by the [[creature]]s that sealed their fate.

Unlike [[Fortress mode]], Adventurer Mode is a sort of advanced [http://en.wikipedia.org/wiki/Sandbox_game open world] version of [http://en.wikipedia.org/wiki/Rogue_%28computer_game%29 rogue] or [http://en.wikipedia.org/wiki/Nethack nethack] taking place in the same procedurally generated worlds used for Fortress Mode, but you control a single character in a turn-based manner rather than manage a group of creatures acting in real time.

=World Selection=

You can play Adventurer mode in any world that has a civilization with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token (which are elf, dwarf, and human in unmodded raws) but as of the current version only human civilizations have towns, NPC fortresses, or shops {{v|0.34.07}}. Elves simply live in the forest with nothing but a few named trees to mark their homes, while Mountainhomes that dwarves live in tend to just be a few dwarves in open space. As a result you need at least one human civilization if you want quests or anything but basic wilderness survival. Alternately, you can alter the other races to also use human towns -- see the talk page under "Dwarven Fortresses."

If you have previously built a fort in the world that you select, your adventurer will be able to go visit it. However, the fort must be abandoned because you will not be able to start an adventure mode game in the same world with an active fortress mode game. Note, though, that you can always save your fortress mode game, duplicate the save folder (copy ''regionX'' to ''regionX-copy'' or something), abandon the fortress in the copy of the world, then start adventure mode in the new clone world.

=Character Creation=

==Race and Civilization==

Any race with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token is playable in adventure mode. In an unmodded game, this means [[Dwarves]], [[Elves]], and [[Human|Humans]]. All three races can complete the same quests.

*'''Humans''' Always originate from one of the villages in the world. begin with bronze or iron weapons and can use any of the items sold by shopkeepers (who, for the time being, are only found in human towns and only sell human-sized clothing/armor). They also start with the widest variety of weapon skills.

*'''Human Outsiders''' Human Outsiders are humans that aren't from that world or any of its villages. They simply appear in the wilderness, a stranger to all. You may always play as an outsider, even if the world is otherwise completely uninhabited. Outsiders can only start with Spear User and Knife User as weapon skills, and they cannot start with Armor User or Shield User. They also start out literally naked with no clothing, but can wear any human-sized armor that they trade for, steal, or loot. "Outsiders" of other races can be played if you add the [[Entity_token#Gameplay|INDIV_CONTROLLABLE]] token to the race's entity definition.

*'''Dwarves''' have the advantage of being able to go into a [[Martial trance|martial trance]] when fighting multiple foes at once. This gives them many combat bonuses, which aids their survival greatly. They are the only race which can start with steel weapons, but they wear "small" sized clothing (like goblins and elves) which means that they're unable to wear human clothing and armour found in shops. Goblin amour will fit them so its usually easy enough to find some armour since you'll run into a lot of hostile goblins during quests. They can start with almost all of the same weapon skills as civilized humans. Most human-sized weapons (such as long swords) must be wielded two-handed by dwarves, due to their size.

*'''Elves''' start with very weak wooden weapons and have a more limited list of weapon skills during character creation. They have the advantage that they have higher natural speed. Elves also have the AT_PEACE_WITH_NATURE tag. This makes all wildlife passive towards them. Like dwarves they wear small sized clothing so will have the same problem finding suitable armour in shops.

*'''Kobolds''' can be played only if there are no other civilizations and there are kobolds. They are very small and weak in combat and a huge challenge compared to the other races. They wear even smaller armour than the other races and armour will be impossible to find for them, unless you are absurdly lucky and run into armoured kobolds.

If no civilization for the given race exists in a world you can only play as an outsider.

== Status ==

Determines the number of starting skill and attribute points, which does not change based on race:
*'''Peasant:''' 15 attribute, 35 skill
*'''Hero:''' 35 attribute, 95 skill
*'''Demigod:''' 105 attribute, 161 skill
The number of skill points is less significant than the number of attribute points because the time it takes to go from Peasant to Demigod in skill terms is much less than what it would take to go from Peasant to Demigod in attribute terms.

== Starting Attributes ==

[[Attribute|Attributes]] are divided into Body and Soul attributes. This section provides some guidance for allocating attributes as it relates to adventurer mode.

=== Body ===

*'''Strength''': Alters the damage you inflict in melee regardless of weapon used. Increases muscle size. This increased muscular layer helps prevent damage, although this is a pretty minor effect. Increasing strength, at least in adventurers, increases movement speed (albeit not as much as agility) due to better carrying capacity.
*'''Agility''': This attribute is directly related to a character's Speed and is also used in combat skills. Agility is really, really important as being faster than the enemies allows you to get more hits in before they can fight back and lets you run away more easily.
*'''Toughness''': Reduces physical damage inflicted on you. Also relates to defensive combat skills.
*'''Endurance''': Reduces the rate at which the adventurer becomes exhausted. Becoming exhausted causes you to collapse, helpless and immobile and can cause you to pass out.
*'''Recuperation''': Increases the rate of wound healing. Not as important as Toughness. Recuperation isn't that useful in adventurer mode since you usually have as much time to rest as you need assuming you can escape a situation alive.
*'''Disease Resistance''': Reduces the risk of disease. Useful for fighting enemies who use poisoned weapons.

=== Soul ===

Some of these are useful for adventure-mode-applicable skills, but some are totally useless except as dump stats.

*'''Analytical Ability''': Useful only for Knapping. Might as well reduce it to very low.

*'''Focus''': Affects Archer, Ambusher, Observer.

*'''Willpower''': Affects Fighter, Crutch Walker and Swimmer. Willpower is really important as it governs how easily you'll pass out from extreme pain. Low willpower is a death sentence if you are seriously wounded, as you'll pass out and have your head caved in. Broken bones currently cause enough pain that even very high willpower usually won't keep you concious. For non bone injuries however willpower can keep you going long enough to kill enemies, or at least get away from them.

*'''Creativity''': Completely useless.

*'''Intuition''': Only helps with Observer, which aids in spotting concealed enemies and ambushes. A useless skill since you rarely see these in adventure mode.

*'''Patience''':Currently useless.

*'''Memory''': Memory aids greatly in mapping out areas as the higher your memory the longer you'll remember an area. As you explore you'll forget previously explored areas, causing them to appear blank, as if you had never been there. If you have low enough memory you'll forget areas of large locations like underground catacombs while you're still in them, making finding your way very confusing, as things like the exit wont be visible anymore until you find it again. Best to have at least average memory.

*'''Linguistic Ability''': Currently useless.

*'''Spatial Sense''': Important. Affects combat skills, Ambusher, Crutch Walker, Swimmer, Observer, Knapping.

*'''Musicality''': Completely useless. Use this as a dump stat.

*'''Kinaesthetic Sense''': Affects most combat skills, walking with crutches and swimming.

*'''Empathy''': Might increase chance of persuading people to join you.{{Verify}}

*'''Social Awareness''': Increases the number of followers you can have at a given "fame" level. Normally you start with a limit of two. Increasing this stat by one level raises that to three. Your fame still plays a bit part in whenever you can recruit followers or not.

=== Attribute Advancement Cap ===

Adventure mode attributes are capped at double the starting value or the starting value plus the racial average, whichever is greater. Humans, for example, have a racial average strength of 1,000. If a human adventurer starts with an ''above average'' strength of 1,100, then his strength will ultimately be capped at 2,200. Had this human started with a ''below average'' strength of 900, then his strength would be capped at 1,900 instead. For the purpose of maximizing final attributes, this makes it important to start with as many attributes in the ''superior'' range as possible (more attributes per point allocated), while avoiding taking any penalties to even remotely important attributes (big attribute deductions per point recovered). As a consequence of the attribute cap, demigod adventurers will always have a much higher potential for advancement than mere peasants and heroes.

== Starting Skills ==

Not all races have the same sets of skills available at character creation time, but keep in mind that all starting [[skill]]s, as well as ones not available at character creation, can be improved through use in game. [[Reader]] is an exception to this.

This section will specifically address starting skills as they relate to adventure mode. For a full description of combat skills see [[Combat skill]]. Other skills that you can't start with, but which can be increased in game (such as Butchery) are described elsewhere.

=== Weapon ===

The weapon you start out with will be based on which of these, plus the unarmed combat skills, is the highest. In other words, even if Swordsman is your highest weapon skill, you won't start with a sword if your Wrestler or Striker skills are better. Usually the best choice anyway is to specialize in just one melee weapon skill. Regardless of weapon skills, a '''large copper dagger''' will always be included in the starting equipment, which is handy for throwing at enemies that are just a step away or finishing off a foe pinned down by a stuck weapon.

Not all races/civilizations can start with all of these skills. (For example, Dwarves can't start with Bowman or Lasher).

Note that different races have different names for their weapon skills. Axegoblin, Axedwarf etc.

Crossbowman is a exception. Dwarves call this skill Marksdwarf, although bow skill is referred to as Bow Dwarf as you'd expect. Elite Axe and Hammer dwarves are refered to as Lords.

*'''Axeman''': allows characters to use axes, great axes, and halberds more effectively.
*'''Bowman''': skill allows characters to use bows more effectively.
*'''Crossbowman''': allows characters to use crossbows more effectively.
*'''Hammerman''': allows characters to use crossbows in melee, mauls, and war hammers more effectively.
*'''Knife User''' - allows characters to use large daggers and knives more effectively.
*'''Lasher''' - allows characters to use whips and scourges more effectively.
*'''Maceman''' - allows characters to use flails, maces, and morningstars more effectively.
*'''Pikeman''' - allows characters to use pikes more effectively.
*'''Spearman''' - allows characters to use spears more effectively.
*'''Swordsman''' - allows characters to use blowguns and bows in melee, long swords, scimitars, short swords, and two-handed swords more effectively.

=== General Combat ===

These two skills can be raised rather quickly in game and so you probably want to skip spending any points on them at the start.

*'''Fighter''' - This increases with, and contributes to, melee combat whether armed or unarmed. It appears that the purpose of it is to allow melee experience to contribute to melee combat in general regardless of weapon. Repeatedly wrestling (grabbing and releasing) even a small creature will raise this skill.
*'''Archer''' - This increases with, and contributes to, ranged combat including throwing. It works similarly to Fighter except for ranged attacks. It can be easily raised by repeatedly throwing rocks, making it advisable for archers to practice their marksmanship with rock throwing before using up the more finite and expensive forms of ammunition. Shooting at a wall with adjacent upward ramp one level below and picking back projectiles is also a good idea (such places often happen to be in castles). See the FAQ section on [[#powerleveling|powerleveling]] for information on raising bowman/marksman skills.

=== Defensive ===

These skills are critical for survival. Starting out with good ability in one (especially Shield User or Armor User) if not all is strongly advised.

*'''Shield User''' - Ability to block attacks with shields. Starting with even novice skill in this means that the adventurer will start with a shield. This is a no brainier unless you're creating a two handed weapon user.
*'''Armor User''': A higher level of this skill reduces the encumbrance penalties of armour, allowing you to move faster when wearing it. It also affects how well armour protects you and this makes a huge difference. Unskilled armour users gain little protection. This is noticeable as you'll begin seeing far more combat reports about hits either striking you though armour, (you managed to use your armour to lessen the force of the blow) or being deflected by your armour (you used your amour to avoid the hit entirety) as your skill rises and you learn to actually use your armour to deflect hits. It is highly advised to train your armour skill before entering battle with it as the speed penalties of lower levels can be a serious handicap.
*'''Dodger''' - Ability to dodge out of the way of attacks. Dodger is incredibly important and will allow you to avoid many, many hits that would have otherwise injured you. Especially important when you are fighting unarmoured and can't afford a battle axe in the chest. Boost this to talented or at least close to it.

=== Unarmed Combat and Improvised Weapons ===

While some of them come in handy at times, they can generally be raised fairly easily in game, especially Wrestler and Thrower.

*'''Wrestler''' - Ability to grapple, restrain, take-down, throw opponents, etc. Higher skill means all of these moves succeed more often. See [[#Wrestling and Unarmed Attacks]] for details. Can be raised very easily in game.
*'''Striker''' - Punching ability. Turns handy when weapons get stuck and there is no time to wrest them back.
*'''Kicker''' - Kicking ability. Same as Striker. Kicks tend to cause a lot more damage than punches and cave in heads often.
*'''Biter''' - Biting ability. Biting is surprisingly effective even with non animal races as after biting you can shake opponents around by your teeth, causing great damage and possibly ripping off body parts.
*'''Thrower''' - Throwing any miscellaneous object including rocks, knives, axes, swords, heads, etc. Skill affects accuracy and damage caused.
*'''Misc. Object User''' - Ability to beat things to death with anything that comes at hand, from bags to coins to their own severed body parts. Also somewhat more commonly used for shield bashing. This skill affects combat with any object, from a rock to a beehive. there are no separate skills for different items

=== Movement and Awareness ===

*'''[[Observer]]''' - Helps one to notice things like ambushes, enemies who are "sneaking" (stealth movement), and traps. Detection range increases with skill, but up to a maximum of 3 tiles away. Hard to train. Adding some points here is advisable.
*'''[[Swimmer]]''' - Allows movement through water without drowning. A Novice swimmer can swim but will revert to being unable to swim if stunned, which happens when falling even 1 z-level into the water, or possibly after an unfriendly encounter with a creature in the water. An Adequate swimmer can swim normally (not drown) while stunned. For this reason, ''starting out as an Adequate swimmer is advisable.'' If you don't, at least start as Novice and go get some swimming practice right away.
*'''[[Ambusher]]''' - The skill of {{K|S}}neaking around unobserved. This can be raised fairly easily by sneaking around while traveling from place to place when speed is not important. At lower skill levels, speed is greatly reduced, but the penalty gradually reduces until negated at Legendary skill and it's possible to sneak at full movement rate. Chance of detection is also reduced at higher skill levels; a more skilled ambusher can remain in close combat for longer without being detected. It is worth noting that ambusher only is checked once the adventurer is 3 tiles or closer to the enemy - at 4 tiles and up, you will remain hidden from the enemy even if you have no skill in Ambusher, as long as you are sneaking.

=== Crafting ===

These allow your character to create things. There is only one skill currently available in an unmodified game.

*'''[[Knapper]]''' - The fine art of sharpening rocks by banging them together in a clever manner. The resulting rocks become sharp rocks which do more damage when thrown and can be used for things requiring a sharp edge like butchering. Easy to raise in game and doing so helps with Kinesthetic and Spatial Sense.

=== Other ===

*'''[[Reader]]''' - Allows you to read books, signs, and writing in Adventurer mode. Novice level is required in order to become a [[Necromancer]]. There is no way to increase this skill. Adding more points is a waste, as novice allows you to read anything.
*'''[[Butcher]]''' - The art of turning corpses into piles of delicious prepared brains and meat for food. You cannot allocate points here during character creation, but that's OK since skill doesn't really affect anything anyway.

= Gameplay =

== Common UI Concepts ==
{{KeyConventions|3}}

== Moving Around ==

=== Local Movement ===
[[File:adventure-local-map.png|thumb|400px|The local travel screen. The lower left shows a small overview map of the area. The upper right shows a small area 1 z-level above the adventurer in the middle. The adventurer is standing in front of the door to a house full of humans, and visibility behind the house is obscured. In the upper left is a small box showing the direction to various sites (which may be quite far away).]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Move
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Move
|-
| {{k|Alt}} and a direction key
| Move carefully / Deliberately enter dangerous terrain
|-
| {{k|<}} or {{k|Shift}}+{{key|5}} (num lock off)
| Ascend
|-
| {{k|>}} or {{k|Ctrl}}+{{key|5}} (num lock off)
| Descend
|-
| {{k|.}}
| Wait for a step
|-
| {{k|s}}
| Stand or lie down
|-
| {{k|S}}
| Sneak
|}

Unless your character is an outsider, you will start out in a human town or hamlet; in the standard tileset the @ sign is your character. In the lower left-hand corner of the screen is a mini-map, with the @ sign showing your relative location to other things in the town/hamlet. The ▐ symbols are small collections of buildings.

The directional keys allow movement. Diagonal movement is particularly important especially when chasing or running away from things.

Use {{k|Alt}}+direction to enter water, jump off of cliffs, or otherwise attempt to enter anything that you can't enter using normal movement commands. Note that when entering water it's best to enter the actual water and not the open space over the water as, in the later case, you will fall in causing you to become stunned which may lead to drowning.

Hitting {{k|.}} allows you to stay in one place and wait for other things to move.

Use {{k|s}} to sit/lie down. Moving while laying down (crawling) will let you move past NPCs which are standing in your way. Also note that you will frequently get knocked to the ground in combat, and if you don't hit {{k|s}} to stand back up then you will crawl slowly along the ground, giving your opponent a lot of opportunity to attack you.

{{k|S}}neak will allow you to move around invisibly, limited by your Ambusher skill and the Observer skill of nearby creatures. The closer you get to a creature, the more likely you are to be detected. Your movement rate will also be very slow at low Ambusher skill levels while sneaking. If you are within observation range of anything then you will be unable to go into stealth mode. Hiding somewhere you can't be seen (such as the inside edge of a murky pool, if you can swim) will allow you to go into stealth mode when creatures are around. Stealth mode will also allow you to move onto/through townsfolk.

=== Fast Travel ===
[[Image:adventurer-fast-travel.png|thumb|400px|Fast Travel screen. A fort is on the west side, and a town is on the east side of the map. The regional map is displayed on the far right.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|T}}
| Fast Travel
|-
| {{k|>}}
| Exit fast travel mode
|}

Entering Fast Travel mode will allow you to move large distances in a single keypress. Of course, the same amount of time will go by and you can also be interrupted (ambushed) while moving in fast travel mode.

See the [[Map legend]] for information on what the map symbols mean. Settlements are indicated by {{Tile|■|7:0:1}} tiles and you can find houses by exiting fast travel while standing on one of these tiles. Yellow tiles of the same shape {{Tile|■|6:0:1}} indicate the presence of shops rather than houses.

Pressing {{K|m}} will put a fully zoomed-out map on the right side of the screen, with your current location marked by a blinking "X". When seeking out a quest, move in the direction of the quest site until the blinking "X" is on top of the symbols indicated in the Adventure Log (you can press {{K|Q}} at any time to look at it again).

Along the top of the map is a line showing the sky, and the position of the sun and/or moon from west to east. This primarily helps you determine how long you have before it gets dark at which point you won't be able to see very far and will be more vulnerable to attack.

While in the fast travel screen you can:

* {{k|c}} - Display/hide clouds/weather
* {{k|m}} - Display/hide the regional map on the right
* {{k|Q}} - Display the Quest log
* {{k|Z}} - Display the sleep menu

Other commands are not available until you exit fast travel with {{k|>}}.

== Status and Information ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|l}}
| Look around
|-
| {{k|Space}}
| Advance/Clear Messages
|-
| {{k|a}}
| View Announcements
|-
| {{k|z}}
| Status
|}

=== Looking Around ===

If you're not sure what a tile is, the {{k|l}}ook command will tell you. In addition to being useful for identifying tiles and creatures, you can also view creatures' equipment and what items are sitting on the ground in a given tile. If in doubt, try the look command.

Move the cursor to the tile you want to look at using direction keys and {{k|Shift}}+direction. It's possible to look up and down z-levels (assuming you have line of sight) using the {{k|<}} and {{k|>}} keys. This, for example, allows you to find out if any flying creatures are above you. Hit {{k|Esc}} to exit look mode and go back to movement mode.

=== Messages ===

The game makes frequent use of messages on the screen to tell you what is going on. If there are a lot of these you may need to use {{k|Space}} to display the rest of the messages that won't fit on the screen. You can always go back and view old messages by pressing {{k|a}}.

=== Status Screen ===

This screen shows your skills, attributes, wounded body parts, health (along with more detailed descriptions of your wounds), lets you view your description, and change your nickname if you want.

=== Saving the Game ===

Hit the {{k|Esc}} key at any time and select {{DFtext|Save Game}} to save your game. You can then come back to it later by using the {{DFtext|Continue Playing}} option in the main menu.

== Searching and Manipulating ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|u}}
| Interact with building, furniture, or mechanism
|-
| {{k|L}}
| Search the nearby area very carefully
|}

The {{k|u}} key can be used to do stuff like pull levers in your abandoned forts. It is also used to lower and raise the bucket when standing right next to a well so you can get water to refill your waterskin with.

{{k|L}} will perform a thorough search of the area that you're standing in, possibly revealing some small creatures.

== Managing Equipment ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|i}}
| Show Inventory
|-
| {{k|d}}
| Drop an item
|-
| {{k|g}}
| Get (pickup) an item off the ground
|-
| {{k|p}}
| Put an item into a container
|-
| {{k|r}}
| Remove an item you are wearing or from a container
|-
| {{k|w}}
| Wear an item
|-
| {{k|I}}
| Interact with an object in an advanced way. (unstick a weapon, refill waterskin etc)
|}

=== Inventory ===

Press {{k|i}} to display a list of what you are currently carrying. Press {{k|-}} {{k|+}} to scroll the list. This list will show you if items are being worn, held in hands, stuck on your body, or are inside a container. Detailed information about an object can be viewed by pressing the key associated with the item.

=== Getting/Dropping Things ===

You can {{k|d}}rop items in your inventory, as well as {{k|g}}et items on the ground on the same tile that you are standing on. If there is more than one item a menu will be listed. Press {{k|-}} {{k|+}} to scroll the list if the list is too long to fit on the screen.

{{k|g}} will also allow you to ignite foliage/any flammable objects adjacent to you. Fires aren't as devastating as one might imagine, but they will cause (most)enemies to path around them, making your crowd control slightly more effective when taking on multiple enemies. As an added bonus, it will also surely piss off the elves.

=== Containers ===

Items can be placed into containers with {{k|p}} and removed with {{k|r}}.

=== Wearing ===

Items can be worn using {{k|w}} and removed using {{k|r}} (the same command used for removing from containers). If an item you want to wear does not show up as an option, then it means you are already wearing too many items in the location used by that item. Try {{K|r}}emoving items in that location and then wear them again in order of priority. You also must put on equipment in an order that makes sense,. for example a shirt first ''then'' the armor, not the other way around. Armour must also be put on in a sensible manner with flexible layers such as chainmail first then rigid plate armour second. After all who in real life would wear chainmail over a hard plate?

''Note that "large" or "small" clothing items are too big / small for your race'' (e.g. a '''large''' giant cave spider silk sock). If you have that problem, try getting clothing from a different source.

After acquiring [[armor]] from one source or another, you'll most likely want to equip it. To do this, first make sure it is in your possession--not on the ground. You can then {{key|w}}ear it, granted you don't already have too much on that equipment slot already. You can {{key|r}}emove or {{key|d}}rop inferior equipment as necessary.

See [[Armor]] for more information on wearing things. One thing to note in particular, DF allows you to wear more than one item in the same location in many situations, for example a copper mail shirt and a copper breastplate. The thin, flexible chain can be worn under the breastplate, but not the other way around.

=== Wielding ===

There is no command for wielding items such as [[weapon]]s in specific hands. Instead, they are automatically equipped when you either {{k|g}}et them from the ground or {{k|r}}emove them from your [[backpack]] - provided the hand that would wield them is free. So in order to change [[weapon]]s or [[shield]]s you should drop items or place them into containers (such as your backpack) until your hands are free, then get items from the floor or remove them from containers which will place them in your hands. For example, put all items into backpack, remove sword from backpack, remove shield from backpack. The items will end up in the right and left hand. Simply remember the {{k|r}}emove command and the {{k|p}}ut into container command.

While normally one would only be able to equip one item in each hand, removing items from your inventory results in them being wielded regardless of whether one's hands are full. This is especially useful with shields, as every shield will contribute a block chance to each incoming attack.

It should be noted that the world of DF seems to have a lot of left handers, so do not be surprised if your character holds the weapon with the left hand and the [[Armor#Shields and Bucklers|shield]] with the right hand.

=== Advanced Interaction ===

The {{k|I}} key allows "complex interaction" with objects in your inventory.

This is used for removing arrows and weapons stuck in wounds which will appear in your inventory when they become stuck in you. Removing stuck arrows can cause bleeding so it is not always a good idea mid combat, but stuck objects will slow you down as you are encumbered by their weight. It s best to remove them as soon as possible when it is safe and you are not in danger of bleeding to death.

Advanced interaction can also be used to steal enemy equipment. Use [[wrestling]] to grab hold of a piece of enemy equipment, such as their weapon, or a helmet protecting their squishy brain and it will appear in the advanced interaction menu. Simply select it and choose "gain possession". if successful you'll take it from them. This can be very useful in battle.

This command is particularly useful for getting water. When standing next to a well you press the {{k|u}} key to lower, then raise the bucket, yielding 10 units of water in the bucket. Then you can press the {{k|I}} key to fill your waterskin from the full bucket (alternatively you can press the {{k|e}} key to drink directly from the bucket).

Advanced interactions can be used next to a campfire to heat things, such as any frozen liquids you have in your inventory(or snow lying on the ground) and need to drink. You can refill waterskins. from a nearby liquid source as well

== Time and Weather ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|D}}
| Date/Time
|-
| {{k|P}}
| Temperature
|-
| {{k|W}}
| Weather
|}

The game has a day/night cycle with time passing as various actions take place.

When using quick travel mode, the top line of the screen will indicate the position of the sun in the sky with a yellow "☼"; further to the right of the screen is earlier in the day and further to the left is later in the day.

In local travel mode you'll have to use the {{k|W}} command.

At night you won't be able to see nearly as well and you will be more vulnerable to ambush.

The game also has weather and temperature. The most common weather you'll experience is rain. Rain is shown as blue moving dots on the local travel screen and will unsurprisingly cause everything outside to become wet. Wet vegetation cannot be set on fire and you cannot light campfires in rain. Temperature is important because if it happens to drop below freezing while you're swimming through water, you'll instantly die from being encased in the ice.

Therefore you might want to keep an eye on the temperature while swimming, especially if it's getting cold.

Also, unlike fortress mode, rivers/other bodies of water can be liquid during the day, and freeze at night. The cycles of freezing can also be erratic from day to day.

Freezing weather can also freeze liquids in your inventory solid, making them undrinkable. If your water freezes and you are thirsty, try hunting down nearby enemies and slicing them up so you can drink their warm, unfrozen blood instead.

== Sleep ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Z}}
| Sleep
|}

Eventually your character will become {{DFtext|Drowsy|3:1}} and this will get worse until you get sufficient sleep.

Sleep does not necessarily have to coincide with night, but if you're traveling alone when night comes you'll be in danger of being attacked by [[Bogeymen]]. To avoid this while traveling solo you need to make it to shelter before nightfall and sleep the night away inside a building or abandoned lair. Enter a building, use {{K|k}} to talk to a human, and ask for permission to stay the night. Next press {{K|Z}} to sleep, {{K|d}} to sleep until dawn, then {{K|Enter}} to confirm. ('''NOTE''': If you stay the night in a castle, you have to sleep in the keep which houses the lord/lady of the castle. Sleeping inside the castle but outside the keep still leaves you vulnerable to attack.) Sleeping on an ocean beach also prevents bogeymen from attacking. ('''NOTE''': You can disable bogeymen by generating a world using [[advanced world generation]] and setting "Number of Night creatures" to 0)

Though sleeping inside can be safe, it's also limiting: any quest site you want to go to has to be within a daytime's round-trip time of a safe habitation, and you have to make your way to there by hopping from one habitation to the next, sleeping at each along the way. A way to avoid this is to travel with companions. If you have any companions with you then Bogeymen won't attack you. You'll still have to sleep at night, though, both to avoid sleep deprivation and because there's no visibility at night. You can still be ambushed at night by wildlife, but that's much less likely than being ambushed by Bogeymen when traveling alone. If you find yourself alone at night with nowhere safe to sleep, the safest bet is to keep traveling until dawn, even if that means running around in circles. You will eventually feel unwell from sleep deprivation, but this can take a considerable amount of time. You can make up for lost sleep once you've found your way to safety.

Note that sleeping in lairs, shrines, and labyrinths makes you safe from ambush, assuming that you or someone else has killed whatever was living there. If you have sufficient shrines/lairs/etc between you and your goal and they are either uninhabited or inhabited by things you are capable of killing then you can travel from lair to lair using each lair as a safe lodging. This is much safer than sleeping out in the open, day or night, even with companions.

If no other options are available, completely surrounding yourself with campfires will keep night marauders at bay as they cannot pass through the fires; the fires will go out after several hours and enable you to move on. The bogeymen or other enemies may be outside your line of sight, which will prevent you from firing arrows or throwing things at them. In this case, you will have to stand up and lie down {{K|s}} repeatedly until the enemies wander into your range, the fires go out and the enemies can path to you, or dawn breaks.

== Food and Drink ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|e}}
| Eat or drink something
|}

The easiest way to stay hydrated and full when starting out is by finding and fighting something weak (say, a vulture, or a raccoon, or a fox). You will almost certainly end up covered in blood. You can drink any liquid covering you using 'e' and then simply selecting the fluid - perhaps a little salty in real life, but in Dwarf Fortress it works. The corpse can then be butchered {{k|x}} for edible parts, to cure your hunger - the first two problems are solved.

Note that drinking vampire blood will turn you into a vampire instantly.

Make sure to eat or drink regularly even if you're not hungry or thirsty, as you can only eat or drink three times in a row: after that you'll need to rest,or wait until you can consume another meal. If you find yourself in need of both food and hydration, make sure to take care of the most urgent problem first, as if you are moderately hungry but severely dehydrated and eat three times, you might be already dead by the time you can drink again.

== Combat ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Attack adjacent hostile creature
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Attack adjacent hostile creature
|-
| {{k|A}}
| Attack an adjacent creature.
|-
| {{k|A}} then {{k|Enter}}
| Wrestle an adjacent creature.
|-
| {{k|f}}
| Fire a projectile
|-
| {{k|t}}
| Throw an item
|-
| {{k|C}}
| Open combat preferences interface
|}

[[Combat]] is the fine art of using physical force to cause injury and death, and it is particularly fun in Dwarf Fortress.

=== Melee Attacks ===

Hostile creatures can be attacked using a non-aimed attack by simply advancing towards your enemy using the arrow keys. Doing a non-aimed attack will also free up any stuck weapon.

Any creature can be attacked by standing next to it and pressing {{k|Shift}}+{{k|A}}. Attacking a friendly or unconscious creature (which includes wild animals for elves) will further require a confirmation, given using {{k|alt}}+{{k|y}}.

Attacking a creature with {{k|A}} will allow you to make an '''aimed attack'''. You must first select the body part that you want to attack. Look at the difficulty rating for various possible attacks. Impossible attacks will be impossible to land and Easier attacks will be very easy to land. The difficulty rating for an attack does not change depending on your weapon skill. Based on player experiences, a Grand Master weapon user can almost always land a "Tricky" strike, while a Novice generally cannot. Attacks on various locations will also have limits on how "squarely" they can land (due to being out of reach, for example). Square and very square attacks will deal more damage.{{Verify}} Attacks which "can't land squarely" are generally still effective.

Attacks aimed at the head are the most effective; a single attack to the cranium with a weapon will usually put an end to the fight. Aimed attacks are especially useful for dismembering opponents. Opponents who are missing a foot will fall over, thereby greatly lowering their speed, and giving you an immediate edge in the fight. Cutting off both hands also highly recommended for obvious reasons. After all, a field full of armless, one-legged enemies can be a big experience booster for your companions.

Aimed attacks are also especially helpful when fighting giant beasts. Some enemies like giant desert scorpions have lots of redundant body parts, and random attacks waste valuable time on low priority areas while the scorpion is busy injecting venom into the whole party. Very large enemies, like giants and hydras, are too tall for effective strikes at the head. Fighting such beasts with random attacks will prove mostly futile until the monster has been knocked over, either due to spinal injuries or loss of feet. Lastly, aimed attacks allow you to grab trophies that are not available via butchering. For example, a minotaur's horns can be cut off during a fight, but since its a humanoid, most adventurers will refuse to butcher its corpse after the fight.

=== Ranged Attacks ===

To attack with a ranged weapon press the {{k|f}} key with a ranged weapon (bow, crossbow, etc.) equipped on one hand and select the square where you want to attack. Note that you need to have some sort of ammo, corresponding to the type of ranged weapon you are using (for example, bows use arrows, crossbows use bolts). Otherwise, a message stating "You have nothing left to fire." is displayed in brown. Similarly use the {{k|t}} key to throw any random object in the same manner. Random objects appear to make a random attack if they happen to have more than one possible type.{{Verify}} For example, if you throw a sword it may hit with a blunt impact, a stabbing impact, or a slicing impact. Throwing crossbow bolts with sufficient throwing skill and strength seems to have an effect similar to firing them, although less powerful. On the plus side, you will never lose ammo if you throw it.

It is not possible to aim for specific body parts with ranged or thrown attacks.

Throwing is generally a good skill to have for any adventurer, as it allows you to slow down fleeing foes, both on the ground and in the air without the need of equipping a (cross)bow. Just like {{k|l}}ooking, you can use throwing to view and hit enemies multiple Z levels away from you. If you're lucky, you can simply land a hit that causes the flying enemy to give in to pain, and then let gravity do the rest of the work. Even if the fall doesn't kill them, they will most likely be stunned long enough for you to run up and slaughter them.

=== Wrestling and Unarmed Attacks ===

:''Main article: [[Wrestling]]''

'''[[Wrestling]]''' (grappling) can be performed by standing next to an enemy and pressing {{k|A}} followed by {{k|Enter}} to switch to wrestling. You can wrestle any enemy. Wrestling works somewhat like a targeted attack. Once you grab a creature by some body part, you may be able to make another wrestling attempt that will allow you to perform a throw or takedown.

For a detailed list of moves such as takedowns, throws, choke holds, etc, see [[Wrestling]].

It's also possible to punch, kick, and bite. These are not in the wrestling menu but are performed like normal targeted attacks with {{k|A}}.

=== Weapons ===

[[Weapon]]s are basically divided into axe, sword, spear, pike, mace, whip, bow and hammer, with various versions of these taking up the gray area.

=== Wounds ===

If you get wounded during combat, there's not much that you can do except perhaps run before you get more wounded. Your wounds will heal over time, so just travel around or sleep in a safe place. Some wounds however may never heal, leaving you permanently crippled. Obtaining a crutch may help with this. Or if you are not already a vampire, then you can get bitten by a werebeast during full moon, which will heal all injuries once per month.

If you have some bolts or arrows stuck in your body, they can be removed by using the complex interaction menu {{k|I}}. Select the stuck bolt or arrow from the list and then pull it out with {{k|a}} You'll probably start bleeding after you pull it out, but the bleeding is rarely anything to worry about.

=== Combat Preferences ===

At any time during gameplay (Except travel mode), you can press {{k|C}} to open the Combat Preferences menu. There are three different preferences you can set: Attack, Dodge and Charge Defense. These have a few different preferences each:

*'''{{k|a}}ttack'''
**'''According to Opponent''' - The default setting. When set to this, charging happens more or less frequently, depending on the difference in size between you and the opponent. Bigger opponents get charged less, smaller more often. Can be very risky, since a random charge against a huge opponent is likely to get you knocked down and stunned. In the same vein, charging when close to obstacles or other environmental hazards is very dangerous, potentially fatal, if the enemy dodges you.
**'''Strike''' - This setting ensures that you never charge an opponent, but rather just swing your weapon at them. This carries less risk than the above, but you're never going to knock anyone down without hitting their legs or spine. Very preferable against large opponents.
**'''Charge''' - When set to this, you ALWAYS charge. When faced with numerous small enemies (Bogeymen in particular), this can be extremely useful, but remember to switch back when facing something bigger. Charging a large dragon is almost a certain death sentence.
**'''Close Combat''' - With this setting, all your auto-attacks are grapples. Generally not very useful, since the random nature of it tends to prevent you from actually doing any damage with it, but if you continually auto-attack a harmless creature with it your wrestling-skill will be legendary in no time.

*'''{{k|d}}odge'''
**'''Move Around''' - This means you can jump away from attacks, physically moving in a random direction. While this lets you dodge attacks more often, it can also result in you jumping into a wall or down a lake. If you're fighting in really tight spaces, you might want to switch it off.
**'''Stand Ground''' - As can be expected, you stand your ground. No jumping around, which is useful in the above situation, but risky in the open. If you have room for jumping around, go with Move Around, but otherwise this could be a good idea.

*'''{{k|c}}harge Defense'''
**'''According to Opponent''' - Again, the default setting. You're more likely to stand still against small enemies charging, but will probably prefer moving away from larger ones. Somewhat risky, in that even a somewhat small enemy can stun you by charging.
**'''Dodge Away''' - With this, you'll dodge away from charging enemies, if you can. It's not a sure bet, but it's very much worth it against enemies who like to charge. This is probably the most preferable mode, since you're not losing a whole lot by dodging a small foe charging, but dodging an angry night beast can save you from a world of pain.
**'''Stand Ground''' - If you're certain of your physical superiority to the opponent, you can safely choose this. Standing your ground like a real man/woman might feel hardcore, but getting knocked down in a fight can be extremely dangerous. It probably has some use against bogeymen though, since they're quite small. If you really are much bigger than the enemy, you'll end up knocking THEM down. Most of the time though, charges heavily favor the attacker, so dodging away is probably preferable.

Using Combat Preferences properly can actually save your hide, so it's worth fiddling with. Just don't forget that you've fiddled with them, since a malplaced charge or dodge could end up killing you.

== Talking ==
[[File:adventurer-talking.png|thumb|400px|Talking to someone in Adventurer mode.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|k}}
| Talk to somebody
|}

Now that you know how to kill people, you may also want to know how to talk to and otherwise interact with them in a less violent manner. While this is less entertaining, it can sometimes be useful.

Press {{k|k}} to enter tal{{k|k}} mode. Move the cursor over a being and a list of language-capable beings on that tile will be shown in the lower left of the screen. If there is more than one creature on the tile, you can select the one you want to talk to using the {{k|-}}/{{k|+}} keys. Hit {{k|Enter}} to begin the conversation.

Normally you will need to Greet someone first, then you will have the following options when it comes to subjects of discussion:
*'''Trade''' - Attempt to initiate [[#Shops|trade]]. This only works for NPCs in shops.
*'''Join''' - Ask the individual to join you as one of your [[#Companions|Companions]]. Soldiers will join you 100% of the time if you don't already have too many companions, but the chance of regular townsfolk joining you will be highly impacted by your reputation.
*'''Surroundings''' - Ask about sites and things in the general geographical area. This may reveal hidden sites (such as lairs) on the map, and may also reveal bits of history such as, "in 123 Urist McSucker founded Boatmurdered". This can be selected repeatedly to reveal multiple facts about the area.
*'''Capital''' - Ask where the capital of the current civilization is. As with the "Surroundings" topic, a random bit of the capital's history will also be given.
*'''Service''' - Ask for a [[#Quests|quest]].
*'''Profession''' - Ask the individual about their profession. If the person is willing to '''Join''' you, they will add a line such as, "How I long for some excitement in my life..."
*'''Family''' - Ask about a random family member. If the person has more than one family member then selecting this option repeatedly will eventually reveal all of them. Like "Surroundings", this can also reveal bits of information about history such as, "Gor Lorthor was my son. In 123, Gor Lorthor was struck down by Trogdor the Burninator."
*'''Accuse of being a night creature''' - If the individual is a vampire in hiding, then they will become hostile to all around them and will fight you. Note, if said vampire has a cult (vampire law-givers usually seem to) the cultists will reveal themselves as well and become hostile to any non-vampire (the one the cult is based around, that is), non-cultist they see, including you.
*'''Report success/spread news''' - This option will only appear once you have completed a quest. Selecting it will cause you to regale people with tales of your amazing adventures, increasing your fame/reputation level. After you have done this once, with one person, the option will not appear again anywhere in any conversation until another quest has been completed. Apparently, everyone is telepathic, and won't want to hear the same story again.
*'''Goodbye''' - End the conversation.

Sometimes other options may also appear. Experiment with them and see what happens.

== Companions ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|c}}
| View companion interface
|}

Companions are the guys who follow you around after you've asked them to Join and they've accepted. Your character will have a limit on the maximum number of companions that is based on fame/reputation level and the ''Social Awareness'' attribute. With average social awareness and the maximum level of fame, the limit is 19 companions.

You can use the {{k|c}} key to open up a list showing your companions and their relative position to you. This can be useful if one of them runs off somewhere and you want to find them. You can select specific companions who are in visual range in order to view them. This is the same as viewing them with {{k|l}}ook.

Short of using special utilities and hacks, you can't change your companions' equipment. When they die you can loot their corpses however. (One devious and evil way to get equipment is to intentionally get your companions killed and then take their stuff.)

However, if they survive long enough/are trained well enough they seem to be capable of leveling stats or skills in some way, and are susceptible to having title or job title changed as well.

Your companions will continue to follow you and fight hostile creatures around you until they either die or are left behind by entering fast travel mode while they are too far away from you. Companions with missing feet and legs will attempt to hobble along behind you. If you need to ditch '''ALL''' of your companions, retire your adventurer in a settlement, and start playing that adventurer again. You will lose all companions by doing this(as well as resetting your thirst/hunger/sleep needs.)

If you keep losing your companions while traveling through rivers, try going to a spot where the river becomes a "minor river(single dark blue line.)" Brooks are obviously also safe to cross.

== Civilization ==

Civilizations are organized groups of creatures (generally of the same race) which build sites such as towns.

=== Towns ===

Humans live in towns comprised of buildings and often a paved road. Human villages are highly modular. The small 5x5 buildings are citizen houses and shops.

Towns appear on the fast travel map as {{Tile|■|7:0:1}} or {{Tile|■|6:0:1}} symbols which are small collections of buildings. Yellow buildings indicate the presences of shops where you can trade. The buildings can be spaced rather far apart, so even when you get your @ on top of a {{Tile|■|7:0:1}} it might take some wandering about in local travel mode to find a building.

Once you find a building, step through the door. It should have multiple U's, each of which is a human.

=== Fortresses ===

Humans also live in fortresses which appear on the fast travel map as large buildings. You can't walk over them. Instead you must move over to what looks like the entrance, exit fast travel with {{k|>}}, and walk toward the direction of the fortress.

Fortresses, if they haven't been abandoned, will be populated by soldiers, a Lord or Lady of some sort, and possibly others. If they have been abandoned then they may be overrun by various wild animals. They do not contain shops.

If control of a civilization has been taken over by a Demon, the fortress may be empty except for that demon, who acts as the Lord. He will behave as any human lord. Sometimes in an abandoned fort you might also find a demon that is a prisoner, who you can actually recruit without any significant amount of fame. If they can be trusted or not is more or less up for debate, but it is still better than Urist McFaceplant.

=== Other Sites ===

'''Note:''' Currently, only humans have civilization sites.

Elves live out in the forest, literally. Although defined to specific regions on the map, they have no structural wealth whatsoever. Some trees are named.

Dwarves live underground. Their entrances are large square pits with stairs around the perimeter, and a row of leading down into the fortress halls at the bottom. The main halls are wide and have pillars near the walls, long and occasionally turn corners. Different levels in the fortress are marked by a row of ramps with two pillars on the side (walk towards the side of the ramp that has the pillars) and, although the number of floors in a fortress can vary, they are usually little and only become deep if the lay of the land above is variable. There are two-tile-wide hallways, empty 5x5 rooms, and scant Dwarves in these pre-fab fortresses. It's obvious the computer is playing a completely different game than you are in [[Fortress mode]]!

Goblins live in [[obsidian]] towers, usually found built in twos, though they both don't necessarily have to be built up. One could be a "tower," one could be an over-glorified "basement." There is probably a temple nearby, completely similar to human temples. Goblin towers have tight 1-wide hallways, spacious and empty rooms, and strange hall extensions that end in remote cross-like dead-ends. Like dwarf fortresses, there is rarely anything in a Goblin tower asides from Goblins, and they have a strange tendency not to attack non-Goblin visitors. They seem to have lots of children.

You may come across what the map defines as a "Goblin" city that is actually populated by Humans or Dwarves living in or around the towers.

=== Shops ===

==== Trading (barter) ====
In human towns (not hamlets or castles), you can find [[building|shops]]. Once you're inside of a shop and right next to any of the NPCs, you can use {{K|k}} to talk to him/her, then select trade. Use {{K|Enter}} to select which items to trade, left/right arrow keys to switch between the list of shop items and your items, and up/down arrow keys to scroll through the lists. Once done, press {{K|t}} to trade. The shopkeeper won't get angry if you're not offering enough in trade, so you can start offering just a few items, keep trying again with a little more until the trade is accepted. Once the trade is accepted all of the items you offered will be on the floor underneath you.

After buying an item, you must pick it up manually from somewhere in the shop. {{K|l}}ook around for an item without $ signs around it. If NPCs are standing directly over the items you just bought, go prone with the {{K|s}} key so you can move onto the same space as them and pick them up.

Due to some limitations, there are only "human town" shopkeepers in a pre-fab Adventure mode civilization.

====Theft====
You may also pick up the item before buying it, but you should never walk out of a shop carrying an unbought item, as that is theft. It is punishable by death if you are caught, and excommunication if you are not. On any occasion when you have stolen goods from a store, i.e. goods bounded by the $$ signs, the game requires you to exit the site ''and'' move a considerable distance before allowing you to quick travel. This may make a getaway more difficult if your adventurer is not already faster than anyone else. This only applies to goods in stores; killing townsfolk and taking their personal things, including those of the shopkeep still only requires exiting the site. The moment you are out of sight, you will be able to warp out as usual. Theft and murder remain within entities; even depopulating one country and stealing all its things will not generate ill response in another country.

In recent versions, you may find towns that are entirely deserted. In this case, you can steal from their shops with no consequences. You can also steal items from a fortress without any consequences, but it is unknown if you can do this if there is someone else in the room to see you. {{verify}}

'''Note that if you steal anything, then nobody in that civilization will talk to you anymore, making it impossible for you to get new quests, use the shops, or get new companions.''' 

==== Selling and buying with money ====
In addition to bartering, you can sell items to a shop for coins, then use the coins to buy stuff at another shop. Just select the items you want to sell or buy, and then set a price using the following buttons:
* {{k|a}}sking for money for your goods.
* {{k|o}}ffering money for their goods.

Shopkeepers are used to adventurers with inflated ideas about the value of their goods, so it may be simplest to ask for 9000☼ for your goods, or offer 1☼ for theirs and suggest a {{k|t}}rade. The shopkeeper will counteroffer with the actual value of the goods, and will be quite delighted to accept a {{k|t}}rade at the price they've just quoted to you. You can then purchase things with your store credit.

When you end the trade session ({{k|esc}}), the items you sold will be dropped at your feet, and the balance of your coins and the items you bought will appear in your hands.

====Managing coins====
You will find that coins from one civilization are nearly worthless in other civilizations. This will typically result in adventurers carrying around lots of now useless coins. Coins can and will encumber your adventurer, eventually reducing your speed. To reduce that effect you can try to exchange your copper and silver coins for gold ones as well as sell all of your loot directly for gold coins. Remember, merchants will always try to pay you in higher denomination currency first but will resort to lower value coins if they run out of anything higher. First, check the merchant's chest to see how much of each type of coins they have.

Coin values are as follows:
* Copper Coin = 1☼
* Silver Coin = 5☼
* Gold Coin = 15☼

To receive the maximum amount of gold coins from that merchant, make sure the amount "they owe you" during the trade is equal to (total amount of gold coins the shop has)*15☼ . If you are selling loot, simply make sure you only trade this worth of goods, and move on to other merchants for the rest. If you wish to exchange copper and silver coins for gold, buy random goods from the merchant until their price is around this value and then sell back all of the goods for their original value but in gold.

Alternatively, you can take your excess coinage and use it to purchase [[Gem|large gems]] at a trinket shop. Large gems make good investments because they are 1) light, 2) variably priced, and 3) equally valuable between different civilizations.
A few goods are strictly superior to all forms of coinage as a store of value, most notably giant cave spider silk items. A suitably sneaky (or powerful) adventurer can murder a few dwarves or goblins for such items for trade and sale for human goods. Giant cave spider silk is a non-renewable resource in a given world - please harvest responsibly.

==== Where to get items to sell ====
The best place to get items to sell is at bandit camps, after you've slaughtered all the bandits. You can loot the clothes and equipment off of the corpses of the bandits (and off your fallen companions, too), plus at the very center of camp there'll be a few scattered weapons and a few bags/chests containing various goods.

The next best way to get items to sell is to kill non-talking monsters, butcher their corpses (see below for how), and pick up the edible bits. Butchered bits from the corpses of people (dwarves, elves, humans, etc) can sometimes be found in monster lairs and these seem to be just as desired by shopkeepers as the products you gain from your own butchering.

Another good early source of income can be bags left in abandoned houses/shops, which usually contain plants and food. No one will complain, and the plants inside can be sold at about 2☼ each plus the value of the bag.

At the bottom of the list comes {{k|L}}ooking Carefully and selling any small creatures you might find. However, shops will not accept live creatures unless they are in cages. Some rocks, piles of sand, and other things found on the ground nearly everywhere can also be sold for 1☼ each.

You can also try filling your backpack from river - it can hold up to 100 units of water which is worth 100☼ total. After your sell it, water will drop to the floor as a pool, and backpack can be refilled instantly and for free from there. In fact, you can infinitely fill any container from any pool/pile of any liquid/powder, so if you happen to find some precious substance like [[sunshine]] or [[dwarven sugar]], money won't be a problem for you anymore. This may be considered an [[exploit]] by some, though.

Another devious method is to go outside the shop, {{k|g}}rab handfuls of mud and throw it into your backpack, then sell them for 1☼ each. The merchants will gladly buy your rare and valuable mud despite the unlimited free mud just outside their shop.

== Quests ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Q}}
| Adventure (Quest) log (tasks, map, et cetera...)
|}

Once you have a quest, press {{K|Q}} to look at them (this screen is called the Adventure Log). The world map is on the left, with your current location highlighted by a blinking "O", while on the right is the list of your quests. You can select a quest and press {{K|z}} to find the location of the quest site: the blinking "O" will move to the quest site, with a green line drawing the path you need to take. Pressing {{K|m}} will tell you the species of the monster you're supposed to kill. You can also use the arrow keys to move the "O" around to examine the surrounding terrain and sites.

Note that once you complete a quest that you can report your success to ''any'' human. Once you tell one human, everyone in the same civilization will know about it. The Adventure Log will tell you to report back to a particular hamlet/town/castle, but you can safely ignore that.

If you're having trouble finding the site on the fast travel map for some reason, exit quick travel mode by pressing {{K|>}}. In the upper left-hand corner of the screen will be a box with symbols running down the left-hand side. At the top of the box will be the symbol of your quest site, with the compass direction to the site at to its right, and "TSK" to the right of the direction indicating an unfinished quest at that site. You can then go back into fast travel mode and head in that direction.

Once you get to the quest site, you'll be unable to enter it when using quick travel mode. Attempting to do so will give the message "You cannot travel through the [site]". You must exit quick travel mode by pressing {{K|>}} and move the rest of the way using the normal movement mode. The box in the upper left-hand corner will tell you the direction to go. When you complete the quest the "TSK" will be gone from the site's line in the box, and looking at the Adventure Log ({{K|Q}}) will show "Report Death of ..." instead of "Kill ...". You then have to move off the site using the slow travel method before entering quick travel mode again with {{K|T}} (trying to do so on the site will tell you "You cannot travel until you leave this site".)

The difficulty of the quests a certain civilization will give you goes up as your fame/reputation with that civilization increases. This is important to remember, you may want to increase your adventurer's skills or gather more companions in between quests to keep up with the rising difficulty level.

==Crafting==
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|x}}
| Perform action (butcher, create item...)
|}

Adventurers can perform limited crafting, (also known as "reactions"). To access the crafting menu, press {{k|x}}.

'''[[Knapper|Knapping]]''' allows an adventurer to sharpen a rock. '''Knapping does not work with stones in containers, only ones on the ground or in your hand.''' Stones can only be {{k|d}}ropped if the stone type does not naturally exist in the biome you are in, so to use ground stones it is worthwhile to {{k|T}}ravel far from the area you {{k|g}}ot the stones. Otherwise, you can place both stones into your hands. This can be achieved by {{k|d}}ropping whatever is held in your left and right hands, then {{k|g}}etting small stones from the ground. Next, press {{k|x}} to open the action menu, and press {{k|c}}reate and then {{k|→}} to select "Make sharp stone". You will be prompted to choose a rock to sharpen ("tool stone"), and then the hammerstone. The tool stone will be replaced in your hand by a sharp version.

'''Butchering''' acts similarly to Fortress Mode's [[Butchery]] by converting a corpse into edible products, bones, and skin. A corpse must be {{k|d}}ropped onto the ground to be butchered, or held in one hand. With a sharp object (such as a dagger or knapped stone or even a bolt/arrow) in your hand or on the same tile of the corpse, press {{k|x}}, {{k|b}}, and {{k|→}} to select the corpse, and then the sharp tool. The corpse will be replaced by its butchering returns.

These are the only reactions possible in an unmodified game though others can be added through modding.

== FAQ ==

===How do I get past NPCs which are in my way?===
Press {{K|s}} to sit, then move to roll between their legs. Once you're done press {{K|s}} to stand again.

===How do I find an entrance to the underworld?===
You cannot find caves by asking for quests. Instead, repeatedly ask NPCs about the surroundings, and they might tell you about the location of a cave. If this doesn't show any caves, travel to a hamlet/town/castle some distance away and try again. If you ever get lost, you can quickly get back to the surface by traveling under a village and retiring there. When you unretire, you'll be aboveground.

===I keep getting maimed and killed! How can I fight without getting seriously hurt?===
The best defense is a good offense. If you let your enemies attack you, you're (unsurprisingly) likely to get hurt eventually.
* Try to ''avoid fighting difficult enemies until you get some armor''. Don't fight enemies at all unless you're sure you can beat them. If you're unsure, you're probably going to get hurt.
* If you have good speed, try to ''fight enemies one-by-one'' - keep moving backwards and only attack when you're within range of just one enemy.
* If you have a slashing weapon, try to ''chop parts off of your enemy'' - it makes them stop fighting for a turn, allowing you to keep attacking them without being attacked in exchange. Chopping off limbs will also weaken your enemies - taking their arms can prevent them from using weapons, taking their legs can make them slow and knock them down.
* Remember that ''it's better to let your enemy come to you, than to go to your enemy''. You have to either move or attack. If you move, you can't attack, so if you move within range to attack your enemy, you allow them to have the first strike (unless you're much faster than them). On the other hand, if you let them move within range of you, then you get to have the first strike. If your enemy is one space away from you, use that as an opportunity to throw a knife or a rock at them; worst case, they will get a bruise or a cut; best case, they will start the melee severely crippled. If you're fast enough, then you can simply step back after getting in that first hit, and they'll have to spend their turn approaching you again. Lather, rinse, repeat.
* Follow the advice under [[#Combat Preferences|Combat Preferences]].

===How can I obtain armor as quickly as possible?===
* Here's the evil way. If you don't mind causing an entire civilization to be hostile to you (preventing trade, etc. with that civ):
** It's relatively easy to obtain some armor by killing a sleeping soldier in a fort and taking his stuff.
** Most villagers are pretty easy to kill and while their stuff isn't usually too valuable it is worth something. Instead of killing animals you can go around killing villagers and taking their stuff, then travel to another civilization that doesn't know (or maybe care) how evil you are in order to trade.
** Don't try this in the beginning if the next civilization over is more than a day or so away. You need to be able to flee to another country in order to escape justice and continue to quest/trade.
* Raid friendly fortress keeps and the dungeons of towns. They don't mind parting with just a few pieces of armor. Beware in the dungeon, you're not the only one attracted to shiny things.
* Pick companions with good equipment so you can "inherit" it when they get killed. Letting them do all of the fighting for a while might help speed up this process. While this might be kind of evil, it's not as evil as the first option and will cause you much less trouble. Even better: if you have Adequate in Swimmer, you can take a dip in the water and they will follow suit.

<div id="powerleveling"></div>

===How do I increase my skills and attributes? (Power-leveling)===

Here are some techniques for raising your skills, very rapidly in some cases.

Most of these skill-raising techniques involve repeatedly entering the same keystrokes. To assist with this you can use a [[Main:Macro|Macro]] to make entering the same sequence of keystrokes over and over again much easier.

Increasing skills increases associated attributes which may in turn benefit other skills. For example, sharpening rocks using {{k|x}} will increase Knapping which will increase a number of attributes that help with combat skills. See [[Attribute#Skills_by_Associated_Attributes|Skills and Associated Attributes]] for a mostly complete list.

*'''Fighting and Wrestling''' - A good way to raise your Fighting and Wrestling skills and related attributes is to go find a small, relatively harmless animal and wrestle with it repeatedly. You can wrestle using {{k|A}} followed by {{k|Enter}}. Continually grabbing and releasing a creature is sufficient to raise your skill, and you can do it indefinitely with the same animal as it won't be injured. Wrestling will increase Kinesthetic Sense, Spatial Sense, and to a lesser extent, Endurance. You may also somewhat increase Dodging and Shield User this way as the creature takes swipes at you.It's possible to change your {{k|C}}ombat preferences for attacking and dodging to ''Close Combat'' and ''Stand Ground'', respectively, allowing you to simply walk into the helpless critter to wrestle it. (Standing your ground prevents you from moving to dodge attacks, so your wrestling can continue uninterrupted.) You will, however, perform occasional throws and take-downs as long as the creature remains standing, which may result in their bleeding to death. If you can wrangle a creature incapable of blood-loss in a high-FPS area (such as a crab on a frozen beach), you can easily raise all associated skills and attributes to Legendary and Superhuman in the course of a few minutes.
*'''Shield User, Armor User, and Dodging''' - In addition to wrestling the creature, you can also sit back and let it attack you to raise your defensive skills. If you have metal armor, then a small animal like a gopher can't do any real damage to you when it hits. Also, to place emphasis more heavily on shield blocking, you can change your attack {{K|C}}ombat preference to ''Stand Ground''. The wrestling-a-crab-on-a-frozen-beach method also works fantastically for this.
*'''Weapon Skills and Fighting''' - Once your defensive skills are getting up there and your agility is high enough to make your speed 1300+, you might want to try fighting bogeymen to increase your weapon skill. Just make sure to fight them one at a time while running away. If you don't know what a bogeyman is yet then you are probably not ready to try this. Also, doing difficult targeted shots will gain more experience and keep the training dummy alive longer.
*'''Throwing and Archery''' - Throwing rocks with {{k|t}} will raise your Throwing and Archery skills. Throwing objects at creatures, while not as completely devastating as it once was, can still come in handy. (In early 31.xx, somebody killed a bronze colossus by throwing a fluffy wambler at its head. We can only hope the wambler survived.) Although throwing is a way to raise Archery without wasting ammunition, there is a non-wasteful method that additionally increases bow/crossbow skills.The most efficient way to level via throwing is to forgo using a macro and separate training into two phases: {{k|g}}etting and {{k|t}}hrowing. First, find a tile with an indefinite amount of throwable objects (e.g., snow, rocks, mud, etc). Then, sequentially mash {{k|g}} and whatever key the rocks are assigned to until both your forearms explode. Rest. Then, sequentially mash {{k|t}}, followed by some consistent key assigned to your rocks, then {{k|enter}}, until you've emptied your inventory. Rest. Rinse and repeat. (You may wish to empty your inventory beforehand such that the rocks are assigned to a key close to {{k|t}}, allowing you to keep one hand on {{k|enter}} and another on {{k|t}}.)
*'''Marksman, Bowman, and Archery''' - Raising the bow and crossbow weapon-specific skills is best done by shooting at a wall or cliff with no floor directly beneath it. If bolts or arrows hit a wall that has floor/ground on the same z-level, then the ammunition will be destroyed. ''However'', ammunition that falls at least one z-level after hitting a wall will remain intact. So, simply find something like a hill inside a castle, stand on it, then shoot at a wall which is on the same z-level you are. The arrows will hit the wall and fall one z-level to the ground, remaining intact. You can then {{k|g}}et the arrows and {{k|f}}ire them at the wall again from the hill, ad infinitum. You can also stand next to a wall that's two or more z-levels high, aiming at the wall one z-level up by hitting {{k|<}} after hitting {{k|f}}. Whatever method you employ, the key is that the arrow needs to fall at least one z-level after hitting a wall to remain intact. Using a macro will speed this up greatly.
*'''Ambushing and Swimming''' - An efficient way to raise Ambushing is to sneak over large stretches of land, possibly in preference to fast {{k|T}}raveling. Ideally, this would be done in a biome containing sparse vegetation and few threatening creatures to blunder into and reduce FPS (e.g., a frozen beach).Although less efficient for raising only Ambushing, it's also possible to sneak and swim at the same time, thus combining their training. ''Just make sure you start with at least Novice or Adequate in swimming'', or you'll find swimming practically impossible to train. Swimming can very quickly improve your Strength, Agility, and Endurance. Additionally, if you can safely drown and then recover (e.g., by moving under a bridge and then back before suffocating), this will raise both Toughness and Endurance at a ''ridiculous'' pace-- a single step spent drowning will raise both attributes by a fifth of a point apiece.
*'''Observer''' - You can't really power-level this skill as it is slow and difficult to train, which is why you're advised to sink some points into it during character creation. However, one way to train it appears to be sleeping or walking around in the wilderness, allowing yourself to be repeatedly ambushed. This is, however, inherently dangerous. Running away from these encounters would probably be faster than slaying your assailants, if not generally safer for your character (but not for your companions, hoh boy).Successfully detecting traps found in tombs and catacombs (performed automatically) will also raise Observer. However, without decent skill to begin with, you'll be torn to pieces by the many traps you'll fail to see. Otherwise, once you've found one or more traps, it's possible to grind experience by sleeping/waiting an hour, thus resetting the traps. Rinse and repeat.
*'''Spatial and Kinesthetic Sense''' - While sharpening rocks with {{k|x}} will improve your Knapping skill, it more importantly increases your Spatial Sense and Kinesthetic Sense attributes, which affect a number of other skills. Knapping can be combined with throwing via a macro to keep your inventory from filling up.
*'''Other Stats''' - Other useful stats like Strength, Agility, and Toughness will increase significantly as the fighting and defense skills increase, so you don't need to do anything other than what you'd normally be doing to increase these.

===I managed to escape but my limbs are chopped off. Now what?===

'Tis but a scratch!

Unfortunately, there is only one way to get them back, and that is by being bitten by a [[werebeast]] and surviving until the next full moon. But as long as you have at least one leg and one arm left you can actually do pretty well. First, get a crutch from somewhere, such as a general store, and make sure it's in one of your hands. Once you do that you should be able to {{k|s}}tand back up again. You will notice that your speed is now much slower than before.

Now go find someplace reasonably safe and walk back and forth until your Crutch Walking skill gets up to Legendary or above. You will notice your speed increasing as your skill levels up until your speed is completely back to normal. As a bonus you'll probably see some stat increases as well. You can continue to dodge with a crutch just as well as before.

You can wield a sword, shield, and crutch all in one hand, so even if you are missing an arm then you're all set. If you are missing both arms but still have both legs then unfortunately you'll be limited to biting, dodging, and wrestling with legs. If you're missing both arms and one leg then your movement will be limited and you'll be limited to biting and wrestling with your one remaining leg. And if all limbs are missing then you'll be limited to rolling around on the ground biting things.

Though you might actually be able to do surprisingly well as a Legendary Biter, especially if you powerlevel your strength to the point where you can shake things around by the teeth ripping limbs off, if you lose both legs then your character is going to be severely limited just due to the poor movement rate, so at that point it's probably best to opt for retirement or a glorious death in battle.

=== How do I keep my companions from running off after random wildlife? ===

In unmodified games, only human companions are typically available and humans currently seem to have the philosophy that all wildlife MUST DIE AN IMMEDIATE BRUTAL DEATH ASAP. While there's currently no way to order them to ignore wildlife and other neutral creatures, you can modify the ''raw\objects\entity_default.txt'' file and add the [[Creature token#A|[AT_PEACE_WITH_WILDLIFE]]] to the entity definition for humans. This will cause humans to have an elf-like attitude toward wildlife, and vice versa. Humans will then avoid killing animals and animals will not run away from humans, also giving you somewhat of an advantage when hunting as a human. However, this does mean you'll have to confirm attacks against animals with {{k|alt}}-{{k|y}}, among other things. (It's still preferable to each of your companions getting one-shotted by hooved, precision kicks to the face... damn horses.)

Animals... either you love them and they love you, or they must die a horrible death right now.

===What creatures of night can I become?===

You basically have four different choices.

Firstly, you can become a [[necromancer]].
* That gives you some traits of an undead. Namely, you don't need to eat, sleep or drink, don't tire or age, zombies or mummies don't attack you and your physical stats are permanently fixed.
* The last one means it's wise to train them beforehand.
* You also can raise dead from the {{K|x}} menu. Depending on the flavor of your spell, zombies can be slow, very slow or not slow at all. They will be listed as companions.
* To become a necromancer, find a necromancer tower and obtain a book or slab containing secrets of life and death from there, then read it. Note that most of the books are useless. In younger worlds necromancers may not have built their towers yet, in which case they'll be hanging at a zombie bandit camp, slab under the arm.

Secondly, you can become a [[vampire]].
* That gives you most traits of an undead. In addition to the listed above, you don't feel pain, don't breathe and immune to most syndromes.
* Your strength, agility and toughness are doubled.
* They're still fixed forever, so, again, be prepared.
* Despite not needing to drink water, you have a hunger for warm blood. To satisfy it, beat someone or something unconscious and {{K|e}}at their blood. However, if you are a necromancer as well as a vampire, you will not need to drink blood.
* To become a vampire, defeat one in combat and drink his blood.

Thirdly, you can become a [[werebeast]].
* This gives you the (uncontrolled) ability to transform into a powerful half-man, half-beast on a full moon.
* There's a fixed list of animals on which the werebeast is based, including goat, llama, lizard, horse, monitor, buffalo, moose, tortoise, camel, kangaroo, ape, gecko, bear, hyena, warthog, iguana, skink, shrew, elk, skunk, pig, raccoon, panda, mole, badger, armadillo, mammoth and more.
* Most importantly, upon transformation (both ways) all your wounds, including missing limbs, are instantly healed.
* You don't show any abnormalcy outside of beast form. You are still mortal.
* When in beast form, everything is hostile to you, you don't need to drink, eat, sleep or breathe, don't feel pain, don't tire and are immune to some syndromes.
* One randomly chosen metal is ten times as deadly to you than usual. All other materials deal you half damage.
* Werebeast's size is several times their base animal size, but no less than 80000. This means all armor will be too small for you while in beast form. But you can still use a shield.
* Also, some werebeasts are truly gigantic — weremammoth has a size of 9000000, on par with demons.
* To become a werebeast, make one bite you. It has to be in the beast form.
* You cannot be a werebeast and a vampire at the same time.

And finally, you can become a mist [[zombie]].
* This makes you undead. In addition to vampire traits, you can see without eyes and can't die via blood loss or beheading. Note that you don't have health point limit raised zombies have.
* You become permanently hostile to everyone except other undead.
* Your strength and toughness are tripled and fixed. Train beforehand.
* Depending on the flavor of zombie virus, your speed may or may not drop to 20% or 60% of its normal value.
* To become a mist zombie, find a mist/fog cloud that zombifies creatures and delve headdeep into it.
* You cannot become a vampire or a werebeast if you are already a zombie. The other way, however, is fine.

=See Also=
*[[Main:Adventure Mode quick reference|Adventure Mode Quick Reference]]
*[[Main:Adventure mode quick start|Adventure Mode Quickstart Guide]]

{{Getting Started}}
{{Category|Adventurer mode}}
{{Category|Interface}}

v0.34:Adventurer mode

2014-03-14T09:40:44Z

Doktoro Reichard: /* See Also */

{{Quality|Masterwork|00:47, 29 September 2013 (UTC)}}
{{av}}

:''This is a detailed reference guide for Adventurer Mode. For a tutorial see the [[Adventure mode quick start|Adventure Mode Quickstart Guide]].
:''See [[Adventure Mode quick reference]] to quickly look up key commands.

In '''Adventurer Mode''' (also called "adventure mode") you create a single adventurer ([[dwarf]], [[human]], or [[elf]]) who starts out somewhere in one of your generated worlds. You can receive [[quest]]s, venture into the wilderness to find [[cave]]s, shrines, lairs, abandoned towers, and other [[Site|towns and settlements]]. You can even visit your abandoned [[fortress]]es and find whatever riches were left to be guarded by the [[creature]]s that sealed their fate.

Unlike [[Fortress mode]], Adventurer Mode is a sort of advanced [http://en.wikipedia.org/wiki/Sandbox_game open world] version of [http://en.wikipedia.org/wiki/Rogue_%28computer_game%29 rogue] or [http://en.wikipedia.org/wiki/Nethack nethack] taking place in the same procedurally generated worlds used for Fortress Mode, but you control a single character in a turn-based manner rather than manage a group of creatures acting in real time.

=World Selection=

You can play Adventurer mode in any world that has a civilization with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token (which are elf, dwarf, and human in unmodded raws) but as of the current version only human civilizations have towns, NPC fortresses, or shops {{v|0.34.07}}. Elves simply live in the forest with nothing but a few named trees to mark their homes, while Mountainhomes that dwarves live in tend to just be a few dwarves in open space. As a result you need at least one human civilization if you want quests or anything but basic wilderness survival. Alternately, you can alter the other races to also use human towns -- see the talk page under "Dwarven Fortresses."

If you have previously built a fort in the world that you select, your adventurer will be able to go visit it. However, the fort must be abandoned because you will not be able to start an adventure mode game in the same world with an active fortress mode game. Note, though, that you can always save your fortress mode game, duplicate the save folder (copy ''regionX'' to ''regionX-copy'' or something), abandon the fortress in the copy of the world, then start adventure mode in the new clone world.

=Character Creation=

==Race and Civilization==

Any race with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token is playable in adventure mode. In an unmodded game, this means [[Dwarves]], [[Elves]], and [[Human|Humans]]. All three races can complete the same quests.

*'''Humans''' Always originate from one of the villages in the world. begin with bronze or iron weapons and can use any of the items sold by shopkeepers (who, for the time being, are only found in human towns and only sell human-sized clothing/armor). They also start with the widest variety of weapon skills.

*'''Human Outsiders''' Human Outsiders are humans that aren't from that world or any of its villages. They simply appear in the wilderness, a stranger to all. You may always play as an outsider, even if the world is otherwise completely uninhabited. Outsiders can only start with Spear User and Knife User as weapon skills, and they cannot start with Armor User or Shield User. They also start out literally naked with no clothing, but can wear any human-sized armor that they trade for, steal, or loot. "Outsiders" of other races can be played if you add the [[Entity_token#Gameplay|INDIV_CONTROLLABLE]] token to the race's entity definition.

*'''Dwarves''' have the advantage of being able to go into a [[Martial trance|martial trance]] when fighting multiple foes at once. This gives them many combat bonuses, which aids their survival greatly. They are the only race which can start with steel weapons, but they wear "small" sized clothing (like goblins and elves) which means that they're unable to wear human clothing and armour found in shops. Goblin amour will fit them so its usually easy enough to find some armour since you'll run into a lot of hostile goblins during quests. They can start with almost all of the same weapon skills as civilized humans. Most human-sized weapons (such as long swords) must be wielded two-handed by dwarves, due to their size.

*'''Elves''' start with very weak wooden weapons and have a more limited list of weapon skills during character creation. They have the advantage that they have higher natural speed. Elves also have the AT_PEACE_WITH_NATURE tag. This makes all wildlife passive towards them. Like dwarves they wear small sized clothing so will have the same problem finding suitable armour in shops.

*'''Kobolds''' can be played only if there are no other civilizations and there are kobolds. They are very small and weak in combat and a huge challenge compared to the other races. They wear even smaller armour than the other races and armour will be impossible to find for them, unless you are absurdly lucky and run into armoured kobolds.

If no civilization for the given race exists in a world you can only play as an outsider.

== Status ==

Determines the number of starting skill and attribute points, which does not change based on race:
*'''Peasant:''' 15 attribute, 35 skill
*'''Hero:''' 35 attribute, 95 skill
*'''Demigod:''' 105 attribute, 161 skill
The number of skill points is less significant than the number of attribute points because the time it takes to go from Peasant to Demigod in skill terms is much less than what it would take to go from Peasant to Demigod in attribute terms.

== Starting Attributes ==

[[Attribute|Attributes]] are divided into Body and Soul attributes. This section provides some guidance for allocating attributes as it relates to adventurer mode.

=== Body ===

*'''Strength''': Alters the damage you inflict in melee regardless of weapon used. Increases muscle size. This increased muscular layer helps prevent damage, although this is a pretty minor effect. Increasing strength, at least in adventurers, increases movement speed (albeit not as much as agility) due to better carrying capacity.
*'''Agility''': This attribute is directly related to a character's Speed and is also used in combat skills. Agility is really, really important as being faster than the enemies allows you to get more hits in before they can fight back and lets you run away more easily.
*'''Toughness''': Reduces physical damage inflicted on you. Also relates to defensive combat skills.
*'''Endurance''': Reduces the rate at which the adventurer becomes exhausted. Becoming exhausted causes you to collapse, helpless and immobile and can cause you to pass out.
*'''Recuperation''': Increases the rate of wound healing. Not as important as Toughness. Recuperation isn't that useful in adventurer mode since you usually have as much time to rest as you need assuming you can escape a situation alive.
*'''Disease Resistance''': Reduces the risk of disease. Useful for fighting enemies who use poisoned weapons.

=== Soul ===

Some of these are useful for adventure-mode-applicable skills, but some are totally useless except as dump stats.

*'''Analytical Ability''': Useful only for Knapping. Might as well reduce it to very low.

*'''Focus''': Affects Archer, Ambusher, Observer.

*'''Willpower''': Affects Fighter, Crutch Walker and Swimmer. Willpower is really important as it governs how easily you'll pass out from extreme pain. Low willpower is a death sentence if you are seriously wounded, as you'll pass out and have your head caved in. Broken bones currently cause enough pain that even very high willpower usually won't keep you concious. For non bone injuries however willpower can keep you going long enough to kill enemies, or at least get away from them.

*'''Creativity''': Completely useless.

*'''Intuition''': Only helps with Observer, which aids in spotting concealed enemies and ambushes. A useless skill since you rarely see these in adventure mode.

*'''Patience''':Currently useless.

*'''Memory''': Memory aids greatly in mapping out areas as the higher your memory the longer you'll remember an area. As you explore you'll forget previously explored areas, causing them to appear blank, as if you had never been there. If you have low enough memory you'll forget areas of large locations like underground catacombs while you're still in them, making finding your way very confusing, as things like the exit wont be visible anymore until you find it again. Best to have at least average memory.

*'''Linguistic Ability''': Currently useless.

*'''Spatial Sense''': Important. Affects combat skills, Ambusher, Crutch Walker, Swimmer, Observer, Knapping.

*'''Musicality''': Completely useless. Use this as a dump stat.

*'''Kinaesthetic Sense''': Affects most combat skills, walking with crutches and swimming.

*'''Empathy''': Might increase chance of persuading people to join you.{{Verify}}

*'''Social Awareness''': Increases the number of followers you can have at a given "fame" level. Normally you start with a limit of two. Increasing this stat by one level raises that to three. Your fame still plays a bit part in whenever you can recruit followers or not.

=== Attribute Advancement Cap ===

Adventure mode attributes are capped at double the starting value or the starting value plus the racial average, whichever is greater. Humans, for example, have a racial average strength of 1,000. If a human adventurer starts with an ''above average'' strength of 1,100, then his strength will ultimately be capped at 2,200. Had this human started with a ''below average'' strength of 900, then his strength would be capped at 1,900 instead. For the purpose of maximizing final attributes, this makes it important to start with as many attributes in the ''superior'' range as possible (more attributes per point allocated), while avoiding taking any penalties to even remotely important attributes (big attribute deductions per point recovered). As a consequence of the attribute cap, demigod adventurers will always have a much higher potential for advancement than mere peasants and heroes.

== Starting Skills ==

Not all races have the same sets of skills available at character creation time, but keep in mind that all starting [[skill]]s, as well as ones not available at character creation, can be improved through use in game. [[Reader]] is an exception to this.

This section will specifically address starting skills as they relate to adventure mode. For a full description of combat skills see [[Combat skill]]. Other skills that you can't start with, but which can be increased in game (such as Butchery) are described elsewhere.

=== Weapon ===

The weapon you start out with will be based on which of these, plus the unarmed combat skills, is the highest. In other words, even if Swordsman is your highest weapon skill, you won't start with a sword if your Wrestler or Striker skills are better. Usually the best choice anyway is to specialize in just one melee weapon skill. Regardless of weapon skills, a '''large copper dagger''' will always be included in the starting equipment, which is handy for throwing at enemies that are just a step away or finishing off a foe pinned down by a stuck weapon.

Not all races/civilizations can start with all of these skills. (For example, Dwarves can't start with Bowman or Lasher).

Note that different races have different names for their weapon skills. Axegoblin, Axedwarf etc.

Crossbowman is a exception. Dwarves call this skill Marksdwarf, although bow skill is referred to as Bow Dwarf as you'd expect. Elite Axe and Hammer dwarves are refered to as Lords.

*'''Axeman''': allows characters to use axes, great axes, and halberds more effectively.
*'''Bowman''': skill allows characters to use bows more effectively.
*'''Crossbowman''': allows characters to use crossbows more effectively.
*'''Hammerman''': allows characters to use crossbows in melee, mauls, and war hammers more effectively.
*'''Knife User''' - allows characters to use large daggers and knives more effectively.
*'''Lasher''' - allows characters to use whips and scourges more effectively.
*'''Maceman''' - allows characters to use flails, maces, and morningstars more effectively.
*'''Pikeman''' - allows characters to use pikes more effectively.
*'''Spearman''' - allows characters to use spears more effectively.
*'''Swordsman''' - allows characters to use blowguns and bows in melee, long swords, scimitars, short swords, and two-handed swords more effectively.

=== General Combat ===

These two skills can be raised rather quickly in game and so you probably want to skip spending any points on them at the start.

*'''Fighter''' - This increases with, and contributes to, melee combat whether armed or unarmed. It appears that the purpose of it is to allow melee experience to contribute to melee combat in general regardless of weapon. Repeatedly wrestling (grabbing and releasing) even a small creature will raise this skill.
*'''Archer''' - This increases with, and contributes to, ranged combat including throwing. It works similarly to Fighter except for ranged attacks. It can be easily raised by repeatedly throwing rocks, making it advisable for archers to practice their marksmanship with rock throwing before using up the more finite and expensive forms of ammunition. Shooting at a wall with adjacent upward ramp one level below and picking back projectiles is also a good idea (such places often happen to be in castles). See the FAQ section on [[#powerleveling|powerleveling]] for information on raising bowman/marksman skills.

=== Defensive ===

These skills are critical for survival. Starting out with good ability in one (especially Shield User or Armor User) if not all is strongly advised.

*'''Shield User''' - Ability to block attacks with shields. Starting with even novice skill in this means that the adventurer will start with a shield. This is a no brainier unless you're creating a two handed weapon user.
*'''Armor User''': A higher level of this skill reduces the encumbrance penalties of armour, allowing you to move faster when wearing it. It also affects how well armour protects you and this makes a huge difference. Unskilled armour users gain little protection. This is noticeable as you'll begin seeing far more combat reports about hits either striking you though armour, (you managed to use your armour to lessen the force of the blow) or being deflected by your armour (you used your amour to avoid the hit entirety) as your skill rises and you learn to actually use your armour to deflect hits. It is highly advised to train your armour skill before entering battle with it as the speed penalties of lower levels can be a serious handicap.
*'''Dodger''' - Ability to dodge out of the way of attacks. Dodger is incredibly important and will allow you to avoid many, many hits that would have otherwise injured you. Especially important when you are fighting unarmoured and can't afford a battle axe in the chest. Boost this to talented or at least close to it.

=== Unarmed Combat and Improvised Weapons ===

While some of them come in handy at times, they can generally be raised fairly easily in game, especially Wrestler and Thrower.

*'''Wrestler''' - Ability to grapple, restrain, take-down, throw opponents, etc. Higher skill means all of these moves succeed more often. See [[#Wrestling and Unarmed Attacks]] for details. Can be raised very easily in game.
*'''Striker''' - Punching ability. Turns handy when weapons get stuck and there is no time to wrest them back.
*'''Kicker''' - Kicking ability. Same as Striker. Kicks tend to cause a lot more damage than punches and cave in heads often.
*'''Biter''' - Biting ability. Biting is surprisingly effective even with non animal races as after biting you can shake opponents around by your teeth, causing great damage and possibly ripping off body parts.
*'''Thrower''' - Throwing any miscellaneous object including rocks, knives, axes, swords, heads, etc. Skill affects accuracy and damage caused.
*'''Misc. Object User''' - Ability to beat things to death with anything that comes at hand, from bags to coins to their own severed body parts. Also somewhat more commonly used for shield bashing. This skill affects combat with any object, from a rock to a beehive. there are no separate skills for different items

=== Movement and Awareness ===

*'''[[Observer]]''' - Helps one to notice things like ambushes, enemies who are "sneaking" (stealth movement), and traps. Detection range increases with skill, but up to a maximum of 3 tiles away. Hard to train. Adding some points here is advisable.
*'''[[Swimmer]]''' - Allows movement through water without drowning. A Novice swimmer can swim but will revert to being unable to swim if stunned, which happens when falling even 1 z-level into the water, or possibly after an unfriendly encounter with a creature in the water. An Adequate swimmer can swim normally (not drown) while stunned. For this reason, ''starting out as an Adequate swimmer is advisable.'' If you don't, at least start as Novice and go get some swimming practice right away.
*'''[[Ambusher]]''' - The skill of {{K|S}}neaking around unobserved. This can be raised fairly easily by sneaking around while traveling from place to place when speed is not important. At lower skill levels, speed is greatly reduced, but the penalty gradually reduces until negated at Legendary skill and it's possible to sneak at full movement rate. Chance of detection is also reduced at higher skill levels; a more skilled ambusher can remain in close combat for longer without being detected. It is worth noting that ambusher only is checked once the adventurer is 3 tiles or closer to the enemy - at 4 tiles and up, you will remain hidden from the enemy even if you have no skill in Ambusher, as long as you are sneaking.

=== Crafting ===

These allow your character to create things. There is only one skill currently available in an unmodified game.

*'''[[Knapper]]''' - The fine art of sharpening rocks by banging them together in a clever manner. The resulting rocks become sharp rocks which do more damage when thrown and can be used for things requiring a sharp edge like butchering. Easy to raise in game and doing so helps with Kinesthetic and Spatial Sense.

=== Other ===

*'''[[Reader]]''' - Allows you to read books, signs, and writing in Adventurer mode. Novice level is required in order to become a [[Necromancer]]. There is no way to increase this skill. Adding more points is a waste, as novice allows you to read anything.
*'''[[Butcher]]''' - The art of turning corpses into piles of delicious prepared brains and meat for food. You cannot allocate points here during character creation, but that's OK since skill doesn't really affect anything anyway.

= Gameplay =

== Common UI Concepts ==
{{KeyConventions|3}}

== Moving Around ==

=== Local Movement ===
[[File:adventure-local-map.png|thumb|400px|The local travel screen. The lower left shows a small overview map of the area. The upper right shows a small area 1 z-level above the adventurer in the middle. The adventurer is standing in front of the door to a house full of humans, and visibility behind the house is obscured. In the upper left is a small box showing the direction to various sites (which may be quite far away).]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Move
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Move
|-
| {{k|Alt}} and a direction key
| Move carefully / Deliberately enter dangerous terrain
|-
| {{k|<}} or {{k|Shift}}+{{key|5}} (num lock off)
| Ascend
|-
| {{k|>}} or {{k|Ctrl}}+{{key|5}} (num lock off)
| Descend
|-
| {{k|.}}
| Wait for a step
|-
| {{k|s}}
| Stand or lie down
|-
| {{k|S}}
| Sneak
|}

Unless your character is an outsider, you will start out in a human town or hamlet; in the standard tileset the @ sign is your character. In the lower left-hand corner of the screen is a mini-map, with the @ sign showing your relative location to other things in the town/hamlet. The ▐ symbols are small collections of buildings.

The directional keys allow movement. Diagonal movement is particularly important especially when chasing or running away from things.

Use {{k|Alt}}+direction to enter water, jump off of cliffs, or otherwise attempt to enter anything that you can't enter using normal movement commands. Note that when entering water it's best to enter the actual water and not the open space over the water as, in the later case, you will fall in causing you to become stunned which may lead to drowning.

Hitting {{k|.}} allows you to stay in one place and wait for other things to move.

Use {{k|s}} to sit/lie down. Moving while laying down (crawling) will let you move past NPCs which are standing in your way. Also note that you will frequently get knocked to the ground in combat, and if you don't hit {{k|s}} to stand back up then you will crawl slowly along the ground, giving your opponent a lot of opportunity to attack you.

{{k|S}}neak will allow you to move around invisibly, limited by your Ambusher skill and the Observer skill of nearby creatures. The closer you get to a creature, the more likely you are to be detected. Your movement rate will also be very slow at low Ambusher skill levels while sneaking. If you are within observation range of anything then you will be unable to go into stealth mode. Hiding somewhere you can't be seen (such as the inside edge of a murky pool, if you can swim) will allow you to go into stealth mode when creatures are around. Stealth mode will also allow you to move onto/through townsfolk.

=== Fast Travel ===
[[Image:adventurer-fast-travel.png|thumb|400px|Fast Travel screen. A fort is on the west side, and a town is on the east side of the map. The regional map is displayed on the far right.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|T}}
| Fast Travel
|-
| {{k|>}}
| Exit fast travel mode
|}

Entering Fast Travel mode will allow you to move large distances in a single keypress. Of course, the same amount of time will go by and you can also be interrupted (ambushed) while moving in fast travel mode.

See the [[Map legend]] for information on what the map symbols mean. Settlements are indicated by {{Tile|■|7:0:1}} tiles and you can find houses by exiting fast travel while standing on one of these tiles. Yellow tiles of the same shape {{Tile|■|6:0:1}} indicate the presence of shops rather than houses.

Pressing {{K|m}} will put a fully zoomed-out map on the right side of the screen, with your current location marked by a blinking "X". When seeking out a quest, move in the direction of the quest site until the blinking "X" is on top of the symbols indicated in the Adventure Log (you can press {{K|Q}} at any time to look at it again).

Along the top of the map is a line showing the sky, and the position of the sun and/or moon from west to east. This primarily helps you determine how long you have before it gets dark at which point you won't be able to see very far and will be more vulnerable to attack.

While in the fast travel screen you can:

* {{k|c}} - Display/hide clouds/weather
* {{k|m}} - Display/hide the regional map on the right
* {{k|Q}} - Display the Quest log
* {{k|Z}} - Display the sleep menu

Other commands are not available until you exit fast travel with {{k|>}}.

== Status and Information ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|l}}
| Look around
|-
| {{k|Space}}
| Advance/Clear Messages
|-
| {{k|a}}
| View Announcements
|-
| {{k|z}}
| Status
|}

=== Looking Around ===

If you're not sure what a tile is, the {{k|l}}ook command will tell you. In addition to being useful for identifying tiles and creatures, you can also view creatures' equipment and what items are sitting on the ground in a given tile. If in doubt, try the look command.

Move the cursor to the tile you want to look at using direction keys and {{k|Shift}}+direction. It's possible to look up and down z-levels (assuming you have line of sight) using the {{k|<}} and {{k|>}} keys. This, for example, allows you to find out if any flying creatures are above you. Hit {{k|Esc}} to exit look mode and go back to movement mode.

=== Messages ===

The game makes frequent use of messages on the screen to tell you what is going on. If there are a lot of these you may need to use {{k|Space}} to display the rest of the messages that won't fit on the screen. You can always go back and view old messages by pressing {{k|a}}.

=== Status Screen ===

This screen shows your skills, attributes, wounded body parts, health (along with more detailed descriptions of your wounds), lets you view your description, and change your nickname if you want.

=== Saving the Game ===

Hit the {{k|Esc}} key at any time and select {{DFtext|Save Game}} to save your game. You can then come back to it later by using the {{DFtext|Continue Playing}} option in the main menu.

== Searching and Manipulating ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|u}}
| Interact with building, furniture, or mechanism
|-
| {{k|L}}
| Search the nearby area very carefully
|}

The {{k|u}} key can be used to do stuff like pull levers in your abandoned forts. It is also used to lower and raise the bucket when standing right next to a well so you can get water to refill your waterskin with.

{{k|L}} will perform a thorough search of the area that you're standing in, possibly revealing some small creatures.

== Managing Equipment ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|i}}
| Show Inventory
|-
| {{k|d}}
| Drop an item
|-
| {{k|g}}
| Get (pickup) an item off the ground
|-
| {{k|p}}
| Put an item into a container
|-
| {{k|r}}
| Remove an item you are wearing or from a container
|-
| {{k|w}}
| Wear an item
|-
| {{k|I}}
| Interact with an object in an advanced way. (unstick a weapon, refill waterskin etc)
|}

=== Inventory ===

Press {{k|i}} to display a list of what you are currently carrying. Press {{k|-}} {{k|+}} to scroll the list. This list will show you if items are being worn, held in hands, stuck on your body, or are inside a container. Detailed information about an object can be viewed by pressing the key associated with the item.

=== Getting/Dropping Things ===

You can {{k|d}}rop items in your inventory, as well as {{k|g}}et items on the ground on the same tile that you are standing on. If there is more than one item a menu will be listed. Press {{k|-}} {{k|+}} to scroll the list if the list is too long to fit on the screen.

{{k|g}} will also allow you to ignite foliage/any flammable objects adjacent to you. Fires aren't as devastating as one might imagine, but they will cause (most)enemies to path around them, making your crowd control slightly more effective when taking on multiple enemies. As an added bonus, it will also surely piss off the elves.

=== Containers ===

Items can be placed into containers with {{k|p}} and removed with {{k|r}}.

=== Wearing ===

Items can be worn using {{k|w}} and removed using {{k|r}} (the same command used for removing from containers). If an item you want to wear does not show up as an option, then it means you are already wearing too many items in the location used by that item. Try {{K|r}}emoving items in that location and then wear them again in order of priority. You also must put on equipment in an order that makes sense,. for example a shirt first ''then'' the armor, not the other way around. Armour must also be put on in a sensible manner with flexible layers such as chainmail first then rigid plate armour second. After all who in real life would wear chainmail over a hard plate?

''Note that "large" or "small" clothing items are too big / small for your race'' (e.g. a '''large''' giant cave spider silk sock). If you have that problem, try getting clothing from a different source.

After acquiring [[armor]] from one source or another, you'll most likely want to equip it. To do this, first make sure it is in your possession--not on the ground. You can then {{key|w}}ear it, granted you don't already have too much on that equipment slot already. You can {{key|r}}emove or {{key|d}}rop inferior equipment as necessary.

See [[Armor]] for more information on wearing things. One thing to note in particular, DF allows you to wear more than one item in the same location in many situations, for example a copper mail shirt and a copper breastplate. The thin, flexible chain can be worn under the breastplate, but not the other way around.

=== Wielding ===

There is no command for wielding items such as [[weapon]]s in specific hands. Instead, they are automatically equipped when you either {{k|g}}et them from the ground or {{k|r}}emove them from your [[backpack]] - provided the hand that would wield them is free. So in order to change [[weapon]]s or [[shield]]s you should drop items or place them into containers (such as your backpack) until your hands are free, then get items from the floor or remove them from containers which will place them in your hands. For example, put all items into backpack, remove sword from backpack, remove shield from backpack. The items will end up in the right and left hand. Simply remember the {{k|r}}emove command and the {{k|p}}ut into container command.

While normally one would only be able to equip one item in each hand, removing items from your inventory results in them being wielded regardless of whether one's hands are full. This is especially useful with shields, as every shield will contribute a block chance to each incoming attack.

It should be noted that the world of DF seems to have a lot of left handers, so do not be surprised if your character holds the weapon with the left hand and the [[Armor#Shields and Bucklers|shield]] with the right hand.

=== Advanced Interaction ===

The {{k|I}} key allows "complex interaction" with objects in your inventory.

This is used for removing arrows and weapons stuck in wounds which will appear in your inventory when they become stuck in you. Removing stuck arrows can cause bleeding so it is not always a good idea mid combat, but stuck objects will slow you down as you are encumbered by their weight. It s best to remove them as soon as possible when it is safe and you are not in danger of bleeding to death.

Advanced interaction can also be used to steal enemy equipment. Use [[wrestling]] to grab hold of a piece of enemy equipment, such as their weapon, or a helmet protecting their squishy brain and it will appear in the advanced interaction menu. Simply select it and choose "gain possession". if successful you'll take it from them. This can be very useful in battle.

This command is particularly useful for getting water. When standing next to a well you press the {{k|u}} key to lower, then raise the bucket, yielding 10 units of water in the bucket. Then you can press the {{k|I}} key to fill your waterskin from the full bucket (alternatively you can press the {{k|e}} key to drink directly from the bucket).

Advanced interactions can be used next to a campfire to heat things, such as any frozen liquids you have in your inventory(or snow lying on the ground) and need to drink. You can refill waterskins. from a nearby liquid source as well

== Time and Weather ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|D}}
| Date/Time
|-
| {{k|P}}
| Temperature
|-
| {{k|W}}
| Weather
|}

The game has a day/night cycle with time passing as various actions take place.

When using quick travel mode, the top line of the screen will indicate the position of the sun in the sky with a yellow "☼"; further to the right of the screen is earlier in the day and further to the left is later in the day.

In local travel mode you'll have to use the {{k|W}} command.

At night you won't be able to see nearly as well and you will be more vulnerable to ambush.

The game also has weather and temperature. The most common weather you'll experience is rain. Rain is shown as blue moving dots on the local travel screen and will unsurprisingly cause everything outside to become wet. Wet vegetation cannot be set on fire and you cannot light campfires in rain. Temperature is important because if it happens to drop below freezing while you're swimming through water, you'll instantly die from being encased in the ice.

Therefore you might want to keep an eye on the temperature while swimming, especially if it's getting cold.

Also, unlike fortress mode, rivers/other bodies of water can be liquid during the day, and freeze at night. The cycles of freezing can also be erratic from day to day.

Freezing weather can also freeze liquids in your inventory solid, making them undrinkable. If your water freezes and you are thirsty, try hunting down nearby enemies and slicing them up so you can drink their warm, unfrozen blood instead.

== Sleep ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Z}}
| Sleep
|}

Eventually your character will become {{DFtext|Drowsy|3:1}} and this will get worse until you get sufficient sleep.

Sleep does not necessarily have to coincide with night, but if you're traveling alone when night comes you'll be in danger of being attacked by [[Bogeymen]]. To avoid this while traveling solo you need to make it to shelter before nightfall and sleep the night away inside a building or abandoned lair. Enter a building, use {{K|k}} to talk to a human, and ask for permission to stay the night. Next press {{K|Z}} to sleep, {{K|d}} to sleep until dawn, then {{K|Enter}} to confirm. ('''NOTE''': If you stay the night in a castle, you have to sleep in the keep which houses the lord/lady of the castle. Sleeping inside the castle but outside the keep still leaves you vulnerable to attack.) Sleeping on an ocean beach also prevents bogeymen from attacking. ('''NOTE''': You can disable bogeymen by generating a world using [[advanced world generation]] and setting "Number of Night creatures" to 0)

Though sleeping inside can be safe, it's also limiting: any quest site you want to go to has to be within a daytime's round-trip time of a safe habitation, and you have to make your way to there by hopping from one habitation to the next, sleeping at each along the way. A way to avoid this is to travel with companions. If you have any companions with you then Bogeymen won't attack you. You'll still have to sleep at night, though, both to avoid sleep deprivation and because there's no visibility at night. You can still be ambushed at night by wildlife, but that's much less likely than being ambushed by Bogeymen when traveling alone. If you find yourself alone at night with nowhere safe to sleep, the safest bet is to keep traveling until dawn, even if that means running around in circles. You will eventually feel unwell from sleep deprivation, but this can take a considerable amount of time. You can make up for lost sleep once you've found your way to safety.

Note that sleeping in lairs, shrines, and labyrinths makes you safe from ambush, assuming that you or someone else has killed whatever was living there. If you have sufficient shrines/lairs/etc between you and your goal and they are either uninhabited or inhabited by things you are capable of killing then you can travel from lair to lair using each lair as a safe lodging. This is much safer than sleeping out in the open, day or night, even with companions.

If no other options are available, completely surrounding yourself with campfires will keep night marauders at bay as they cannot pass through the fires; the fires will go out after several hours and enable you to move on. The bogeymen or other enemies may be outside your line of sight, which will prevent you from firing arrows or throwing things at them. In this case, you will have to stand up and lie down {{K|s}} repeatedly until the enemies wander into your range, the fires go out and the enemies can path to you, or dawn breaks.

== Food and Drink ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|e}}
| Eat or drink something
|}

The easiest way to stay hydrated and full when starting out is by finding and fighting something weak (say, a vulture, or a raccoon, or a fox). You will almost certainly end up covered in blood. You can drink any liquid covering you using 'e' and then simply selecting the fluid - perhaps a little salty in real life, but in Dwarf Fortress it works. The corpse can then be butchered {{k|x}} for edible parts, to cure your hunger - the first two problems are solved.

Note that drinking vampire blood will turn you into a vampire instantly.

Make sure to eat or drink regularly even if you're not hungry or thirsty, as you can only eat or drink three times in a row: after that you'll need to rest,or wait until you can consume another meal. If you find yourself in need of both food and hydration, make sure to take care of the most urgent problem first, as if you are moderately hungry but severely dehydrated and eat three times, you might be already dead by the time you can drink again.

== Combat ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Attack adjacent hostile creature
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Attack adjacent hostile creature
|-
| {{k|A}}
| Attack an adjacent creature.
|-
| {{k|A}} then {{k|Enter}}
| Wrestle an adjacent creature.
|-
| {{k|f}}
| Fire a projectile
|-
| {{k|t}}
| Throw an item
|-
| {{k|C}}
| Open combat preferences interface
|}

[[Combat]] is the fine art of using physical force to cause injury and death, and it is particularly fun in Dwarf Fortress.

=== Melee Attacks ===

Hostile creatures can be attacked using a non-aimed attack by simply advancing towards your enemy using the arrow keys. Doing a non-aimed attack will also free up any stuck weapon.

Any creature can be attacked by standing next to it and pressing {{k|Shift}}+{{k|A}}. Attacking a friendly or unconscious creature (which includes wild animals for elves) will further require a confirmation, given using {{k|alt}}+{{k|y}}.

Attacking a creature with {{k|A}} will allow you to make an '''aimed attack'''. You must first select the body part that you want to attack. Look at the difficulty rating for various possible attacks. Impossible attacks will be impossible to land and Easier attacks will be very easy to land. The difficulty rating for an attack does not change depending on your weapon skill. Based on player experiences, a Grand Master weapon user can almost always land a "Tricky" strike, while a Novice generally cannot. Attacks on various locations will also have limits on how "squarely" they can land (due to being out of reach, for example). Square and very square attacks will deal more damage.{{Verify}} Attacks which "can't land squarely" are generally still effective.

Attacks aimed at the head are the most effective; a single attack to the cranium with a weapon will usually put an end to the fight. Aimed attacks are especially useful for dismembering opponents. Opponents who are missing a foot will fall over, thereby greatly lowering their speed, and giving you an immediate edge in the fight. Cutting off both hands also highly recommended for obvious reasons. After all, a field full of armless, one-legged enemies can be a big experience booster for your companions.

Aimed attacks are also especially helpful when fighting giant beasts. Some enemies like giant desert scorpions have lots of redundant body parts, and random attacks waste valuable time on low priority areas while the scorpion is busy injecting venom into the whole party. Very large enemies, like giants and hydras, are too tall for effective strikes at the head. Fighting such beasts with random attacks will prove mostly futile until the monster has been knocked over, either due to spinal injuries or loss of feet. Lastly, aimed attacks allow you to grab trophies that are not available via butchering. For example, a minotaur's horns can be cut off during a fight, but since its a humanoid, most adventurers will refuse to butcher its corpse after the fight.

=== Ranged Attacks ===

To attack with a ranged weapon press the {{k|f}} key with only(!) the bow equipped and select the square where you want to attack. Similarly use the {{k|t}} key to throw any random object in the same manner. Random objects appear to make a random attack if they happen to have more than one possible type.{{Verify}} For example, if you throw a sword it may hit with a blunt impact, a stabbing impact, or a slicing impact. Throwing crossbow bolts with sufficient throwing skill and strength seems to have an effect similar to firing them, although less powerful. On the plus side, you will never lose ammo if you throw it.

It is not possible to aim for specific body parts with ranged or thrown attacks.

Throwing is generally a good skill to have for any adventurer, as it allows you to slow down fleeing foes, both on the ground and in the air without the need of equipping a (cross)bow. Just like {{k|l}}ooking, you can use throwing to view and hit enemies multiple Z levels away from you. If you're lucky, you can simply land a hit that causes the flying enemy to give in to pain, and then let gravity do the rest of the work. Even if the fall doesn't kill them, they will most likely be stunned long enough for you to run up and slaughter them.

=== Wrestling and Unarmed Attacks ===

:''Main article: [[Wrestling]]''

'''[[Wrestling]]''' (grappling) can be performed by standing next to an enemy and pressing {{k|A}} followed by {{k|Enter}} to switch to wrestling. You can wrestle any enemy. Wrestling works somewhat like a targeted attack. Once you grab a creature by some body part, you may be able to make another wrestling attempt that will allow you to perform a throw or takedown.

For a detailed list of moves such as takedowns, throws, choke holds, etc, see [[Wrestling]].

It's also possible to punch, kick, and bite. These are not in the wrestling menu but are performed like normal targeted attacks with {{k|A}}.

=== Weapons ===

[[Weapon]]s are basically divided into axe, sword, spear, pike, mace, whip, bow and hammer, with various versions of these taking up the gray area.

=== Wounds ===

If you get wounded during combat, there's not much that you can do except perhaps run before you get more wounded. Your wounds will heal over time, so just travel around or sleep in a safe place. Some wounds however may never heal, leaving you permanently crippled. Obtaining a crutch may help with this. Or if you are not already a vampire, then you can get bitten by a werebeast during full moon, which will heal all injuries once per month.

If you have some bolts or arrows stuck in your body, they can be removed by using the complex interaction menu {{k|I}}. Select the stuck bolt or arrow from the list and then pull it out with {{k|a}} You'll probably start bleeding after you pull it out, but the bleeding is rarely anything to worry about.

=== Combat Preferences ===

At any time during gameplay (Except travel mode), you can press {{k|C}} to open the Combat Preferences menu. There are three different preferences you can set: Attack, Dodge and Charge Defense. These have a few different preferences each:

*'''{{k|a}}ttack'''
**'''According to Opponent''' - The default setting. When set to this, charging happens more or less frequently, depending on the difference in size between you and the opponent. Bigger opponents get charged less, smaller more often. Can be very risky, since a random charge against a huge opponent is likely to get you knocked down and stunned. In the same vein, charging when close to obstacles or other environmental hazards is very dangerous, potentially fatal, if the enemy dodges you.
**'''Strike''' - This setting ensures that you never charge an opponent, but rather just swing your weapon at them. This carries less risk than the above, but you're never going to knock anyone down without hitting their legs or spine. Very preferable against large opponents.
**'''Charge''' - When set to this, you ALWAYS charge. When faced with numerous small enemies (Bogeymen in particular), this can be extremely useful, but remember to switch back when facing something bigger. Charging a large dragon is almost a certain death sentence.
**'''Close Combat''' - With this setting, all your auto-attacks are grapples. Generally not very useful, since the random nature of it tends to prevent you from actually doing any damage with it, but if you continually auto-attack a harmless creature with it your wrestling-skill will be legendary in no time.

*'''{{k|d}}odge'''
**'''Move Around''' - This means you can jump away from attacks, physically moving in a random direction. While this lets you dodge attacks more often, it can also result in you jumping into a wall or down a lake. If you're fighting in really tight spaces, you might want to switch it off.
**'''Stand Ground''' - As can be expected, you stand your ground. No jumping around, which is useful in the above situation, but risky in the open. If you have room for jumping around, go with Move Around, but otherwise this could be a good idea.

*'''{{k|c}}harge Defense'''
**'''According to Opponent''' - Again, the default setting. You're more likely to stand still against small enemies charging, but will probably prefer moving away from larger ones. Somewhat risky, in that even a somewhat small enemy can stun you by charging.
**'''Dodge Away''' - With this, you'll dodge away from charging enemies, if you can. It's not a sure bet, but it's very much worth it against enemies who like to charge. This is probably the most preferable mode, since you're not losing a whole lot by dodging a small foe charging, but dodging an angry night beast can save you from a world of pain.
**'''Stand Ground''' - If you're certain of your physical superiority to the opponent, you can safely choose this. Standing your ground like a real man/woman might feel hardcore, but getting knocked down in a fight can be extremely dangerous. It probably has some use against bogeymen though, since they're quite small. If you really are much bigger than the enemy, you'll end up knocking THEM down. Most of the time though, charges heavily favor the attacker, so dodging away is probably preferable.

Using Combat Preferences properly can actually save your hide, so it's worth fiddling with. Just don't forget that you've fiddled with them, since a malplaced charge or dodge could end up killing you.

== Talking ==
[[File:adventurer-talking.png|thumb|400px|Talking to someone in Adventurer mode.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|k}}
| Talk to somebody
|}

Now that you know how to kill people, you may also want to know how to talk to and otherwise interact with them in a less violent manner. While this is less entertaining, it can sometimes be useful.

Press {{k|k}} to enter tal{{k|k}} mode. Move the cursor over a being and a list of language-capable beings on that tile will be shown in the lower left of the screen. If there is more than one creature on the tile, you can select the one you want to talk to using the {{k|-}}/{{k|+}} keys. Hit {{k|Enter}} to begin the conversation.

Normally you will need to Greet someone first, then you will have the following options when it comes to subjects of discussion:
*'''Trade''' - Attempt to initiate [[#Shops|trade]]. This only works for NPCs in shops.
*'''Join''' - Ask the individual to join you as one of your [[#Companions|Companions]]. Soldiers will join you 100% of the time if you don't already have too many companions, but the chance of regular townsfolk joining you will be highly impacted by your reputation.
*'''Surroundings''' - Ask about sites and things in the general geographical area. This may reveal hidden sites (such as lairs) on the map, and may also reveal bits of history such as, "in 123 Urist McSucker founded Boatmurdered". This can be selected repeatedly to reveal multiple facts about the area.
*'''Capital''' - Ask where the capital of the current civilization is. As with the "Surroundings" topic, a random bit of the capital's history will also be given.
*'''Service''' - Ask for a [[#Quests|quest]].
*'''Profession''' - Ask the individual about their profession. If the person is willing to '''Join''' you, they will add a line such as, "How I long for some excitement in my life..."
*'''Family''' - Ask about a random family member. If the person has more than one family member then selecting this option repeatedly will eventually reveal all of them. Like "Surroundings", this can also reveal bits of information about history such as, "Gor Lorthor was my son. In 123, Gor Lorthor was struck down by Trogdor the Burninator."
*'''Accuse of being a night creature''' - If the individual is a vampire in hiding, then they will become hostile to all around them and will fight you. Note, if said vampire has a cult (vampire law-givers usually seem to) the cultists will reveal themselves as well and become hostile to any non-vampire (the one the cult is based around, that is), non-cultist they see, including you.
*'''Report success/spread news''' - This option will only appear once you have completed a quest. Selecting it will cause you to regale people with tales of your amazing adventures, increasing your fame/reputation level. After you have done this once, with one person, the option will not appear again anywhere in any conversation until another quest has been completed. Apparently, everyone is telepathic, and won't want to hear the same story again.
*'''Goodbye''' - End the conversation.

Sometimes other options may also appear. Experiment with them and see what happens.

== Companions ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|c}}
| View companion interface
|}

Companions are the guys who follow you around after you've asked them to Join and they've accepted. Your character will have a limit on the maximum number of companions that is based on fame/reputation level and the ''Social Awareness'' attribute. With average social awareness and the maximum level of fame, the limit is 19 companions.

You can use the {{k|c}} key to open up a list showing your companions and their relative position to you. This can be useful if one of them runs off somewhere and you want to find them. You can select specific companions who are in visual range in order to view them. This is the same as viewing them with {{k|l}}ook.

Short of using special utilities and hacks, you can't change your companions' equipment. When they die you can loot their corpses however. (One devious and evil way to get equipment is to intentionally get your companions killed and then take their stuff.)

However, if they survive long enough/are trained well enough they seem to be capable of leveling stats or skills in some way, and are susceptible to having title or job title changed as well.

Your companions will continue to follow you and fight hostile creatures around you until they either die or are left behind by entering fast travel mode while they are too far away from you. Companions with missing feet and legs will attempt to hobble along behind you. If you need to ditch '''ALL''' of your companions, retire your adventurer in a settlement, and start playing that adventurer again. You will lose all companions by doing this(as well as resetting your thirst/hunger/sleep needs.)

If you keep losing your companions while traveling through rivers, try going to a spot where the river becomes a "minor river(single dark blue line.)" Brooks are obviously also safe to cross.

== Civilization ==

Civilizations are organized groups of creatures (generally of the same race) which build sites such as towns.

=== Towns ===

Humans live in towns comprised of buildings and often a paved road. Human villages are highly modular. The small 5x5 buildings are citizen houses and shops.

Towns appear on the fast travel map as {{Tile|■|7:0:1}} or {{Tile|■|6:0:1}} symbols which are small collections of buildings. Yellow buildings indicate the presences of shops where you can trade. The buildings can be spaced rather far apart, so even when you get your @ on top of a {{Tile|■|7:0:1}} it might take some wandering about in local travel mode to find a building.

Once you find a building, step through the door. It should have multiple U's, each of which is a human.

=== Fortresses ===

Humans also live in fortresses which appear on the fast travel map as large buildings. You can't walk over them. Instead you must move over to what looks like the entrance, exit fast travel with {{k|>}}, and walk toward the direction of the fortress.

Fortresses, if they haven't been abandoned, will be populated by soldiers, a Lord or Lady of some sort, and possibly others. If they have been abandoned then they may be overrun by various wild animals. They do not contain shops.

If control of a civilization has been taken over by a Demon, the fortress may be empty except for that demon, who acts as the Lord. He will behave as any human lord. Sometimes in an abandoned fort you might also find a demon that is a prisoner, who you can actually recruit without any significant amount of fame. If they can be trusted or not is more or less up for debate, but it is still better than Urist McFaceplant.

=== Other Sites ===

'''Note:''' Currently, only humans have civilization sites.

Elves live out in the forest, literally. Although defined to specific regions on the map, they have no structural wealth whatsoever. Some trees are named.

Dwarves live underground. Their entrances are large square pits with stairs around the perimeter, and a row of leading down into the fortress halls at the bottom. The main halls are wide and have pillars near the walls, long and occasionally turn corners. Different levels in the fortress are marked by a row of ramps with two pillars on the side (walk towards the side of the ramp that has the pillars) and, although the number of floors in a fortress can vary, they are usually little and only become deep if the lay of the land above is variable. There are two-tile-wide hallways, empty 5x5 rooms, and scant Dwarves in these pre-fab fortresses. It's obvious the computer is playing a completely different game than you are in [[Fortress mode]]!

Goblins live in [[obsidian]] towers, usually found built in twos, though they both don't necessarily have to be built up. One could be a "tower," one could be an over-glorified "basement." There is probably a temple nearby, completely similar to human temples. Goblin towers have tight 1-wide hallways, spacious and empty rooms, and strange hall extensions that end in remote cross-like dead-ends. Like dwarf fortresses, there is rarely anything in a Goblin tower asides from Goblins, and they have a strange tendency not to attack non-Goblin visitors. They seem to have lots of children.

You may come across what the map defines as a "Goblin" city that is actually populated by Humans or Dwarves living in or around the towers.

=== Shops ===

==== Trading (barter) ====
In human towns (not hamlets or castles), you can find [[building|shops]]. Once you're inside of a shop and right next to any of the NPCs, you can use {{K|k}} to talk to him/her, then select trade. Use {{K|Enter}} to select which items to trade, left/right arrow keys to switch between the list of shop items and your items, and up/down arrow keys to scroll through the lists. Once done, press {{K|t}} to trade. The shopkeeper won't get angry if you're not offering enough in trade, so you can start offering just a few items, keep trying again with a little more until the trade is accepted. Once the trade is accepted all of the items you offered will be on the floor underneath you.

After buying an item, you must pick it up manually from somewhere in the shop. {{K|l}}ook around for an item without $ signs around it. If NPCs are standing directly over the items you just bought, go prone with the {{K|s}} key so you can move onto the same space as them and pick them up.

Due to some limitations, there are only "human town" shopkeepers in a pre-fab Adventure mode civilization.

====Theft====
You may also pick up the item before buying it, but you should never walk out of a shop carrying an unbought item, as that is theft. It is punishable by death if you are caught, and excommunication if you are not. On any occasion when you have stolen goods from a store, i.e. goods bounded by the $$ signs, the game requires you to exit the site ''and'' move a considerable distance before allowing you to quick travel. This may make a getaway more difficult if your adventurer is not already faster than anyone else. This only applies to goods in stores; killing townsfolk and taking their personal things, including those of the shopkeep still only requires exiting the site. The moment you are out of sight, you will be able to warp out as usual. Theft and murder remain within entities; even depopulating one country and stealing all its things will not generate ill response in another country.

In recent versions, you may find towns that are entirely deserted. In this case, you can steal from their shops with no consequences. You can also steal items from a fortress without any consequences, but it is unknown if you can do this if there is someone else in the room to see you. {{verify}}

'''Note that if you steal anything, then nobody in that civilization will talk to you anymore, making it impossible for you to get new quests, use the shops, or get new companions.''' 

==== Selling and buying with money ====
In addition to bartering, you can sell items to a shop for coins, then use the coins to buy stuff at another shop. Just select the items you want to sell or buy, and then set a price using the following buttons:
* {{k|a}}sking for money for your goods.
* {{k|o}}ffering money for their goods.

Shopkeepers are used to adventurers with inflated ideas about the value of their goods, so it may be simplest to ask for 9000☼ for your goods, or offer 1☼ for theirs and suggest a {{k|t}}rade. The shopkeeper will counteroffer with the actual value of the goods, and will be quite delighted to accept a {{k|t}}rade at the price they've just quoted to you. You can then purchase things with your store credit.

When you end the trade session ({{k|esc}}), the items you sold will be dropped at your feet, and the balance of your coins and the items you bought will appear in your hands.

====Managing coins====
You will find that coins from one civilization are nearly worthless in other civilizations. This will typically result in adventurers carrying around lots of now useless coins. Coins can and will encumber your adventurer, eventually reducing your speed. To reduce that effect you can try to exchange your copper and silver coins for gold ones as well as sell all of your loot directly for gold coins. Remember, merchants will always try to pay you in higher denomination currency first but will resort to lower value coins if they run out of anything higher. First, check the merchant's chest to see how much of each type of coins they have.

Coin values are as follows:
* Copper Coin = 1☼
* Silver Coin = 5☼
* Gold Coin = 15☼

To receive the maximum amount of gold coins from that merchant, make sure the amount "they owe you" during the trade is equal to (total amount of gold coins the shop has)*15☼ . If you are selling loot, simply make sure you only trade this worth of goods, and move on to other merchants for the rest. If you wish to exchange copper and silver coins for gold, buy random goods from the merchant until their price is around this value and then sell back all of the goods for their original value but in gold.

Alternatively, you can take your excess coinage and use it to purchase [[Gem|large gems]] at a trinket shop. Large gems make good investments because they are 1) light, 2) variably priced, and 3) equally valuable between different civilizations.
A few goods are strictly superior to all forms of coinage as a store of value, most notably giant cave spider silk items. A suitably sneaky (or powerful) adventurer can murder a few dwarves or goblins for such items for trade and sale for human goods. Giant cave spider silk is a non-renewable resource in a given world - please harvest responsibly.

==== Where to get items to sell ====
The best place to get items to sell is at bandit camps, after you've slaughtered all the bandits. You can loot the clothes and equipment off of the corpses of the bandits (and off your fallen companions, too), plus at the very center of camp there'll be a few scattered weapons and a few bags/chests containing various goods.

The next best way to get items to sell is to kill non-talking monsters, butcher their corpses (see below for how), and pick up the edible bits. Butchered bits from the corpses of people (dwarves, elves, humans, etc) can sometimes be found in monster lairs and these seem to be just as desired by shopkeepers as the products you gain from your own butchering.

Another good early source of income can be bags left in abandoned houses/shops, which usually contain plants and food. No one will complain, and the plants inside can be sold at about 2☼ each plus the value of the bag.

At the bottom of the list comes {{k|L}}ooking Carefully and selling any small creatures you might find. However, shops will not accept live creatures unless they are in cages. Some rocks, piles of sand, and other things found on the ground nearly everywhere can also be sold for 1☼ each.

You can also try filling your backpack from river - it can hold up to 100 units of water which is worth 100☼ total. After your sell it, water will drop to the floor as a pool, and backpack can be refilled instantly and for free from there. In fact, you can infinitely fill any container from any pool/pile of any liquid/powder, so if you happen to find some precious substance like [[sunshine]] or [[dwarven sugar]], money won't be a problem for you anymore. This may be considered an [[exploit]] by some, though.

Another devious method is to go outside the shop, {{k|g}}rab handfuls of mud and throw it into your backpack, then sell them for 1☼ each. The merchants will gladly buy your rare and valuable mud despite the unlimited free mud just outside their shop.

== Quests ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Q}}
| Adventure (Quest) log (tasks, map, et cetera...)
|}

Once you have a quest, press {{K|Q}} to look at them (this screen is called the Adventure Log). The world map is on the left, with your current location highlighted by a blinking "O", while on the right is the list of your quests. You can select a quest and press {{K|z}} to find the location of the quest site: the blinking "O" will move to the quest site, with a green line drawing the path you need to take. Pressing {{K|m}} will tell you the species of the monster you're supposed to kill. You can also use the arrow keys to move the "O" around to examine the surrounding terrain and sites.

Note that once you complete a quest that you can report your success to ''any'' human. Once you tell one human, everyone in the same civilization will know about it. The Adventure Log will tell you to report back to a particular hamlet/town/castle, but you can safely ignore that.

If you're having trouble finding the site on the fast travel map for some reason, exit quick travel mode by pressing {{K|>}}. In the upper left-hand corner of the screen will be a box with symbols running down the left-hand side. At the top of the box will be the symbol of your quest site, with the compass direction to the site at to its right, and "TSK" to the right of the direction indicating an unfinished quest at that site. You can then go back into fast travel mode and head in that direction.

Once you get to the quest site, you'll be unable to enter it when using quick travel mode. Attempting to do so will give the message "You cannot travel through the [site]". You must exit quick travel mode by pressing {{K|>}} and move the rest of the way using the normal movement mode. The box in the upper left-hand corner will tell you the direction to go. When you complete the quest the "TSK" will be gone from the site's line in the box, and looking at the Adventure Log ({{K|Q}}) will show "Report Death of ..." instead of "Kill ...". You then have to move off the site using the slow travel method before entering quick travel mode again with {{K|T}} (trying to do so on the site will tell you "You cannot travel until you leave this site".)

The difficulty of the quests a certain civilization will give you goes up as your fame/reputation with that civilization increases. This is important to remember, you may want to increase your adventurer's skills or gather more companions in between quests to keep up with the rising difficulty level.

==Crafting==
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|x}}
| Perform action (butcher, create item...)
|}

Adventurers can perform limited crafting, (also known as "reactions"). To access the crafting menu, press {{k|x}}.

'''[[Knapper|Knapping]]''' allows an adventurer to sharpen a rock. '''Knapping does not work with stones in containers, only ones on the ground or in your hand.''' Stones can only be {{k|d}}ropped if the stone type does not naturally exist in the biome you are in, so to use ground stones it is worthwhile to {{k|T}}ravel far from the area you {{k|g}}ot the stones. Otherwise, you can place both stones into your hands. This can be achieved by {{k|d}}ropping whatever is held in your left and right hands, then {{k|g}}etting small stones from the ground. Next, press {{k|x}} to open the action menu, and press {{k|c}}reate and then {{k|→}} to select "Make sharp stone". You will be prompted to choose a rock to sharpen ("tool stone"), and then the hammerstone. The tool stone will be replaced in your hand by a sharp version.

'''Butchering''' acts similarly to Fortress Mode's [[Butchery]] by converting a corpse into edible products, bones, and skin. A corpse must be {{k|d}}ropped onto the ground to be butchered, or held in one hand. With a sharp object (such as a dagger or knapped stone or even a bolt/arrow) in your hand or on the same tile of the corpse, press {{k|x}}, {{k|b}}, and {{k|→}} to select the corpse, and then the sharp tool. The corpse will be replaced by its butchering returns.

These are the only reactions possible in an unmodified game though others can be added through modding.

== FAQ ==

===How do I get past NPCs which are in my way?===
Press {{K|s}} to sit, then move to roll between their legs. Once you're done press {{K|s}} to stand again.

===How do I find an entrance to the underworld?===
You cannot find caves by asking for quests. Instead, repeatedly ask NPCs about the surroundings, and they might tell you about the location of a cave. If this doesn't show any caves, travel to a hamlet/town/castle some distance away and try again. If you ever get lost, you can quickly get back to the surface by traveling under a village and retiring there. When you unretire, you'll be aboveground.

===I keep getting maimed and killed! How can I fight without getting seriously hurt?===
The best defense is a good offense. If you let your enemies attack you, you're (unsurprisingly) likely to get hurt eventually.
* Try to ''avoid fighting difficult enemies until you get some armor''. Don't fight enemies at all unless you're sure you can beat them. If you're unsure, you're probably going to get hurt.
* If you have good speed, try to ''fight enemies one-by-one'' - keep moving backwards and only attack when you're within range of just one enemy.
* If you have a slashing weapon, try to ''chop parts off of your enemy'' - it makes them stop fighting for a turn, allowing you to keep attacking them without being attacked in exchange. Chopping off limbs will also weaken your enemies - taking their arms can prevent them from using weapons, taking their legs can make them slow and knock them down.
* Remember that ''it's better to let your enemy come to you, than to go to your enemy''. You have to either move or attack. If you move, you can't attack, so if you move within range to attack your enemy, you allow them to have the first strike (unless you're much faster than them). On the other hand, if you let them move within range of you, then you get to have the first strike. If your enemy is one space away from you, use that as an opportunity to throw a knife or a rock at them; worst case, they will get a bruise or a cut; best case, they will start the melee severely crippled. If you're fast enough, then you can simply step back after getting in that first hit, and they'll have to spend their turn approaching you again. Lather, rinse, repeat.
* Follow the advice under [[#Combat Preferences|Combat Preferences]].

===How can I obtain armor as quickly as possible?===
* Here's the evil way. If you don't mind causing an entire civilization to be hostile to you (preventing trade, etc. with that civ):
** It's relatively easy to obtain some armor by killing a sleeping soldier in a fort and taking his stuff.
** Most villagers are pretty easy to kill and while their stuff isn't usually too valuable it is worth something. Instead of killing animals you can go around killing villagers and taking their stuff, then travel to another civilization that doesn't know (or maybe care) how evil you are in order to trade.
** Don't try this in the beginning if the next civilization over is more than a day or so away. You need to be able to flee to another country in order to escape justice and continue to quest/trade.
* Raid friendly fortress keeps and the dungeons of towns. They don't mind parting with just a few pieces of armor. Beware in the dungeon, you're not the only one attracted to shiny things.
* Pick companions with good equipment so you can "inherit" it when they get killed. Letting them do all of the fighting for a while might help speed up this process. While this might be kind of evil, it's not as evil as the first option and will cause you much less trouble. Even better: if you have Adequate in Swimmer, you can take a dip in the water and they will follow suit.

<div id="powerleveling"></div>

===How do I increase my skills and attributes? (Power-leveling)===

Here are some techniques for raising your skills, very rapidly in some cases.

Most of these skill-raising techniques involve repeatedly entering the same keystrokes. To assist with this you can use a [[Main:Macro|Macro]] to make entering the same sequence of keystrokes over and over again much easier.

Increasing skills increases associated attributes which may in turn benefit other skills. For example, sharpening rocks using {{k|x}} will increase Knapping which will increase a number of attributes that help with combat skills. See [[Attribute#Skills_by_Associated_Attributes|Skills and Associated Attributes]] for a mostly complete list.

*'''Fighting and Wrestling''' - A good way to raise your Fighting and Wrestling skills and related attributes is to go find a small, relatively harmless animal and wrestle with it repeatedly. You can wrestle using {{k|A}} followed by {{k|Enter}}. Continually grabbing and releasing a creature is sufficient to raise your skill, and you can do it indefinitely with the same animal as it won't be injured. Wrestling will increase Kinesthetic Sense, Spatial Sense, and to a lesser extent, Endurance. You may also somewhat increase Dodging and Shield User this way as the creature takes swipes at you.It's possible to change your {{k|C}}ombat preferences for attacking and dodging to ''Close Combat'' and ''Stand Ground'', respectively, allowing you to simply walk into the helpless critter to wrestle it. (Standing your ground prevents you from moving to dodge attacks, so your wrestling can continue uninterrupted.) You will, however, perform occasional throws and take-downs as long as the creature remains standing, which may result in their bleeding to death. If you can wrangle a creature incapable of blood-loss in a high-FPS area (such as a crab on a frozen beach), you can easily raise all associated skills and attributes to Legendary and Superhuman in the course of a few minutes.
*'''Shield User, Armor User, and Dodging''' - In addition to wrestling the creature, you can also sit back and let it attack you to raise your defensive skills. If you have metal armor, then a small animal like a gopher can't do any real damage to you when it hits. Also, to place emphasis more heavily on shield blocking, you can change your attack {{K|C}}ombat preference to ''Stand Ground''. The wrestling-a-crab-on-a-frozen-beach method also works fantastically for this.
*'''Weapon Skills and Fighting''' - Once your defensive skills are getting up there and your agility is high enough to make your speed 1300+, you might want to try fighting bogeymen to increase your weapon skill. Just make sure to fight them one at a time while running away. If you don't know what a bogeyman is yet then you are probably not ready to try this. Also, doing difficult targeted shots will gain more experience and keep the training dummy alive longer.
*'''Throwing and Archery''' - Throwing rocks with {{k|t}} will raise your Throwing and Archery skills. Throwing objects at creatures, while not as completely devastating as it once was, can still come in handy. (In early 31.xx, somebody killed a bronze colossus by throwing a fluffy wambler at its head. We can only hope the wambler survived.) Although throwing is a way to raise Archery without wasting ammunition, there is a non-wasteful method that additionally increases bow/crossbow skills.The most efficient way to level via throwing is to forgo using a macro and separate training into two phases: {{k|g}}etting and {{k|t}}hrowing. First, find a tile with an indefinite amount of throwable objects (e.g., snow, rocks, mud, etc). Then, sequentially mash {{k|g}} and whatever key the rocks are assigned to until both your forearms explode. Rest. Then, sequentially mash {{k|t}}, followed by some consistent key assigned to your rocks, then {{k|enter}}, until you've emptied your inventory. Rest. Rinse and repeat. (You may wish to empty your inventory beforehand such that the rocks are assigned to a key close to {{k|t}}, allowing you to keep one hand on {{k|enter}} and another on {{k|t}}.)
*'''Marksman, Bowman, and Archery''' - Raising the bow and crossbow weapon-specific skills is best done by shooting at a wall or cliff with no floor directly beneath it. If bolts or arrows hit a wall that has floor/ground on the same z-level, then the ammunition will be destroyed. ''However'', ammunition that falls at least one z-level after hitting a wall will remain intact. So, simply find something like a hill inside a castle, stand on it, then shoot at a wall which is on the same z-level you are. The arrows will hit the wall and fall one z-level to the ground, remaining intact. You can then {{k|g}}et the arrows and {{k|f}}ire them at the wall again from the hill, ad infinitum. You can also stand next to a wall that's two or more z-levels high, aiming at the wall one z-level up by hitting {{k|<}} after hitting {{k|f}}. Whatever method you employ, the key is that the arrow needs to fall at least one z-level after hitting a wall to remain intact. Using a macro will speed this up greatly.
*'''Ambushing and Swimming''' - An efficient way to raise Ambushing is to sneak over large stretches of land, possibly in preference to fast {{k|T}}raveling. Ideally, this would be done in a biome containing sparse vegetation and few threatening creatures to blunder into and reduce FPS (e.g., a frozen beach).Although less efficient for raising only Ambushing, it's also possible to sneak and swim at the same time, thus combining their training. ''Just make sure you start with at least Novice or Adequate in swimming'', or you'll find swimming practically impossible to train. Swimming can very quickly improve your Strength, Agility, and Endurance. Additionally, if you can safely drown and then recover (e.g., by moving under a bridge and then back before suffocating), this will raise both Toughness and Endurance at a ''ridiculous'' pace-- a single step spent drowning will raise both attributes by a fifth of a point apiece.
*'''Observer''' - You can't really power-level this skill as it is slow and difficult to train, which is why you're advised to sink some points into it during character creation. However, one way to train it appears to be sleeping or walking around in the wilderness, allowing yourself to be repeatedly ambushed. This is, however, inherently dangerous. Running away from these encounters would probably be faster than slaying your assailants, if not generally safer for your character (but not for your companions, hoh boy).Successfully detecting traps found in tombs and catacombs (performed automatically) will also raise Observer. However, without decent skill to begin with, you'll be torn to pieces by the many traps you'll fail to see. Otherwise, once you've found one or more traps, it's possible to grind experience by sleeping/waiting an hour, thus resetting the traps. Rinse and repeat.
*'''Spatial and Kinesthetic Sense''' - While sharpening rocks with {{k|x}} will improve your Knapping skill, it more importantly increases your Spatial Sense and Kinesthetic Sense attributes, which affect a number of other skills. Knapping can be combined with throwing via a macro to keep your inventory from filling up.
*'''Other Stats''' - Other useful stats like Strength, Agility, and Toughness will increase significantly as the fighting and defense skills increase, so you don't need to do anything other than what you'd normally be doing to increase these.

===I managed to escape but my limbs are chopped off. Now what?===

'Tis but a scratch!

Unfortunately, there is only one way to get them back, and that is by being bitten by a [[werebeast]] and surviving until the next full moon. But as long as you have at least one leg and one arm left you can actually do pretty well. First, get a crutch from somewhere, such as a general store, and make sure it's in one of your hands. Once you do that you should be able to {{k|s}}tand back up again. You will notice that your speed is now much slower than before.

Now go find someplace reasonably safe and walk back and forth until your Crutch Walking skill gets up to Legendary or above. You will notice your speed increasing as your skill levels up until your speed is completely back to normal. As a bonus you'll probably see some stat increases as well. You can continue to dodge with a crutch just as well as before.

You can wield a sword, shield, and crutch all in one hand, so even if you are missing an arm then you're all set. If you are missing both arms but still have both legs then unfortunately you'll be limited to biting, dodging, and wrestling with legs. If you're missing both arms and one leg then your movement will be limited and you'll be limited to biting and wrestling with your one remaining leg. And if all limbs are missing then you'll be limited to rolling around on the ground biting things.

Though you might actually be able to do surprisingly well as a Legendary Biter, especially if you powerlevel your strength to the point where you can shake things around by the teeth ripping limbs off, if you lose both legs then your character is going to be severely limited just due to the poor movement rate, so at that point it's probably best to opt for retirement or a glorious death in battle.

=== How do I keep my companions from running off after random wildlife? ===

In unmodified games, only human companions are typically available and humans currently seem to have the philosophy that all wildlife MUST DIE AN IMMEDIATE BRUTAL DEATH ASAP. While there's currently no way to order them to ignore wildlife and other neutral creatures, you can modify the ''raw\objects\entity_default.txt'' file and add the [[Creature token#A|[AT_PEACE_WITH_WILDLIFE]]] to the entity definition for humans. This will cause humans to have an elf-like attitude toward wildlife, and vice versa. Humans will then avoid killing animals and animals will not run away from humans, also giving you somewhat of an advantage when hunting as a human. However, this does mean you'll have to confirm attacks against animals with {{k|alt}}-{{k|y}}, among other things. (It's still preferable to each of your companions getting one-shotted by hooved, precision kicks to the face... damn horses.)

Animals... either you love them and they love you, or they must die a horrible death right now.

===What creatures of night can I become?===

You basically have four different choices.

Firstly, you can become a [[necromancer]].
* That gives you some traits of an undead. Namely, you don't need to eat, sleep or drink, don't tire or age, zombies or mummies don't attack you and your physical stats are permanently fixed.
* The last one means it's wise to train them beforehand.
* You also can raise dead from the {{K|x}} menu. Depending on the flavor of your spell, zombies can be slow, very slow or not slow at all. They will be listed as companions.
* To become a necromancer, find a necromancer tower and obtain a book or slab containing secrets of life and death from there, then read it. Note that most of the books are useless. In younger worlds necromancers may not have built their towers yet, in which case they'll be hanging at a zombie bandit camp, slab under the arm.

Secondly, you can become a [[vampire]].
* That gives you most traits of an undead. In addition to the listed above, you don't feel pain, don't breathe and immune to most syndromes.
* Your strength, agility and toughness are doubled.
* They're still fixed forever, so, again, be prepared.
* Despite not needing to drink water, you have a hunger for warm blood. To satisfy it, beat someone or something unconscious and {{K|e}}at their blood. However, if you are a necromancer as well as a vampire, you will not need to drink blood.
* To become a vampire, defeat one in combat and drink his blood.

Thirdly, you can become a [[werebeast]].
* This gives you the (uncontrolled) ability to transform into a powerful half-man, half-beast on a full moon.
* There's a fixed list of animals on which the werebeast is based, including goat, llama, lizard, horse, monitor, buffalo, moose, tortoise, camel, kangaroo, ape, gecko, bear, hyena, warthog, iguana, skink, shrew, elk, skunk, pig, raccoon, panda, mole, badger, armadillo, mammoth and more.
* Most importantly, upon transformation (both ways) all your wounds, including missing limbs, are instantly healed.
* You don't show any abnormalcy outside of beast form. You are still mortal.
* When in beast form, everything is hostile to you, you don't need to drink, eat, sleep or breathe, don't feel pain, don't tire and are immune to some syndromes.
* One randomly chosen metal is ten times as deadly to you than usual. All other materials deal you half damage.
* Werebeast's size is several times their base animal size, but no less than 80000. This means all armor will be too small for you while in beast form. But you can still use a shield.
* Also, some werebeasts are truly gigantic — weremammoth has a size of 9000000, on par with demons.
* To become a werebeast, make one bite you. It has to be in the beast form.
* You cannot be a werebeast and a vampire at the same time.

And finally, you can become a mist [[zombie]].
* This makes you undead. In addition to vampire traits, you can see without eyes and can't die via blood loss or beheading. Note that you don't have health point limit raised zombies have.
* You become permanently hostile to everyone except other undead.
* Your strength and toughness are tripled and fixed. Train beforehand.
* Depending on the flavor of zombie virus, your speed may or may not drop to 20% or 60% of its normal value.
* To become a mist zombie, find a mist/fog cloud that zombifies creatures and delve headdeep into it.
* You cannot become a vampire or a werebeast if you are already a zombie. The other way, however, is fine.

=See Also=
*[[Main:Adventure Mode quick reference|Adventure Mode Quick Reference]]
*[[Main:Adventure mode quick start|Adventure Mode Quickstart Guide]]

{{Getting Started}}
{{Category|Adventurer mode}}
{{Category|Interface}}

v0.34:Macros and keymaps

2014-03-11T04:42:43Z

Doktoro Reichard: /* Creating macros */ - Clearing meaning of adding and replacing macros ingame

{{Quality|Exceptional|14:18, 4 April 2011 (UTC)}}
{{av}}
Playing Dwarf Fortress means lots of typing. The game has an internal macro/keymap system. Using it or any external program can save you a great deal of time when dumping, rewalling, designating, and so forth.

== DF macros ==
=== Creating macros ===
The controls for creating macros within DF are as follows:

*{{k|Ctrl}}+{{k|r}} = record (and finish recording)
*{{k|Ctrl}}+{{k|s}} = save
*{{k|Ctrl}}+{{k|l}} = load
*{{k|Ctrl}}+{{k|u}}+number = set to repeat [number] of times
*{{k|Ctrl}}+{{k|p}} = play

To create a macro, press {{k|Ctrl}}+{{k|r}} to begin recording your actions. When you have recorded all the actions that you want, stop recording by hitting {{k|Ctrl}}+{{k|r}} again and save ({{k|Ctrl}}+{{k|s}}) the macro. The macro is then added to your macro list. To load a macro from the list just press {{k|Ctrl}}+{{k|l}}. You can then play the macro by pressing {{k|Ctrl}}+{{k|p}} whenever you want. You can also set a macro to repeat by pressing {{k|Ctrl}}+{{k|u}}, typing a two digit number, and then pressing {{k|Ctrl}}+{{k|p}} to begin the playback session. Moving your mouse from the playing window, or otherwise losing focus on Dwarf Fortress, is <s>an annoying way</s> a good way to interrupt a macro session from continuing (also the only known method).

There is a directory data/init/macros for them. The macros are saved in .mak format. The first line of the macro file must match the filename, or the file will not be recognized as a valid macro. Even a recorded file for a simple macro - for example to create a 3 tiles wide ramp - may already consist of up to 50 commands listed. This is because every possible [[Key_bindings|binding of the key pressed]] is included in the macro and put in a block (and {{k|r}} for ramp has many by default).
<pre>
pressing_enter_recorded
SELECT
CLOSE_MEGA_ANNOUNCEMENT
WORLD_PARAM_ENTER_VALUE
SETUPGAME_SAVE_PROFILE_GO
D_BURROWS_DEFINE
D_MILITARY_ALERTS_SET
End of group
CUSTOM_CTRL_R
End of group
End of macro
</pre>
For this example the recording was started, enter was pressed and the recording was stopped. When using this macro every underlying command in the file will be called, if possible. If you are in the designation menu, it will react as a select, the other commands will be ignored. If you are in the burrow menu, it will work like pressing enter there. The macro alway ends with a block containing the end of its recording. But executing macros seems to ignore this command. If you have changed your key bindings you'll get another result, because the underlying commands are recorded, not the keys pressed. 
When creating or editing your own macros it is a good idea to use only those commands you really want.
<pre>
ramping_created
DESIGNATE_RAMP
End of group
CURSOR_DOWN_Z
End of group
SELECT
End of group
CURSOR_RIGHT
End of group
CURSOR_RIGHT
End of group
SELECT
End of group
CURSOR_LEFT
End of group
CURSOR_LEFT
End of group
CURSOR_UP
End of group
End of macro
</pre>
This selfmade example will designate a 3 tiles wide ramp one z-level below and place the cursor to make the next execution of the macro continue the way down. The first line has to be the name of the file. You can see that there are grouping tags for every single keypress. These are important for a working macro. 
It is unknown if there is the possibility of creationg loops/iterations, other programming features or comments. 

Removing macros in-game can be done by pressing {{k|Esc}} and then selecting Keybindings > Macros. Press {{k|Backspace}} on the macros you want to delete, then press {{k|Esc}} and select "Save and Exit". This will also delete the corresponding macro file permanently. Otherwise, you can delete the corresponding .mak file from the init/macros/ folder, although that will only take effect the next time DF is run.

Changing macros while the game is running uses a counter-intuitive process. After editing the macro file, create a backup of it and remove the macro as described earlier. However, before saving the changes, place the backup file on the init/macros/ folder. Then save the changes and reload the macro with {{k|Ctrl}}+{{k|l}}.

Adding macros is also possible, resorting to the macro changing process. A "dummy" macro would be recorded and saved, then deleted. The macro that would be added would replace the dummy file.
<pre>
macroscreen
OPTIONS
End of group
STANDARDSCROLL_DOWN
CURSOR_DOWN
End of group
STANDARDSCROLL_DOWN
CURSOR_DOWN
End of group
SELECT
End of group
SELECT
End of group
End of macro
</pre>

=== Tuning macros ===
The fewer commands a macro consists of, the faster it runs. This means you should avoid unnecessary steps by optimizing the "path" of your designations.

The second and most effective way to increase speed is to remove all unnecessary commands DF recorded. These may be found in the init/macros folder and edited with any basic text editing program. The extra commands are ignored by the game but they still take time to be processed. To move a cursor 3 (up/down) or 4 (right/left) commands are recorded, most other keys are bound to more commands. Pressing {{k|d}} for example records more than 30 commands.

For example the code below is a simple macro that selects the digging designation, moves one square to the right, and then designates that tile to be dug.
<pre>
example
OPTION4
CUSTOM_D
WORLD_PARAM_DELETE
LEGENDS_EXPORT_DETAILED_MAP
A_COMBAT_DODGE
A_STATUS_DESC
A_SLEEP_DAWN
A_INV_DROP
SETUP_NOTES_DELETE_NOTE
BUILDJOB_TARGET_RIGHT
BUILDJOB_BED_DORMITORY
BUILDJOB_FARM_WINTER
BUILDJOB_RACKSTAND_KILL2
HOTKEY_BUILDING_DOOR
HOTKEY_BUILDING_CONSTRUCTION_STAIR_DOWN
HOTKEY_BUILDING_WORKSHOP_DYER
BUILDING_ORIENT_RIGHT
BUILDING_ADVANCE_STAGE
BUILDING_TRIGGER_MAX_SIZE_DOWN
BUILDING_TRACK_STOP_DUMP
HOTKEY_GLASS_DOOR
HOTKEY_CARPENTER_DOOR
HOTKEY_MASON_DOOR
HOTKEY_TRAP_DOOR
BUILDJOB_STOCKPILE_DELETE_CHILD
STOCKPILE_ARMOR
STOCKPILE_SETTINGS_DISABLE
STORES_DUMP
ORDERS_DYED_CLOTH
ORDERS_ZONE_DRINKING
D_DESIGNATE
D_HAULING_STOP_LC_DIR
D_BURROWS_DELETE
D_NOTE_DELETE
D_NOTE_ROUTE_DELETE
D_BITEM_DUMP
D_LOOK_DUMP
ARENA_CREATURE_SIDE_UP
ASSIGNTRADE_SORT
DESIGNATE_DUMP
DESIGNATE_DIG
ITEM_DUMP
D_MILITARY_DISBAND_SQUAD
D_MILITARY_ALERTS_DELETE
D_MILITARY_AMMUNITION_REMOVE_ITEM
D_MILITARY_DELETE_UNIFORM
STRING_A100
End of group
STANDARDSCROLL_RIGHT
CURSOR_RIGHT
WORLD_PARAM_INCREASE
A_MOVE_E
End of group
SELECT
CLOSE_MEGA_ANNOUNCEMENT
WORLD_PARAM_ENTER_VALUE
SETUPGAME_SAVE_PROFILE_GO
D_BURROWS_DEFINE
D_MILITARY_ALERTS_SET
End of group
SELECT
CLOSE_MEGA_ANNOUNCEMENT
WORLD_PARAM_ENTER_VALUE
SETUPGAME_SAVE_PROFILE_GO
D_BURROWS_DEFINE
D_MILITARY_ALERTS_SET
End of group
CUSTOM_CTRL_R
End of group
End of macro
</pre>
Here is the same code but optimized through removal of all the excess commands. Each macro also contains an addition CUSTOM_CTRL_R command at the end that may be removed as well.
<pre>
example
DESIGNATE_DIG
End of group
CURSOR_RIGHT
End of group
SELECT
End of group
SELECT
End of group
End of macro
</pre>

The third way to increase the speed of macros is to change settings in the init-files. In the [[init.txt|base init file (data/init/init.txt)]] you will find the follow lines:
<pre>
If you set KEY_REPEAT_ACCEL_LIMIT above one, then after KEY_REPEAT_ACCEL_START repetitions
the repetition delay will smoothly decrease until repetition is this number of times faster
than at the start.

[KEY_REPEAT_ACCEL_LIMIT:8]
[KEY_REPEAT_ACCEL_START:10]

This controls the number of milliseconds between macro instructions.

[MACRO_MS:15]

</pre>

* The <code>MACRO_MS</code> setting is the number of milliseconds between macro instructions (the default, 15, allows 1000/15 instructions per second, or about 66). Decreasing this makes macros run '''faster''', although decreasing it too far can make the game unresponsive while the macro is running.
* The <code>KEY_REPEAT_ACCEL_START</code> and <code>KEY_REPEAT_ACCEL_LIMIT</code> settings are unrelated to macros (except while recording). See [[Technical tricks#Keyboard|Technical tricks]] for more information.

== External utilities ==

=== [http://joelpt.net/quickfort/ QuickFort] ===
A spreadsheet-driven construction tool for Dwarf Fortress. Converts CSV files containing a "graphical" (or at least two-dimensional) representation of what you want to build into efficient DF macros. Comes with a number of scripts to get you started, some of them quite complex.

=== AutoHotKey ===
AutoHotKey is a powerful easy-to-use scripting language that can simulate keystrokes. (among other functions)

To started:
# Go to the [http://www.autohotkey.com/ AutoHotKey website] and download AutoHotKey. Installation is simple and the program uses very little system resources.
# Read through their [http://www.autohotkey.com/docs/Tutorial.htm quick-start guide] and start write your macro scripts (file type .ahk), which may contain any number of commands. You activate scripts by double-clicking .ahk files or by assigning hotkeys to your macros. Both of these can be done at any time - even right in the middle of a game. AutoHotKey also allows for automated activation of scripts.

=== Fluxbox + xvkbd ===
For linux, it's a quite cool solution. It's possible to create macros with outside tools, like fluxbox (linux window manager) + xvkbd (linux virtual keyboard for kiosks, with some macro capabilities). See the documentation [[Fluxbox_macros|here]].

Pros:
*Faster execution
*Easier script writing
*Portable code
Cons:
*Sometime needs timing
*Need xvkbd (Linux at least)
*Need some special key reservation

'''Please see also the [[40d:Macros and Keymaps|40d macros page]], as much of what is there works perfectly fine. If you can verify it works, please move it to this page.'''

== Useful Macro Ideas ==

The following are macro ideas that other players have found useful, and may make management of your fort easier. For most macros it's highly recommended to '''pause the game''' before hitting the play button to avoid your dwarves causing unexpected behavior, i.e. a dwarf giving birth or anything else that auto-zooms to a different location.

=== Large Bedrooms ===

Bedrooms, especially larger ones or large blocks of identical ones, involve a lot of designations and build orders. These macros are designed to streamline the process. For all of these mass-building macros you may wish to temporarily forbid any of your artifact or masterwork furniture, to avoid giving overly-valuable items to your dwarf peasantry.

==== Placing Beds ====

So you've recorded a macro to dig out a series of bedrooms, and now you have to fill them. Bring up the {{k|b}}uild menu, select {{k|b}}ed, and go the first position you want to place a bed in.

Start a new macro ({{k|Ctrl}}+{{k|r}}) and place the bed (selecting the first bed from the list), then move to the next bedroom in sequence. Repeat this until you reach the end of the row. If you are placing beds into multiple long rows of bedrooms, move the cursor to the first bed in the next row to make things faster. Turn off macro recording ({{k|Ctrl}}+{{k|r}}), but don't exit the build menu. You can then save your macro if you wish, though it's not necessary. Play the macro ({{k|Ctrl}}+{{k|p}}), and you have just laid out another row. Repeat until you have enough bedrooms or you run out of beds.

==== Placing Coffers ====

Placing coffers (but ''not'' bags) requires an extra step. Pause the game (you ''did'' remember to pause before playing macros, didn't you?) and go to the Stocks menu. Forbid all bags, regardless of what's inside them or what they're being used for (this is temporary). Exit to main screen and repeat the steps above, this time placing containers in your rooms. You will end up placing only chests / coffers / boxes, ignoring any bags. Repeat and play back for the rest of your bedrooms, then un-forbid your bags before un-pausing the game.

==== Resizing Rooms ====

If the bedroom is finished (at least all the beds are hauled to place), you may want to create a new macro to designate each room as a bedroom. {{k|q}}uery the building and select the first bed. Start a new macro and press {{k|r}} to designate it as a bedroom, then press + a few times to fill the available space. If you are fine with the size of the bedroom you can press enter, move on to the next bed, and repeat this for the whole row. If you want bedrooms that fill all the room and not all your bedrooms are the same size, you may have to press + a bit more or less for the larger cases. Repeat this for the rest of the rows as above.

=== Mass Selector ===

With this macro you can select a lot of things at once. Extremely helpful if you want to sell a lot of junk to the caravans. Record {{k|enter}}, then {{k|down}} about 10-25 times in a row. (For some menus you may wish to use {{k|enter}}, then {{k|+}}) When the caravan arrives, your dwarves haul all the bins to your Trade Depot for sale as normal. At the trade menu, load the macro and play it as many times as you like. The macro will select all the items in your "for sale" list, saving the bins you carried them in for later use. Be sure to at least browse through the final list once you're done to avoid selling items you didn't wish to sell, i.e. items that were in the same bin as your trade goods that you wish to keep, or wood items if you're trading with the Elves.

=== Mass Trap Builder ===

It's basically just the same as building items in bedrooms, but for traps. Useful for populating entire hallways with weapon or stone-fall traps.

=== Custom Uniforms ===

Since custom uniforms are not saved from one fortress to another, it can be tedious to remake them after each new embark. Instead, you can record a few macros to create each of your custom uniforms (Axedwarves with full armor, Wrestlers with light armor, Archers, Civilians, etc.) It is recommended to start recording each macro from the main window, before entering the (m)ilitary screen, and to avoid naming the uniform as part of the macro. Because of the way the uniform menu is set up, you should also be careful not to move the cursor back into the uniform list during the recording of your macro, or problems may arise. As always, pause the game before you start recording or playback.

=== Digging in Odd Directions/Shapes ===

While it is very simple and fast to designate mining in any of the 6 possible linear directions (North, East, South, West, Up, and Down) in very long sections, specialized mining, such as diagonal hallways, circular rooms, etc., are more difficult. It may be worth, for example, recording 4 macros that dig a short section of 3-tile wide hallway in non-standard directions (NE, NW, SW, and SE). This way, when you want a hallway dug at a 45 degree angle you just load the appropriate macro and keep playing it until the hallway is the desired length.

=== Downshafts ===

Simple up/down stairs are easy to do, but if your standard fort layout includes stairs with empty spaces around them, like so...
<pre>
(rooms)

%%..%%
%....%
(more ..XX.. (still
rooms) ..XX.. more
%....% rooms)
%%..%%

(etc...)
</pre>
...it can be cumbersome to designate all of that for multiple Z-levels at once. Instead, create a macro from one reference point (say, the top-left staircase of the 2x2 shaft or some such) and hit record, then designate the staircase area as you see fit. Move the cursor back to your reference point and move down one Z-level, then stop recording. You can now load it up and play it wherever you need it.

For added awesomeness, trim out the extra commands in a text editor as described above. Then highlight the whole macro and copy/paste it into a new file, copying the commands 5 times or as many as you want. Then save the new macro as a separate file (be sure to rename it at the top of the macro text as well). In this way you can have easy-to-use macros for digging your own standard stairwell. Separate macros for 1 level, 5 levels, and 20 levels seem to work well.

== Troubleshooting Scripts ==
Users may experience some issues in getting external scripts to work, particularly when using looping scripts when experiencing low frame-rates.
* If experiencing low frame-rates, try adding delays ("Sleep 100" to pause for 100 milliseconds for example) within macros to allow the interface to keep up. If there are nested loops, sometimes adding a pause at the end of an inner loop is all that is needed to flush the keyboard buffer.
* Another way to add delay during and after each simulated key press is to put SetKeyDelay, 40, 40 at the start of the macro.
* Make sure that Dwarf Fortress maintains focus. IM windows are the enemy! Who needs friends anyhow? You've got Dwarf Fortress.
* This may go without saying, but most macros assume standard key-mappings. If you're using non-standard ones, you may have to edit the macro to get it to work.
* Visiting liaisons can bring up screens that eat keystrokes, throwing a long-looping script out-of-phase with where it expects the game to be. Wait for the farewell screen before running a long script, or just pause the game beforehand.
* The SendPlay function supports keys that the Send function does not, for example {{key|Shift-Enter}}. According to the AutoHotKey documentation, SendPlay may also be better at preventing dropped keystrokes.

=== General Fortress Mode Hotkeys Script ===
An attempt at speeding up various designations. Includes an up/down stair builder, a fast move up/down, and some select-and-advance keys. Please see [[user:DDR#Dwarf_Fortress_General_AHK_Script]].

v0.34 Talk:Macros and keymaps

2014-03-11T04:21:41Z

Doktoro Reichard: /* How do you "delete and reload" a macro? */

== Designating start point ==
:Recording mining operations
Press d, move the cursor to the start point. Start recording. If you want to mine press d again and continue with the macro.

:Playing macros
Press d, move the cursor to the start position, load the macro Ctrl+l. Play the macro Ctrl+p

== Coordinates ==
Macros are locally coordinated, that means they act on the current view and start at the default position, unless you move the cursor by pressing d

== Moving mouse outside window ==

I can confirm it... sort of. Upon moving my mouse to the Window bar, the macro I was executing stopped, although the "Play" indicator remained. I'm using the latest SDL version, if it matters.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 03:37, 16 February 2014 (UTC)

:I also have this issue on other platforms, usually when switching to another application (using SDL, of course). Maybe it's SDL-specific, although I can't check because running the Legacy version in Wine would almost certainly produce different results than running it on Windows. I haven't found this on the bug tracker, but I'll check again when I get a chance. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 03:58, 16 February 2014 (UTC)

::FWIW it isn't a bug: it's the only way to stop a macro while executing. I merely posted this as to close a verify tag that was on the page.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 12:22, 16 February 2014 (UTC)

== How do you "delete and reload" a macro? ==

The article says this:
<blockquote>
Changing, removing and adding macros while the game is running uses a counter-intuitive process. After editing the file, you must delete and reload the macro. Select Options>KeyBindings>Macros. Delete the macro and reload it with {{k|Ctrl}}+{{k|l}}.
</blockquote>
However, in my experience, you can't reload a macro once it has been deleted. Can someone clarify this, please?

:It's, as it indicates, contrived and counter intuitive, although the explanation is lacking. After deleting the macro from the Keybindings menu (but without leaving the menu), I then was compelled to copy a backup of the amended file to the macro folder, which worked. I may rewrite that part in order to match what I see from my testing.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 04:21, 11 March 2014 (UTC)

Dodging

2014-03-02T01:28:59Z

Doktoro Reichard: Redirected page to DF2012:Combat skill

#REDIRECT [[cv:Combat_skill]]

v0.34 Talk:Legendary artifact

2014-02-22T12:41:46Z

Doktoro Reichard: /* Legendary Weapons */

:Sometimes dwarves will grow particularly attached to weapons and armor, and if they become attached enough, they will name their armor/weapons.
Dwarves are not the only ones that can name items, nor is it restricted to actual weapons. [http://i.imgur.com/fftV2.png a named bucket] and [http://i.imgur.com/ozJ3S.png a named shoe], both wielded by demons that have been terrorizing the wildlife and invading goblins for about two years now. There was no announcement like when a dwarf names his weapon, but they both appear in blue on the artifacts list. I doubt armor can be named (and have never seen it myself), as the naming seems to stem largely from the item's kill list, and normally armor doesn't score kills. -- [[User:Qazmlpok|Qazmlpok]] 18:55, 23 September 2012 (UTC)
:Armor can '''definitely''' be named - I've had it happen numerous times in version 0.31. It mainly happens when the armor has successfully deflected a large quantity of attacks, and danger room training causes that to happen rather quickly. --[[User:Quietust|Quietust]] 21:56, 23 September 2012 (UTC)

== Artifact mechanisms can jam ==

The page is flat out wrong, weapon traps with artifact mechanisms can jam in v0.34.11. [http://i.imgur.com/D8IUSlW.png Proof] -[[Special:Contributions/91.157.56.136|91.157.56.136]] 11:17, 21 April 2013 (UTC)

== Building Destroyers ==

While it's true Artifacts cannot be destroyed by Building Destroyer creatures, aren't they deconstructed instead? If so that would be worth noting.

== Legendary Weapons ==

Having 4 dwarves with legendary weapons named, I thought I would add the information to the wiki, but there's a discrepancy I now noticed. Those 4 dwarves are dead, and yet only one weapon is listed as available.

To avoid adding pictures, the best description of this would be, in the stocks menu, that 1 named weapon is in yellow, and the other three are in purple (the color that indicates forbidding).

Using the specific equipment menu of the military, I also can only select the weapon at yellow. They are in the same place, so another factor must be the cause. I noticed that, of the four dwarves, only one has a proper memorial slab engraved (regardless of being buried, which they were), and that one has the weapon at yellow.

I'll try and engrave the remaining slabs to check if that's the cause. '''If''' named weapons would be as good as Artifact weapons, that would confer a boon to any military.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 22:28, 3 February 2014 (UTC)

:Engraved the slabs, nothing happened. Checked the corpse list and I don't see the corpses of the dwarves whose weapons are forbidden. However a peculiarity appeared: a weapon had two slayers, one of them was buried, the other I didn't see a trace. So, in order for a weapon to be "re-used", all dwarves that owned it have to be properly buried. Smells like DF.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 22:58, 3 February 2014 (UTC)

I've been adding some information to the page regarding legendary weaponry and armor. I have had several dwarves naming their weapons and armor. I have had two cases where the objects in question hadn't killed anything. My thoughts on this is that use of items is somehow recorded in the object, hence making sparring sessions fair ground for naming weapons. This should be tested thoroughly.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 12:41, 22 February 2014 (UTC)

v0.34:Health care

2014-02-22T12:37:24Z

Doktoro Reichard: /* Traction Benches */ - possibility of viewing if a dwarf has healed in traction with the units view menu

{{quality|Exceptional|23:44, 17 April 2011 (UTC)}}{{av}}{{Buggy}}

A '''hospital''' is a [[Activity zone#Hospital|zone]] designated via the [[Activity zone|zone menu]]. Hospitals use any beds, tables, traction benches, and coffers/bags that have been built within the zone. The hospital will requisition [[thread]], [[cloth]], [[splint]]s, [[crutch]]es, [[plaster powder]] (for casts), [[bucket]]s, and [[soap]] for medical use. These will be stored within the hospital's coffers/bags; you may adjust the desired quantities.

'''Doctors''' are dwarves assigned to any of the five medical labors: [[wound dresser|dressing wounds]], [[diagnostician|diagnosis]], [[surgeon|surgery]], [[bone doctor|setting bones]], and [[suturer|suturing]]. All doctors in the fortress operate under the instruction of the [[Chief medical dwarf]], an appointed [[noble]]. Doctors <strike>inflict</strike> perform medicine on a dwarf only after treatment has been prescribed by a diagnostician. Doctors do not perform any healthcare on animals, despite injured animals "requesting" diagnosis in the [[Health screen|z-health screen]].

All beds within a hospital zone are automatically hospital beds, where injured dwarves will go (or be brought) to recuperate. Tired healthy dwarves will occasionally camp there too if the hospital is close, even if they have their own bed.

==Setting up a Hospital==
* Hit {{k|i}} and set up a hospital [[zone]] in the area you plan on having your hospital. Be sure "Hospital" is highlighted. Proximity to [[water]] is a plus, since patients need to be washed and cannot drink alcohol.
* Place enough [[bed]]s in that zone to ensure you can keep all wounded dwarves in the hospital, plus a few spare that will be occupied by lazy couch-surfers.{{bug|647}} Note that normal beds or [[bedroom]]s can and will accept wounded dwarves whether or not a hospital zone exists, though hospital beds will be preferred if they are free. Doctors do not need a hospital zone, though a lack of equipment will probably limit care options.
* Build [[container]]s ({{k|b}}-{{k|h}}) to store hospital supplies. (A small hospital can manage with 2 containers, a fully fledged fortress with an adventurous military may need as much as 8. Also note that some people recommend setting up custom stockpiles instead.)
* Build at least one [[table]] ({{k|b}}-{{k|t}}) for surgeons to perform surgery on. You may perform surgery without tables; it will be more messy.
** Place the tables right next to the beds, or you may get "cancels surgery, patient not resting" spam, as moving the sleeping patient more than one square from the bed to the table wakes up the patient. {{bug|2773}}
** Multiple dwarves may undergo simultaneous surgeries on the same table.
* Build one or more [[traction bench]]es to handle compound fractures when the dwarf requires "immobilization." Remember to check back on the <strike>victim</strike> patient after a while or they may be in the traction bench for a long, long time.{{bug|4470}} (Or be lucky; sometimes immobilization requests simply disappear with no bad consequences.)
** Each traction bench can only accommodate one dwarf at a time, and the dwarf may be there for quite some time, so plan accordingly.
* Stockpiles are not needed but can be used instead of chests and bags in the hospital zone.
* Assign a [[chief medical dwarf]] (in the [[noble]]s screen) to enable the fortress-wide [[health screen]] as well as invidual dwarves' health summary screens ({{k|v}}-{{k|z}}-{{k|h}}).
* Pick one or more dwarves to be doctors, and enable the health labor(s) on them (through {{k|v}}-{{k|p}}-{{k|l}}). Be sure the diagnosis labor is well covered. Without a diagnosis, patients cannot be treated. If they cannot be treated, they will occupy the hospital area until they die, performing no function. (Any dwarf with the Diagnosis labor enabled can diagnose dwarves, but the Chief Medical Dwarf may impact the diagnosis job creation{{verify}}. Once a patient is diagnosed, you can see on the individual health screen what procedures are needed, for example washing or suturing.)
* If you use a [[burrow]] to keep doctors near the hospital zone, ensure that this burrow covers all needed materials or you could get job cancellations because of lack of material. Thread/cloth stockpiles, and items bought from caravans (e.g. plaster early in the game) are often the most troubling.

== Skills and Injuries==
'''Doctors''' have 5 specialized skills and 2 support healthcare labors.

[[Diagnostician]] -- [[Surgeon]] -- [[Suturer]] -- [[Wound dresser]] -- [[Bone doctor]] -- Feed patients/prisoners -- [[Recovering wounded]]

Those with the '''recover wounded''' labor will attempt to bring a wounded dwarf to the hospital zone, or lacking one to the nearest unoccupied bed. Note that recovering wounded appears to be an extremely low priority task. Since immobile patients will need to be carried to a hospital before diagnosis, it may be necessary to temporarily disable all other labors on another dwarf to move them first.

A '''diagnoser''' will then identify and prescribe a treatment which any doctor (including himself) may carry out. A dwarf cannot be treated without a diagnosis. Depending on the injury a treatment labor will occur. Diagnosis is often required between procedures as well.

[[Wound|Injuries]]
:{| border=0 cellpadding=0 cellspacing=1 style="background: black"
|-
| '''NONE: No recorded active wounds on the part.'''
|-
| '''MINOR: Any damage that doesn't have functional/structural consequences (might be heavy bleeding, though).'''
|-
| '''INHIBITED: Any muscular, structural, or functional damage, without total loss.'''
|-
| '''FUNCTION LOSS: An important function of the part is completely lost, but the part is structurally sound (or, at least partially intact). '''
|-
| '''BROKEN: The part has lost all structural integrity or muscular ability.'''
|-
| '''MISSING: The part is completely gone. '''
|}
If a chief medical dwarf is appointed you can view your fortress' health using the {{k|z}}-status key), or individually by selecting a dwarf and using {{k|w}} for wounds section.
* '''Bones''' can be set and treated by bone doctors depending on severity using thread and cloth for fractures, splints and casts, or traction benches. Grasping is often impaired during healing. The {{DFtext|Immobilization Request}} status tag is an indication that a splint or plaster cast is required. Multiple overlapping and compound fractures require a surgeon. Caused by [[attack_types#Blunt_weapons|blunt]] trauma.
*'''Skin and muscle''' can be treated by a suturer using thread and cloth. The wound will continue to bleed until sutured, severe wounds impair grasping during healing. Closed wounds will be dressed by a wound dresser. Caused by [[attack_types#Edged_weapons|slashing]] injuries.
*'''Internal Organs''' can be treated or removed by a surgeon using tables and traction benches. Repair of infected or rotten wounds is treated similarly. Caused by [[attack_types#Piercing_weapons|piercing]] injuries.

Any dwarves with the Feed patients/prisoners labor will attempt to give food or a bucket of water to a hungry or thirsty patient. By default all dwarves start with the non-doctor labors designated. These have no corresponding [[skill]]s - they do not cause experience gain, but merely are activities that can be turned on/off for each dwarf.

==Infection==
Every open wound can become infected. Infections may heal over time; however, many dwarves will die due to infection, often months after the actual wounding.

Causes of infection include:
* No cleaning of the wounds.
* Cleaning with water from a [[Water#Stagnant_Water|stagnant water]] source.
* Cleaning with [[Water#Water_laced_with_mud|water laced with mud]]. {{Verify}}
* Cleaning without [[soap]].
* <s>Bad luck</s> [[Fun]]!

== Equipment ==
=== Traction Benches ===

A '''traction bench''' is used by a [[doctor]] in a [[Hospital|hospital zone]] to immobilize a dwarf that has sustained complex or overlapping fractures.

It is constructed in the [[Mechanic's workshop]], and requires a [[table]], a [[mechanism]], and a [[rope]] or a [[chain]] to construct. Note that if any [[Stockpile|stockpiles]] have been linked to "Give" to the workshop, all of the resources needed to construct the traction bench must be found in the linked piles (e.g., linking only a stone stockpile may prevent access to the necessary tables/ropes/chains).

Currently there is a bug that may prevent fully healed dwarves from ever leaving the traction bench. {{bug|4470}} Removing the traction bench will free the dwarf.

Do not be hasty in removing a presumably-stuck dwarf from traction, however. Such treatment takes weeks or months to succeed and removing the dwarf prematurely will undo all the progress that has been made. If the dwarf has been in traction without being diagnosed or otherwise treated for a month and the health screen shows no scheduled treatment, they probably were forgotten and need the traction bench deconstructed to release them. Another possible way to check if a dwarf is stuck is by {{k|v}}iewing the {{k|w}}ounds of the dwarf in question. If the damaged part isn't at red, then the dwarf is stuck.

=== Casts ===

Casts are made out of [[plaster powder]] and are used to keep broken bones in their proper place until healed. To store it in a hospital, build a chest or other container inside the hospital zone. Applying a cast also requires a bucket and cloth, and a water source.

Plaster powder is produced at a [[kiln]] or [[magma kiln]] from [[gypsum]], [[alabaster]], [[selenite]], or [[satinspar]] and an empty [[bag]] by a dwarf with the furnace operator skill enabled. They can also be bought at embark for 3 points per unit; each unit comes with a free [[bag]].

=== Splints ===
Splints immobilize limbs that have sustained bone fractures. They allow the broken limb to be utilized until it is fully healed, Dwarves will be able to leave the hospital and resume their normal duties once securely splinted up since by this stage their wounds have already been cleaned, sutured and dressed. Applied by a bone doctor.

They can be made out of one [[wood]] at the [[carpenter's workshop]] or out of one metal [[bar]] at the [[metalsmith's forge]] or the [[magma forge]]. The use of splints seems to be an effective alternative to applying a plaster cast, which are also easier to obtain and prepare. Splints are categorized as [[finished goods]].

=== Other equipment===
*[[Crutch]]es {{DFtext|┬|770}} help a crippled dwarf walk again.
*[[Table]]s are used to conduct operations on.
*[[Bed]]s are used by patients to rest.
*[[Thread]] is used to suture closed wounds.
*[[Cloth]] is used to clean wounds, wash patients and dress wounds.
*[[Soap]] is used to clean wounds, sterilizing and preventing infection.
*[[Water]] is used to clean wounds, bathe patients and give drink. Patients do not drink alcohol.
*[[Bucket]]s are used to gather and hold the water for its uses.
*[[Container]]s are used to store hospital supplies.

==Tips for an Effective Hospital==
* Regularly use ({{k|i}}-{{k|H}}) to examine your hospital stockpile. Ensure your hospital is well-stocked. If you run out of materials regularly, increase the limits.
** Due to a [[#Bugs|bug]], hauling dwarves routinely oversupply hospitals. This can be troublesome in many ways, particularly when all the cloth in the fortress is routed to the hospital, leaving your clothier without clothmaking materials and filling the hospital containers with cloth and thread, which leaves no room for soap. Because of this, ''do not, ever,'' place containers in a hospital zone; instead, designate separate stockpiles nearby for cloth, thread, soap and other hospital implements. Setting those stockpiles to not accept bins or barrels, while space-consuming, can help to visualize the state of hospital stocks and prevent further container-capacity related issues.
**A workaround is to set cloth and thread to 0, add one container which will be filled by other items, and then set the cloth and thread to 1 unit. The hospital will only claim as much cloth and thread as will fit into the container after accounting for the other items.
**Another workaround is to disable hauling for all but one dwarf, since the oversupply problem is caused by the hospital calling all hauling dwarves for a unit of cloth or thread, and all dwarves responding at once, resulting in a unit of cloth or thread for every available dwarf.
**A third workaround is to allow your dwarves to fill up the containers however they want, then use {{k|t}} to examine the contents of the containers and {{k|d}}ump the items that you need to reclaim for other uses. Remember to reclaim the items after they have been dumped.
**Another workaround is to forbid all cloth, thread, soap, etc. except for the amount that you want to move to the hospital. Once all of the Store Item in Hospital jobs are done, it is safe to unforbid everything again.
** It is safe to set the hospital stocks for everything but soap to 0 and then build a container. Soap in the hospital zone is reserved for hospital use and will not be used up by bathing dwarves as stockpiled soap can be.
* It is possible to do without soap in the hospital stockpile. Choosing to do so, however, increases the risk of infection, which most likely will kill your dwarf. Consult the [[soap]] page to understand that industry. Bring 1 lye on embark for one bar of soap, which translates to 150 units.
* Put a well inside the hospital for maximum efficiency. Doctors need to wash regularly, and clean water reduces infection.
* Do not place chairs next to your surgery tables. A chair is an invitation for rat-roast eating freeloaders to block the medical process.
* Consider making use of burrows to ensure your healthcare workers stay in the area.
* You may wish to consider individual rooms for each bed if you find your doctors are choosing to treat Urist McScratched over Urist McBloodFountainTheGushing. A locked door minimizes the mess and thereby infection and allows you to prioritize.
* The Chief Medical Dwarf only enables the Health status screen. The position has no in-game use. Look after your CMDs if you rely heavily on this screen, but otherwise they can be treated as any other dwarf.
** Diagnosis skill level does not affect the diagnosis, only the time it takes for the diagnosis to happen. Embarking with a dwarf skilled in diagnosis (and other medical skills) is helpful, both to speed diagnosis and to stave off skill rust when long periods of time go between injuries.
** Also helpful is enabling medical skills on all dwarves in the fortress, which allows medical jobs to be picked up immediately so long as there is an idle dwarf.
* Create "nurses" by setting dwarves to only use the Recover Wounded, Bring Food and Water labors.
** It is important not to distract doctors from treating patients (or other medical helpers such as crutch haulers, or wounded recoverers).
** "Recover wounded", "Give food" and "Give water" are low priority jobs, so it is entirely possible for a patient to starve to death, dehydrate to death, or bleed to death if no one ever gets "unbusy" enough to bring them food, water, or move them to the hospital.
** Similarly, it is important not to put your doctors at risk by recovering wounded in the middle of a battle—if they become injured, they cannot treat themselves.
* You can select nurses who enjoy helping people to give them good thoughts. This also prevents dwarves that hate bringing others food from receiving unhappy thoughts.
* When a serious injury happens, don't exit (or save) the game until the injured are in the hospital zone, especially if a dwarf is immobile. "Bring crutch" and "Recover Wounded" jobs will be lost, keeping the patient away from the hospital, and doctors will NOT go to patients, even if burrowed with them, because a diagnose job hasn't been created. Sometimes a second "crutch required" or "recover wounded" request will be generated, but often too late for the patient's full recovery. Best bet is ensure someone (not burrowed) has "recover wounded" enabled at all times; burrow doctors doing non-medical tasks immediately; hope the patient makes it to the hospital.

Dwarves will prefer to store and use the most expensive thread and cloth. Yes, that includes special "[[raw adamantine|exotic]]" strands. You may want to forbid these during medical emergencies.

==Bugs==
* Hospital stores more materials than assigned. {{Bug|191}} {{Bug|4406}}
* Dwarves with healthcare jobs will use the closest supplies to do their work, even if they are not stored in the hospital. {{Bug|287}}
* Dwarves will steal items from the caravan and store them in hospital. {{Bug|66}}
* For a variety of reasons, an injured dwarf may leave the hospital and/or refuse to go to the hospital. {{Bug|309}}
* Injured nails won't heal, leading to eventual infection and death. {{Bug|3756}}
* Adamantine thread used for suturing. {{Bug|1346}}
* Wounded [[justice|criminals]] don't get sent to the hospital. {{Bug|3901}}
* Your dwarf may get stuck in traction, even after the wounds have healed. If this happens, simply remove the traction bench. {{Bug|4470}}
* The quality and value of a finished traction bench doesn't account for all of the inputs used to make it. {{verify}}
* Purchased plaster powder does not appear in the hospital storage. {{verify}}
* Dwarves resting in bed may be starving/dehydrated and not being taken care of, deconstructing the bed to generate a new Recover Wounded task and force them to rest properly fixes this.

{{d for dwarf}}
Soap is the only item dwarves will use to sterilize a wound. While dwarves are of course aware that humans will pour perfectly quaffable alcohol over their bloody wounds and onto the filthy ground to get the same effect, dwarves understand that some things are more precious than a single life, and face oblivion with a bit more dignity. Application of extreme heat is also well known to prevent infections and seal a wound, but dwarves consider magma the only legitimate heat source, and the non-lethal application of magma a sacrilege.

{{Category|Healthcare}}
{{Industry}}

Traction Bench

2014-02-22T12:33:42Z

Doktoro Reichard: Redirected page to DF2012:Health care#Traction Benches

#REDIRECT [[cv:Health care#Traction Benches]]

v0.34:Trap

2014-02-22T10:49:15Z

Doktoro Reichard:

{{quality|Masterwork|21:10, 26 April 2011 (UTC)}}{{av}}

:''For information on trapping [[vermin]], see [[animal trap]].''

'''Traps''' are a comparatively quick and easy method for defending a fortress. Unlike [[soldier]]s, they're always on duty, and, once set up, need less management. On the other hand, they are immobile and can only lie in wait for foes to walk over them. To build a trap, go to the {{k|b}}uild->{{k|T}}raps/Levers menu. You'll generally need one [[mechanism]], a dwarf with the [[mechanic]] labor designated (ranks in this [[skill]] reduce the time to place a trap), and at least one other component depending on the type of trap - a stone, a cage, or one or more weapons. They can be built indoors or outdoors, and require a level ground square with no other constructions in them. Traps will block the passage of caravan wagons.

Stone-fall, weapon and cage traps will be triggered by most hostile entities entering their tile{{verify}}, with the possible exception of [[thief|thieves]], flying creatures and other occasional <s>nasty</s> fun surprises. Any unconscious creature will trigger traps, including your own dwarves.

Note that only dwarves with the mechanic labor enabled will reload traps (cage, stone or weapon). In combat situations, [[mechanic]]s have a nasty habit of wanting to reload (or clean) traps when they are triggered, regardless of who or what might be out there as well. [[Forbid]]ding traps after they are built will keep [[Main:Urist|Urist McSuicide]] from deciding to reload a trap in the middle of a [[siege]]. Just remember to unforbid them when things calm down, so the traps are all ready for next time. Note that forbidding a trap after it has been triggered doesn't help, as the job to refill the trap has already been issued in that case, so a Mechanic will carry a stone out to the trap anyway. Alternatively, simply order your dwarves to stay within a safe [[burrow]] until any threats have been dealt with. If a cage trap has captured something while forbidden and left alone for an extended period of time (nearly a year or longer) the caged individual escapes and and you will get the announcement "Something has emptied a cage!" Once put into a stockpile or claimed this will prevent the captured individual from escaping.

It is possible to determine the state of a trap (loaded/unloaded) and the components it contains using the {{K|t}} query.
Deconstructing a trap leaves the components used in its creation on the ground around the tile. Traps destroyed by hostile action may return damaged objects.

Traps can be deconstructed by pressing {{k|t}} to view the trap (or {{k|q}}, although the name of the trap will not be displayed until it is flagged for removal), followed by {{k|x}} to remove it.

==Stone-fall Trap==
The simplest trap to construct, a stone-fall trap is essentially a [[stone]] suspended up in the air which is dropped on intruders when the trap is triggered. These are a popular defensive measure early on, as the components needed are readily available as soon as you start mining. A single stone trap will usually '''not''' severely wound or kill most animals and enemies, to the extent that this may be a bug. After being used they need to be reloaded with another stone by any [[dwarf]] with [[mechanic]] [[skill]] enabled, a task which your dwarves will see to automatically. The dwarf will generally not use the stone that just dropped, but a new one (would you want to put your hands on that gory mess?). Being that stonefall traps do not alert you of ambushes when triggered by hidden invaders{{verify}}, this can frequently lead your mechanics into peril. The weight of the stone used in the trap affects the amount of damage the trap does, but it's quite difficult to get your dwarves to use heavier stones, like galena, when loading the traps.

Stone-fall traps respect [[economic stone]] restrictions and they can't be loaded with [[clay]].

*Shortcut {{k|b}} {{k|T}} {{k|s}}
*Components used: [[mechanism]] and an ordinary [[stone]]
*Appearance: {{Raw Tile|^|7:1}} = ready, {{Raw Tile|^|7:0}} = no stone loaded

==Weapon Trap==
Weapon traps are similar in nature to stone-fall traps, and are triggered when any hostile creature stands on the trap. They contain between one and ten weapons, and tend to be much more reliable for outright killing or critically injuring invading creatures. Before you write off stone-fall traps as worse versions of weapon traps, note that weapon traps require you to have previously made [[weapon]]s, making them more of an option somewhat later in the game. Any weapon can be used, including human weapons, training weapons, bows, traded weapons and weapons recovered from dead goblins. Think of it as fair retribution when goblins are sliced to pieces by their own axes!

You can also use the corkscrews that are normally used in [[screw pump]]s, or menacing spikes that are normally used in spike traps, or any of three specialist trap only weapons:

[[Metalsmith's forge]]
*menacing <metal> spike
*large, serrated <metal> disc
*spiked <metal> ball
*enormous <metal> corkscrew
*giant <metal> axe blade

[[Carpenter's workshop]]
*menacing <wooden> spike
*spiked <wooden> ball
*enormous <wooden> corkscrew

[[Glass furnace]]
*menacing <glass> spike
*large, serrated <glass> disc
*spiked <glass> ball
*enormous <glass> corkscrew
*giant <glass> axe blade

Don't know which to make? -> '''Detailed [[Trap component]] information'''

These weapons have all the material property advantages and disadvantages that normal weapons have. It should be noted that the trap weapons are larger than normal dwarf weapons, meaning they should be more effective than normal weapons made of equivalent materials. When triggered, this trap will "attack" the creature with all the weapons available to it, normally doing massive damage. This can also be ''very'' messy if the trap is loaded with cutting weapons, often creating an explosion of blood and dismembered body parts. Using blunt weapons reduces the mess somewhat, and you may wish to strategically place a [[User:Uristocrat/Dwarven_Bathtub | Dwarven Bathtub]] nearby.

Weapon traps do not cause slightly suicidal mechanics to reset them after each triggering but instead reset automatically after an unknown period of time. However, there is a 50% chance that the victim will get stuck in the mechanism and cause the trap to jam (use {{k|t}} to check the trap), requiring a dwarf to remove the body. When the trap jams, the mechanic will automatically attempt to clean it, so forbidding the body (or forbidding the trap's mechanism in advance) may be necessary to save him from the victim's friends. Note that weapon traps will only jam if they ''directly'' kill the creature - if they instead inflict a mortal wound and cause the creature to bleed out, they will not jam.

When placing the trap you will be asked for a type of mechanism as normal, then asked to select weapons to use. The quality of your chosen mechanism matters[http://www.bay12games.com/forum/index.php?topic=14461.msg131214#msg131214]. At this point you will get a list of all stockpiled weapons in your fortress. {{k|+}}{{k|-}} will select different weapons and pressing "Enter/Return" adds 1 of the selected weapon to the trap; you can e{{k|x}}pand the selection to choose more carefully. Up to 10 weapons can be put in each trap and all weapons in the trap will attack at once when it is triggered (10 large serrated disks normally results in the unfortunate triggering creature leaving with <strike>fewer limbs than</strike> none of the limbs and several more torn apart organs than it came in with). When happy with your weapon selection press {{k|d}} to set the trap.

The triggering creature will defend from the trap's attacks just like from a dwarf's, by jumping away, dodging and blocking. This can be used in your favour if the trapped tile happens to be surrounded by pits.

*Shortcut: {{k|b}} {{k|T}} {{k|w}}
*Components used: [[mechanism]] and whatever [[weapon]]s you want, limit 10.
*Appearance: {{Raw Tile|^|4:1}} = ready, {{Raw Tile|^|4:0}} = jammed or out of ammo

==Cage Trap==
Cage traps are different from the other trap types in that they do not directly kill or injure invaders. Instead, they capture the creature that triggers them in a [[cage]]. Despite the unfortunate lack of violence, this is still very effective as it completely neutralizes the target so that it can be dealt with later. After a creature is captured, it's stored in an animal [[stockpile]] if the current standing order is set ({{K|o}}-{{K|a}}). The trap will then be reset by hauling an empty cage to the trap's location. This is done ''automatically'', as in, during a siege, by any dwarf with the [[Mechanic]]s labor enabled. Cage traps will also alert you to ambushes when triggered by hidden invaders, making them a useful forward defense mechanism.

'''Most''' captured creatures do not require any nourishment and will survive being in a cage indefinitely; in fact, even submersion in water or magma appears to have no effect on caged creatures. It is possible for dwarves to bring [[water]] to cages, but this will only occur if you have someone friendly also locked in the cage - like a dwarf child snatched by a goblin. See below for how to remove things from a cage.

'''Cage traps will not capture every creature in the game''', so you ''will'' need alternative defenses - [[titan]]s and [[forgotten beast]]s (as well as certain other types of creatures) are immune to traps entirely and will waltz right past all of your carefully placed cages unless the cage has a giant cave spider web on it. A webbed cage trap '''will''' capture nearly anything; the only creatures it cannot capture are those immune to both cage traps and webbing, such as a web-spinning forgotten beast or a dwarf from your fortress on a Collect Webs job.

Cage traps are also useful for catching wild animals. This can be done by simply placing traps in areas where wild animals roam (this does '''not''' require a dwarf with the [[trapping]] labor enabled). The captured animals can be tamed (and sometimes trained into war animals!) at the [[kennel|kennels]]. See [[Animal trainer]] for more on training animals.

In the process of taming a wild animal, there is a chance that seeds will be left in the cage. Dwarves ''only'' load empty cages into traps. One way to remove the seeds and make the cage usable again is to {{K|d}}ump them. First loo{{K|k}} at the cage in your Animal [[stockpile]], then highlight the seed and press {{K|Enter}} to look at the seed, then press {{K|d}} to dump the seed.

*Shortcut: {{k|b}} {{k|T}} {{k|c}}
*Components used: [[mechanism]] and a [[cage]].
*Appearance: {{Raw Tile|^|2:1}} = ready, {{Raw Tile|^|2:0}} = no cage

The material a cage is made affects indirectly the speed at which it is assembled into the trap. Heavier cages take longer to assemble. The more skilled a dwarf is in the [[Mechanics]] skill, the less time he takes to assemble the cage.

With exception to the latter, cage material has no effect (beyond weight for hauling, value of finished trap, and the fact that [[elf]] merchants will get angry if the cage is wooden). A glass terrarium is just as strong as a steel cage. Cage [[quality]], however, can be important: due to a bug, creatures can eventually escape from [[artifact]] cages, but not from lower-quality cages (presumably the opposite of the intended behaviour).{{bug|6117}}

To release a creature from a cage, build the cage ({{k|b}} {{k|j}}) and use {{k|q}} to unassign it. You can also simply assign the creature to a pasture or pit. To release a hostile creature (or wild animal) safely from a cage, build the cage and link the cage to a [[lever]] that can be remotely triggered. If you have many cages you need to empty out quickly see [[Mass pitting]]. Cages have no current limit to the amount of beasts you can put in them, so you can build one cage and assign all the beasts to that cage. Typical caveats of dealing with wild/hostile animals apply.

As with most traps, if a dwarf goes to sleep or is knocked unconscious over a cage trap, it will be triggered and the dwarf will be trapped. Unlike usual creatures, a caged dwarf can starve or die from dehydration.

==Upright Spear/Spike==

Weapon traps trigger when a hostile creature steps on them. An upright spear/spike trap is different -- it must be triggered externally to cause the spears or spikes to spring up or to recede back down. When the spears/spikes spring up, ''any'' creature on the tile will be subject to possible impalement.

Placing the upright spear/spike trap does not require a mechanism, and it does not require the Mechanic labor. It only requires 1 to 10 [[Weapon|spears]] or [[Trap component|spikes]]. Linking it to a [[lever]] or a [[pressure plate]] will require a mechanism and must be performed by a Mechanic. Without such a link, the trap will not operate.

An often overlooked ability of an upright spike trap is that it also inflicts damage on a creature that falls onto it while it is deployed. And since they are built in the deployed state they can be quickly built to make a pit trap more lethal, without the need for extra mechanisms. However, you will still need some way to cause your victims to fall onto the spike from above in the first place, and the pit must be more than 1 z level deep for the spikes to cause damage. Note, however, that if any enemies survive the fall they may gain [[DF2012:Exploit#Shaft_of_Enlightenment|ridiculous weapon skills]].{{bug|6397}}

*Shortcut: {{k|b}} {{k|T}} {{k|S}}
*Components used: 1-10 spears or spikes, plus further [[mechanism]]s for linking to triggers.
*Appearance: {{Raw Tile|{{!}}|0:1}} = extended, {{Raw Tile|.|7:0}} = retracted

==Mechanism Quality==

All of the above traps other than Upright Spear use mechanisms in their construction. The quality of the mechanism used impacts weapon traps beyond their value however, in weapon traps the mechanism quality seems to act similarly to weapon skill in an entity and will play a part in determining whether a strike lands. Code analysis suggests that mechanism quality also impacts the effectiveness of stone fall traps, though it has no effect on cage traps.

==Other Traps==
You can create [[trap design|even more elaborate traps]] with imaginative use of pits, [[pressure plate]]s, [[lever]]s, [[grate]]s, [[support]]s, [[water]], and/or [[magma]], creating sacrificial altars (blood for the Blood God!) and whatever else you can think of. Watching those goblins try to find a way out of your drowning chamber as it begins to fill is really quite satisfying. These are best made in a large, repeatable mass killing way. If you make a trap that kills 10 or so goblins that only works once and you have to rebuild it, wasting time you don't have during a [[siege]], then you're <s>not trying hard enough</s> having too much [[fun]].

==See Also==
*[[Trap design]]
*[[Mass pitting]]
{{buildings}}
{{Category|Traps}}

v0.34:Legendary artifact

2014-02-17T00:32:19Z

Doktoro Reichard: /* Other notes */ - Had a named shield with only 1 kill

{{av}}
{{Quality|Exceptional|18:18, 13 March 2012 (UTC)}}

[[File:Announce.png|thumb|right|500px|Example of an [[announcement]]...announcing...the creation of a legendary artifact: in this case, a glorified [[millstone]].]]
Dwarves in [[strange mood]]s will create '''legendary artifacts''': unique, "named" [[item]]s which are of unsurpassable [[Item quality|quality]] (and often [[value]] as well). An artifact is the ultimate expression of a [[dwarf]]'s desires, fears, memories and hopes in art form, and each dwarf will produce at most one in their lives (or [[insanity|die]] trying). Dwarves that create an artifact immediately gain enough [[experience]] to boost them to [[legendary]] level in the affected [[Strange mood#Skills and workshops|skill]], unless they were [[Strange mood#Possessed|possessed]].

Dwarves drop artifacts in the [[workshop]] as soon as they are made. They cannot be traded, but most can be used just like any item of its type. A list of all artifacts that the fortress has created can be seen by pressing {{k|l}}.

== Uses ==
Artifacts are normally of extremely high [[value]] and [[quality]], and can be used just like normal items of their type; they're therefore extremely useful in any situation where value or quality are important. Note that material and weight calculations still apply, so an artifact sword made of dingo bone or an artifact breast plate made of gold are not going to be overwhelmingly powerful.

=== Furniture ===
Artifact [[furniture]] of high value can be placed in [[room]]s to greatly increase the room's value (and hence quality), which can be useful to meet the room quality requirements of [[noble]]s. They can also be placed in high traffic areas of the fort, so that dwarves that pass by (or over) them will get happy [[thought]]s from admiring them. Artifact [[mechanism]]s can be turned into [[lever]]s and [[trap]]s, which count as furniture.

Certain artifact types (barrels, buckets, mechanisms, etc) can be used as components in some buildings; doing so will multiply the artifact's effect on fortress value.

=== Weapons ===
Artifact weapons get a large ×3 quality bonus to their weapon accuracy and armor deflection values (compared to ×2 to masterwork); this is not enough to make totally inappropriate materials competitive with [[steel]] masterwork equipment. Also note that while they will be half again more accurate, artifact blades do not have a sharper edge than masterwork items of their material; in other words, their material type modifiers remain unchanged, and they will do no more damage than a regular item of their type (though they will never dull.)

Artifact [[weapon]]s (if not being used in the military) can be put into a [[trap#Weapon Trap|weapon trap]], which will make it count as valuable [[furniture]]. Artifact [[door]]s and [[hatch]]es provide indestructible, instantly lockable gates.

=== Finished Goods ===
[[File:Artifact Storage.png|thumb|right|300px|Finished goods are not particularly useful, only adding to your [[wealth]] (and all of the things that entails). This bin is clutter for the fortress, but any and every thief's dream score, an object of worship for three different [[kobold]] [[civilization]]s.]]
An artifact [[gem]] is called a perfect gem and functions the same as a large gem, having all the same uses, i.e., none.

Artifact [[finished goods]] solely add to value of your fortress, or they can be traded in Adventurer Mode.

=== Cages ===

Artifact cages are apparently intended to be impossible for creatures to escape. However, due to a bug, the logic appears to be backwards -- currently, creatures can eventually escape from [[artifact]] cages, but not from lower-quality cages.{{bug|6117}}

== Adventure Mode ==

Artifacts can include books written by historical figures. Where they are stored is recorded during worldgen, and can be discovered in Legends mode.

== Other notes ==
Sometimes dwarves will grow particularly attached to [[weapon]]s and [[armor]], and if they become attached enough, they will name their armor/weapons. The armor/weapon will then be listed as an artifact, although its value will remain the same.

What causes dwarves to name their weapons is unknown - time alone will suffice (though it may take a very long time), but slaying an important historical figure such as a [[forgotten beast]] will often be enough. A weapon having a long kill list will also contribute to its naming. A weapon or piece of armor (even a shield) may be named if it only had a single kill.

After the weapon has been named, it will become fixed{{verify}} to the dwarf that named it. It then becomes impossible to melt. If the dwarf dies, the weapon will be forbidden for use, until all dwarves that slayed something with that particular weapon (according to its kill list) at any given moment (before and after its naming) are properly buried in a coffin. If any of the slayers' bodies have been destroyed, the weapon cannot be used again.

Artifacts cannot be destroyed by temperature extremes{{verify}}, building destroyers, [[cave-ins]], or fire, although they will ignite and burn as is normal for their material type. They can be lost in pits, carried off the map by flows, stolen by thieves, or atom-smashed by bridges. The loss of an artifact does not appear to affect the happiness of its creator.

After creation, an artifact cannot be further decorated (by encrusting it with gems, studding it with metal, or have images sewn into it). Your pitiful gabbro scepter cannot be made more valuable.

Artifacts disappear from the artifact list upon abandoning a fortress.

Artifact creation has a wider selection of possible item types for several skills, occasionally resulting in artifact items that could not be made normally, like bone shields or metal beds.

Artifacts and their mechanics were the topic of [[Main:Dwarf Fortress Talk|Dwarf Fortress Talk]] [http://www.bay12games.com/media/df_talk_7_transcript.html #7]. The future of artifacts was discussed in a [http://www.bay12games.com/media/df_talk_7_transcript_2.html separate portion] of that cast.

Artifacts can be disabled in [[D_init.txt]]

Artifacts created by happy dwarves (i.e. not fell or macabre moods) have a 1% chance to be named after the dwarf who created them.

{{Category|Items}}
{{Category|Lore}}

v0.34 Talk:Macros and keymaps

2014-02-16T12:22:16Z

Doktoro Reichard: /* Moving mouse outside window */

v0.34:Decoration

2014-02-16T04:48:10Z

Doktoro Reichard: Adding the fact decorations can be limitless, if made with different materials.

{{av}}{{Quality|Exceptional|22:36, 14 June 2012 (UTC)}}

'''Decorations''' are fancy embellishments of your goods that, while unnecessary, greatly adds to their value for [[trade]] and other purposes by adding another material to the base item. Decorating with a material already present in the object, whether as its base or as an earlier decoration, is not possible. However, you may place an infinite amount of different decorations one one item. Most decorations have quality levels: a base value of 10☼, multiplied by its [[Item_value#Material_Multipliers|material multiplier]] and [[Quality|quality multiplier]], separate from the item itself. When an item is decorated, it is shown with double angle brackets - for example, a (no quality) decorated +steel battle axe+ becomes a «+steel battle axe+». Decoration quality is shown outside the double angle-brackets, the item quality remains within them with the item. So if you have *«+steel battle axe+»*, you have a +steel battle axe+ with *decorations* on it. When an item has more than one decoration the quality level of the best one is shown.

There are a number of caveats to these embellishments. Weapon decorations do not affect combat multipliers, even if your maul "menaces with spikes of steel." Adding decorations to an item does not increase its weight; this may be a bug. Decorations on "grey" items (with brackets) that were gained in battle, stolen from or traded with a [[caravan]], certify the product as "home-made" (brown), and make it count for your exports.

You cannot pick a specific object for a dwarf to decorate; their [[path]]ing will cause them to use the closest suitable object (yes, that will ''always'' be a barrel). With the addition of linked [[stockpile]]s, it is possible to set up a stockpile that will lend its contents to beautification; this sounds easy and nifty but isn't; it's a pain to set up and keep track of. In the past, locking all the desired content up, including the workshop and misbehaving dwarf, was the way to go. This still works.

The different civilizations have different tastes when it comes to decorations and consequently may offer (or ask for) more or less than the item value shown on the item information screen. [[Hippies|Elves]] dislike spikes and will not adorn their own items with them, and will also refuse to offer anything for the decoration. On the other hand, they will estimate a decoration depicting a [[tree]] at twice its normal value, because elves like trees so much. These modifiers only affect the value of the decorations themselves, not of the base item. They also only affect values when trading with visiting [[Trading|Merchants]], the fortress-internal value ratings are unaffected by such preferences. Most of the modifiers are regulated by entries in the entity_default [[Raw file]].

== Types of decoration ==

;Bone, Hoof, Ivory or tooth, Pearl, Shell,
: At a [[craftsdwarf's workshop]], objects can be decorated with [[bone]], [[hoof]], [[ivory]] or [[tooth]], [[pearl]], and [[shell]]. Requires [[bone carving]]. You cannot choose what kind of object to decorate. Decorating with bone uses up a whole stack of bones. {{Bug|2011}}

;Gem
: At a [[jeweler's workshop]], objects can be encrusted with [[Gem|cut gem]]s (including cut glass or cut stones). You may specify whether to decorate furniture, finished goods or ammo. Requires [[gem setting]].

;Metal studs
: At a [[metalsmith's forge]], objects can be studded with various metals. Requires [[metalcrafting]], but '''does not''' require [[fuel]]. The type of metal is chosen by the player, but the type of object is not.

;Cloth
: At a [[clothier's shop]], [[cloth]] images (plant fiber, silk and yarn) can be sewn onto clothing items (including leather armor) and bags. Requires [[clothier|clothesmaking]].

;Leather
: At a [[leather works]], leather images can be sewn onto clothing items in the same manner as cloth, with the same restrictions. Requires [[leatherworking]].

{| border = 1 cellspacing="0" cellpadding="5"
| align="center" style="background:#f0f0f0;"|'''Decoration'''
| align="center" style="background:#f0f0f0;"|'''Furniture'''
| align="center" style="background:#f0f0f0;"|'''Crafts'''
| align="center" style="background:#f0f0f0;"|'''Clothing'''
| align="center" style="background:#f0f0f0;"|'''Armor'''
| align="center" style="background:#f0f0f0;"|'''Weapons'''
| align="center" style="background:#f0f0f0;"|'''Ammo'''
|-
| Bone, Hoof, Ivory or tooth, Pearl, Shell || {{Y}} || {{Y}} || {{Y}} || {{Y}} || {{Y}} || {{Y}}
|-
| Gem || {{Y}} || {{Y}} || {{Y}} || {{N}} || {{N}} || {{Y}}
|-
| Metal studs || {{Y}} || {{Y}} || {{Y}} || {{Y}} || {{Y}} || {{Y}}
|-
| Cloth || {{Y}} (bags) || {{N}} || {{Y}} || {{Y}} (leather) || {{N}} || {{N}}
|-
| Leather || {{Y}} (bags) || {{N}} || {{Y}} || {{Y}} (leather) || {{N}} || {{N}}
|-
|}

== Bugs ==

Decorating with bone, horn or hoof uses up the entire remaining stack instead of just one item.{{bug|2011}}

{{Category|Items}}

v0.34:Macros and keymaps

2014-02-16T03:38:23Z

Doktoro Reichard: /* Creating macros */

{{Quality|Exceptional|14:18, 4 April 2011 (UTC)}}
{{av}}
Playing Dwarf Fortress means lots of typing. The game has an internal macro/keymap system. Using it or any external program can save you a great deal of time when dumping, rewalling, designating, and so forth.

== DF macros ==
=== Creating macros ===
The controls for creating macros within DF are as follows:

*{{k|Ctrl}}+{{k|r}} = record (and finish recording)
*{{k|Ctrl}}+{{k|s}} = save
*{{k|Ctrl}}+{{k|l}} = load
*{{k|Ctrl}}+{{k|u}}+number = set to repeat [number] of times
*{{k|Ctrl}}+{{k|p}} = play

To create a macro, press {{k|Ctrl}}+{{k|r}} to begin recording your actions. When you have recorded all the actions that you want, stop recording by hitting {{k|Ctrl}}+{{k|r}} again and save ({{k|Ctrl}}+{{k|s}}) the macro. The macro is then added to your macro list. To load a macro from the list just press {{k|Ctrl}}+{{k|l}}. You can then play the macro by pressing {{k|Ctrl}}+{{k|p}} whenever you want. You can also set a macro to repeat by pressing {{k|Ctrl}}+{{k|u}}, typing a two digit number, and then pressing {{k|Ctrl}}+{{k|p}} to begin the playback session. Moving your mouse from the playing window, or otherwise losing focus on DwarfFortress, is <s>an annoying way</s> a good way to interrupt a macro session from continuing (also the only known method).

There is a directory data/init/macros for them. The macros are saved in .mak format. The first line of the macro file must match the filename, or the file will not be recognized as a valid macro. Even a recorded file for a simple macro - for example to create a 3 tiles wide ramp - may already consist of up to 50 commands listed. This is because every possible [[Key_bindings|binding of the key pressed]] is included in the macro and put in a block (and {{k|r}} for ramp has many by default).
<pre>
pressing_enter_recorded
SELECT
CLOSE_MEGA_ANNOUNCEMENT
WORLD_PARAM_ENTER_VALUE
SETUPGAME_SAVE_PROFILE_GO
D_BURROWS_DEFINE
D_MILITARY_ALERTS_SET
End of group
CUSTOM_CTRL_R
End of group
End of macro
</pre>
For this example the recording was started, enter was pressed and the recording was stopped. When using this macro every underlying command in the file will be called, if possible. If you are in the designation menu, it will react as a select, the other commands will be ignored. If you are in the burrow menu, it will work like pressing enter there. The macro alway ends with a block containing the end of its recording. But executing macros seems to ignore this command. If you have changed your key bindings you'll get another result, because the underlying commands are recorded, not the keys pressed. 
When creating or editing your own macros it is a good idea to use only those commands you really want.
<pre>
ramping_created
DESIGNATE_RAMP
End of group
CURSOR_DOWN_Z
End of group
SELECT
End of group
CURSOR_RIGHT
End of group
CURSOR_RIGHT
End of group
SELECT
End of group
CURSOR_LEFT
End of group
CURSOR_LEFT
End of group
CURSOR_UP
End of group
End of macro
</pre>
This selfmade example will designate a 3 tiles wide ramp one z-level below and place the cursor to make the next execution of the macro continue the way down. The first line has to be the name of the file. You can see that there are grouping tags for every single keypress. These are important for a working macro. 
It is unknown if there is the possibility of creationg loops/iterations, other programming features or comments. 

Changing, removing and adding macros while the game is running uses a counter-intuitive process. After editing the file, you must delete and reload the macro. Select Options>KeyBindings>Macros. Delete the macro and reload it with {{k|Ctrl}}+{{k|l}}.
<pre>
macroscreen
OPTIONS
End of group
STANDARDSCROLL_DOWN
CURSOR_DOWN
End of group
STANDARDSCROLL_DOWN
CURSOR_DOWN
End of group
SELECT
End of group
SELECT
End of group
End of macro
</pre>

=== Tuning macros ===
The fewer commands a macro consists of, the faster it runs. This means you should avoid unnecessary steps by optimizing the "path" of your designations.

The second and most effective way to increase speed is to remove all unnecessary commands DF recorded. These may be found in the init/macros folder and edited with any basic text editing program. The extra commands are ignored by the game but they still take time to be processed. To move a cursor 3 (up/down) or 4 (right/left) commands are recorded, most other keys are bound to more commands. Pressing {{k|d}} for example records more than 30 commands.

For example the code below is a simple macro that selects the digging designation, moves one square to the right, and then designates that tile to be dug.
<pre>
example
OPTION4
CUSTOM_D
WORLD_PARAM_DELETE
LEGENDS_EXPORT_DETAILED_MAP
A_COMBAT_DODGE
A_STATUS_DESC
A_SLEEP_DAWN
A_INV_DROP
SETUP_NOTES_DELETE_NOTE
BUILDJOB_TARGET_RIGHT
BUILDJOB_BED_DORMITORY
BUILDJOB_FARM_WINTER
BUILDJOB_RACKSTAND_KILL2
HOTKEY_BUILDING_DOOR
HOTKEY_BUILDING_CONSTRUCTION_STAIR_DOWN
HOTKEY_BUILDING_WORKSHOP_DYER
BUILDING_ORIENT_RIGHT
BUILDING_ADVANCE_STAGE
BUILDING_TRIGGER_MAX_SIZE_DOWN
BUILDING_TRACK_STOP_DUMP
HOTKEY_GLASS_DOOR
HOTKEY_CARPENTER_DOOR
HOTKEY_MASON_DOOR
HOTKEY_TRAP_DOOR
BUILDJOB_STOCKPILE_DELETE_CHILD
STOCKPILE_ARMOR
STOCKPILE_SETTINGS_DISABLE
STORES_DUMP
ORDERS_DYED_CLOTH
ORDERS_ZONE_DRINKING
D_DESIGNATE
D_HAULING_STOP_LC_DIR
D_BURROWS_DELETE
D_NOTE_DELETE
D_NOTE_ROUTE_DELETE
D_BITEM_DUMP
D_LOOK_DUMP
ARENA_CREATURE_SIDE_UP
ASSIGNTRADE_SORT
DESIGNATE_DUMP
DESIGNATE_DIG
ITEM_DUMP
D_MILITARY_DISBAND_SQUAD
D_MILITARY_ALERTS_DELETE
D_MILITARY_AMMUNITION_REMOVE_ITEM
D_MILITARY_DELETE_UNIFORM
STRING_A100
End of group
STANDARDSCROLL_RIGHT
CURSOR_RIGHT
WORLD_PARAM_INCREASE
A_MOVE_E
End of group
SELECT
CLOSE_MEGA_ANNOUNCEMENT
WORLD_PARAM_ENTER_VALUE
SETUPGAME_SAVE_PROFILE_GO
D_BURROWS_DEFINE
D_MILITARY_ALERTS_SET
End of group
SELECT
CLOSE_MEGA_ANNOUNCEMENT
WORLD_PARAM_ENTER_VALUE
SETUPGAME_SAVE_PROFILE_GO
D_BURROWS_DEFINE
D_MILITARY_ALERTS_SET
End of group
CUSTOM_CTRL_R
End of group
End of macro
</pre>
Here is the same code but optimized through removal of all the excess commands. Each macro also contains an addition CUSTOM_CTRL_R command at the end that may be removed as well.
<pre>
example
DESIGNATE_DIG
End of group
CURSOR_RIGHT
End of group
SELECT
End of group
SELECT
End of group
End of macro
</pre>

The third way to increase the speed of macros is to change settings in the init-files. In the [[init.txt|base init file (data/init/init.txt)]] you will find the follow lines:
<pre>
If you set KEY_REPEAT_ACCEL_LIMIT above one, then after KEY_REPEAT_ACCEL_START repetitions
the repetition delay will smoothly decrease until repetition is this number of times faster
than at the start.

[KEY_REPEAT_ACCEL_LIMIT:8]
[KEY_REPEAT_ACCEL_START:10]

This controls the number of milliseconds between macro instructions.

[MACRO_MS:15]

</pre>

* The <code>MACRO_MS</code> setting is the number of milliseconds between macro instructions (the default, 15, allows 1000/15 instructions per second, or about 66). Decreasing this makes macros run '''faster''', although decreasing it too far can make the game unresponsive while the macro is running.
* The <code>KEY_REPEAT_ACCEL_START</code> and <code>KEY_REPEAT_ACCEL_LIMIT</code> settings are unrelated to macros (except while recording). See [[Technical tricks#Keyboard|Technical tricks]] for more information.

== External utilities ==

=== [http://joelpt.net/quickfort/ QuickFort] ===
A spreadsheet-driven construction tool for Dwarf Fortress. Converts CSV files containing a "graphical" (or at least two-dimensional) representation of what you want to build into efficient DF macros. Comes with a number of scripts to get you started, some of them quite complex.

=== AutoHotKey ===
AutoHotKey is a powerful easy-to-use scripting language that can simulate keystrokes. (among other functions)

To started:
# Go to the [http://www.autohotkey.com/ AutoHotKey website] and download AutoHotKey. Installation is simple and the program uses very little system resources.
# Read through their [http://www.autohotkey.com/docs/Tutorial.htm quick-start guide] and start write your macro scripts (file type .ahk), which may contain any number of commands. You activate scripts by double-clicking .ahk files or by assigning hotkeys to your macros. Both of these can be done at any time - even right in the middle of a game. AutoHotKey also allows for automated activation of scripts.

=== Fluxbox + xvkbd ===
For linux, it's a quite cool solution. It's possible to create macros with outside tools, like fluxbox (linux window manager) + xvkbd (linux virtual keyboard for kiosks, with some macro capabilities). See the documentation [[Fluxbox_macros|here]].

Pros:
*Faster execution
*Easier script writing
*Portable code
Cons:
*Sometime needs timing
*Need xvkbd (Linux at least)
*Need some special key reservation

'''Please see also the [[40d:Macros and Keymaps|40d macros page]], as much of what is there works perfectly fine. If you can verify it works, please move it to this page.'''

== Useful Macro Ideas ==

The following are macro ideas that other players have found useful, and may make management of your fort easier. For most macros it's highly recommended to '''pause the game''' before hitting the play button to avoid your dwarves causing unexpected behavior, i.e. a dwarf giving birth or anything else that auto-zooms to a different location.

=== Large Bedrooms ===

Bedrooms, especially larger ones or large blocks of identical ones, involve a lot of designations and build orders. These macros are designed to streamline the process. For all of these mass-building macros you may wish to temporarily forbid any of your artifact or masterwork furniture, to avoid giving overly-valuable items to your dwarf peasantry.

==== Placing Beds ====

So you've recorded a macro to dig out a series of bedrooms, and now you have to fill them. Bring up the {{k|b}}uild menu, select {{k|b}}ed, and go the first position you want to place a bed in.

Start a new macro ({{k|Ctrl}}+{{k|r}}) and place the bed (selecting the first bed from the list), then move to the next bedroom in sequence. Repeat this until you reach the end of the row. If you are placing beds into multiple long rows of bedrooms, move the cursor to the first bed in the next row to make things faster. Turn off macro recording ({{k|Ctrl}}+{{k|r}}), but don't exit the build menu. You can then save your macro if you wish, though it's not necessary. Play the macro ({{k|Ctrl}}+{{k|p}}), and you have just laid out another row. Repeat until you have enough bedrooms or you run out of beds.

==== Placing Coffers ====

Placing coffers (but ''not'' bags) requires an extra step. Pause the game (you ''did'' remember to pause before playing macros, didn't you?) and go to the Stocks menu. Forbid all bags, regardless of what's inside them or what they're being used for (this is temporary). Exit to main screen and repeat the steps above, this time placing containers in your rooms. You will end up placing only chests / coffers / boxes, ignoring any bags. Repeat and play back for the rest of your bedrooms, then un-forbid your bags before un-pausing the game.

==== Resizing Rooms ====

If the bedroom is finished (at least all the beds are hauled to place), you may want to create a new macro to designate each room as a bedroom. {{k|q}}uery the building and select the first bed. Start a new macro and press {{k|r}} to designate it as a bedroom, then press + a few times to fill the available space. If you are fine with the size of the bedroom you can press enter, move on to the next bed, and repeat this for the whole row. If you want bedrooms that fill all the room and not all your bedrooms are the same size, you may have to press + a bit more or less for the larger cases. Repeat this for the rest of the rows as above.

=== Mass Selector ===

With this macro you can select a lot of things at once. Extremely helpful if you want to sell a lot of junk to the caravans. Record {{k|enter}}, then {{k|down}} about 10-25 times in a row. (For some menus you may wish to use {{k|enter}}, then {{k|+}}) When the caravan arrives, your dwarves haul all the bins to your Trade Depot for sale as normal. At the trade menu, load the macro and play it as many times as you like. The macro will select all the items in your "for sale" list, saving the bins you carried them in for later use. Be sure to at least browse through the final list once you're done to avoid selling items you didn't wish to sell, i.e. items that were in the same bin as your trade goods that you wish to keep, or wood items if you're trading with the Elves.

=== Mass Trap Builder ===

It's basically just the same as building items in bedrooms, but for traps. Useful for populating entire hallways with weapon or stone-fall traps.

=== Custom Uniforms ===

Since custom uniforms are not saved from one fortress to another, it can be tedious to remake them after each new embark. Instead, you can record a few macros to create each of your custom uniforms (Axedwarves with full armor, Wrestlers with light armor, Archers, Civilians, etc.) It is recommended to start recording each macro from the main window, before entering the (m)ilitary screen, and to avoid naming the uniform as part of the macro. Because of the way the uniform menu is set up, you should also be careful not to move the cursor back into the uniform list during the recording of your macro, or problems may arise. As always, pause the game before you start recording or playback.

=== Digging in Odd Directions/Shapes ===

While it is very simple and fast to designate mining in any of the 6 possible linear directions (North, East, South, West, Up, and Down) in very long sections, specialized mining, such as diagonal hallways, circular rooms, etc., are more difficult. It may be worth, for example, recording 4 macros that dig a short section of 3-tile wide hallway in non-standard directions (NE, NW, SW, and SE). This way, when you want a hallway dug at a 45 degree angle you just load the appropriate macro and keep playing it until the hallway is the desired length.

=== Downshafts ===

Simple up/down stairs are easy to do, but if your standard fort layout includes stairs with empty spaces around them, like so...
<pre>
(rooms)

%%..%%
%....%
(more ..XX.. (still
rooms) ..XX.. more
%....% rooms)
%%..%%

(etc...)
</pre>
...it can be cumbersome to designate all of that for multiple Z-levels at once. Instead, create a macro from one reference point (say, the top-left staircase of the 2x2 shaft or some such) and hit record, then designate the staircase area as you see fit. Move the cursor back to your reference point and move down one Z-level, then stop recording. You can now load it up and play it wherever you need it.

For added awesomeness, trim out the extra commands in a text editor as described above. Then highlight the whole macro and copy/paste it into a new file, copying the commands 5 times or as many as you want. Then save the new macro as a separate file (be sure to rename it at the top of the macro text as well). In this way you can have easy-to-use macros for digging your own standard stairwell. Separate macros for 1 level, 5 levels, and 20 levels seem to work well.

== Troubleshooting Scripts ==
Users may experience some issues in getting external scripts to work, particularly when using looping scripts when experiencing low frame-rates.
* If experiencing low frame-rates, try adding delays ("Sleep 100" to pause for 100 milliseconds for example) within macros to allow the interface to keep up. If there are nested loops, sometimes adding a pause at the end of an inner loop is all that is needed to flush the keyboard buffer.
* Another way to add delay during and after each simulated key press is to put SetKeyDelay, 40, 40 at the start of the macro.
* Make sure that Dwarf Fortress maintains focus. IM windows are the enemy! Who needs friends anyhow? You've got Dwarf Fortress.
* This may go without saying, but most macros assume standard key-mappings. If you're using non-standard ones, you may have to edit the macro to get it to work.
* Visiting liaisons can bring up screens that eat keystrokes, throwing a long-looping script out-of-phase with where it expects the game to be. Wait for the farewell screen before running a long script, or just pause the game beforehand.
* The SendPlay function supports keys that the Send function does not, for example {{key|Shift-Enter}}. According to the AutoHotKey documentation, SendPlay may also be better at preventing dropped keystrokes.

=== General Fortress Mode Hotkeys Script ===
An attempt at speeding up various designations. Includes an up/down stair builder, a fast move up/down, and some select-and-advance keys. Please see [[user:DDR#Dwarf_Fortress_General_AHK_Script]].

v0.34 Talk:Macros and keymaps

2014-02-16T03:37:43Z

Doktoro Reichard: /* Moving mouse outside window */ new section

v0.34:Cage

2014-02-15T02:43:43Z

Doktoro Reichard: Cages that are worn out are stored in a refuse pile, even if full with a live goblin.

{{quality|Exceptional|22:58, 6 January 2011 (UTC)}}{{av}}{{buggy}}

{{furniture|name=Cage
|tile=‼|col=0:6:0
|wood=y
|metal=y
|glass=y
|rooms=
* [[Jail]] (if metal)
}}
:''For information on cage traps, see [[Trap#Cage_Trap|traps]].''

'''Cages''' are used in [[cage trap]]s, [[jail]]s, [[zoo]]s, [[pit]]s and aquariums.
A glass cage is called a terrarium or, if filled with water for holding [[Captured live fish|captured]] live vermin [[fish]], an aquarium.

Cages are stored on the Animal Stockpile (unless they have been [[Wear|worn]] out somehow, in which case they are stored in a Refuse Stockpile). Dwarves will attempt to collect and store cages in stockpiles if the {{k|o}}rders - dwarves haul {{k|a}}nimals option is set.

To set a pile to accept ''only'' empty cages, set up an animal pile (or a custom pile) and in its settings {{k|b}}lock all and use {{k|u}} to enable empty cages. Similarly, to block empty cages, use {{k|u}} to disable them. ({{k|j}} toggles [[animal trap]]s.)

==Building and using a cage==
Cages can be constructed from [[wood]] at a [[carpenter's workshop]], from [[metal]] at a [[metalsmith's forge]], and from [[glass]] at a [[glass furnace]].

You can then either build them on a tile via {{k|b}} - {{k|j}} (this is needed for linking a lever to them, or assigning a tame animal to it) or simply keep them stockpiled so they can be used to load cage [[trap]]s.

When building a cage, you can choose a cage that already has something inside. To precisely select which cage to use, you can expand the list of cages with {{k|x}}.

===Creature containment===

To assign creatures to a (built) cage, press {{k|q}} and move the cursor over the cage. Use {{k|+}} and {{k|-}} to scroll up and down the list of [[creatures]], and {{k|Enter}} to assign them to the cage. Creatures currently assigned to the cage are listed at the top; the rest of the creatures are listed in order of arrival on the map (including any inaccessible creatures). Note that tame grazing creatures will starve if left in cages, though pet owners may feed their pets. Instead of caging grazers, assign them to a [[zone|pasture]] that has plenty of tasty [[grass]] and/or [[cave moss]].

Multiple creatures can be assigned to the same cage with no penalty. It is apparently possible to fit hundreds of [[dog|puppies]] in a cage with dozens of [[blind cave ogre]]s with no ill effects or a [[dragon]], a thousand [[cat]]s, and whatever else is on hand, leading some players to conclude that cages include some sort of hidden "cage space" that allows infinitely tight packing of creatures.

There is no particular labor for releasing creatures from (built) cages. Use {{k|q}} to examine the cage (it must first be "built," not just stored - use {{k|b}}-{{k|j}} to build cages, and {{k|x}} to be sure to get the right cage), {{k|a}} to assign, and then use {{k|enter}} to toggle the animal(s) currently inside (animals assigned to the cage will have a green "+" next to them). Any available dwarf will perform the job, so beware of pitting untamed or hostile creatures with a weak dwarf.

You can get details about the creatures which are in a built cage by pressing {{k|t}} and then {{k|enter}}. There, you can scroll the list of creatures and get details, for example, you can tell whether a creature is male or female, which is useful if you are preparing a breeding program.

[[Vermin]] can also be assigned to cages, to save space or [[animal trap]]s. However, if you try to release them ({{k|q}} and then {{k|a}}), the dwarf will pickup an animal trap and put the poor creature back in a stock cage. To explicitly release an animal, instead "pull" the animal somewhere else: either assign the animal to a [[pit]] (which could simply be a hillside outside your fortress), or a pasture. This has the benefit of making it clear where the animal is being released. However keep in mind the dwarf will uncage the animal first and then lead it to the release, so large/dangerous animals may escape en route. Consider using the [[dump]] command to move the cage before release, or assign the animal stockpile next to the pit/pasture.

Bees shows up in the list of creatures that can be assigned to a cage, but dwarfs will not start the task, and it will not be shown in the {{k|j}}obs list.

[[Breeding]] creatures are unable to get pregnant if caged, although they will give birth while caged if they became pregnant before being caged.

===Prisons===

To set a cage as a [[jail]], {{k|q}}uery the cage, designate it as a {{k|r}}oom, and then set it to be used for {{k|j}}ustice. Only [[metal]] cages may be used in this way, despite [[wood]]en cages being strong enough to hold [[dragon]]s.

If you want your prisoners to survive their sentences, it is strongly recommended '''not''' to use cages but [[rope|chains or ropes]] for your prisons, with drink and food placed directly adjacent to the chains. Caged dwarves must be given water and drink by others, and the required jobs are almost never generated. Dwarves caged in the name of justice will ''normally'' die of thirst or starvation, due to a bug preventing prisoner care jobs from being queued up in many cases {{Bug|2606}}.

===Remotely Opening Cages===

A built cage can be linked to a [[lever]] to remotely open it. When the cage opens, the occupant(s) inside are released, the cage and [[mechanism]] deconstruct and can be returned to their respective stockpiles. Note that you have to use a "built" cage as described above, it won't work with cages on your stockpile. Also note that the mechanism attached to the lever will '''not''' automatically deconstruct; you have to manually deconstruct the lever to get back the mechanism used to open the cage.

===Alternate way of Opening Cages===

When traders are around, you can select "move good to trading depot" and select the cage of choice. When a hauler takes the cage, any untameable creatures inside will be released. Be sure to disarm the creature beforehand...

A way to release creatures from stockpiled cages (which have not been built) is to assign the creatures to a [[pasture]] (which is possible for any living thing except dwarves). The same precautions as for trading the cage should be taken first.

Another way is to use [[container]] spilling effect: cages [[Trap_design#Minecarts hurled from a colliding minecart]] ''also'' spill their contents upon collision (see [http://www.bay12forums.com/smf/index.php?topic=109460.msg3340230#msg3340230 this forum message]). Possibly works with a [[Bridge#Raising_and_Retracting_Bridges raising bridge flinging]] as well{{verify}}, but minecarts are easier to load as needed via stockpiles anyway. This combines timing control of a lever or pressure plate with reusability of pitting. If you want to deliver Goblin snatchers into your target practice room despite [[Thief|thieves]]' ability to wriggle out of normal pitting, or a bunch of [[Cave floater]]s toward invaders, this method may be preferrable.

===Cages and Fluids===

A cage will protect a creature inside it from [[swimmer|drowning]], so if you want to drown a creature in a cage, you must open it remotely, as explained in the above section (as a corollary, if your fortress is drowning in water, you can cage your dwarves and rescue them later). However, built cages will not protect caged creatures from [[magma]], making this a somewhat faster option, as it doesn't require linking each cage to a lever. Cages which are not [[magma-safe]] will be degraded and/or destroyed by this process, and cages which are made of flammable materials (such as wood) may be set on [[fire]]. Any items the creature had equipped will teleport {{verify}} to wherever the creature was caged, typically a tile with a [[cage trap]] on it. These items may or may not be on fire; no case of teleporting !!large cave spider silk sock!!s have yet been observed, but this doesn't prove it can't happen. Exercise caution.

It's also possible to cage fluids(done by pushing uncaged animals/invaders over armed cage traps with water.) The cage containing the liquid must be built to remove the liquid. *magma not tested (yet)

===Buying Cages ===
Traders may bring cages for sale. If these cages contain a [[tame]]d [[creature]], the item will be listed as (creature) cage, and will not describe the material the cage is made out of. However, the cage may contain a tamed [[vermin]], in which case it will be listed in the trading dialogue as by the material the cage is made out of. In such cases, the expanded cage description will list the contents of the cage. You can often infer that trained vermin are in a cage by noting the cage's value compared to other cages of identical quality in the list.

However, once you have bought the cage the item name will list the material of the cage; ie: Wolf Cage (Oaken).

===Selling caged creatures ===
If you want to sell an animal, you need to assign it to a constructed cage first (see above) and then deconstruct the cage by {{K|q}}uerying it and pressing {{K|x}}. You can then select the cage in the trading menu.

Note that only tamed animals can be traded safely. The dwarf assigned to hauling a container will look through its contents and chuck out anything that can't be traded. In the case of cages, this means anything sentient - including such nasties as [[cyclops|cyclopes]].{{Bug|4065}} Letting such monsters loose in the middle of your fort is good [[fun]].

=== How to disarm hostiles in cages ===
An easy way to take away all prisoner-held armor and clothing is via the mass designation tool. Designate an area with {{K|d}}-{{K|b}}-{{K|c}} to claim and {{K|d}}-{{K|b}}-{{K|d}} to dump an area (i.e. your animal [[stockpile]], filled with caged prisoners). Afterwards, hit {{K|k}}, and go over each cage and press {{K|d}} for each of them - this stops the dumping on the cages themselves. You will need a [[DF2012:Activity zone#Garbage Dump|garbage dump]] set up already for the dwarves to take the dumped items to. The dwarves will strip the prisoners naked and haul the items away. The cages themselves (and the creatures within) will remain in place. The items will end up in the garbage dump zone. If you want to to reuse the items, you need only to designate claim {{K|d}}-{{K|b}}-{{K|c}} on your garbage dump zone to reclaim the items after they are dumped there. If your animal stockpile is outdoors, you need to have the "Dwarves Gather Refuse from Outside" {{K|o}}-{{K|r}}-{{K|o}} order set.

An easier way to selectively disarm prisoners is to designate mass forbid {{K|d}}-{{K|b}}-{{K|f}} and mass dump {{K|d}}-{{K|b}}-{{K|d}} on all of the caged prisoner stockpile. You will need a [[bookkeeper]] for this. Press {{K|z}} and go to the [[stocks]] screen. Find an item category with items marked '''F''' and '''D'''. Press {{K|f}} to remove the '''F''' for those items, but don't remove the '''D'''. This will unforbid them, but they will remain marked for dumping. When you exit the stocks screen, the dwarves will haul those items from the cages and drop them into the garbage dump. When the dwarves have finished the hauling tasks, designate a mass claim {{K|d}}-{{K|b}}-{{K|c}} and mass undump {{K|d}}-{{K|b}}-{{K|D}} on the same area as earlier to remove the forbid and dump designations from the cages and the rest of the contents.

This method can be used to confiscate specific items from caged prisoners, like weapons, armor or bags containing stolen property or kidnapped children. It can be more useful to just remove their weapons if you want to use your caged prisoners for target practice; they will be more durable with their clothes and armor equipped, but not very dangerous without their weapons.

=== Emptying refuse ===
If you [[animal trainer|tame an animal]] while it is inside a cage (a process which involves feeding a plant to the caged animal), you may leave seeds inside the cage. To get these out, you must mark them for [[activity zone#Garbage_Dump|dumping]], designate a garbage zone, and wait for a dwarf to dump the seeds in the garbage zone. Then you can reclaim them.

Animals that expire in a cage (built in a [[zoo]], or just sitting in an animal stockpile) also clutter up the cage until removed. If the cage is unbuilt and the animal is [[butcher]]able, your dwarves may haul the animal, cage included, to the butcher shop for processing. If not, you will need to manually clean the cage by dumping the corpse and any other items.

Marking refuse for dumping can be done by pressing {{k|k}} for an unbuilt cage ({{k|t}} for a built cage), then selecting the cage and pressing {{k|Enter}}, then selecting the item and pressing {{k|Enter}} again, and finally pressing {{k|d}} to mark the item (rather than the cage) for dumping. Or if there is a lot of refuse, you can use {{k|d}}-{{k|b}}-{{k|d}} to mass-dump everything in the tile, and then un-mark the cage itself.

=== How to quickly empty out many cages ===
If you have many [[Trap#Cage_Trap|cage traps]] then you may have trouble emptying out cages quickly enough at times. See [[Mass pitting]] for suggestions on how to quickly recycle cages.

Another easy way to quickly empty cages is to simply send the imprisoned creatures to a pasture, where your squad can slaughter them.
(Your dwarfs can drag every goblin except thieves).
The easiest way is to place the pasture right next to the cages and let our dwarfs shoot them down. This way you can kill the thieves and monsters too.

{{buildings}}

==Bugs==

* Creatures in cages that come from dead merchants can only be freed by assigning them to a [[Zone#Pen/Pasture|pen/pasture zone]] and then when they have been put there, deassign them from the pen/pasture.
* When bringing a cage to the Trade Depot in order to trade it, any untameable creatures inside the cage will be freed. Tamed (and presumably also wild but tameable) animals can be safely traded. {{Bug|4065}}
* Aquariums cannot be used to store large fish (they will drown), though vermin fish work just fine. {{Bug|1590}}
* Placing a vermin fish in an aquarium can cause [[purring maggot]]s to become unmilkable. {{Bug|6116}}
* Creatures escape from Artifact traps/cages. {{bug|6117}}
* Dwarves caged in the name of justice will often die of thirst or starvation, due to prisoner care jobs not being queued up in many cases {{Bug|2606}}.

{{Category|Justice}}
{{Category|Buildings}}

v0.34:Exploit

2014-02-14T22:25:51Z

Doktoro Reichard: /* The Minecart Stop */ - minor grammar fix

{{quality|Exceptional|15:49, 24 August 2010 (UTC)}}{{av}}

An '''exploit''' is a quirk of a game that allows players to gain what other players may consider an unfair advantage, usually by making use of a feature that is not working properly or which defies logic. 'Exploiting the game' is distinct from '[[Main:cheating|cheating]]' because exploits occur within the game as written and do not need any external [[Main:utilities|utilities]] or [[Main:modding|modding]]. Whether a player chooses to make use of an exploit or not depends on their personal taste; given that [[Main:Dwarf Fortress|Dwarf Fortress]] is a single-player game, the user alone can decide what liberties to take and what options to shun. Among DF players there is much discussion about what actually should be considered an exploit, going from making sweetpod syrup instead of sugar, growing crops in winter, or even underground, as the one extreme, to justifying 'water wheel batteries' as the other. This page takes a rather relaxed approach in that you considering it an exploit is basically enough to add it, if you don't get too much opposition.

== Atom Smasher ==
{{main|Dwarven atom smasher}}

Lowering a raised [[drawbridge]] can be used to obliterate most creatures or items beneath it. The drawbridge will be destroyed if it is used to crush a creature of too large a size.

==Manager Exercise Program==

As a [[Manager]], skill is gained as tasks are approved, not completed. Simply by queuing lots of jobs ({{key|j}} {{key|m}} {{key|q}}) (and providing a meager office), the manager will quickly level to [[legendary]] as an [[Organizer]]. The tasks can then be removed once approved.

==Merchant Swindles==

There are a variety of ways to steal cargo from [[merchant]]s without seizing it; all amount to naked theft. Tearing down the [[trade depot]] while the merchants are there is the easiest way.

Also, marking items for [[dump]]ing, using view creature mode ({{key|v}}), the stocks menu ({{key|z}}), items in room mode ({{key|t}}), or mass dump mode ({{key|d}})-({{key|b}})-({{key|d}}) then marking the entire depot, lets you relieve merchants of their goods. Just reclaim the items from your garbage dump [[zone]] later. You can even take clothing and equipment off merchant and guards this way.

You can make a wall around the merchants (and even the poor animals) and let them starve to death, letting you take what ever you want. Wait quite a while for them to starve. They will become [[Insanity|very angry]] if you do, so never open the door once they are on the brink of death.

However, the merchants will consider any lost goods to be stolen goods regardless of the method used to take possession of or destroy them.{{Verify}} See [[40d:Trading#Note_that_the_civ|the 40d page]] and [http://www.bay12forums.com/smf/index.php?topic=43771.msg829692#msg829692 This forum post]. So unless you specifically want to take the clothing off the backs of the merchants or steal from your own civ, you might as well just seize the goods anyway.

== Quantum stockpiles ==

A Quantum Stockpile (QSP) allows you to store an infinte number of items in a single tile. QSPs can make for super efficient storage, allowing more compact fortresses, shorter hauling routes, more efficient manufacturing flows, stocktaking at a glance with look {{K|k}} and [http://www.bay12forums.com/smf/index.php?topic=92241.msg3276117#msg3276117 possibly higher FPS].

Note that, due to {{bug|5994}}, deconstructing [[construction]]s near a quantum stockpile can potentially create many simultaneous [[hauling]] jobs. There is currently no easy way to prevent this. Undumps, due to their single-job nature, will not have this problem, and minecart stops will generate only a limited number of jobs due to their [[minecart#Capacity|capacity]].

=== Simple Quantum Stockpiles ===
The simplest QSP is created by designating a garbage pit zone instead of a [[stockpile]], dumping the items you want to store and then reclaiming them when you are ready to use them.

A similar effect may be achieved for stones by building a wall two tiles in front of a catapult and digging a channel between the wall and catapult. By firing the catapult at the wall, the stone falls into the trench. The stone will pile up in the channel, putting it out of sight and out of mind. Not only does this train [[siege operator]]s, but it clears the stone that your [[miner]]s leave everywhere.

Another way to quantum stockpile is to not have appropriate stockpiles to move items back to after you move them to the trading depot. The depot can hold an infinite number of items, and those items will not be removed if there is nowhere else to place them. This is also useful for anything you want to trade anyway.

=== The Minecart Stop ===
This method allows the type of items to be stored in the Quantum Stockpile to be completely controlled and to be as broad or specific as required. Collection of items is automatic with no user input required (just like a normal stockpile), and the number of haulers collecting for the stockpile is controlled by the size and number of receiving stockpiles. Distribution is also automatic, with dwarves coming to collect items as needed (just like from a normal stockpile).

This can be utilised as part of a [[minecart]] transport system, or standalone with no tracks or moving minecarts whatsoever. The steps below are to create a standalone Quantum Stockpile, but the same general principles apply if used in a minecart transport system.

''Setup:''
rrrr r receiving stockpile
S S track stop, set to dump south
d d distribution stockpile

# Build a track stop {{K|b}} - {{K|C}} - {{K|S}}. Ensure you set the dumping direction {{K|d}}.
# Designate a 1x1 distribution stockpile {{K|p}} on the square where the stop will dump and define preferences {{K|q}} to make the settings {{K|s}} store only what you want, with no barrels {{K|E}}, bins {{K|C}} or wheelbarrows {{K|w}}.
# Designate a receiving stockpile {{K|p}} (can be anywhere, but optimally right next to the constructed track stop) of any size. The larger it is, the more dwarves will simultaneously collect items. Define the preferences{{K|q}} of this stockpile to be the same as the distribution stockpile, with the possible exception of the number of wheelbarrows. If the QSP is for heavy items (eg loose [[stone]]s), you may want to use wheelbarrows in the receiving stockpile to speed up collection. Wheelbarrows will place a limit of up to three dwarves simulatenously collecting, unless you make multiple receiving stockpiles, each with its own set of wheelbarrows.
# Construct a new hauling route {{K|h}}, assign a vehicle {{K|v}} (You'll need to make a mine cart), and define a new stop {{K|s}} on your constructed track stop. {{K|Enter}} to define the stop, {{K|Enter}} again to set the desired items to the same as your stockpiles, {{K|x}} to remove all existing conditions, {{K|s}} to make a stockpile link and choose the receiving stockpile/s to tell the minecart track stop to take from them.

It is a little fiddly to initially set up, and if you miss any step it won't work at all, but once in operation it's an extremely efficient storage system, and scales easily with the size of your fortress, number of haulers and number of items to store.

This method cannot store any items in [[bin]]s or [[barrel]]s at all, including bolts (which shouldn't be stored in a bin anyway {{bug|2706}}), and all types of drinks (you will see your dwarves leave barrels and pots of alcohol all over the place). [[Food]] stored using this method tends to attract [[vermin]], especially swarms of [[fly|flies]], since it can't be placed in barrels. This method works well for [[furniture]], [[wear|cast-off]] [[clothing]], [[metal]] and [[stone]]. A quantum minecart stop can be combined with some sort of [[garbage disposal]] mechanism to easily handle [[refuse]] and [[invader]]s' corpses.

Note however that if your dwarves are under [[standing orders]] to ignore outdoor refuse (the default setting) they will also not load an outdoor refuse pile into the minecart.

=== The Undump ===
This technique was [http://www.bay12forums.com/smf/index.php?topic=92241.0 developed] before minecarts were implemented. While still a valid method, it has been superseded by the Minecart Stop QSP which achieves the same result, is easier to set up and has fewer drawbacks.

''Setup:''
H Hatch cover
===== ^ pressure plate, citizens trigger, linked to hatch
^sHs= = Wall
===== s Stockpile (same type)

The idea is that haulers try to place some item on the right stockpile, step on the pressure plate and make the hatch cover retract. This makes them cancel the hauling job because they can't reach the right stockpile. They then drop the item on the left stockpile, on top of as big of a pile as you want.

More information on this method can be found on the inventor's [[User:Vasiln/Undump|user page]].

Drawbacks to this design:
#It's slow, because the one target stockpile generates only one job at a time. If you have more than one target stockpile they create lag because of pathing issues. You probably want to keep your normal stockpiles and use the undump to clean them up slowly. At which point you could consider just using the normal quantum stockpile dumping. Or you build more undumps.
#Job cancellation spam. You can turn that off.
#Oftentimes, dwarves drop the item on top of the pressure plate instead of on the stockpile. A feeder stockpile just outside the undump helps here.
#You obviously need some materials to build it.
#You need to create an open space tile where the hatch cover is (channelling only leaves a ramp), which means digging in the level below.
#You want to set the pressure plate to the lowest minimum weight (10000, which gets a zero cut off and displays as 1000). This can get tedious, so getting a macro is advised.
#If your stockpile management is exceptional already, the undump may not be of as much use to you.
However, there is a multitude of potential applications that get discussed in [http://www.bay12forums.com/smf/index.php?topic=92241.0 this] thread.

== Building destroyer door ==

Forbid something a dwarf is carrying as he goes through a door, and he'll drop it. The door won't close and won't stop any normal creature from going through, but building destroyers seem to stop in their tracks, waiting for it to close before moving on. Note: your civilians can pass the creature safely, but attacking it cancels your protection. {{Verify}}

== HFS's back door ==

There's a convoluted way to dig down through [[semi-molten rock]] and evade the head-on encounter with [[hidden fun stuff]]. Doing this can enable you to, among other things, mine undiggable [[slade]] and duplicate rare minerals. See the page for [[semi-molten rock]] for details.

== Forgotten beast zoo ==

Wall off all the passageways into your lowest level at the outermost square of the map - except one, which leads to a little vestibule surrounded by fortifications. Wave hello to the various ungainly "[[forgotten beast]]s" which accumulate inside.

Alternatively, by using a [[giant cave spider]] or web-spewing forgotten beast to place [[web]]s on cage traps you can capture and display non-web-spewing forgotten beasts, titans, and more.

== Dwarven Water Reactor ==

A [[screw pump]] requires 10 power to move water; a [[water wheel]] supplies 100 power if it's got water moving it. Arrange the former to feed the latter, while the latter powers the former, and you can get perpetual motion going - with a surplus of power available. See [[Water wheel#Perpetual motion|here]] for more details.

== Urist McAdventurer the Shield-wall ==

Adventurers are not limited in the number of items they can hold in their hands, allowing them to equip a virtually unlimited number of shields or bucklers with little effect to the adventurer's performance. This offers multiple chances to block attacks (vastly reducing the number that cause damage) and quickly trains up the shield user skill, further increasing the effectiveness of those shields. There is an indirect limit on how many shields you can equip based on how the total weight of your adventurer's items affects your speed, but the tradeoff between wearing a dozen (or more) shields is well worth the minor reduction in speed.

== Infinite drink in adventure mode ==

Thirst can be quenched indefinitely in adventure mode by emptying a waterskin when you only have 1 unit of liquid left and refilling it from the pool that forms; giving you 3 units of drink. This is especially useful if you managed to find alcohol and fill your waterskin with some, as alcohol never freezes in cold weather.

== Backpack of holding ==

In adventurer mode, if you try to pick something up while both your hands are already holding something, it'll go straight in your backpack, even if it would not have fit had you first picked it up and then tried to put it inside. That means you can stuff as much as you want into your backpack.

== And we'll throw in the barrel/bag for free ==

On [[embark]] buying things which are stored in [[barrel]]s gets the barrel for free, with at most 10 items per barrel, so, for example, the 15 units of randomly chosen [[meat]] which come with the default supplies will get you two free barrels, one completely filled with 10 units of meat and one half filled with 5 units of meat; you get another two free barrels from the 15 units of randomly chosen [[fish]]. You can get rid of all of that food, then for the same cost select one unit each of meat from 30 different kinds of animals, giving you 30 free barrels instead of only 4, since each different kind of animal meat is put in its own barrel. Note that different types of meat from the same kind of animal goes into a single barrel, so choosing 1 yak brain + 1 yak eye + 1 yak spleen will get you only one free barrel instead of three.

The same thing goes for things stored in [[bag]]s. Each unit of [[sand]] comes in its own bag, and since each unit of sand costs only 1 embark point while bags cost a minimum of 10 embark points each, you can get bags for ten times cheaper by buying sand, then [[dumping]] out the sand after embark.

== Infinite Adamantine / Metals ==

Because one bar of metal produces 25 bolts and a single bolt can be melted to 0.1 bars of metal, you can create unlimited adamantine wafers in your fortress using a [[Stupid_dwarf_trick#Bolt_Splitting_Operation|clever setup]] with marksdwarves to separate the stacks of adamantine bolts into single bolts. See this [http://www.bay12forums.com/smf/index.php?topic=51423.0 forum thread] for more details.

Coins may also be split at a [[trade depot]] and melted down individually for up to a 50x return. Smelt a stack of coins, then trade it to a caravan. You can then buy the stack back in pieces, and each individual smaller stack will melt and produce .1 bars. One bar produces 500 coins, but splitting it into stacks of 1 coin each would create 500 melt jobs, producing 50 bars in return. The process is discussed in greater detail, both with and without use of macros on this [http://www.bay12forums.com/smf/index.php?topic=111680.0 forum thread]. While potentially time consuming, this new method both results in far more bars produced per stack (potentially a net profit of 49 bars instead of 1.5), and can duplicate any metal, not just military ones while simultaneously training your broker. Combined with a magma smelter and properly written macros, this method turns a smelter into a free metal generator. Those who are less patient may instead opt to simply melt the coin stacks immediately after they are minted - while this yields only a 10% gain, it is far less time consuming.

For multiplying weapons/armor-grade metals, forging and melting giant axe blades, large serrated discs, and leggings will yield a 50% gain per item; note that this does ''not'' work with adamantine, since adamantine goods require 3 times as many wafers, instead leading to a 70% loss per item.

See the [[Melt item]] article for the best yields when melting down items made of mundane metals for the current version.

== Quick trade goods ==

Since [[trap component#spiked ball|spiked balls]] have an extremely high base [[item value]] of ''126'', they can be produced en masse from cheap [[wood]] or other materials and sold off to unsuspecting merchants. This makes for quick cash in any fortress that has a skilled carpenter and an excess of wood on hand.

In fact, any [[trap component]]s make extremely high-value trade goods, especially since metal components require only 1 [[bar]]. (They also increase the [[value]] of [[noble]]'s rooms, and are useful in defense.)

[[Prepared meal]]s can also be quick and valuable trade goods. Purchase an abundance of raw food when the traders arrive, and set your [[kitchen]] to work cooking that food into lavish meals. Then haul the stacks of meals back to the depot and trade them for whatever supplies you really want. The caravan will buy back meals composed of their own ingredients at 25x to 100x their initial value.

== Silk farm ==

{{main|Silk farming}}
A silk farm can serve as a safe and endless source of silk thread from [[giant cave spider]]s or other [[forgotten beast|web-spewing beasts]]. Its essence is a room with a bait creature separated from a web-spewing creature by fortifications. The webber will attempt to attack the bait by shooting [[web]]s through the fortifications. Weavers can collect the webs as silk thread and create silk cloth.

== Dwarven Radar ==

Dwarven radar is a handy way of checking for caverns and other special features using the [[farm plot]]s, paved [[road]]s, and [[activity zone]]s. Know where the carverns are before you designate your carefully planned, fully symmetric living quarters!

For more details, see the [http://www.bay12forums.com/smf/index.php?topic=93694.0 forum thread].

== Dwarven vacuum cleaner/quantum teleporter ==

Due to a {{bug|5994|bug|link=yes}} in the current version, removing a [[construction]] teleports all free items in the surrounding map tile to the location of the removing dwarf. The teleported items can even travel through solid rock, providing a very safe, quick, and convenient means to empty traps and battlefields of corpses and spoils. Of particular note, drowning pools can be emptied without draining and refilling their water. After "vacuuming" everything into a safe area, your dwarves can sort through the loot at their leisure.

== Shaft of Enlightenment ==

Creatures with at least Dabbling in a weapon skill that fall onto an [[DF2012:Spike#Upright_Spear.2FSpike|upright spear / spike]] with an appropriate weapon equipped can experience godly increases in certain combat skills, up to [[legendary]] +70.{{bug|6397}} A drop of 2-3 [[z-level]]s, low-quality wooden [[training spear]]s, and wooden floors are recommended to maximize survivability. See this [http://www.bay12forums.com/smf/index.php?topic=134512.0 forum thread] for details.

v0.34:Corpse

2014-02-14T04:41:32Z

Doktoro Reichard: Corpses of dead tame animals can't be butchered, as per the Butcher's Shop infobox

{{quality|Fine|22:17, 10 November 2010 (UTC)}}{{av}}

A '''corpse''' is what is left of a creature once dead. The corpses of vermin are called '''remains'''.

A corpse has several levels of decay, it will begin as "(creature or name) corpse", progress to "rotten (creature or name) corpse", "(creature or name) partially decayed corpse", and then to "(creature or name) skeleton", and will remain a skeleton indefinitely. Alternatively, if the creature had had parts ripped or cut off before death, the corpse will be described as "mutilated corpse" and "partial skeleton" in respective descriptions, and the parts (if still on the map) will decay into a type of bone depending on the part.

Body parts decaying naturally is the only way to get useable bones from creatures dwarves refuse to butcher (such as [[goblin|goblins]] and [[elves]], any [[DF2012:Learns|sentient]] creature), according to their ethics (unless you modded the ethics). Cutting a live goblin up using serrated blade traps or throwing them down extreme heights (such they explode) will generate useable goblin bones and skulls. Already-dead corpses can be reanimated with the help of a necromancer, or naturally if you are in any type of evil embark, and trapped. Remains of vermin, however, simply progress from "(vermin) remains" to "rotten (vermin) remains" before simply vanishing.

[[Butcher]]ing a corpse produces quantities of [[meat]], [[prepared organs]], [[bone|bones]], a [[skull]], [[skin]], and nails/hoofs, as well as cartilage, nervous tissue, and other types of useless byproducts. Body parts can be butchered, presumably for whatever tissues/organs were in the part. "Butchering" a skeleton produces only a skull, bones, cartilage and other non-decaying tissues. The corpses of very small animals, such as of [[raven]]s, currently cannot be butchered. Also, corpses of tamed animals can't be butchered.

Corpses will produce [[miasma]] in subterranean areas, but not above ground.

If a corpse of a dwarf is left untended, it will lead to some unintended, [[Tantrum spiral|often Fun]], [[Ghost|results]].

Corpses can be [[Undead|raised from the dead]]. This will occur in some [[Surroundings#Evil|evil]] biomes if the creature is killed inside an evil biome (if killed outside of the evil biome on an embark with part non-evil biome and part evil biome, the corpse will not rise) or if it is raised by a [[necromancer]]. Corpses may also be risen from the dead by [[mummy|mummies]], though mummies will only be encountered in [[tomb]]s in adventure mode. Severed body parts will be able to rise if they have either a grasp tag (hands and possibly other body parts) or if they still have a head attached, so it may be advisable to kill risen corpses with blunt weaponry to avoid swarms of body parts. Corpses and severed body parts will not rise again if they have been [[butcher]]ed, their skin [[tanner|tanned]] and their hair [[spinner|spun into thread]], or if they have been exposed to [[magma]]. However, due to what is presumably a bug, magma and [[fire]] damage currently will not destroy an animated corpse.

v0.34:Bismuth

2014-02-12T12:02:27Z

Doktoro Reichard: Bismuth bars can be studded, only if a manager orders it...

{{quality|Exceptional|15:57, 30 September 2010 (UTC)}}{{Metal|name=Bismuth|color=5:5:1
|uses=
* Make [[bismuth bronze]] at [[smelter]]
|ore=
* [[Bismuthinite]]
|properties=
* [[Material value]] 2
}}{{av}}

'''Bismuth''' is a metal smelted from [[bismuthinite]]. Bismuth bars can normally only be used to make the [[alloy]] bismuth bronze (although [[Strange mood|moody]] dwarves can apparently construct most anything out of bismuth).

*1x Bismuth bar + 1x [[Tin]] bar + 2x [[Copper]] bar = 4x [[Bismuth bronze]] bar

You can stud other objects with Bismuth, although the option isn't available at the forge and instead needs to be ordered by the Manager.

<gallery>
File:Wismut Kristall und 1cm3 Wuerfel.jpg|Bismuth crystals and cube
File:Bismuth_2.jpg|Bismuth
</gallery>

{{gamedata}}
{{metals}}

v0.34:Experience

2014-02-12T07:58:06Z

Doktoro Reichard:

{{Quality|Superior|20:23, 28 April 2013 (UTC)}}
{{av}}

'''Experience''' represents how much a certain dwarf (or other intelligent creature) has learned about a certain subject or profession. It affects proficiency in skills. Precise points in experience are never displayed directly, except in Adventurer mode.

Every experience point earned is associated with a [[skill]]. Every time a dwarf uses this skill, experience is gained. When a skill is unused for a while, the skill will become [[rusty]] and experience will decrease, eventually permanently.

Most skills give 30 XP per use, [[smoothing]], carving [[fortifications]], [[engraving]] and [[mining]] give 10 XP per use, and military skills are variable, with more XP gained from real combat than from training. Skills that can use stacks of items, such as [[plant processing]], will add experience based on the size of the stack. 

A more skilled dwarf will do work better and faster than an unskilled one. The better work results in higher quality items. The speed of work is most notable in legendary miners, who will barely touch the walls to make them crumble.

{| style="margin: 0 auto; border: 1px solid black; border-spacing: 0"
|-
| width="33%" style="border-right: 1px solid black;" |
{| width="100%"
! Lvl !! Title !! XP
|-
| 0 || Dabbling ||align="right"| 1
|-
| 1 || Novice ||align="right"| 500
|-
| 2 || Adequate ||align="right"| 1100
|-
| 3 || Competent ||align="right"| 1800
|-
| 4 || Skilled ||align="right"| 2600
|-
| 5 || Proficient * ||align="right"| 3500
|-
| 6 || Talented ||align="right"| 4500
|}
| width="33%" style="border-right: 1px solid black;" |
{| width="100%"
! Lvl !! Title !! XP
|-
| 7 || Adept ||align="right"| 5600
|-
| 8 || Expert ||align="right"| 6800
|-
| 9 || Professional ||align="right"| 8100
|-
| 10 || Accomplished ||align="right"| 9500
|-
| 11 || Great † ||align="right"| 11000
|-
| 12 || Master ||align="right"| 12600
|-
| 13 || High Master ||align="right"| 14300
|}
| width="33%" |
{| width="100%"
! Lvl !! Title !! XP
|-
| 14 || Grand Master ||align="right"| 16100
|-
| 15 || Legendary ||align="right"| 18000
|-
| 16 || Legendary+1 ‡ ||align="right"| 20000
|-
| 17 || Legendary+2 ‡ ||align="right"| 22100
|-
| 18 || Legendary+3 ‡ ||align="right"| 24300
|-
| 19 || Legendary+4 ‡ ||align="right"| 26600
|-
| 20 || Legendary+5 ‡ ||align="right"| 29000
|}
|}
::::''Notes:''
:::::<nowiki> *</nowiki> This is the highest skill level possible for one of your starting dwarves.
:::::† Once soldiers reach this level in a weapon skill, they will become a [[Soldier#Heroes|hero]] and no longer complain about long patrol duty.
:::::‡ These levels are not shown in game, but they do have an effect. An ordinary legendary dwarf produces a significant proportion of superior quality goods while a legendary+5 dwarf is guaranteed at least exceptional quality, barring effects like tiredness and hunger. It seems to be possible to have a skill over Legendary+5, at least in adventure mode. This is clearly seen by looking at the experience required for the next level and comparing how much you level up. The easiest way to see this is to remove your weapon, choose not to dodge or move around, and simply wait while something harmless tries to kill you. Tested in version 31.10, probably unchanged since then.{{verify}}

v0.34:Corpse

2014-02-11T00:49:10Z

Doktoro Reichard: touch up of some content related to sentient creature butchering.

{{quality|Fine|22:17, 10 November 2010 (UTC)}}{{av}}

A '''corpse''' is what is left of a creature once dead. The corpses of vermin are called '''remains'''.

A corpse has several levels of decay, it will begin as "(creature or name) corpse", progress to "rotten (creature or name) corpse", "(creature or name) partially decayed corpse", and then to "(creature or name) skeleton", and will remain a skeleton indefinitely. Alternatively, if the creature had had parts ripped or cut off before death, the corpse will be described as "mutilated corpse" and "partial skeleton" in respective descriptions, and the parts (if still on the map) will decay into a type of bone depending on the part.

Body parts decaying naturally is the only way to get useable bones from creatures dwarves refuse to butcher (such as [[goblin|goblins]] and [[elves]], any [[DF2012:Learns|sentient]] creature), according to their ethics (unless you modded the ethics). Cutting a live goblin up using serrated blade traps or throwing them down extreme heights (such they explode) will generate useable goblin bones and skulls. Already-dead corpses can be reanimated with the help of a necromancer, or naturally if you are in any type of evil embark, and trapped. Remains of vermin, however, simply progress from "(vermin) remains" to "rotten (vermin) remains" before simply vanishing.

[[Butcher]]ing a corpse produces quantities of [[meat]], [[prepared organs]], [[bone|bones]], a [[skull]], [[skin]], and nails/hoofs, as well as cartilage, nervous tissue, and other types of useless byproducts. Body parts can be butchered, presumably for whatever tissues/organs were in the part. "Butchering" a skeleton produces only a skull, bones, cartilage and other non-decaying tissues. The corpses of very small animals, such as of [[raven]]s, currently cannot be butchered.

Corpses will produce [[miasma]] in subterranean areas, but not above ground.

If a corpse of a dwarf is left untended, it will lead to some unintended, [[Tantrum spiral|often Fun]], [[Ghost|results]].

Corpses can be [[Undead|raised from the dead]]. This will occur in some [[Surroundings#Evil|evil]] biomes if the creature is killed inside an evil biome (if killed outside of the evil biome on an embark with part non-evil biome and part evil biome, the corpse will not rise) or if it is raised by a [[necromancer]]. Corpses may also be risen from the dead by [[mummy|mummies]], though mummies will only be encountered in [[tomb]]s in adventure mode. Severed body parts will be able to rise if they have either a grasp tag (hands and possibly other body parts) or if they still have a head attached, so it may be advisable to kill risen corpses with blunt weaponry to avoid swarms of body parts. Corpses and severed body parts will not rise again if they have been [[butcher]]ed, their skin [[tanner|tanned]] and their hair [[spinner|spun into thread]], or if they have been exposed to [[magma]]. However, due to what is presumably a bug, magma and [[fire]] damage currently will not destroy an animated corpse.

v0.34:Corpse

2014-02-11T00:37:07Z

Doktoro Reichard: Rule T

{{quality|Fine|22:17, 10 November 2010 (UTC)}}{{av}}

A '''corpse''' is what is left of a creature once dead. The corpses of vermin are called '''remains'''.

A corpse has several levels of decay, it will begin as "(creature or name) corpse", progress to "rotten (creature or name) corpse", "(creature or name) partially decayed corpse", and then to "(creature or name) skeleton", and will remain a skeleton indefinitely. Alternatively, if the creature had had parts ripped or cut off before death, the corpse will be described as "mutilated corpse" and "partial skeleton" in respective descriptions, and the parts (if still on the map) will decay into a type of bone depending on the part. Note: this is the only way to get useable bones from creatures dwarves refuse to butcher according to their ethics (unless you modded the ethics). Cutting a goblin up using serrated blade traps or throwing them down extreme heights (such they explode) will generate useable goblin bones and skulls. Already-dead corpses can be reanimated with the help of a necromancer, or naturally if you are in any type of evil embark, and trapped. Remains of vermin, however, simply progress from "(vermin) remains" to "rotten (vermin) remains" before simply vanishing.

[[Butcher]]ing a corpse produces quantities of [[meat]], [[prepared organs]], [[bone|bones]], a [[skull]], [[skin]], and nails/hoofs, as well as cartilage, nervous tissue, and other types of useless byproducts. Body parts can be butchered, presumably for whatever tissues/organs were in the part. "Butchering" a skeleton produces only a skull, bones, cartilage and other non-decaying tissues. The corpses of very small animals, such as of [[raven]]s, currently cannot be butchered.

Corpses will produce [[miasma]] in subterranean areas, but not above ground.

If a corpse of a dwarf is left untended, it will lead to some unintended, [[Tantrum spiral|often Fun]], [[Ghost|results]].

Corpses can be [[Undead|raised from the dead]]. This will occur in some [[Surroundings#Evil|evil]] biomes if the creature is killed inside an evil biome (if killed outside of the evil biome on an embark with part non-evil biome and part evil biome, the corpse will not rise) or if it is raised by a [[necromancer]]. Corpses may also be risen from the dead by [[mummy|mummies]], though mummies will only be encountered in [[tomb]]s in adventure mode. Severed body parts will be able to rise if they have either a grasp tag (hands and possibly other body parts) or if they still have a head attached, so it may be advisable to kill risen corpses with blunt weaponry to avoid swarms of body parts. Corpses and severed body parts will not rise again if they have been [[butcher]]ed, their skin [[tanner|tanned]] and their hair [[spinner|spun into thread]], or if they have been exposed to [[magma]]. However, due to what is presumably a bug, magma and [[fire]] damage currently will not destroy an animated corpse.

User:Doktoro Reichard

2014-02-09T04:08:16Z

Doktoro Reichard: /* Personal links */

__TOC__

== Description ==

I'm just a guy that happened to pass by here, complaining about the [[Glass industry]] page not being quite right. Now, I'm here fixing tidbits, adding some research and overall trying to be a DF player.

My bio (if you could call it that) can be found at the [http://gaming.stackexchange.com/users/54659/doktoro-reichard Arqade SE], which you could say was the main reason for me being here. I also used to play a lot of World of Warcraft, but those days are bygone.

I also use the same name at the bay12games forums so... well, that's pretty much it.

== Files ==

Here are some files that I've made mention or that are base blocks to other files. Feel free to use them in any dwarfy way.

[https://dl.dropboxusercontent.com/u/27314922/Dwarf%20Fortress/GlassIndustryWorkflow_DF2012_v2.dia Glass Workflow Chart]. A [http://en.wikipedia.org/wiki/Dia_%28software%29 Dia] file. Not the most user-friendly software, but gets the job done.

[https://dl.dropboxusercontent.com/u/27314922/Dwarf%20Fortress/Gems.xls Gems spreadsheet]. Just an import of the data got by Shandra.

[https://dl.dropboxusercontent.com/u/27314922/Dwarf%20Fortress/Gems2.xls Gems spreadsheet (treated)]. This has very very ugly graphs regarding distribution of gems on an embark. Based on the above.

== Personal links ==

Maybe I'll move this to a proper page, but as the size is small for now I'll keep this as is

I encounter several good topics on DF that, although being too difficult to place on the wiki, do think deserve some thorough reading.

[http://www.bay12forums.com/smf/index.php?topic=104643 !!SCIENCE!! Thread: Operation FPS Bomb] - A pretty darn good experiment regarding FPS. At most, it helped me understand why my fortress came from a good 20 to a meager 8.
:Been making experiments and I'm not sure whether it's the need for dwarves to store any crap they own or animals jumping up and down or even my thousands of goblets slowing down the game, but placing my dwarves on a vow of poverty did work, and placed 160 dwarves to 40 FPS.

[http://www.bay12forums.com/smf/index.php?topic=91789 My fort has MAGMA LANDMINES] - Just a reminder to add this to the wiki, as landmines are mentioned, but none as dwarfy.

== The Legend of Uristurist, "Daggerdaggers" ==

There exists a legend among all dwarvish civilizations, about a group of seven that set up camp at a very particular and unremarkable place, near a human settlement. That place was none other than Uristurist.

Now, Uristurist is just a plot of wood-ridden land, nothing fancy. Except for the fact that even Armok himself turns a blind eye: the laws of physics, civilization, time and space all crumble before the mightiest of powers those seven dwarves went to discover and manipulate, far from prying eyes. That power is none other that !!SCIENCE!!

Imbued with the knowledge to alter the very fabric of the universe through communion with Lua, they changed their surroundings in order to better understand their own kind: they produced mountains of Obsidian mugs, spawned obsidian out of thin air, at a speed never imagined built stairways and death wells for which to throw horses. And, when bored or troubled, regressed time itself.

For fun, they involved themselves in quantum physics, replacing their body parts with others cloned from their partners. They dipped themselves in magma and burnt themselves to oblivion. They gained and lost skill in instant. They even had the power to summon sieges from their own kin, and trap them in cages as puny goblins.

There is no limit to what happens at Uristurist, or so the legends tell, as no migrant or errant dwarf has yet reached the mythical fortress.

== "Improved" Undump ==

After finding out the hard way that pathfinding is '''the most''' CPU-intensive operation DF does, I started looking at current attempts of creating quantum stockpiles, without actually using dump zones, which are regarded as cheating by some. The designs by [[User:Vasiln/Undump|Vaslin]] seem to be interesting, but wasteful.

To start with, here is my current idea:
{{diagram|spaces=yes|1=\

╔═════════
║++[#F00]^[#0F0]=[#0F0]=¢[#0F0]=[#0F0]=[#0F0]=
║++═════[#0F0]=[#0F0]=
║++[#F00]^[#0F0]=[#0F0]=¢[#0F0]=[#0F0]=[#0F0]=
║++═════[#0F0]=[#0F0]=
║++[#F00]^[#0F0]=[#0F0]=¢[#0F0]=[#0F0]=[#0F0]=
║++═════[#0F0]=[#0F0]=

}}

The space at the right of the pressure traps (at red) is all stockpile designated (represented in green). The point here is, as stated in other works, to as soon as a dwarf passes through the trap, the hatches are activated, precipitating the dwarf to drop the item he's holding onto the stockpile.

The advantage of this design is that the space at the right can be adjusted to the number of haulers one wants, remembering that each empty stockpile square is assigned to a hauler.
The design can also be expanded downwards. There seems to be a slight fault where dwarves drop items before the stockpile; that may be from the fact that repeated queuing actually closes all hatches, preventing the dwarf from finding a path, therefore dropping the item.

The disadvantages are those of the original system: slow, prone to fault and increasing the number of "machines" can lower the FPS due to pathfinding issues.

== DFHack scripts ==
=== Healing by proxy ===

Trying to save Urist McMiner from a magma-induced full body melting, I poked around with the ''gui/gm-editor'' tool of the latest DFHack (0.34.11 r3) in order to see if I could try and ''delete'' the melt.

Unfortunately, the current stable release of ''gui/gm-editor'' isn't informative, and to top it off melts are somewhat complex (e.g. there isn't a '''single''' "is_urist_molten" value).

So, the 2nd best way to treat a molten dwarf was to do a little bit of ''!!Quantum Cellular Mimicry™!! (patent pending)'', by this I mean to copy the body of a base dwarf to the affected dwarf.

The script works (although if it crashes your game don't blame me). It seemed to crash when assigning a '''male''' body to a '''female''' one.

{{Spoil_small|
<pre>
function assign(tgt,src)
if df.isvalid(tgt) == 'ref' then
df.assign(tgt, src)
elseif type(tgt) == 'table' then
for k,v in pairs(src) do
if type(v) == 'table' then
local cv = tgt[k]
if cv == nil then
cv = {}
tgt[k] = cv
end
assign(cv, v)
else
tgt[k] = v
end
end
else
error('Invalid assign target type: '..tostring(tgt))
end
return tgt
end

dfhack.lineedit("Select affected dwarf")

local unit=dfhack.gui.getSelectedUnit()
print(unit)

dfhack.lineedit("Select base dwarf")

local base_unit=dfhack.gui.getSelectedUnit()
print(base_unit)

if unit then
while #unit.body.wounds > 0 do
unit.body.wounds:erase(#unit.body.wounds-1)
end
unit.body.wound_next_id=1

unit.body.blood_count=unit.body.blood_max

unit.status2.limbs_stand_count=unit.status2.limbs_stand_max
unit.status2.limbs_grasp_count=unit.status2.limbs_grasp_max

unit.flags1.dead=false

unit.flags2.has_breaks=false
unit.flags2.gutted=false
unit.flags2.circulatory_spray=false
unit.flags2.vision_good=true
unit.flags2.vision_damaged=false
unit.flags2.vision_missing=false
unit.flags2.breathing_good=true
unit.flags2.breathing_problem=false

unit.flags2.calculated_nerves=false
unit.flags2.calculated_bodyparts=false

unit.counters.winded=0
unit.counters.stunned=0
unit.counters.unconscious=0
unit.counters.webbed=0
unit.counters.pain=0
unit.counters.nausea=0
unit.counters.dizziness=0

unit.counters2.paralysis=0
unit.counters2.fever=0
unit.counters2.exhaustion=0
unit.counters2.hunger_timer=0
unit.counters2.thirst_timer=0
unit.counters2.sleepiness_timer=0
unit.counters2.vomit_timeout=0

for k,v in pairs(unit.body.components) do
for kk,vv in pairs(v) do
if k == 'body_part_status' then v[kk].whole = 0 else v[kk] = 0 end
end
end

assign(unit.body, base_unit.body)

end
</pre>|healing_by_proxy.lua}}

I got most of the code from what was already posted at the [http://www.bay12forums.com/smf/index.php?topic=119761.15 forums]. Due to some problem with Lua, I was unable to use the 'utils' package so I've pasted the utils.assign function in the script.

The first part is the dwarves selection. You select the affected dwarf first in DF, then press Enter in DFHack. Repeat for the base dwarf.
The second part clears wounds (probably unnecessary) and resets flags.
The third part actually copies the bodies from dwarf 2 to dwarf 1, hence recovering him. This implies however that the base dwarf is healthy.

There also seems to yet exist some other place where molten body parts data is stored besides unit.body. After some verification, I think DF stores some values (not in the dwarf himself, but somewhere) that are later called back. After applying, running, applying, running,..., one of the scripts from the above link, I got my molten dwarf at perfect condition.

This could also be used to melt every single dwarf in the fortress.

=== Cloning ===

It follows the same reasoning as the "healing by proxy" script.

{{Spoil_small|
<pre>
function assign(tgt,src)
if df.isvalid(tgt) == 'ref' then
df.assign(tgt, src)
elseif type(tgt) == 'table' then
for k,v in pairs(src) do
if type(v) == 'table' then
local cv = tgt[k]
if cv == nil then
cv = {}
tgt[k] = cv
end
assign(cv, v)
else
tgt[k] = v
end
end
else
error('Invalid assign target type: '..tostring(tgt))
end
return tgt
end

dfhack.lineedit("Select affected dwarf")

local unit=dfhack.gui.getSelectedUnit()
print(unit)

dfhack.lineedit("Select base dwarf")

local base_unit=dfhack.gui.getSelectedUnit()
print(base_unit)

if unit then
assign(unit, base_unit)
end
</pre>|cloning.lua}}

User talk:Bjh21

2014-02-08T22:24:08Z

Doktoro Reichard: /* Infinite vs unlimited finite */

==Infinite vs unlimited finite==
Hi, I would like to say that an infinite number is exactly the same as an unlimited finite number. In fact, an unlimited number is not finite - it has no limit, so its values are infinite. What you changed does not really matter, but I just want to say it :P {{User:Latias1290/Sig/src|17:05|February 08, 2014}}

:(lurker...) Technically, the number isn't infinite, its just too damn big to even make a dent if you place several thousand. The number is, by necessity, capped by memory, as each mechanism occupies a separate space in memory. The game would freeze long before you reached that threshold, however.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 22:24, 8 February 2014 (UTC)

v0.31:World rejection

2014-02-08T00:12:36Z

Doktoro Reichard: /* Error Dialog Text */

{{av}}{{quality|Fine|07:23, 20 April 2011 (UTC)}}
This is the place for those troubled individuals who are attempting [[Advanced world generation]] but end up with nothing but rejections from the world generation process.

:For general information advanced world generation see [[Advanced world generation]].

=Solving World Rejection Problems=

Generally speaking, you can always solve world rejection problems by nullifying (setting to 0) all of the parameters that specify "minimum number of" whatever. The main problem with this is that many of the details of your world will be left purely to chance, perhaps not giving you the sort of conditions that you're looking for.

One general thing to try is nullify all of the parameters that cause rejection (most of which contain the word "minimum") and see what is generated. If you find that you get too few mountains, for example, you can then play with parameters such as elevation and see what happens. This will give you a chance to actually view the worlds that would otherwise be rejected so you can get a better idea of what impact various settings are having.

=The Rejection Log=

Change the Init file from [LOG_MAP_REJECTS:NO] to [LOG_MAP_REJECTS:YES] and in the main Dwarf Fortress folder you'll find a file called <tt>map_rejection_log.txt</tt>. Every time a world is rejected the reason will be logged to this file. Reading this file will give you a better idea of what is going on than the "having trouble placing" errors that you get on the screen only after a few hundred errors, not all of which may be the same as the specific "having trouble placing" dialogue that is shown.

="The World Generator is having trouble placing..."=

Specific rejection errors, and possible solutions, are described below.

===Mountain peaks===
rejection log example: Not enough peaks: 1<3
Check your maximum elevation parameters.
*Can the elevation 400 be placed enough times to provide space for your peaks?
**Check your preset elevations for the elevation 400.
**You must have at least as many of these highest elevation points as you are requiring peaks.

Alternatively, reduce the number of peaks required by the parameters.

===Mid-level elevations.===
*Your worldgen parameters must allow elevations between 100 and 299 for this.
**Check the parameters governing elevation frequencies.
**Or simply reduce the number of mid-level elevation squares required.

===Low elevations===
Your worldgen parameters must allow for enough elevations between 0 and 99 for this.

===High elevations===
Your worldgen parameters must allow for enough elevations between 300 and 400 for this.

===Ocean squares along the edges===
Your worldgen parameters must allow for enough elevations between 0 and 99 for this.
*If that doesn't work, simply reduce the number of edge oceans required.

===rainfall/drainage/savagery/volcanism in the manner specified by the parameters===
Check the parameters governing these features. Reduce the number of high, medium or low squares required.

===Volcanoes===
Check your maximum volcanism value.
*Volcanoes can only form in areas with 100 volcanism.
**As such, you must have at least as many areas with 100 volcanism as you do desired volcanoes.
If all else fails, reduce the number of volcanoes required by the parameters.

===Swamps and marshes===
Make sure your parameters and presets can support mid-elevation, mid-to-high rainfall, low drainage, non-freezing areas.
*If that doesn't work, reduce the number of swamp squares and regions required by the parameters.

===Deserts and badlands===
Make sure your parameters and presets can support mid-elevation, very low rainfall, non-freezing areas.
*If that doesn't work, reduce the number of desert squares and regions required by the parameters.

===Forests===
Make sure your parameters and presets can support mid-elevation, high rainfall, high drainage, non-freezing areas.
*If that doesn't work, reduce the number of forest squares and regions required by the parameters.

===Mountains===
Make sure your parameters and presets can support high elevation areas.
*If that doesn't work, reduce the number of mountain squares and regions required by the parameters.

===Oceans===
Make sure your parameters and presets can support low elevation areas.
*If that doesn't work, reduce the number of ocean squares and regions required by the parameters.

===Glaciers===
Make sure your parameters and presets can support mid-elevation, very high drainage, freezing areas.
*If that doesn't work, reduce the number of glacial squares and regions required by the parameters.

===Tundra regions===
Make sure your parameters and presets can support mid-elevation, low-to-mid drainage, freezing areas.
*If that doesn't work, reduce the number of tundra squares and regions required by the parameters.

===Grasslands===
Make sure your parameters and presets can support mid-elevation, low-to-mid rainfall, low-to-mid drainage, non-freezing areas.
*If that doesn't work, reduce the number of grassland squares and regions required by the parameters.

===Hills===
Make sure your parameters and presets can support mid-elevation, low-to-mid rainfall, high drainage, non-freezing areas.

===Rivers===
Make sure your parameters and presets allow as many mountain squares as you are requiring river start points.
*If that doesn't work, reduce the number of rivers required by the parameters.

===Too many subregions===
Make sure your parameters and presets aren't so variable that biomes change frequently.
*If that doesn't work, increase the number of subregions permitted by the parameters, up to the cap.

===Mountain caves===
Make sure your parameters and presets allow as many border mountain squares as you are requiring mountain caves.
*If that doesn't work, reduce the number of mountain caves required by the parameters.

===Low-lying caves===
Make sure your parameters and presets allow as many mid-elevation squares as you are requiring low-lying caves.
*If that doesn't work, reduce the number of non-mountain caves required by the parameters.

===Civilizations===
Make sure your parameters and presets offer enough low-to-mid savagery, evil/good appropriate, biome appropriate squares to establish sites.
*High savagery (66+) blocks civilization placement -- make sure your parameters and presets offer at least small pockets of low-to-mid savagery areas.
**If you have very few biome types and are placing good or evil regions, they'll often crowd out the civilizations as well.
*If that doesn't work, reduce the number of civilizations required by the parameters.

===The world generator couldn't find any civilization definitions===
This problem cannot be resolved by continuing, so you should either abort or skip all rejects for a legends-only game.

===The world generator is having trouble placing a controllable civilization===
Make sure your parameters and presets have adequate squares of this kind.
*Dwarves, for example, require non-evil, non-good, unsavage mountain squares that aren't surrounded by the ocean.
*If that doesn't work, remove the requirement of a controllable civilization from the parameters, which will restrict you to adventurers (assuming an appropriate civilization is placed)

= Error Dialog Text =

LACK OF PEAKS
MEDIUM ELEVATION REJECTION
LOW ELEVATION REJECTION
HIGH ELEVATION REJECTION
LACK OF EDGE OCEANS
RAINFALL REJECTION
DRAINAGE REJECTION
SAVAGERY REJECTION
VOLCANISM REJECTION
LACK OF VOLCANOS
SWAMP REJECTION
DESERT REJECTION
FOREST REJECTION
MOUNTAIN REJECTION
OCEAN REJECTION
GLACIER REJECTION
TUNDRA REJECTION
GRASSLAND REJECTION
HILLS REJECTION
LACK OF RIVERS
TOO MANY REGIONS
LACK OF MOUNTAIN CAVES
LACK OF LOW-LYING CAVES
UNABLE TO PLACE ENOUGH CIVILIZATIONS
NO CIVILIZATIONS AVAILABLE
UNABLE TO PLACE CONTROLLABLE CIVILIZATION

'''The world generator is having trouble placing enough mountain peaks.'''
You might want to check your maximum elevation value and other elevation parameters.
Can the elevation 400 be placed enough times to provide space for your peaks?
You might want to check your preset elevations for the elevation 400.
You must have at least as many of these highest elevation points as you are requiring peaks.
Alternatively, you can reduce the number of peaks required by the parameters.

'''The world generator is having trouble placing enough mid-level elevations.'''
Can your parameters achieve elevations between 100 and 299?
You might want to adjust the parameters governing elevation frequencies.
Alternatively, you can reduce the number of mid-level elevation squares required.

'''The world generator is having trouble placing enough low elevations.'''
Can your parameters achieve elevations between 0 and 99?

'''The world generator is having trouble placing enough high elevations.'''
Can your parameters achieve elevations between 300 and 400?

'''The world generator is having trouble placing enough ocean squares along the edges.'''
Can your parameters achieve elevations between 0 and 99 frequently?
You might want to adjust the parameters governing elevation.
Alternatively, you can reduce the number of edge oceans required.

'''The world generator is having trouble placing rainfall in the manner specified by the parameters.'''
You might want to adjust the parameters governing rainfall.
Alternatively, you can reduce the number of high, medium or low rainfall squares required.

'''The world generator is having trouble setting drainage in the manner specified by the parameters.'''
You might want to adjust the parameters governing drainage.
Alternatively, you can reduce the number of high, medium or low drainage squares required.

'''The world generator is having trouble placing savagery in the manner specified by the parameters.'''
You might want to adjust the parameters governing savagery.
Alternatively, you can reduce the number of high, medium or low savagery squares required.

'''The world generator is having trouble setting volcanism in the manner specified by the parameters.'''
You might want to adjust the parameters governing volcanism.
Alternatively, you can reduce the number of high, medium or low volcanism squares required.

'''The world generator is having trouble placing enough volcanos.'''
You might want to check your maximum volcanism value.
Can volcanism be placed at the value 100 enough times to provide space for each of your volcanos?
You might want to check your preset volcanism for the value 100.
You must have at least as many of these highest volcanism points as you are requiring volcanos.
Alternatively, you can reduce the number of volcanos required by the parameters.

'''The world generator is having trouble placing swamps and marshes.'''
Make sure your parameters and presets can support mid-elevation, mid-to-high rainfall, low drainage, non-freezing areas.
Alternatively, you can reduce the number of swamp squares and regions required by the parameters.

'''The world generator is having trouble placing deserts and badlands.'''
Make sure your parameters and presets can support mid-elevation, very low rainfall, non-freezing areas.
Alternatively, you can reduce the number of desert squares and regions required by the parameters.

'''The world generator is having trouble placing forests.'''
Make sure your parameters and presets can support mid-elevation, high rainfall, high drainage, non-freezing areas.
Alternatively, you can reduce the number of forest squares and regions required by the parameters.

'''The world generator is having trouble placing mountains.'''
Make sure your parameters and presets can support high elevation areas.
Alternatively, you can reduce the number of mountain squares and regions required by the parameters.

'''The world generator is having trouble placing oceans.'''
Make sure your parameters and presets can support low elevation areas.
Alternatively, you can reduce the number of ocean squares and regions required by the parameters.

'''The world generator is having trouble placing glaciers.'''
Make sure your parameters and presets can support mid-elevation, very high drainage, freezing areas.
Alternatively, you can reduce the number of glacial squares and regions required by the parameters.

'''The world generator is having trouble placing tundra regions.'''
Make sure your parameters and presets can support mid-elevation, low-to-mid drainage, freezing areas.
Alternatively, you can reduce the number of tundra squares and regions required by the parameters.

'''The world generator is having trouble placing grasslands.'''
Make sure your parameters and presets can support mid-elevation, low-to-mid rainfall, low-to-mid drainage, non-freezing areas.

'''The world generator is having trouble placing hills.'''
Make sure your parameters and presets can support mid-elevation, low-to-mid rainfall, high drainage, non-freezing areas.

'''The world generator is having trouble placing rivers.'''
Make sure your parameters and presets allow as many mountain squares as you are requiring river start points.
Alternatively, you can reduce the number of rivers required by the parameters.

'''The world generator is placing too many subregions.'''
Make sure your parameters and presets aren't so variable that biomes change frequently.
Alternatively, you can increase the number of subregions permitted by the parameters, up to the cap.

'''The world generator is having trouble placing mountain caves.'''
Make sure your parameters and presets allow as many border mountain squares as you are requiring mountain caves.
Alternatively, you can reduce the number of mountain caves required by the parameters.

'''The world generator is having trouble placing low-lying caves.'''
Make sure your parameters and presets allow as many mid-elevation squares as you are requiring low-lying caves.
Alternatively, you can reduce the number of non-mountain caves required by the parameters.

'''The world generator is having trouble placing enough civilizations.'''
Make sure your parameters and presets offer enough low-to-mid savagery, evil/good appropriate, biome appropriate squares to establish sites.
High savagery (66+) blocks civilization placement -- make sure your parameters and presets offer at least small pockets of low-to-mid savagery areas.
If you have very few biome types and are placing good or evil regions, they'll often crowd out the civilizations as well.
Alternatively, you can reduce the number of civilizations required by the parameters.

'''The world generator is couldn't find any civilization definitions.'''
This problem cannot be resolved by continuing, so you should either abort or skip all rejects for a legends-only game.

'''The world generator is having trouble placing a controllable civilization.'''
Dwarves, for example, require non-evil, non-good, unsavage (<66) mountain squares that aren't surrounded by the ocean. Make sure your parameters and presets have adequate squares of this kind.
Alternatively, you can remove the requirement of a controllable civilization from the parameters, which will restrict you to adventurers (assuming an appropriate civilization is placed).

= List of Log Error Messages =

<pre>
Not enough peaks
Not enough medium altitudes
Not enough medium altitudes after shift down
Not enough low altitudes after shift down
Not enough medium altitudes after shift up
Not enough high altitudes after shift up
Not enough partial edge oceans
Not enough complete edge oceans

Rainfall not evenly distributed
Flat/rough areas not evenly distributed:
Savagery not evenly distributed
Volcanism not evenly distributed

Initial swamp square count fails by
Initial desert square count fails by
Initial forest square count fails by
Initial mountain square count fails by
Initial ocean square count fails by
Initial glacier square count fails by
Initial tundra square count fails by
Initial grassland square count fails by
Initial hill square count fails by

Not enough volcanos

Swamp region count fails by
Desert region count fails by
Forest region count fails by
Mountain region count fails by
Ocean region count fails by
Glacier region count fails by
Tundra region count fails by
Grassland region count fails by
Hill region count fails by

Not enough river start points before erosion
Not enough river start points after erosion

Too many distinct subregions

Not enough medium altitude locations after erosion
Not enough low altitude locations after erosion:
Not enough high altitude locations after erosion

Not enough mountain cave locations
Not enough mountain cave locations after location check
Not enough low-lying cave locations
Not enough low-lying cave locations after location check

Not enough entity placement locations

No entity definitions available
No controllable entity definitions available
Did not place controllable entity
Placed farming entity without crops

Final swamp region count fails by
Final desert region count fails by
Final forest region count fails by
Final mountain region count fails by
Final ocean region count fails by
Final glacier region count fails by
Final tundra region count fails by
Final grassland region count fails by
Final hill region count fails by
</pre>

= Error Continuation Options =

: CONTINUE until you give me another warning.
: ABORT NOW and I'll look over my parameters.
: ALLOW THIS REJECTION TYPE and continue reporting others.
: ALLOW ALL REJECTS, even if I end up with a legends-only world!

{{World}}

v0.34:World rejection

2014-02-07T23:27:49Z

Doktoro Reichard: Adding civilization rejection picture

{{av}}
Dwarf Fortress uses a "belt and braces" method of world generation in that whilst the map properties are configurable by [[world token]]s there are also tokens which will cause the rejection and 'reroll' or re-randomisation of the world. By way of example, if you were to leave the world at its default setting, but set a rejection parameter which required there to be a large number of "minimum desert tiles", then a large number of worlds might be rejected until one (by random chance) was finally generated that met that requirement. Because of the high number of possible rejections, this is an inefficient way of generating a world with many deserts; instead, it's recommended to work with broader parameters, such as [[#Weighted Ranges|Weighted Ranges]], to generate the world you want. It is possible to set the parameters in such a way that will result in endless rejections because they specify a world which is incredibly unlikely or impossible to be generated.

If a certain number of rejections of the same type happen during world gen, then you will get a notification telling you what is causing the rejections. This can happen after a few hundred rejections or it may take thousands. This is possibly due to the fact that you may have more then one type of rejection occurring, and as such it takes thousands of rejections until any one type hits the threshold for the warning message.

[[File:Civilization rejection.PNG|framed|center|A message that appears when one of the rejection types hits its treshold]]

== Rejection parameters ==

The following are the primary rejection parameters, their sole purpose is to cause rejections, they do not affect the generation of the world in any way:

[REGION_COUNTS:SWAMP:0:0:0]
[REGION_COUNTS:DESERT:0:0:0]
[REGION_COUNTS:FOREST:0:0:0]
[REGION_COUNTS:MOUNTAINS:0:0:0]
[REGION_COUNTS:OCEAN:0:0:0]
[REGION_COUNTS:GLACIER:0:0:0]
[REGION_COUNTS:TUNDRA:0:0:0]
[REGION_COUNTS:GRASSLAND:0:0:0]
[REGION_COUNTS:HILLS:0:0:0]
'''Note: the above values are arbitrary although these setting effectively disable the region counts.'''

[SUBREGION_MAX:2750]

[ELEVATION_RANGES:0:0:0]
[RAIN_RANGES:0:0:0]
[DRAINAGE_RANGES:0:0:0]
[SAVAGERY_RANGES:0:0:0]
[VOLCANISM_RANGES:0:0:0]

'''Note: the above values are arbitrary although these setting effectively disable the range counts.'''

== Placement tokens ==

The following are tokens are not rejection parameters but instead force to placement certain of features. This can cause rejections if the world generated does not support the placement of the features in sufficient quantities or at all. For example a volcano requires the square to have a volcanism of 100, if the maximum volcanism for the world is less then 100 then no volcanoes can be placed. See [[advanced world generation]] for more details.

[VOLCANO_MIN:3]

[PEAK_NUMBER_MIN:12]

[PARTIAL_OCEAN_EDGE_MIN:1]
[COMPLETE_OCEAN_EDGE_MIN:0]

[RIVER_MINS:300:300]

[MOUNTAIN_CAVE_MIN:25]
[NON_MOUNTAIN_CAVE_MIN:50]

[TOTAL_CIV_NUMBER:40]
[PLAYABLE_CIVILIZATION_REQUIRED:1]

== Others ==

It is unknown if the following tokens can cause rejection:

[REGIONAL_INTERACTION_NUMBER:28]
[DISTURBANCE_INTERACTION_NUMBER:28]

[GOOD_SQ_COUNTS:0:0:0]
[EVIL_SQ_COUNTS:0:0:0]

{{World}}

File:Civilization rejection.PNG

2014-02-07T23:23:15Z

Doktoro Reichard: Continued world rejection by the generator trying to place a high number of civilizations together.

Continued world rejection by the generator trying to place a high number of civilizations together.

v0.34:Advanced world generation

2014-02-07T23:17:32Z

Doktoro Reichard: /* World rejection */ - Linking the v0.31 page as there's no page with that information for DF2012

{{quality|Exceptional|23:35, 30 March 2011 (UTC)}}{{av}}
{{old}}

:''This article contains information on advanced world generation. For information on basic world generation, see [[World generation]].''
:''See [[World token]] to more easily find information by the names used in the world_gen.txt file.''
:''See [[World rejection]] for information on solving problems related to worlds always being rejected.''
:''See [[Worldgen examples]] for example worlds.''

When you want more control of what your world looks like, it's time for '''advanced world generation'''. A detailed reference with advice is provided below. This article assumes that you are already familiar with [[World generation|'''basic''' world generation]]. If you are not then please read about that first.

Once you select {{DFtext|Design New World With Advanced Parameters}} from the main menu, a screen that looks something like this will appear:

[[File:AdvancedWorldGen.png‎]]

This screen is relatively intuitive but some parts could use some explanation.

== Parameter sets ==

The list of already defined parameter sets is in the upper right corner. You can select the current set that you want to work with using the up and down directional keys.

Hitting {{K|a}} will add a new set to the end of the list. You can also {{K|c}}opy an existing set to a new one allowing you to base a new set on an existing one. Using {{K|t}} you can change the name of the parameter set but note that this will not affect the name of the world that is generated.

Parameter sets are stored in the <tt>data/init/world_gen.txt</tt> file in the main DF directory. The {{K|F1}} and {{K|F6}} keys will load and save '''all''' of the parameter sets to this file. You will need to save the world gen parameters to this file before you hit {{K|Enter}} to generate the world.

The <tt>world_gen.txt</tt> file can also be edited with a text editor. This is particularly useful because people will often post their parameter sets on the forum or wiki in text form. (See below for more info.) The {{K|F1}} key comes in handy when editing this file while the game is still running.

The tokens used in <tt>world_gen.txt</tt> are at the bottom of each parameter description. Here's the one for title.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TITLE: <name>]</nowiki></tt>
| <tt><nowiki>[TITLE:MEDIUM ISLAND]</nowiki></tt>
| Required
|}

== World name ==

As previously mentioned, the title of the parameter set doesn't affect the name of the world. You can force a particular name for your world using {{K|n}} or set it back to the default random setting using {{K|N}}.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CUSTOM_NAME: <name>]</nowiki></tt>
| <tt><nowiki>[CUSTOM_NAME:Realm of Cheese Engravings]</nowiki></tt>
| For a random name, simply don't use this token.
|}

== World dimensions ==

The size of the map to be generated can be selected with {{K|u}} {{K|i}} {{K|o}} {{K|p}}. Larger maps take longer to generate and may limit [[Frames per second|FPS]] in game.

Changing the dimensions of the world will reset the parameters because many of them have different defaults depending on the surface area available.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[DIM:<width>:<height>]</nowiki></tt>
| <tt><nowiki>[DIM:129:129]</nowiki></tt>
| Valid values are 17,33,65,129, and 257. Others may not work.
|}

== Seed values ==

The world generation process uses a PRNG (Pseudo Random Number Generator) algorithm. A PRNG will produce a sequence of numbers that "looks" random even though the actual sequence of numbers will always be the same if the PRNG is started with the same seed value. Basically this means that if you run world generation with a certain seed value on your computer, and someone else runs world generation with the same seed value on their computer, the same sequence of random numbers will be generated on both computers. The practical impact of this is that someone else can generate exactly the same world that you generated by entering the same seed value that you used.

A specific seed value can be entered with {{K|s}}. This will change '''all''' of the seed values to the value you enter. If you need to enter different seed values for each type of seed, use {{K|e}}.

In order to find out what seed values were used for the last world you generated you can look at this screen. If you want to be able to tell someone else how to generate exactly the same world that you just generated, they will need all of the seed value listed under Last Param Set.

When generating a world using a seed, the way that the world is generated is also based at least in part on certain world tokens. As such you cannot for example change the minimum and maximum rainfall and get the same world but drier or wetter, instead a different world is generated. Saying that, it would also seem that certain small changes to these world tokens can occasionally generate a very similar world, however other tokens are more sensitive. For more information see the forum thread [http://www.bay12forums.com/smf/index.php?topic=112132.msg3404199#msg3404199 here].

The following are tokens which appear to be involved in the implementation of the seed and are not safe to change:

[DIM:X:X] 
[ELEVATION:X:X:X:X] 
[RAINFALL:X:X:X:X] 
[TEMPERATURE:X:X:X:X] 
[DRAINAGE:X:X:X:X] 
[VOLCANISM:X:X:X:X] 
[SAVAGERY:X:X:X:X] 
[ELEVATION_FREQUENCY:X:X:X:X:X:X] 
[RAIN_FREQUENCY:X:X:X:X:X:X] 
[DRAINAGE_FREQUENCY:X:X:X:X:X:X] 
[TEMPERATURE_FREQUENCY:X:X:X:X:X:X] 
[SAVAGERY_FREQUENCY:X:X:X:X:X:X] 
[VOLCANISM_FREQUENCY:X:X:X:X:X:X] 
[PARTIAL_OCEAN_EDGE_MIN:X] 
[COMPLETE_OCEAN_EDGE_MIN:X] 
[HAVE_BOTTOM_LAYER_1:X] 

Many other world parameters such as end year and embark points can however be changed without it having any effect on the geography of the world generated from the seed values.

Normally you don't enter these seed values and the world generation process comes up with seed values based on some sort of "true" random information from things like random values in uninitialized memory, the current date/time, etc. If you have entered a seed value you can revert back to all seeds being random using {{K|S}}.

== Generating a world ==

Unless you're using an already defined parameter set you will probably want to {{K|e}}dit the parameters. Select the set you want to edit using the up/down directional keys and press {{K|e}}. Information about each parameter is documented below.

Once you are happy with the parameters you have set, hit {{K|Esc}} to get back to this screen, hit {{K|F6}} to save the values you just edited, and hit {{K|Enter}} to start. The rest of the process is the same as basic [[World generation]].

The phases of the world generation process are (this order is not completely correct):
* Preparing elevation...
* Setting temperature...
* Running rivers...
* Forming lakes and minerals...
* Growing vegetation...
* Verifying terrain...
* Importing wildlife...
* Recounting legends...
* Placing civilizations...
* Making cave civilizations...
* Making cave pops...
* Placing other beasts...
* Placing megabeasts...
* Placing good/evil...
* Placing caves...
* Prehistory generation
* Finalizing civ mats...
* Finalizing art...
* Finalizing uniforms...
* Finalizing sites...

== World painter ==
:''Main article: [[World painter]]
The '''world painter''' tool allows you to paint features onto a map that is then used when generating a world. It is very difficult to use properly, and tends to result in endless rejected worlds, unless you loosen or remove the restrictions placed on biomes and civilizations in the advanced settings. That being said it is also a very powerful tool, and allows you to generate worlds more to your liking.

To access the world painter, hit {{k|e}} to start editing the advanced parameters and finally hit {{k|p}} to open world painter. How to use the world painter is not entirely obvious so please check out the [[World painter]] documentation to avoid frustration. (Losing may be fun, but frustration is not.)

== Editing the parameters init file ==

Parameter sets are stored in ''world_gen.txt'' in the ''\data\init'' folder, using [[world token]]. 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 [[Main:Pregenerated worlds|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.

== Advanced parameters ==

To access advanced parameters, press {{key|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.

The parameters are described below in the order that they appear in the list in the UI, not necessarily the other they appear in the configuration file. See [[world token]] for an index that will help you look things up by token name.

There are essentially 4 types of controls for the generation of the surface map;

Terrain Parameters, as described below, these 5 variables define the basic background world, how hot or cold it is, how much rainfall, how high the mountains are. The world automatically goes through the temperature range along the Y axis although sometimes it will be hotter in the north, other times in the south. Minima and maxima and X,Y variance can drastically alter the world.

Weighted Meshes, these are a way to fine tune the amount of the 5 basic variables on the map. It can be used to set the specific distribution of different elevations or rainfall areas for example.

Rejection Parameters, Dwarf Fortress has a belt and braces approach to world generation. The above controls allow you to shape the world then the rejection parameters throw it out if it isn't right! There are a number of rejection parameters for the number and degree of the 5 basic variables, for biome types etc. If the world does not meet the requirements of any one rejection parameter the world is rejected an re-randomised. Also see [http://dwarffortresswiki.org/index.php/DF2012:World_rejection World Rejection]

The are also the feature placing options such as rivers, mountain peaks, volcanoes and oceans. These can cause rejections if the terrain parameters don't allow enough suitable locations for the features to be placed.

If you are experimenting with world design, one method would be to disable the rejection parameters and use the first two control types. Otherwise any significant change will likely result in endless rejections.

=== Seed values ===

Here you can enter specific seed values for different parts of the world generation process. Different sequences of pseudorandom numbers are used for different parts, so you can use this to reproduce only the particular part of world generation from some previously generated world if you want.

Normally you will want to leave all of these set to Random unless you're specifically trying to reproduce the results of another world generation run.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SEED:<number>]</nowiki></tt>
| <tt><nowiki>[SEED:31337]</nowiki></tt>
| rowspan="4" |
For each of these not in the config file, a random seed will be used.
|-
| <tt><nowiki>[HISTORY_SEED:<number>]</nowiki></tt>
| <tt><nowiki>[HISTORY_SEED:31337]</nowiki></tt>
|-
| <tt><nowiki>[NAME_SEED:<number>]</nowiki></tt>
| <tt><nowiki>[NAME_SEED:31337]</nowiki></tt>
|-
| <tt><nowiki>[CREATURE_SEED:<number>]</nowiki></tt>
| <tt><nowiki>[CREATURE_SEED:31337]</nowiki></tt>
|}

=== Embark Points ===

This controls the number of points that you have for skills and equipment when you embark in fortress mode. Turning this value up will allow games started in this world to start with more skilled dwarves with better equipment. Normally you can do just fine by leaving this value set to default, but you might want to up it for experimental/testing purposes or to help dwarves survive in a particularly evil world.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[EMBARK_POINTS:<number>]</nowiki></tt>
| <tt><nowiki>[EMBARK_POINTS:1274]</nowiki></tt>
| Required
|}

=== End year ===

This is how many years of history are generated for the world. This is basically the same as the History parameter in basic world gen, except that you can enter an exact value for number of years. See [[World_generation#History|History]] for more info.

History is divided into "ages" which are determined by the ''percentage'' of megabeasts and semi-megabeasts killed at various points. One can attempt to make a world go through the ages more quickly by pumping up the ratio of semimegabeast to megabeast caves, the former of which are usually more killable than the regular megabeasts. This will net you more "Age of Legends", "Age of Heroes", etc.

For more information on the history aspect of the game, see [[Legends]] and [[Calendar#Ages|Ages]].

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[END_YEAR:<number>]</nowiki></tt>
| <tt><nowiki>[END_YEAR:1050]</nowiki></tt>
| Required
|}

=== Population cap after civ creation ===

This determines the maximum possible population of civilization member beings on the map. It should usually be kept the same value as the appropriate sized standard map. Turning the value up will result in larger civilizations. You can enter -1 to make population unlimited in which case populations will only be limited by factors like biome, space, number of sites, and per-civilization population caps.

Each race may have up to 100 civilizations each, and each civilization a maximum population of 10,000. This means that '''if you set this parameter to -1 ("No cap"), you can quickly be overrun''' by sites and population. Civilizations, known as ''entities'' in the [[Raw file|raw files]], have 3 or 4 basic variables that will greatly affect their final placement on the world map, in respect to this kind of unchecked growth. See [[Entity_token#Population|Population (Entity Token)]] for more information on interpreting/editing the raws if you need more precise control of civilization placement.

Huge populations can cause the size of history data to explode, cause history generation to take forever, lower FPS, and generally slow down the game.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TOTAL_CIV_POPULATION:<number>]</nowiki></tt>
| <tt><nowiki>[TOTAL_CIV_POPULATION:15000]</nowiki></tt>
| Required
|}

=== Site cap after civ creation ===

This controls the maximum number of towns and similar sites on the entire map. Raising the number will allow for more towns, etc though the number of sites will ultimately still be limited by things like space, terrain, and population cap.

Note that '''this parameter controls only "civilization" sites''' like towns. Other sites such as lairs will be added on to this maximum. After civilizations reach this cap, they will not spread out anymore to place new cities.

By default, the raws limit each civilization site to a population of 120 regardless of the race of the civilization. Therefore, without editing the raws, the total population on the map can't go above site cap x 120.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SITE_CAP:<number>]</nowiki></tt>
| <tt><nowiki>[SITE_CAP:1040]</nowiki></tt>
| Required
|}

=== Beast control ===

These parameters don't usually matter too much, but may matter for small numbers of beasts.

==== Percentage of Megabeasts and Titans Dead for Stoppage ====

The world starts out with a certain number of powerful megabeast and titan entities in existence. If a percentage of the megabeast and titan population dies out during history generation, then history generation will stop early. For example, if the elimination value is 80%, and the generated history starts with 200 entities and 160 of those 200 entities are eliminated by historical events before the End Year is reached, history generation will stop early.

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

The percentage of dead megabeasts and titans for stoppage will not be checked until this year is reached in history generation. This can be used to ensure that a world reaches a certain year even if all of the megabeasts in the world are slain earlier.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[BEAST_END_YEAR:<year>:<percentage or -1>]</nowiki></tt>
| <tt><nowiki>[BEAST_END_YEAR:200:80]</nowiki></tt>
| Use -1 as percentage to disable. Year must still be at least 2.
|}

=== Cull Unimportant Historical Figures ===

Whether or not the game ignores unimportant figures in history generation. The culling is many CPU-intensive steps in history generation but it saves memory and will speed up loading/saving games a bit. This does mean that the "unimportant" figures will not appear in Legends mode or in things like dwarf engravings, but they might not appear in engravings anyway.

Unimportant figures are people or creatures who suffer early deaths, never having offspring or killing anything named during history generation. For example, residents of goblin towers may get murdered by demons at a young age. After culling unimportant figures, Legends mode would say something like the demon has killed "a creature at Eviltower in the year 102."

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CULL_HISTORICAL_FIGURES:<0 or 1>]</nowiki></tt>
| <tt><nowiki>[CULL_HISTORICAL_FIGURES:0]</nowiki></tt>
| 0 = No, 1 = Yes
|}

=== Reveal All Historical Events ===

Setting this to Yes will allow access to all information about the history of the world in Legends mode. If set to No, then you will have to discover historical information in adventure mode or by instructing dwarves to make engravings.{{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[REVEAL_ALL_HISTORY:<0 or 1>]</nowiki></tt>
| <tt><nowiki>[REVEAL_ALL_HISTORY::1]</nowiki></tt>
| 0 = No, 1 = Yes
|}

=== Terrain Parameters ===

These determine how random values for terrain elevation, rainfall, temperature, drainage, volcanism, and savagery are generated. What biomes exist are then determined by how these factors overlap with each other.

==== Minima and Maxima ====

These are the absolute minimum and maximum values that can ever be generated for a particular map square characteristic. Changing these can cause the occurrence of certain [[Biome|biomes]] to become impossible, so modify these with care. Because of this problem, you may want to use [[#Weighted Ranges|Weighted Ranges]] instead.

By ''subtly'' tweaking the min and max values, vastly different maps can be made.

==== X and Y Variance ====

These control how wildly things like elevation and rainfall can vary between adjacent map squares. For example, if these values are set to the maximum of 3,200 for elevation then you will end up with more very low areas right next to very high areas. The number for X determines the east-west variance and the number for Y determines the north-south variance. By setting only one of these to a high value you can, for example, create horizontal or vertical bands of areas which are more similar to each other.

Generally speaking, raising both of these values will create a more random "patchwork" of many small biomes while setting both x and y values to 0 will cause every square on the map to use a single random value for the given characteristic.

For "patchwork" worlds to avoid being rejected, [[#Maximum_Number_of_Subregions|Maximum Number of Subregions]] will probably need to be increased from the default.

==== Elevation ====

This controls the range of terrain elevations that can occur in the world.

Usually you just want to leave the min/max values alone. Raising the minimum elevation can, for example, make it impossible for oceans to exist. This does '''not''' directly control the number of available Z-levels at a particular site, though high maximum values may contribute to peaks which can raise the number of above ground Z-levels. In other words, a maximum elevation of 400 and minimum of 1 does not mean you get 400 Z-levels but it might increase the number of Z-levels somewhat in some regions compared to others.

Raising the variance will result in a more bumpy uneven landscape.

Some biomes/features that are impacted by elevation:
* A high minimum (above 99) means no oceans as they need elevations below 100.
* A low maximum (below 300) means no mountains as mountains need elevations above 300.
* River start locations need a minimum elevation of 300. Therefore, a world with a maximum elevation of 299 everywhere prevents river generation, but rivers can still occur if maximum elevation is set to 300.
*Mountain peaks can only form in squares with an elevation of 400.

==== Rainfall ====

Controls the amount of rainfall in each map square/area. Setting the minimum too high or the maximum too low can make the formation of certain biomes impossible. Rainfall causes it to [[Rain]] more in a given area, which can have various effects.

Also makes more rivers appear on the world map.

Note that if [[#Do Orographic Precipitation and Rain Shadows|orographic precipitation and rain shadows]] is on then mountains will cause additional variance in rainfall, so (for example) rainfall below the specified minimum can occur in the shadow of a mountain. If you want the minimum and maximum for this parameter to be absolutely respected you must turn off the orographic precipitation option.

==== Temperature ====

These parameters control how hot or cold various areas will be. If you lower the minimum and maximum values, the world will be colder overall, for example. As with the others, changing these values too much could make it impossible for certain biomes to exist. See [[Climate]] for more info.

[[Temperature]] appears to always be a vertical gradient of some sort no matter how these parameters are set, but if the values are lower then the gradient could be from "cold" to "colder" rather than "cold" to "warm" for example. Dwarf Fortress automatically applies temperature variations for latitude and elevation.

So, the value from the temperature rolling process is ''not the absolute temperature value the region will get, but rather local variation.'' The "base" temperature for an area is derived from its latitude and elevation, and then the random value determined by these parameters are applied to it to make it vary a bit. The local variation is fairly small compared to the base temperature, which appears to be hard coded.

==== Drainage ====

Changing drainage parameters will change the way water-affected biomes are formed. Low drainage will contribute to the formation of [[Lake|lakes]], [[River|rivers]], and [[Swamp|swamps]]. High drainage will cause water to sink into the ground rather than sit on the surface, which is important for forming hills.

Lower drainage values have been reported to contribute to the formation of thicker soil layers though it is currently unknown exactly how other factors (such as elevation or perhaps rain) impact soil formation.

==== Volcanism ====

Volcanism controls the occurrence of Igneous [[Layer|Layers]], and the formation of volcanoes. For a volcano to form, a square must have a volcanism value of 100 so reducing the maximum from 100 will make volcanoes impossible. Raising the minimum will increase the rarity of non-igneous layers.

Setting minimum to high value is not a good way to produce multiple volcanoes as you are likely to get a "Volcanism not evenly distributed" rejection. Instead use the Minimum Number of Volcanoes parameter and possibly adjust the weighted ranges for volcanism as described below.

==== Savagery ====

These parameters control the level of [[Surroundings#Savage|savagery]] on the map. Raising the minimum savagery too high may make it impossible for certain races to exist, and similarly lowering the maximum too far can make it impossible for certain creatures to exist. The largest chance of having unusable maps comes from too high of a savagery value.

==== Configuration Tokens ====

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[ELEVATION:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[ELEVATION:1:400:401:401]</nowiki></tt>
| Range: 0 to 400 Maximum of 400 required for mountain peaks. Variance range: 0-3200
|-
| <tt><nowiki>[RAINFALL:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[RAINFALL:0:100:200:200]</nowiki></tt>
| Range: 0 to 100 Variance range: 0-3200
|-
| <tt><nowiki>[TEMPERATURE:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[TEMPERATURE:25:75:200:200]</nowiki></tt>
| Range: -1000 to 1000 Variance range: 0-3200
|-
| <tt><nowiki>[DRAINAGE:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[DRAINAGE:0:100:200:200]</nowiki></tt>
| Range: 0 to 100 Variance range: 0-3200
|-
| <tt><nowiki>[VOLCANISM:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[VOLCANISM:1:100:200:200]</nowiki></tt>
| Range: 0 to 100 Maximum of 100 required for volcanoes. Variance range: 0-3200
|-
| <tt><nowiki>[SAVAGERY:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[SAVAGERY:1:100:200:200]</nowiki></tt>
| Range: 0 to 100 Variance range: 0-3200
|}

=== Terrain Mesh Sizes and Weights ===

These parameters make it possible to influence the number of squares in a particular range without making conditions outside of that range impossible. For example, you can make it possible for more many more low elevation squares to exist without making it impossible for high elevations to form. Changing these parameters is often preferable to simply changing the min/max values.

[[File:World_map-large-32x32-elevation-mesh.png|thumb|300px|A large world generated with an Elevation Mesh Size of 32x32 and range weights set to 1:0:0:0:1 (i.e., only extreme high and low elevations). Notice that with this coarse mesh, the terrain seems to appear almost like a grid of "pyramids" that are smoothed together. With a finer mesh size, these pyramids will be smaller, more numerous, smoother, and less apparent.]]
==== Mesh Size ====

Mesh size determines how "finely grained" weighted ranges will be applied. Setting this to Ignore will cause the weighted range settings to be ignored for that terrain characteristic. The end result of this is that a small mesh, for example 2x2, will affect less of the map than a large mesh, like 16x16 for a medium map, which will affect almost all of the map. Also note that the X,Y variance can also have a profound effect on the implementation of the mesh, see this [http://www.bay12forums.com/smf/index.php?topic=112132.msg3410520#msg3410520 forum post] for more details.

Mesh Size affects the smoothing brush in the world painter.

==== Weighted Ranges ====

If mesh size is set to something other than Ignore, these weights will be applied at the granularity of the selected mesh size for purposes of generating random values in each range. This allows random number generation to be non-linear for the given terrain characteristic.

For example, if the Elevation Weighted Range parameters were set to (starting with the 0-20 range) 60:10:10:10:10 (these values do not have to add up to any particular number) then about 60% of the map squares (on average) will have an elevation in the range of 0-20, and the other ranges will be represented by around 10% of the map squares each. The exact distribution is still left up to chance though ''on average'' it will be close to this specification.

The way the process appears to work is that the map is divided into a "wireframe mesh" where the lines are Mesh Size number of tiles apart. Each intersection of the "wires" is randomly assigned an elevation (or whatever) and then the tiles between these points are smoothed out. See the image on the right for an example.

Weighted ranges do not make rejection checks, although they can be responsible for many rejections if you neglect to adjust or disable some of the [[#Minimum Number of Mid/Low/High Characteristic Squares|Minimum Number of Mid/Low/High Characteristic Squares]] for example.

==== Configuration Tokens ====

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[ELEVATION_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[ELEVATION_FREQUENCY:2:1:2:3:4:5]</nowiki></tt>
| rowspan="6" | Valid mesh values:

1 = Ignore

2 = 2x2

3 = 4x4

4 = 8x8

5 = 16x16

6 = 32x32

(limited by world size)
|-
| <tt><nowiki>[RAIN_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[RAIN_FREQUENCY:3:1:2:3:4:5]</nowiki></tt>
|-
| <tt><nowiki>[DRAINAGE_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[DRAINAGE_FREQUENCY:4:1:2:3:4:5]</nowiki></tt>
|-
| <tt><nowiki>[TEMPERATURE_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[TEMPERATURE_FREQUENCY:1:1:1:1:1:1]</nowiki></tt>
|-
| <tt><nowiki>[SAVAGERY_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[SAVAGERY_FREQUENCY:5:1:2:3:4:5]</nowiki></tt>
|-
| <tt><nowiki>[VOLCANISM_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[VOLCANISM_FREQUENCY:1:1:1:1:1:1]</nowiki></tt>
|}

=== Minimum Mountain Peak Number ===

This will cause the world to be rejected if fewer than this many peaks (based on elevation) are present on the map. Elevations of 400 must be possible for mountain peaks to occur. If set to zero then worlds will not be rejected based on number of peaks.

You may need to adjust elevation parameters, such as the highest weighted range, in order to get the desired number of elevation 400 squares needed for larger numbers of peaks. Like volcanoes, mountain peaks can make embark zones more interesting but other than that they don't appear to "do" anything special. Reportedly they do increase the highest Z-level above ground in all embark zones in the same region even if the selected embark zone does not include the peak.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[PEAK_NUMBER_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[PEAK_NUMBER_MIN:20]</nowiki></tt>
| Elevations of 400 must occur for peaks to form.
|}

=== Minimum Partial Edge Oceans ===

This will cause a world to be rejected unless there are at least this many oceans touching an edge of the map. If set to zero then worlds will not be rejected based on this criterion. Setting both this parameter and Minimum Complete Edge Oceans to values that total more than 4 when added together may cause all worlds to be rejected as you can't have both a partial and complete edge ocean on a given edge.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[PARTIAL_OCEAN_EDGE_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[PARTIAL_OCEAN_EDGE_MIN:2]</nowiki></tt>
| Maximum of 4
|}

=== Minimum Complete Edge Oceans ===

This will cause a world to be rejected unless there are at least this many oceans which completely cover an edge of the map. Since a square map only has 4 edges, the maximum value possible is 4. If set to zero then worlds will not be rejected based on this criterion but still might end up with complete edge oceans by chance.

Note that the ability for this many edge oceans to exist will be limited by elevation. Therefore to actually create large oceans you will probably need to change things like the Elevation Mesh Size and Weighted Ranges to increase the number and distribution of very low elevation squares on the map.

Given appropriate weight, range, and variance values for things like elevation, a setting of:
*1 results in a world that seems like a chunk of coastline. One edge of the map will be completely underwater and there will be ocean taking up much of the map on that side. Think the east or west coast of the United States, the north coast of Canada, or southern Europe. If your edge ocean happens to pick your world's frozen side most of it will be glacier.
*2 results in another coastline along with the first one. The map could end up looking something like Panama if the oceans pick opposite sides of the map.
*3 results in a peninsula, like Florida in the US. There will be oceans surrounding 3 sides of the map, and land touching only one side of the map.
*4 results in one or more island(s) depending on things like elevation variance and weights. Regardless of whether you get one island or multiple islands, the entire map will be surrounded by water.
Unfortunately there's no easy way to control which oceans end up on which edges, except perhaps setting X and Y variance to different values.

Edge oceans will take up part of the other edges too. For example a full edge ocean on the east side will have part of the north and south sides underwater, but that does ''not'' add to the ''partial'' edge oceans count.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[COMPLETE_OCEAN_EDGE_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[COMPLETE_OCEAN_EDGE_MIN:0]</nowiki></tt>
| Maximum of 4
|}

=== Minimum Volcano Number ===

Worlds with less than this number of volcanoes will be rejected. Note that this will not just create this many volcanoes at random; there must be at least this many squares with a Volcanism of 100. Therefore adjusting Weighted Range for 80-100 to some higher value is recommended if you want to facilitate a large number of volcanoes. In addition, Maximum Volcanism must be set to 100 or squares with volcanism of 100 will be impossible making volcanoes impossible.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[VOLCANO_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[VOLCANO_MIN:15]</nowiki></tt>
| Volcanoes require a volcanism of 100 to occur.
|}

=== Mineral Scarcity ===

Controls the frequency at which minerals occur. Setting this value lower will increase the amount of ore present on a map, the number of different types of ore, and the number/types of gems. The default value will result in a maximum of 2-4 metal ores per map (assuming you choose a good embark location) which may be limiting until the economy is fully implemented and desired metals can be traded for.

The options Very Rare, Rare, Sparse, Frequent and Everywhere in the [[World_generation#Basic_World_Generation_Menu|basic world generation menu]] use the values 50000, 10000, 2500, 500 and 100 respectively.

According to [http://www.bay12forums.com/smf/index.php?topic=79018.msg2063804#msg2063804 research] by Shandra on v0.31.25, this is the relationship between the value of this setting and the approximate number of gems and ore:

[[File:MineralSetting_v25_limit10k.png]]

This is for the same 8x8 embark region in a world which is otherwise the same except for the mineral scarcity parameter. Although most of the detailed information comes from experiments on previous versions.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[MINERAL_SCARCITY:<number>]</nowiki></tt>
| <tt><nowiki>[MINERAL_SCARCITY:2500]</nowiki></tt>
| Range: 100 to 100,000

|}
'''Note: as of DF2012 low mineral scarcity settings do not cause rejections.'''

=== Max Megabeasts Caves ===

This is the number of megabeasts placed at the beginning of history. Megabeasts are hydras, bronze colossuses, rocs and dragons which are all placed in equal proportions [http://www.bay12forums.com/smf/index.php?topic=112465.msg3415177#msg3415177 data].

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[MEGABEAST_CAP:<number>]</nowiki></tt>
| <tt><nowiki>[MEGABEAST_CAP:75]</nowiki></tt>
| Megabeasts count towards BEAST_END_YEAR calculation.
|}

=== Max Semi-Megabeast Caves ===

This is the number of semi-megabeasts placed at the beginning of history. Semi-megabeasts are giants, ettins, minotaurs, and cyclopes, which are placed in equal proportions [http://www.bay12forums.com/smf/index.php?topic=112465.msg3415188#msg3415188 data].

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SEMIMEGABEAST_CAP:<number>]</nowiki></tt>
| <tt><nowiki>[SEMIMEGABEAST_CAP:150]</nowiki></tt>
| Semimegabeasts do not count towards BEAST_END_YEAR calculation.
|}

=== Titan Parameters ===

==== Number ====

This controls the number of titans that exist at the beginning of history[http://www.bay12forums.com/smf/index.php?topic=112465.msg3415203#msg3415203 data]. The number of forgotten beasts is unaffected by this parameter [http://www.bay12forums.com/smf/index.php?topic=112465.msg3415155#msg3415155 data].

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TITAN_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[TITAN_NUMBER:33]</nowiki></tt>
| Titans count towards BEAST_END_YEAR calculation.
|}

==== Attack Population Requirement ====

Megabeasts will begin to attack your fort once at least this many dwarves inhabit it, regardless of whether any other attack criteria have been met. This number defaults to 80 which isn't usually too difficult to deal with.

==== Exported Wealth Requirement ====

Megabeasts will begin to attack your fort once you have exported at least this many [[Currency|dwarfbucks]] worth of merchandise, regardless of whether or not any other criteria have been met. This parameter defaults to None (disabled).

==== Created Wealth Requirement ====

Megabeasts will begin to attack your fort once the fort's total wealth has reached this many [[Currency|dwarfbucks]] in value. This happens regardless of whether any of the other criteria, such as population, have been met; therefore, even with 1 dwarf, a fort could be attacked if the fort were worth at least this value.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TITAN_ATTACK_TRIGGER:<population>:<exp wealth>:<created wealth>]</nowiki></tt>
| <tt><nowiki>[TITAN_ATTACK_TRIGGER:80:0:100000]</nowiki></tt>
| 0 = None (disabled). Only one requirement must be met for an attack.
|}

=== Number of Demon Types ===

[[Demon|Demons]] are similar to titans and forgotten beasts in that they are procedurally generated, but unlike titans they are not unique. Thus many different types of demons will exist in the world but there will be many members of each type. Setting this to zero means no demons will exist, limiting the amount of fun you can have.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[DEMON_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[DEMON_NUMBER:52]</nowiki></tt>
| 0 to 1000
|}

=== Number of Night Troll Types ===

The number of different [[Night troll|night trolls]] that will exist in the world. These are also procedurally generated. Setting this to zero means that the world will have no night trolls.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[NIGHT_TROLL_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[NIGHT_TROLL_NUMBER:77]</nowiki></tt>
| 0 to 1000
|}

=== Number of Bogeyman Types ===

The number of different [[Bogeyman|bogeyman]] forms that will exist in the world. Bogeyman are procedurally generated, though their forms do not vary by much. Setting this to zero, means that the world will have no bogeyman. Additionally setting this to zero will not allow custom bogeymen to appear in the world.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[BOGEYMAN_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[BOGEYMAN_NUMBER:27]</nowiki></tt>
| 0 to 1000
|}

=== Number of Vampire Curse Types ===

The number of different [[Vampire|vampires]] that will exist in the world. Although they too are generated at the start of a new world, they generally no different from one another, with the biggest difference being what stat bonuses their vampirism gives {{verify}}. Setting this to zero means no vampires will exist.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[VAMPIRE_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[VAMPIRE_NUMBER:72]</nowiki></tt>
| 0 to 1000
|}

=== Number of Werebeast Curse Types ===

The number of different [[Werebeast|werebeasts]] that can exist in the world. It is common for werebeasts, unlike vampires, to assume many different forms and variations, the most well known of these amount as different species of animal beasts. From lizards, to wolves, to maybe even bears. Setting this to zero means no werebeasts will exist.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[WEREBEAST_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[WEREBEAST_NUMBER:58]</nowiki></tt>
| 0 to 1000
|}

=== Number of Secret Types ===

The number of secrets that exist in the world. Currently, all secrets are secrets of life and death, and the ones holding these secrets are necromancers. Setting this to zero means that no [[necromancer]]s will appear.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SECRET_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[SECRET_NUMBER:44]</nowiki></tt>
| 0 to 1000
|}

=== Number of Regional Interaction Types ===

The number of interactions that can be caused in regions, which may incorporate evil rain and cloud types. Currently, only evil region interactions are generated this way.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[REGIONAL_INTERACTION_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[REGIONAL_INTERACTION_NUMBER:20]</nowiki></tt>
| 0 to 1000
|}

=== Number of Disturbance Interaction Types ===

The number of different [[Mummy|disturbed dead]] {{verify}} that can exist in the world. Setting this to zero, while being as pointless as is, (since you're never forced to enter a tomb anyway), will most likely prevent any toilet roll spooks from appearing, but it may or may not also prevent the existence of the pyramids which house them too.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[DISTURBANCE_INTERACTION_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[DISTURBANCE_INTERACTION_NUMBER:10]</nowiki></tt>
| 0 to 1000
|}

=== Number of Evil Cloud Types ===

This number specifies [[Weather#Evil weather|the total amount of various face-melting, eye-boiling, and zombifyingly-fun]] clouds of pure evil may appear in your world. Setting this to zero means you no longer will ever have to deal with encroaching dust walls of doom in that world. I'd keep this value low...

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[EVIL_CLOUD_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[EVIL_CLOUD_NUMBER:45]</nowiki></tt>
| 0 to 1000
|}

=== Number of Evil Rain Types ===

The lesser of a relatively large group of evils... evil rain. This number states how many different types of green-ooze drenchers, disconcerting blood-showers, and sickly yellow slime-baths can occur in your world. Compared to evil clouds though, this one hardly is worth stressing out about, usually.... Setting this to zero means the only semi-solid to fully liquid liquids to fall from the sky will be pure H2O.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[EVIL_RAIN_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[EVIL_RAIN_NUMBER:352]</nowiki></tt>
| 0 to 1000
|}

=== Desired Good/Evil Square Counts ===

These values change the amount of [[Surroundings#Good|good or evil]] tiles on the map, depending on the size of the region they are being considered for.

The exact size of small, medium, and large are: small is 1-24, medium is 25-99, and large is 100+, for any map size. The counts used here will always be restricted to regions of the given size no matter how large the number. Also, the count is more of a goal than a minimum or maximum. As a result you can end up with many more or many fewer than the requested number of squares in some situations.

In particular, if you have something like a case where only 3 large regions exists in a world, and you request "1 evil square" in large regions, you will end up with one of the large regions being ''entirely evil''. So any non-zero value in one of these settings essentially means "force at least one region of this size to be all good/evil."

Note that the "evilness" of evil biomes is also impacted by savagery.

Certain civilizations can not exist in good and/or evil squares, so too many of one or the other may limit the size of certain types of civilizations. Dwarves, for example, need non-aligned biomes.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[GOOD_SQ_COUNTS::<med region>:<lg region>]</nowiki></tt>
| <tt><nowiki>[GOOD_SQ_COUNTS:100:1000:2000]</nowiki></tt>
| rowspan="2" | Set count to zero to disable for that region size.
|-
| <tt><nowiki>[EVIL_SQ_COUNTS::<med region>:<lg region>]</nowiki></tt>
| <tt><nowiki>[EVIL_SQ_COUNTS:100:1000:2000]</nowiki></tt>
|}

=== Minimum Biome Square Counts ===

These numbers control whether or not a world will be rejected based on a lack of different [[biome|biomes]]. Raising these numbers will '''not''' automatically generate the given number of squares of the given biome! For a biome to exist, certain conditions like elevation and rainfall must exist.

These parameters simply filter out worlds that (for example) randomly fail to have enough high elevation squares to support a given number of mountains, etc. Some settings may cause worlds to always be rejected. For example, if for some reason the maximum elevation parameter is set to a value below what will support mountain biomes, it will be impossible to satisfy a non-zero requirement for mountain squares. The same principle goes for other conditions and biomes such as low elevations and oceans, etc.

Certain civilizations require different biomes to exist (such as dwarves and mountains), so eliminating certain biomes will make it impossible for certain civilizations to form.

These parameters often result in infinite world rejection problems. See [[World rejection]] for information on solving problems related to worlds always being rejected due to one or more of these parameters.

0 means no minimum for rejection. Setting to 0 does not guarantee 0 squares of that biome.

==== Biome Type Requirement Table ====

Terrain requirements for various biomes are described below.{{Verify}} Note that some of the exact ranges are unknown.

{| {{prettytable}}
|- bgcolor="#dddddd"
! rowspan="2" | Biome
! colspan="4" | Terrain Requirement
|-
! Elevation
! Rainfall
! Temperature
! Drainage
|-
| Swamp/Marsh
| 100-299
| 33-100
| Non-Freezing
| 0-32
|-
| Desert/Badland
| 100-299
| 0-9
| non-freezing
| note1
|-
| Forest
| 100-299
| 66-100
| non-freezing
| 66-100
|-
| Mountains
| 300-400
| N/A
| N/A
| N/A
|-
| Ocean
| 0-99
| N/A
| N/A
| N/A
|-
| Glacier
| 100-299
| N/A
| Freezing
| 80(?)-100
|-
| Tundra
| 100-299
| N/A
| Freezing
| 0-66
|-
| Grassland
| 100-299
| 0-66
| Non-Freezing
| 0-66
|-
| Hills
| 100-299
| 0-66
| Non-Freezing
| 66-100
|}
note1 drainage: 00-32 sand desert, 33-49 rocky wasteland, 50-65 rocky wasteland but different characters/appearance, 66-100 badlands

==== Minimum Initial Square Count ====

This is the minimum number of squares of the given biome that must exist before things like erosion take place.

One thing to keep in mind is the maximum number of squares on a map of a given size. If the total number of squares on a map is lower than the sum of all square count parameters then you will get infinite world rejection.

To determine the number of squares on a map, just multiply the dimensions. In practice these parameters will need to sum to lower than the maximum because some space is needed for "slack".

{| {{prettytable}}
|- bgcolor="#dddddd"
! Map Size
! Number of Squares
|-
| 17x17
| 289
|-
| 33x33
| 1089
|-
| 65x65
| 4225
|-
| 129x129
| 16614
|-
| 257x257
| 66049
|}

==== Minimum Initial Region Count ====

This is the minimum number of regions of contiguous biome squares that must exist before other processes such as erosion take place.

==== Minimum Final Region Count ====

This many regions of the given biome must exist after erosion and similar phases of generation have been completed.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
|-
| <tt><nowiki>[REGION_COUNTS:SWAMP:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:SWAMP:1032:7:6]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:DESERT:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:DESERT:1032:7:6]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:FOREST:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:FOREST:4128:13:12]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:MOUNTAINS:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:MOUNTAINS:8256:9:9]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:OCEAN:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:OCEAN:8256:7:6]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:GLACIER:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:GLACIER:0:0:0]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:TUNDRA:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:TUNDRA:0:0:0]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:GRASSLAND:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:GRASSLAND:8256:13:12]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:HILLS:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:HILLS:8256:13:12]</nowiki></tt>
|}

=== Erosion Cycle Count ===

Tells the world-generator how long the world has to erode its tall peaks down to mountainsides during the 'running rivers...' stage of world creation. The higher this number, the less jagged the world will be, and the more wide the major rivers will be. If you use the maximum number, your mountains will dissolve before your eyes into plains which can lead to rejections if there aren't enough mountains to use for river start points and dwarven civilization origin points.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[EROSION_CYCLE_COUNT:<number>]</nowiki></tt>
| <tt><nowiki>[EROSION_CYCLE_COUNT:250]</nowiki></tt>
| Range: 0 to 1000
|}

=== Minimum/Desired River Start Locations ===

This is the minimum number of riverheads that must exist before and after erosion takes place. Worlds will be rejected if they fail to meet these numbers. As with minimum biome counts, raising this number doesn't automatically create this many riverheads. Other conditions like terrain and rainfall must exist for rivers to form.

Extremely high pre-erosion values speed erosion greatly, while low post erosion values are useful for limiting rejects due to lack of river origin points. One can try the 800 value to get more lakes.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[RIVER_MINS:<min pre-erosion>:<des post-erosion>]</nowiki></tt>
| <tt><nowiki>[RIVER_MINS:200:400]</nowiki></tt>
| Range: 0 to 800
|}

=== Periodically Erode Extreme Cliffs ===

If enabled, makes every impassable rock wall into a series of ramps. Some prefer to pump up erosion to about 250, and turn the "Desired pre-erosion river count" to 0 for good erosion and no extra canyons.

Normally this is set to Yes (1).

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[PERIODICALLY_ERODE_EXTREMES:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[PERIODICALLY_ERODE_EXTREMES:1]</nowiki></tt>
| 1/0 = Yes/No
|}

=== Do Orographic Precipitation and Rain Shadows ===

Toggle that allows terrain height to affect rainfall. For example, moist air coming from the ocean blows over the land. As the terrain gets higher, it forces the moist air up, causing it to rain on the seaward side of a mountain. Eventually, all the rain has fallen if the mountain is tall enough. So, when the breeze goes over the top, there's no moisture left to fall on the other side, creating a rain-shadow. This should create a tendency for more extreme rainfall in regions, creating more forests, deserts, marshlands, and grasslands. Also note that it can create rainfall outside of mix-max rainfall settings, so even in a world with a 0 max rainfall you may get rainfall biomes. Turning it off should result in more controllable, less complex rainfall conditions based on rainfall parameters as it adds a random element which can distort or otherwise mess up the climates on a pregenerated map.

This should be disabled if you're importing a map or using a preset map file that has weather.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[OROGRAPHIC_PRECIPITATION:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[OROGRAPHIC_PRECIPITATION:1]</nowiki></tt>
| 1/0 = Yes/No
|}

=== Maximum Number of Subregions ===

This is the number of separate biomes (the flashing regions you see on embark when you hit F1, F2, etc when there's more than one biome on the embark location) that are allowed to exist on the entire map.

Setting this to very low values will result in numerous rejections depending on [[#X and Y Variance|variance parameters]]. If variance values are set to high numbers, many small biomes will be created causing rejection if this parameter value is not increased beyond the default.

Increasing the value of this tag is often a must when generating "patchwork" worlds with lots of biome variance, but simply increasing it without increasing variance parameters will not guarantee more biomes.

It is also interesting to note that the maximum subregions is 5000 which is more then the total number of squares for a pocket or small map. However for a medium or large map (16641 or 66049 squares) it quickly becomes a mere fraction of the total number of possible subregions. In fact it would be quite easy on a large map to end up with far too many subregions and get endless rejections of this type.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SUBREGION_MAX:<number>]</nowiki></tt>
| <tt><nowiki>[SUBREGION_MAX:2750]</nowiki></tt>
| Range: 1 to 5000
|}

=== Cavern Parameters ===
[[Caverns]] are the hollow areas underground which dwarves tend to encounter when they're digging around.

==== Cavern Layer Number ====

This parameter determines how many cavern systems will be generated, not including the Magma layer or the Bottom layer. Defaults to three. Setting it to lower values could help FPS.

'''Warnings:'''
*Disabling caverns by setting this to 0 will make it impossible to grow any underground plants, as none will exist for your civilization to cultivate. (Underground plants will not be available on embark.)
*Setting this property lower then the default of 3 will make it impossible to find certain [[Demonic_fortress|Fun features]] ([http://www.bay12forums.com/smf/index.php?topic=111527.0 Source])

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVERN_LAYER_COUNT:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_COUNT:3]</nowiki></tt>
| Range: 0 to 3
|}

==== Cavern Layout Parameters ====

Open caverns and dense passageways are not mutually exclusive. When both are raised, bizarre results can occur, such as layers showing a combination of open caverns, a cluster of network passages, and natural walls sprinkling the inside of an otherwise open cavern. [http://www.bay12forums.com/smf/index.php?topic=76355.msg1936859#msg1936859 Reference]

If you want the largest open spaces possible, then decrease the density and increase the openness. If you want a labyrinth of passageways, lower the openness and raise the passage density.

Another interesting note about the cavern layers is that the seed and number of demon types affect the layout of the caverns.

<gallery widths=200 heights=200 perrow=2>
File:Open00Density100.jpg|Cavern slice with Openness of 0 and Density of 100
File:Open100Density00.jpg|Cavern slice with Openness of 100 and Density of 0
File:Open100Density100.jpg|Cavern slice with Openness of 100 and Density of 100
File:Open50Density50.jpg|Cavern slice with Openness of 50 and Density of 50
</gallery>

===== Layer Openness Min/Max =====

Dictates the size of cavern passages. When Passage Density (see below) is set to minimum (0), caverns will be open expanses. Raising the maximum will increase the size of the caverns.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVERN_LAYER_OPENNESS_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_OPENNESS_MIN:0]</nowiki></tt>
| rowspan="2" | Range: 0 to 100
|-
| <tt><nowiki>[CAVERN_LAYER_OPENNESS_MAX:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_OPENNESS_MAX:100]</nowiki></tt>
|}

===== Layer Passage Density Min/Max =====

This determines how many passages form the cavern. If openness (see above) is set to minimum and density increased then you will get a maze like network of small criss-crossing passages. Raising the values further increases the number of the maze-like passages.

Caverns will be large, open spaces at 0, and comprised of many small vertical shafts of rock at 100. Setting both values to be the same results in a uniform look for the caverns.{{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVERN_LAYER_PASSAGE_DENSITY_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_PASSAGE_DENSITY_MIN:0]</nowiki></tt>
| rowspan="2" | Range: 0 to 100
|-
| <tt><nowiki>[CAVERN_LAYER_PASSAGE_DENSITY_MAX:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_PASSAGE_DENSITY_MAX:100]</nowiki></tt>
|}

See [http://www.bay12forums.com/smf/index.php?topic=76355.0 this forum thread] for more information on openness and density including many more images.

===== Layer Water min\max =====

Determines how many caverns will have water at the bottom. Note that, even at 100, there will be some amount of ground in caverns, but each cavern 'bubble' will contain some amount of water.

At 0, there will be no water in your caverns. This may impact future underground plant growth, although maps will still start with underground flora.{{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVERN_LAYER_WATER_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_WATER_MIN:0]</nowiki></tt>
| rowspan="2" | Range: 0 to 100
|-
| <tt><nowiki>[CAVERN_LAYER_WATER_MAX:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_WATER_MAX:100]</nowiki></tt>
|}

==== Magma Layer ====

This parameter controls whether the [[magma sea]] exists.

Setting 1/Yes causes the magma layer to exist, value 0/No prevents it. Appears not have impact on volcanoes, nor volcanism, so even if 0/No there will still be embark locations with magma. If a [[volcano]] exists, it appears to always tap the magma sea, but the magma sea will not be revealed by revealing the volcano.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
|-
| <tt><nowiki>[HAVE_BOTTOM_LAYER_1:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[HAVE_BOTTOM_LAYER_1:1]</nowiki></tt>
|}

==== Bottom Layer ====

Determines if the space below the magma sea exists. If Yes the "HFS" layer is always present. Normally you want to leave this set to Yes for maximum fun.

If enabled, this will force the magma layer above it. (Unknown whether this has any impact on occurrence of HFS "temple".){{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
|-
| <tt><nowiki>[HAVE_BOTTOM_LAYER_2:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[HAVE_BOTTOM_LAYER_2:1]</nowiki></tt>
|}

=== Z Levels (Depth) Settings ===

These parameters control the "thickness" of various "layers" on the map. Note that a "layer" in this case does not refer to one Z-level, but refers to a number of related Z-levels such as "levels above ground".

The following table assumes that you have 3 cavern layers. The Levels Above Layer settings control how many Z-Levels are above each layer. A layer may itself consist of multiple Z-Levels (and almost always does).

{|style="margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;" class="wikitable"
|-style="background:#F2F2F2;text-align:center;"
!style="border:1px #AAA solid;padding:0.2em;" width="120"|Setting Name
!style="border:1px #AAA solid;padding:0.2em;" width="200"|Token
!style="border:1px #AAA solid;padding:0.2em;"| Description
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Ground
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_GROUND:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| The number of Z-Levels of air above the highest surface level. Has no impact on how many Z-levels deep the surface layer is.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above layer 1
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_1:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Z-Levels of stone above the first cavern layer. Making this higher will guarantee ''at least'' this many levels to build your fortress, but will have no impact on how many z-levels thick the surface layer is. Also, the top of a cavern may be higher than the rest of a cavern, so in practice there will be more "solid" levels than this above the cavern.
As for version 0.31.25 this setting is inaccurate. The actual number of z-levels may vary in a range of approx. ±5, which may result in non-existence of any solid z-levels between a surface layer and first cavern layer.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Layer 2
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_2:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Z-levels of earth between very top of second cavern and very bottom of first cavern.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Layer 3
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_3:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Z-levels of earth between very top of third cavern and very bottom of second cavern.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Layer 4
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_4:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Z-Levels of earth between very highest magma and very bottom of third cavern. Spoiler Hidden (select invisible text to read): Making this high will give a large area for HFS veins, so that it never touches caverns, giving more to mine '''if''' it was impacting the cavern previously.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Layer 5
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_5:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Uncertain. May control the number of levels of "Semi Molten Rock" between HFS and Magma, may control number of levels of magma, may impact both. In experimentation, the overall depth of all magma sea and semi-molten rock levels appears to increase, but not consistent enough to say for certain. Only valid if Magma Layer present. Spoiler Hidden:Often the HFS vein will only extend as high as the highest magma, making this the only guaranteed way to increase amount of HFS to mine, but unfortunately also creating enormous useless semi-molten z-levels
|-
|style="border:1px #AAA solid;padding:0.2em;"| At Bottom
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_AT_BOTTOM:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Appears to be number of levels of HFS chamber. Only valid if Bottom Layer present. Often has no impact. Values larger than default results in strange things.
|}

Some implications:
* The number of surface layers (e.g. soil), at this time, can not be controlled. For example, on a map with 1 layer of Peat, then a layer of Silt, then a layer of Obsidian, there is no control to let you increase either one to be, say, 20 z-levels. (though you may get lucky with the Obsidian).
* There can be multiple stone layers between the cavern and the surface. So increasing Levels Above Layer 1 may give you more Conglomerate, or more Granite, and you have no control over which stone layer spans those Z-Levels.
* The layers shown on embark span across the cavern layers in an unknown and inconsistent way. Sometimes those 10 different layers of stone are evenly distributed over your 400 z-level deep map, sometimes the first 9 get 1 z-level each and the last gets the other 391 levels. No way to control found yet.
* The HFS temple, if present, will always extend into the rock layers, and appears to always make contact with the bottom cave. Large values for levels above layer 5 and layer 4 can result in enormous temples, but the number of levels at the top (the part with undead) appears to be unaffected.
* Unconfirmed whether number of levels between caverns has any impact on cavern height. There will be connecting ramps and/or shafts between cavern layers no matter how many levels are between them.
* '''Very Important''': These values appear to apply across a whole 16x16 Region, not just embark areas. That means that if a 16x16 region is completely flat, but has one tall mountain in one far corner, even if you set Levels Above Ground low (e.g. 2 z-levels) you still have all the empty air of the highest mountain in every embark tile (e.g. 200 z-levels). Also can happen to the semi-molten layer, and can lead to unexpected behavior.
* Very large values can cause strange things to happen. Even more true for small values.

=== Cave Parameters ===

Caves are sort of like caverns except that they have a passage to the surface and are generally much smaller. Caves can connect to caverns if they are sufficiently deep.

==== Minimum/Maximum Natural Cave Size ====

These parameters appear to control the length and depth of caves.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVE_MIN_SIZE:<number>]</nowiki></tt>
| <tt><nowiki>[CAVE_MIN_SIZE:5]</nowiki></tt>
| rowspan="2" | Range: 1 to 500
|-
| <tt><nowiki>[CAVE_MAX_SIZE:<number>]</nowiki></tt>
| <tt><nowiki>[CAVE_MAX_SIZE:25]</nowiki></tt>
|}

==== Number of (Non-)Mountain Caves ====

The number of caves that will be generated. Lurking kobolds set up shop in caves and store stolen items here. A setting of 0 in both will stop kobold civilizations from appearing. Special note: a cave is not a lair.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[MOUNTAIN_CAVE_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[MOUNTAIN_CAVE_MIN:100]</nowiki></tt>
| rowspan="2" | Range: 0 to 800
|-
| <tt><nowiki>[NON_MOUNTAIN_CAVE_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[NON_MOUNTAIN_CAVE_MIN:200]</nowiki></tt>
|}

==== Make Caves Visible ====

If set to no (default) then the location of caves will not be marked on the map. If set to yes, caves will appear on the map as {{Raw Tile|•|#808080|#00DD00}} symbols so that they may be sought out or avoided as desired.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[ALL_CAVES_VISIBLE:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[ALL_CAVES_VISIBLE:0]</nowiki></tt>
| 1/0 = Yes/No
|}

=== Allow Init Options to Show Tunnels ===

This parameter doesn't do anything.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SHOW_EMBARK_TUNNEL:<0-2>]</nowiki></tt>
| <tt><nowiki>[SHOW_EMBARK_TUNNEL:2]</nowiki></tt>
| 0 = No 1 = Only in Finder 2 = Always
|}

=== Number of Civilizations ===

This number of civilizations will be placed on the map before history generation begins. These civilizations may later die out due to historical events. The five races are dwarf, elf, human, goblin, and kobold; they will be placed in equal numbers until the quota has been reached. If there is an odd number of civs (not divisible by 5), then the remainder is distributed randomly. Kobold civs require caves to be placed; if no caves exist, then kobolds are skipped and will not appear. This does not cause rejections [http://www.bay12forums.com/smf/index.php?topic=112465.msg3415125#msg3415125 data].

Note that a high value here can cause lots of map rejections, particularly on smaller maps as there simply isn't enough room or regions to put them all in.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TOTAL_CIV_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[TOTAL_CIV_NUMBER:40]</nowiki></tt>
| Range: 0 to 300
|}

=== Playable Civilization Required ===

If this is set to yes (default) then worlds will be rejected if no civilization with [[Entity token|CIV_CONTROLLABLE]] can be placed. In an unmodded game, only the dwarves have this token.

If set to no, the result may be a world that cannot be played in Fortress Mode.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[PLAYABLE_CIVILIZATION_REQUIRED:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[PLAYABLE_CIVILIZATION_REQUIRED:1]</nowiki></tt>
| 1/0 = Yes/No
|}

=== Minimum Number of Mid/Low/High Characteristic Squares ===

Sets the minimum possible number of squares of certain ranges of each of the region qualities, such as elevation, rain, drainage, volcanism, savagery, and temperature. These need to be changed to reflect your regional meshes and weights. These are responsible for a HUGE number of map rejections. These values can all be set to 0 for much fewer map rejections, particularly in the case of more wacky, non-standard maps.

These values will cause worlds to be rejected unless at least the given number of squares of the given type are randomly generated. Setting these values too high could result in worlds always being rejected if other parameters such as the maximum/minimums for elevation, etc, don't allow enough of those squares to get generated.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[ELEVATION_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[ELEVATION_RANGES:8256:16512:8256]</nowiki></tt>
| rowspan="5" | Minimum number of squares that must have low, medium, and high amounts of the given attribute. 
0 = No minimum
|-
| <tt><nowiki>[RAIN_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[RAIN_RANGES:8256:16512:8256]</nowiki></tt>
|-
| <tt><nowiki>[DRAINAGE_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[DRAINAGE_RANGES:8256:16512:8256]</nowiki></tt>
|-
| <tt><nowiki>[SAVAGERY_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[SAVAGERY_RANGES:8256:16512:8256]</nowiki></tt>
|-
| <tt><nowiki>[VOLCANISM_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[VOLCANISM_RANGES:8256:16512:8256]</nowiki></tt>
|}

==World rejection==

:''Main article [[World rejection]]''

If you are having the common problem of your generated worlds always being rejected by the world generator, see [[v0.31:World rejection|Solving World Rejection Problems (v0.31 page)]] as it contains many detailed suggestions on how to troubleshoot and solve these issues.

== Default Worldgen Parameters ==

There is no single default for each parameter. Several advanced world generation profiles come with the game by default. See [[world_gen.txt|Default world_gen.txt]] to take a look at this file.

== Parameter Set Examples ==

If you're trying to do something specific then the [[Worldgen examples|Worldgen examples]] might be helpful. These are complete parameter sets that can be copied directly into your ''world_gen.txt'' file and customized as desired.
If they have nothing for you try [[Worldgen Tricks|Worldgen Tricks]], for known tricks and tips on making a world just right for you.

For many many more examples see:
* [http://www.bay12forums.com/smf/index.php?topic=101280 v0.34 WorldGen "Cookbook" Thread]

{{World}}

v0.34:Immigration

2014-02-07T02:15:17Z

Doktoro Reichard: /* Migrant wave sizes */

{{quality|Exceptional|21:11, 20 August 2010 (UTC)}}{{av}}{{buggy}}

Immigration can occur at any time once per season. Smaller migrant waves of 2 to 10 arrive in early seasons, followed by a large wave in the low double digits in the second spring, one year after embark (the maximum wave size reported to date is [http://www.reddit.com/r/dwarffortress/comments/q580c/hole_shit/ 77]). The first 2 migrant waves are hardcoded and will appear under any circumstances, unaffected by fortress wealth or even the extinction of their home civilization. Each group of migrants will often include domestic animals, including both pets and stray livestock. Many also include [[child]]ren. Be prepared with adequate [[food]], [[alcohol|drink]], and [[bed]]s, among other things.

Migrants will often have skills that match your fortress' needs — migrants with skills your fortress uses a lot or skills that your fortress doesn't have at all are more likely to show up at your gates. Important skills (mining, food production, and basic crafting, according to Toady) are weighed more heavily than other skills.[http://www.bay12games.com/media/df_talk_12_transcript.html Source] {{dot}} [http://www.bay12games.com/media/Dwarf_Fortress_Talk_12.mp3 MP3]

Migration waves are generally a good thing — if you're prepared for them.

== Labor preferences ==

Each migrant can arrive with a wide collection of often unrelated skills, far greater than possible with one of the [[starting build|starting 7 dwarves]], and [[experience]] levels as high as Legendary.
Any and all skills might be represented, including obscure military skills (like [[blowgunner]]), high levels of one or more [[social skill]]s, [[crutch walker]], [[concentration]] and others. It's even possible to have dwarves with skills that may not be obtainable by other means, like [[military tactics]] or [[tracker|tracking]].

Immigrants may have high skills in certain [[labor|labors]] without actually having them enabled in their labor preferences. This leads to dwarves either doing jobs from an area they are not labeled for or no work at all. For example, an adequate cheese maker (with the cheese making labor turned on) may also have the skill bone carving on "high master", albeit turned off in his preferences. The dwarf in question is listed as a bone carver on screen and in the [[status]] tab, but will only perform the cheese making labor. Individually checking each immigrant for skills and labor preferences is the only workaround so far. The use of programs such as [[utilities|Dwarf Therapist]] and [[Utility:DFHack|DFHack]] can greatly decrease the time taken to check each dwarf's skills.

As of v34.04, migrants may arrive with all labors except hauling, cleaning, recovering wounded, and caring for wounded disabled, depending on the settings one has entered into [[init.txt]].

== Historical migrants ==

Some immigrants are [[legends|historical]] figures. These immigrants come to your fortress with skills representing their history, and may come to your fortress with wounds they have suffered during [[world generation]]. Immigrants may even be [[vampire]]s.

==Limiting/preventing immigration==
If the fortress population exceeds the population cap when the dwarven [[liaison]] is visiting he will note that you don't want any more dwarves. On his safe return to the dwarven homeland he then will see that no migrants are sent that year. So you can stop immigration by setting the POPULATION_CAP option in [[d_init.txt]] to a number lower than your current population, the change will only take effect after the dwarven caravan visits so you may get up to three waves of migrants before the change takes effect.{{Verify}}

The first two immigrant waves are hardcoded so you will always receive them, and if you have fewer than 4 dwarves POPULATION_CAP is ignored {{Verify}}. The number of migrants depends on the [[wealth|created wealth]] of your fortress and so is affected by your dwarves activities. Note that if your fortress should ever become a mountainhome, you will receive an additional migration wave with the promotion, regardless of your population cap. The number of migrants is not affected by how far below the population cap your fortress was. One dwarf short, or twenty - it's all the same.

It is worth noting that you need a certain minimum population size before any of your dwarves will experience [[strange mood]]s. Additionally, POPULATION_CAP still allows babies to be born. You will need to alter BABY_CAP in order to change it.

To reiterate, '''the population cap is not a hard limit on the number of dwarves in your fortress'''; It is a soft cap on immigration that only is checked when a liaison successfully reports back to your home civ. If a player is as little as 1 dwarf under their population cap when the liaison leaves, they will be eligible for a full year of normal immigration. As such, it is recommended that players set their population cap at 20-30 dwarves below the number of dwarves they actually want in their fort.

There is an open bug where it seems that for some people POPULATION_CAP doesn't work at all.{{Verify}}{{Bug|2922}}

==Immigration mechanics==
The date on which immigrants appear in a season seems to be fixed at the start of that season, but the number of immigrants and their skills are determined when the migrant wave arrives.

There is never a migration in the first winter. There won't even be a {{DFtext|The fortress attracted no migrants this season|DarkGoldenRod}} message.

Migrant skill levels seem to depend on the size of the home civilization; a difference will be noticed if you picked a dwarven civilization that was not well established (few towns or none) compared to a well established one.

==Migrant wave sizes==
The first two migrant waves have a minimum size of 1, if it has a relative in your group already, and a maximum size of 10. The size of these waves are unaffected by fortress wealth.

The third migrant wave and on are influenced by the [[wealth|created wealth]] of the fortress, with more wealth attracting more immigrants (more research is needed to determine specifics). Specifically, they're influenced by the fortress wealth as reported by the last outgoing dwarven [[caravan]]. Wealth created after the caravan leaves has no influence until the next year's caravan leaves. If the caravan fails to make it out then the fortress' wealth is not reported. The dwarven [[liaison]] does not report on fortress wealth, in those circumstances where the liaison makes it out but the caravan doesn't.

Imported wealth, caravan sales figures, absolute caravan profit and caravan profit margin either have no effect on migration numbers, or only have an effect by applying a percent modification to the numbers driven by created wealth. If a fortress manages to [[trading|trade]] (not offer) away 100% of its created wealth then no immigrants will come the next season. More research is needed to determine if the aforementioned statistics have any influence on migration numbers.

One factor which is known to affect migrant wave size is the total size of your fortress's {{k|u}}nits list (all 4 categories), which consists of dwarves, invaders, merchants, and animals which either died or currently live at your fortress. As this number increases, the maximum size of migrant waves will be reduced: starting at a local population of 1000, migrant wave sizes are limited to 10, and at subsequent levels of 1300, 1600, 1800, 2000, 2200, 2400, 2600, 2800, and 2900, the limit is decreased by 1, and once you reach a local population of 3000 you will cease to get migrants at all.

Kurik Amudnil created a DFHack script to prevent the latter from happening, by clearing (and storing, so that it can be restored as wanted) the dead units list of uninteresting creatures. It is available [http://www.bay12forums.com/smf/index.php?topic=91166.msg4336893#msg4336893 here] and is also included in the [[Utility:Lazy_Newb_Pack|Lazy Newb Pack]].

==Adventure mode==
In certain locations in [[adventure mode]], you may come across a '''Migrating Group'''. One such location is near a recently [[abandon|abandoned]] [[fortress]]; choosing to travel to the group will allow you to talk to the members of your former fortress as they travel back to dwarven civilization.

==Fortress Failure Migration==
If a fortress is abandoned during [[unhappy]], [[Main:stark raving mad|stark raving mad]] times the citizens can migrate to your new fortress still stark raving mad (berserk possibly, further looking into required).

==Bugs==
If any migrants to your fort were formerly traders or soldiers with a trade caravan, then they will be marked as a "friendly" Trader, stand around at the map edge for a while (blocking the rest of the migrants, and caravans or even a Monarch), and then wander around randomly, unable to be assigned labors. {{Bug|5098}} [[Utility:DFHack|DFHack]] includes a command "tweak fixmigrant" as a workaround for this bug. This bug occurs most often if your starting dwarven civilization at embark is a very small one with few or even no towns at all.

Also, some migrants will be incorrectly listed as babies or children, when they are not in the expected age range for those categories. This will automatically fix itself when they have their next birthday. Some baby migrants may have future birth dates. {{Bug|3945}}

You might have a situation where a single migrant can't find the fort and just stands at the edge of the map, not moving at all.

{{Category|Dwarves}}
{{Category|World}}

{{Starting FAQ}}

v0.34:Immigration

2014-02-07T02:11:15Z

Doktoro Reichard: /* Migrant wave sizes */ - adding some information someone told me about in the forums that seems relevant

{{quality|Exceptional|21:11, 20 August 2010 (UTC)}}{{av}}{{buggy}}

Immigration can occur at any time once per season. Smaller migrant waves of 2 to 10 arrive in early seasons, followed by a large wave in the low double digits in the second spring, one year after embark (the maximum wave size reported to date is [http://www.reddit.com/r/dwarffortress/comments/q580c/hole_shit/ 77]). The first 2 migrant waves are hardcoded and will appear under any circumstances, unaffected by fortress wealth or even the extinction of their home civilization. Each group of migrants will often include domestic animals, including both pets and stray livestock. Many also include [[child]]ren. Be prepared with adequate [[food]], [[alcohol|drink]], and [[bed]]s, among other things.

Migrants will often have skills that match your fortress' needs — migrants with skills your fortress uses a lot or skills that your fortress doesn't have at all are more likely to show up at your gates. Important skills (mining, food production, and basic crafting, according to Toady) are weighed more heavily than other skills.[http://www.bay12games.com/media/df_talk_12_transcript.html Source] {{dot}} [http://www.bay12games.com/media/Dwarf_Fortress_Talk_12.mp3 MP3]

Migration waves are generally a good thing — if you're prepared for them.

== Labor preferences ==

Each migrant can arrive with a wide collection of often unrelated skills, far greater than possible with one of the [[starting build|starting 7 dwarves]], and [[experience]] levels as high as Legendary.
Any and all skills might be represented, including obscure military skills (like [[blowgunner]]), high levels of one or more [[social skill]]s, [[crutch walker]], [[concentration]] and others. It's even possible to have dwarves with skills that may not be obtainable by other means, like [[military tactics]] or [[tracker|tracking]].

Immigrants may have high skills in certain [[labor|labors]] without actually having them enabled in their labor preferences. This leads to dwarves either doing jobs from an area they are not labeled for or no work at all. For example, an adequate cheese maker (with the cheese making labor turned on) may also have the skill bone carving on "high master", albeit turned off in his preferences. The dwarf in question is listed as a bone carver on screen and in the [[status]] tab, but will only perform the cheese making labor. Individually checking each immigrant for skills and labor preferences is the only workaround so far. The use of programs such as [[utilities|Dwarf Therapist]] and [[Utility:DFHack|DFHack]] can greatly decrease the time taken to check each dwarf's skills.

As of v34.04, migrants may arrive with all labors except hauling, cleaning, recovering wounded, and caring for wounded disabled, depending on the settings one has entered into [[init.txt]].

== Historical migrants ==

Some immigrants are [[legends|historical]] figures. These immigrants come to your fortress with skills representing their history, and may come to your fortress with wounds they have suffered during [[world generation]]. Immigrants may even be [[vampire]]s.

==Limiting/preventing immigration==
If the fortress population exceeds the population cap when the dwarven [[liaison]] is visiting he will note that you don't want any more dwarves. On his safe return to the dwarven homeland he then will see that no migrants are sent that year. So you can stop immigration by setting the POPULATION_CAP option in [[d_init.txt]] to a number lower than your current population, the change will only take effect after the dwarven caravan visits so you may get up to three waves of migrants before the change takes effect.{{Verify}}

The first two immigrant waves are hardcoded so you will always receive them, and if you have fewer than 4 dwarves POPULATION_CAP is ignored {{Verify}}. The number of migrants depends on the [[wealth|created wealth]] of your fortress and so is affected by your dwarves activities. Note that if your fortress should ever become a mountainhome, you will receive an additional migration wave with the promotion, regardless of your population cap. The number of migrants is not affected by how far below the population cap your fortress was. One dwarf short, or twenty - it's all the same.

It is worth noting that you need a certain minimum population size before any of your dwarves will experience [[strange mood]]s. Additionally, POPULATION_CAP still allows babies to be born. You will need to alter BABY_CAP in order to change it.

To reiterate, '''the population cap is not a hard limit on the number of dwarves in your fortress'''; It is a soft cap on immigration that only is checked when a liaison successfully reports back to your home civ. If a player is as little as 1 dwarf under their population cap when the liaison leaves, they will be eligible for a full year of normal immigration. As such, it is recommended that players set their population cap at 20-30 dwarves below the number of dwarves they actually want in their fort.

There is an open bug where it seems that for some people POPULATION_CAP doesn't work at all.{{Verify}}{{Bug|2922}}

==Immigration mechanics==
The date on which immigrants appear in a season seems to be fixed at the start of that season, but the number of immigrants and their skills are determined when the migrant wave arrives.

There is never a migration in the first winter. There won't even be a {{DFtext|The fortress attracted no migrants this season|DarkGoldenRod}} message.

Migrant skill levels seem to depend on the size of the home civilization; a difference will be noticed if you picked a dwarven civilization that was not well established (few towns or none) compared to a well established one.

==Migrant wave sizes==
The first two migrant waves have a minimum size of 1, if it has a relative in your group already, and a maximum size of 10. The size of these waves are unaffected by fortress wealth.

The third migrant wave and on are influenced by the [[wealth|created wealth]] of the fortress, with more wealth attracting more immigrants (more research is needed to determine specifics). Specifically, they're influenced by the fortress wealth as reported by the last outgoing dwarven [[caravan]]. Wealth created after the caravan leaves has no influence until the next year's caravan leaves. If the caravan fails to make it out then the fortress' wealth is not reported. The dwarven [[liaison]] does not report on fortress wealth, in those circumstances where the liaison makes it out but the caravan doesn't.

Imported wealth, caravan sales figures, absolute caravan profit and caravan profit margin either have no effect on migration numbers, or only have an effect by applying a percent modification to the numbers driven by created wealth. If a fortress manages to [[trading|trade]] (not offer) away 100% of its created wealth then no immigrants will come the next season. More research is needed to determine if the aforementioned statistics have any influence on migration numbers.

One factor which is known to affect migrant wave size is the total size of your fortress's {{k|u}}nits list (all 4 categories), which consists of dwarves, invaders, merchants, and animals which either died or currently live at your fortress. As this number increases, the maximum size of migrant waves will be reduced: starting at a local population of 1000, migrant wave sizes are limited to 10, and at subsequent levels of 1300, 1600, 1800, 2000, 2200, 2400, 2600, 2800, and 2900, the limit is decreased by 1, and once you reach a local population of 3000 you will cease to get migrants at all.

Kurik Amudnil created a DFHack script to prevent the latter from happening, by clearing (and storing, so that it can be restored as wanted) the dead units list of uninteresting creatures. It is available [http://www.bay12forums.com/smf/index.php?topic=91166.msg4336893#msg4336893 here].

==Adventure mode==
In certain locations in [[adventure mode]], you may come across a '''Migrating Group'''. One such location is near a recently [[abandon|abandoned]] [[fortress]]; choosing to travel to the group will allow you to talk to the members of your former fortress as they travel back to dwarven civilization.

==Fortress Failure Migration==
If a fortress is abandoned during [[unhappy]], [[Main:stark raving mad|stark raving mad]] times the citizens can migrate to your new fortress still stark raving mad (berserk possibly, further looking into required).

==Bugs==
If any migrants to your fort were formerly traders or soldiers with a trade caravan, then they will be marked as a "friendly" Trader, stand around at the map edge for a while (blocking the rest of the migrants, and caravans or even a Monarch), and then wander around randomly, unable to be assigned labors. {{Bug|5098}} [[Utility:DFHack|DFHack]] includes a command "tweak fixmigrant" as a workaround for this bug. This bug occurs most often if your starting dwarven civilization at embark is a very small one with few or even no towns at all.

Also, some migrants will be incorrectly listed as babies or children, when they are not in the expected age range for those categories. This will automatically fix itself when they have their next birthday. Some baby migrants may have future birth dates. {{Bug|3945}}

You might have a situation where a single migrant can't find the fort and just stands at the edge of the map, not moving at all.

{{Category|Dwarves}}
{{Category|World}}

{{Starting FAQ}}

v0.34 Talk:Calendar

2014-02-06T23:35:44Z

Doktoro Reichard: /* Draconic Ages */ - rsp

== Age of Slums? ==
After making a small world, i noticed that it progressed into an age of slum. interestingly there appears to be two dwarven forts and one of each type of other civilization. which is odd for such a small world, especially after such a long time. i wonder if its similar to the age of twilight although the setting does not seem to suggest so...

Also on a minor note it is actually the age of ''slum'' (non-plural), i wonder whether this is down to a grammar error or if there is one ''slum of note''??– [[template:unsigned|unsigned]] comment by [[User:78.145.70.105|78.145.70.105]]

:From the [[string dump]], there is no "slum". Presumably, then, "slum" is the name of the dominant megabeast in your world. For example, if "Bob" the dragon was the dominant megabeast, it might be listed as the Age of Bob. You can confirm this in [[Legends mode]].--[[User:Loci|Loci]] ([[User talk:Loci|talk]]) 19:18, 26 August 2013 (UTC)

== Fast Progression? ==

After experimenting a few times with worldgen in the latest release, I found that usually after ~100 years on small worlds the age rapidly progresses through Legends and Heroes, sometimes all the way to Golden. I'm using medium everything except history length and size. Is this normal? It says here ("after 3.1") that it usually never gets past Myth. [[User:BaronNinja|BaronNinja]] 22:56, 25 February 2012 (UTC)

== Pocket world ==

This page makes references to Pocket worlds. What does that mean? It should be explained here.

:I've added a link to the World Size portion of World Gen in case someone has this question. [[User:Krenshala|Krenshala]] 01:27, 21 July 2012 (UTC)

== Draconic Ages ==

Despite the talk [[v0.31_Talk:Calendar#Draconic_Age|in the previous version]] about this topic, it seems odd that, while other beasts get referenced by name, Dragons don't. I think that it may be because of the kill list.

Currently (and as I can see with Legends Viewer and in Legends mode), there exists a single historic Dragon present in the world. I've had the fortune of capturing it (which means I might kill it for fun). Anyway... thinking the naming issue is related to it's kill list I can tell that he killed 47 historic (notable) and 27 animals (which isn't a grand kill list, although the dragon in question is entitled).

I've added the nuance at the main topic page because it doesn't match with the previous format. I would like to get more info about this.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 06:10, 3 February 2014 (UTC)

In all their grandeur, the dragon name is actually just a way to locate it in legend mode, as other than that, the name is of least importance for the game to reference, another reason is that a world there is usually only one dragon, and this maybe just easier to do,since even thou the age maybe called the age of the demon bathime, there is also three billion demons just below your feet. So it be easier to call it the age by the name instead age of the demon. See my point. This is Sbcc.

:But the fact remains that the behavior isn't constant, as seen in [http://www.reddit.com/r/dwarffortress/comments/1ehk2i/hit_the_draconic_age_in_a_worldgen_nothing_about/ this reddit] post, where a Draconic Age was achieved, a commenter then stated he had, and quoting "the Forest-Titan Age in one game and The Age of The Pride in another.", where the Pride refers to a giant roc. Hence the question remains, why some are named after race and others referred by name and others by title?--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 23:35, 6 February 2014 (UTC)

User talk:Loci

2014-02-06T22:33:23Z

Doktoro Reichard: /* Recent changes to the exploratory mining page */

I've been seeing your edits on the recent changes page for a while now. Good job. :-) [[User:Emufarmers|Emufarmers]] 08:22, 6 December 2012 (UTC)

Thanks for the information regarding creating new pages. I have removed my question from [[Dwarf Fortress Wiki:Centralized Discussion#Content|where I posted it]] and will add a Wiki Editing section to the [[Frequently Asked Questions|FAQ]]. [[User:13thEssence|13thEssence]] 00:30, 5 February 2013 (UTC)

==Creature Type Pages==
Are those supposed to be stub articles, or did you mean to create them as categories? --[[User:Quietust|Quietust]] 22:28, 19 December 2012 (UTC)

:Mainly I created them as stub articles so I would have somewhere to link the "interesting" attributes in the creature info box. That way the info box can just say "No Stun" with a link to more information if the user desires, but without cluttering up the info box with excessive common knowledge. While I also considered adding these tags as categories to the proper creature pages, I haven't put in the time to make that all work yet. --[[User:Loci|Loci]] 22:35, 19 December 2012 (UTC)

::Eh, I tried to set up categories for the various "interesting" attributes, but the creature pages would display the categories without actually being assigned to the categories. Presumably it was a problem with transclusion depth, or formatting, or something. Someone more familiar with the system could probably get it to work, but I didn't feel like spending any more time on the problem so I removed the categories. --[[User:Loci|Loci]] 12:39, 20 December 2012 (UTC)
:::That's because you were just inserting '''page links''' - if you wanted to put them in categories, you should've used <nowiki>[[Category:DF2012:whatever]]</nowiki> rather than just <nowiki>[[whatever]]</nowiki>. --[[User:Quietust|Quietust]] 13:52, 20 December 2012 (UTC)

::::Not quite. I actually had added the categories using the <nowiki>{{Category|foo}}</nowiki> template, but removed them because they didn't work. Your links aren't working for me, either. When I click on [[:Category:DF2012:Flying]], for instance, I get ''"This category currently contains no pages or media."'' If, however, I add the category template <nowiki>{{Category|Flying}}</nowiki> to a creature page directly, the creature shows up on the category page. However, I certainly don't want to modify each and every creature page individually, so any workable solution has to be based on a template transcluding data from the creature /raws. If the creature pages won't register in the categories, I'd rather have the links to the "stub articles" than links to non-functional categories. --[[User:Loci|Loci]] 14:24, 20 December 2012 (UTC)
:::::Using {{tl|Category|foo}} will include it in the category and {{tl|Catlink|foo}} will make an actual link appear on the page - if you want both to happen, then you need to use both of those (see {{tl|attrib proc}} which I just recently modified). --[[User:Quietust|Quietust]] 14:50, 20 December 2012 (UTC)

::::::If you click on [[:Category:DF2012:Flying]], you will find that the majority of creatures with flying are *not* currently included. This is exactly the same problem I ran into with my revision [http://dwarffortresswiki.org/index.php?title=Template:Attrib_proc&oldid=179580 179580], which looks remarkably similar to your revsion [http://dwarffortresswiki.org/index.php?title=Template:Attrib_proc&oldid=179609 179609]. In short, the creature pages show the category links, but aren't actually added to the category until the creature page is edited directly (the three flying creatures currently listed in the category have all been edited since your change). That means the categories won't be complete until *every* creature page with an ability has been edited (or the category lists are administratively regenerated), which is why I chose to revert the categories and just link to an ability page. --[[User:Loci|Loci]] 23:15, 1 January 2013 (UTC)

:::::::Well, it was empty... then when I edited [[Giant bat]] it was added to the category page (even though I didn't edit the creatureinfo box). I only added a sentence about how much [[fun]] giant bats are to see what would happen. Strange that just editing a page would add it to a category... --[[User:Lethosor|Lethosor]] ([[User_talk:Lethosor|talk]]) 02:47, 13 February 2013 (UTC)

::::::::Yep; that's exactly the problem I ran into. For a technical explanation: whenever a template is edited, the wiki software queues up jobs to automatically "regenerate" all the pages that include that template. As those jobs are processed, the pages should pick up new categories from the template. Unfortunately, the wiki software is not handling this specific case correctly--it appears that the raws are not being transcluded correctly during the regeneration, leading the conditional logic to conclude that no creature has the [FLIER] tag. When users edit the creature pages, though, the categories ''are'' regenerated correctly because the raws ''are'' transcluded correctly. I'm still looking for a solution to resolve the automatic regeneration problem, but since it only happens in the server's back-end processing it's hard to pin down. --[[User:Loci|Loci]] 08:47, 13 February 2013 (UTC)

::::::::: Wow, I just noticed you said pretty much exactly what I said in the post before. Anyway, I noticed [[Template:Creaturelookup/0]] is using "/raw" as the path to raws. Maybe the wiki software isn't resolving this path correctly (which could be hard to track down, like you said in the section below). --[[User:Lethosor|Lethosor]] ([[User_talk:Lethosor|talk]]) 21:04, 13 February 2013 (UTC)

== Regenerating cached categories ==

I will reset the caches this weekend. --[[User:Briess|Briess]] 09:48, 6 January 2013 (UTC)

:Thanks! --[[User:Loci|Loci]] 16:02, 6 January 2013 (UTC)

:It appears that the pages still aren't being categorized--the jobs are likely stuck in the [http://www.mediawiki.org/wiki/Manual:Job_queue Job Queue] (currently [http://dwarffortresswiki.org/api.php?action=query&meta=siteinfo&siprop=statistics 730 jobs] waiting). [http://www.mediawiki.org/wiki/Manual:RunJobs.php Manually running the queue] will hopefully put everything in the proper categories. --[[User:Loci|Loci]] 21:35, 7 January 2013 (UTC)
::I simply forgot to clear the appropriate caches. The full job queue is run on a scripting server every 30 seconds, that estimate is always wrong. --[[User:Briess|Briess]] 21:19, 10 January 2013 (UTC)
::For context, a single page rebuild creates about 100 jobs in the queue, so the expected number of jobs for this reset should be in the 10k-100k range. --[[User:Briess|Briess]] 21:20, 10 January 2013 (UTC)

:::Alright; sorry for the confusion. --[[User:Loci|Loci]] 21:43, 10 January 2013 (UTC)
::::No worries. The refresh cycle is running now and will take between 6-10 hours to complete. --[[User:Briess|Briess]] 21:45, 10 January 2013 (UTC)

Just an update - clearing the cache failed because of some silly issues with the way mediawiki creates jobs. We will need to null edit every page in order to get things working properly again. I will probably set up a bot to do this for us. --[[User:Briess|Briess]] 05:48, 11 January 2013 (UTC)

:That, sadly, does not sound like a very workable solution. When I changed the formatting in one of the templates, all the categories were emptied again. So all the creature pages would probably have to be null-edited again after every change to any template on the creature pages. Unless the bot can be fully automated, the categories are practically guaranteed to be incomplete. In light of these problems it would perhaps be best to scrap the categories entirely. --[[User:Loci|Loci]] 19:03, 25 January 2013 (UTC)
:: Let's not do that yet. I'm planning on upgrading mediawiki again shortly, and I believe there are fixes to this issue in newer versions of the software. --[[User:Briess|Briess]] 01:26, 26 January 2013 (UTC)

I did some experimentation on this problem; the automatic regeneration ''is'' running, but it appears that the creature raws are not being transcluded correctly during the regeneration, which prevents detection of the necessary tags. I believe the #df_raw function is not correctly returning the raws when executed from the context of the job queue process--is that something you could take a look at? Alternately, is this code available somewhere I could take a look at it? Unfortunately, since this is probably DFwiki-specific code, I doubt a Mediawiki update will fix it. --[[User:Loci|Loci]] 09:12, 13 February 2013 (UTC)
:[https://github.com/quietust/DFRawFunctions] is the repo. --[[User:Briess|Briess]] 06:34, 14 February 2013 (UTC)

::Thank you. While I don't see any significant problems in the code, I do see several paths that could lead #df_raw to return without the raws. You suggested above that the job queue is running on a separate server. Are the two config variables $wgDFRawEnableDisk and $wgDFRawPath setup correctly on this server? You might also try setting the correct values in DFRawFunctions.php directly, in case the global config values aren't being applied when the job queue is run. Whichever user is running to process the job queue needs to have read permissions to the raws directory and all files and subdirectories inside. That user may also need directory-list/execute permissions on those directories as well. --[[User:Loci|Loci]] 17:11, 14 February 2013 (UTC)

== Variations ==

Thanks for fixing up the issues with namespaces and large/gigantic variations (although I must admit, "Tis" is pretty interesting). I tried adding spaces to [[:Template:Creature/basename]], but I'm unsure if #mreplace is aware of spaces. It looks like the variations don't show up on [[DF2012:Giant mantis]] (although I neglected to see if they did before, but they probably didn't, since Giant mantis man and Giant giant mantis don't exist). The link is still incorrect on [[:Template:Creature/variation links]], however. Also, I created [[:Template:Creature/exists]] as a potential replacement for #ifexists (which is "expensive" - the examples at [[:Template:Creature/variation links]] list an expensive function count of 68/100). A DFRaw function should do the trick, but I have yet to find a working solution. The problem I ran into previously was how the raws of base creatures contain no references to variations. I suppose, as a workaround, we could have a script build a cache-type template (probably run outside of the wiki and generating template code), but it would likely break easily with updates and take up a lot of space for a template. --{{User:Lethosor/sig}} 22:55, 5 March 2013 (UTC)
:Note: [[DF2012:Giant tortoise man]] does display variation links, but none to itself. --{{User:Lethosor/sig}} 22:56, 5 March 2013 (UTC)

::I wouldn't worry about the expensive function count--each invocation only uses 4, but the 17 examples on the template page are the reason why that particular page is so high. In normal use, each creature page should only need 4 (actually 6 since creature/variation uses 2 as well). I have an idea to override the variations output which should make it possible to "special case" around the bugs. Really, "Large" and "Gigantic" could be handled as special cases too, since there are only a few of them. I'll see if I can get that working here shortly. --[[User:Loci|Loci]] 23:19, 5 March 2013 (UTC)

== Double Redirects ==

I'll take a look and see what broke there. It used to work properly but something got finagled at some point. --[[User:Briess|Briess]] 18:24, 10 March 2013 (UTC)

== Image Issues ==

Should be fixed now. Thanks for the heads up. --[[User:Briess|Briess]] 20:40, 2 April 2013 (UTC)

:Wow; that was fast! Thank you for your dedication to the Dwarf Fortress Wiki. --[[User:Loci|Loci]] 20:47, 2 April 2013 (UTC)

== Creature categories ==

In case you haven't noticed, the recent upgrade seems to have fixed the issue with the categories ([[:Category:DF2012:Exotic pet]] lists 273 creatures). --{{User:Lethosor/sig}} 12:58, 13 April 2013 (UTC)

:They worked briefly, but sadly they're now broken again in a new way: [[:Category:DF2012:Exotic pet]] currently includes [[Cat]], [[Dog]], [[Dwarf]], and all other creatures that use the attribute template. So we traded empty categories for incorrectly-filled categories, resulting in equally worthless information. --[[User:Loci|Loci]] ([[User talk:Loci|talk]]) 20:39, 13 April 2013 (UTC)
::Just a sec, I've started the repair process there -- for future reference, when this happens, just do a null edit of [[Template:Creaturelookup/0]] (that is, an edit that doesn't change anything), and the wiki software will automatically fix this, though it might take a little while (incidentally, it wasn't the update that fixed it, it was me, using this trick) --[[User:Zzedar|Zzedar]] ([[User talk:Zzedar|talk]]) 20:55, 13 April 2013 (UTC)
:::I also started rerunning all the category regeneration, so it should be super fixed. :) --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 21:00, 13 April 2013 (UTC)

:Excellent! That appears to have fixed it. I don't know why my change to [[Template:Attrib proc]] wouldn't cause the same regeneration, but I'm just glad to finally have useful categories. Now we finally have a list of all the critters with [[:Category:DF2012:Shell|shells]] and [[:Category:DF2012:Syndrome|syndromes]]. --[[User:Loci|Loci]] ([[User talk:Loci|talk]]) 21:17, 13 April 2013 (UTC)

== [[DF:Next]] ==

I have no idea why I created that. I might have thought it would be useful in a template, but right now it's only used on [[Special:WhatLinksHere/Dwarf_Fortress_Wiki:Next|2 content pages]]. The only reason I can think of is that it could help detect things that need updating once the next version is actually released, but that can probably be accomplished with a search. Personally, I agree that "the next version" is clearer than "DF2013". --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:36, 4 December 2013 (UTC)

== Recent changes to the exploratory mining page ==

(Recent changes page lurker) Why did you remove the reference to the "Pinwheel Shafts" from that page? Seemed quite appropriate and non-harmful. Also, if you could link any research you point out in the text (mainly about FPS death, which I believe should go to a new, separate section but within the same topic), that would be great.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 22:39, 5 February 2014 (UTC)

:Eh, that design was significantly similar to the mineshaft design, yet less efficient and did not provide 100% visibility. The only "claim to fame" listed was protecting against dwarves falling down stairways, an event so rare in this version that I've never even seen it happen. I didn't feel that the design was particularly clever, so I removed it from the page. If you are fond of it, feel free to put it back.

:[http://www.bay12forums.com/smf/index.php?topic=104643 This forum thread] was the source of my comment on FPS death. Specifically, [http://www.bay12forums.com/smf/index.php?topic=104643.msg3096896#msg3096896 blue sam3 notes that open space causes lag], and later on [http://www.bay12forums.com/smf/index.php?topic=104643.msg3403998#msg3403998 ghostwoods compares linear space to square space].--[[User:Loci|Loci]] ([[User talk:Loci|talk]]) 20:13, 6 February 2014 (UTC)

:: No, I'm not particularly fond of that design (I'm more of an organic development kind of fellow), but I do like to know why things that might have been good yesterday are deleted today, without any apparent reason (even in the changelog).
:: Also, I did read that post fully (it's even in my userpage due to the relevance). I would have to argue that just opening space by mining costs FPS. What does cost is, as I think you mentioned, the increased pathing calculations that results from the open space. That research also came a bit before the current DF2012 according to the [[Release information]] page. This being said, my main concern about that part is that FPS death is a diagonal subject to Exploratory mining and would deserve a section of its own, if enough relevant information is present in the page.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 22:33, 6 February 2014 (UTC)

Grazing

2014-02-06T19:15:07Z

Doktoro Reichard: Redirected page to DF2012:Grazer

#REDIRECT [[cv:Grazer]]

v0.34:Grazing

2014-02-06T19:11:47Z

Doktoro Reichard: Redirected page to DF2012:Grazer

#REDIRECT [[DF2012:Grazer]]

v0.34:Grazing

2014-02-06T19:11:18Z

Doktoro Reichard: Redirected page to DF2012:Pasture

#REDIRECT [[DF2012:Pasture]]

User:Doktoro Reichard/Sandbox

2014-02-06T19:06:49Z

Doktoro Reichard: testing a redirect bug with grazer page

#REDIRECT [[cv:Grazer]]

Talk:Main Page

2014-02-06T17:15:16Z

Doktoro Reichard: /* Amount of double redirects or how to fix them? */ new section

{{Archive|
# [[Talk:Main Page/archive1|Archive 1]]
# [[Talk:Main Page/archive2|Archive 2]]
# [[Talk:Main Page/archive3|Archive 3]]
}}

== Thread links on Main Page ==

Hi There - I'm relatively new to the DFwiki, and I noticed that some of the thread links on the Main Page don't work correctly. I logged in to try and edit the page, but when it wasn't an available option, I realized that it is probably restricted to administrators, given the 'please report vandalism' thing in the site announcements header.

The Team17 forums have closed, so the Team17 link is a dead one.
The SomethingAwful.com forums link is behind a login wall, so I'm not sure if you would want to remove this as well? I believe that they do occasionally rotate forums (such as Games) to be available to non-logged in users though, so it would perhaps be available intermittently.
:*<s>[http://forum.team17.com/showthread.php?t{{=}}30824 Team17 Forum Thread]</s>
:*<s>[http://forums.somethingawful.com/showthread.php?threadid{{=}}3466523 Something Awful]</s>
:Agreed and removed. Thanks! --[[User:Loci|Loci]] ([[User talk:Loci|talk]]) 20:02, 15 August 2013 (UTC)

== Fun Comic ==

What happened to the Fun Comic at the Losing page?--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 21:22, 23 January 2014 (UTC)

:Weird. We had a problem with an image server a while back, so this may be related. I'll get Briess to check on it. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:26, 23 January 2014 (UTC)

::Good to know (and to help). In case the file's lost, there's a crawl of it at the [https://web.archive.org/web/20130512135455/http://dwarffortresswiki.org/images/4/40/FunComic.png Internet Archive]. I also observed similar problems over at the [[Dwarf Fortress webcomics]] page.--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 21:29, 23 January 2014 (UTC)

:::[[:File:Comic df3.png]] doesn't have an edit history ([http://dwarffortresswiki.org/index.php?title=Comic_df3.png&action=history]), which usually means that it hasn't been uploaded, although that could be incorrect. Same for the rest of them, except [http://dwarffortresswiki.org/index.php?title=File:FunComic.png&action=history FunComic.png]. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:34, 23 January 2014 (UTC)
::::I'm rebuilding all the images now. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 21:54, 23 January 2014 (UTC)
::::The problem should now be fixed. It appears any time one of the webnodes loses a connection to the image server, it starts invalidating the images in question. I'll investigate ways to automatically rebuild the images when that happens. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 22:02, 23 January 2014 (UTC)

== Amount of double redirects or ''how to fix them?'' ==

I come across several cases of double redirection which, as stated both here and in the rest of the wikiverse, are not a good thing to have.

Recently I found about the [[Special:DoubleRedirects]] page. There are roughly 350 double redirects on the wiki. From experience here, they could be easily fixed, because most redirect to the alternate name of the page, instead of the proper page itself.

As I've been adverted slightly due to a wrong fix I did I ask now if there are a set of guidelines, particularly because of the namespace usage here, that are or can be used to begin a duplicate removal process (which as stated, would be a mostly trivial thing to do, albeit costly in time).--[[User:Doktoro Reichard|Doktoro Reichard]] ([[User talk:Doktoro Reichard|talk]]) 17:15, 6 February 2014 (UTC)

v0.34:Losing

2014-02-06T17:03:40Z

Doktoro Reichard: /* Have I Won Yet? */ - fixing plural of colossus

{{Quality|Exceptional}}
{{D for Dwarf}}
{{av}}

Losing is fun!

Either way, it keeps you busy.

There is no internal end point, single goal, final Easter egg or "You Win!" announcement in Dwarf Fortress. Therefore, eventually, almost every fortress will fall. The only ones that don't tend to be very conservative and very boring—and what fun is that? Therefore, DF = losing ∧ DF = fun ⇒ losing = fun, and that's okay! It's a game philosophy, so embrace it, own it, and have ''fun'' with it!

Most new players will lose their first few forts sooner rather than later; when you lose a [[fortress]], don't feel like you don't understand the game. Dwarf Fortress has a steep learning curve, and part of the process (and fun!) is discovering things for yourself. However, this Wiki serves as an excellent place to speed up the learning process.

If you lose, you can always [[reclaim fortress mode|reclaim fortress]] or go visit it in [[adventurer mode]].

If you're looking for more ways to <s>lose horribly</s> test yourself, try either the [[mega construction]] or the [[Challenges]] articles.

[[File:FunComic.png|thumb|right|Fun in Dwarf Fortress]]

== Autopsy, or why your fortress died ==

Various common things can cause the death of a fortress. Let's examine some together...

===Dwarf vs. Wild===
Sometimes the wilds take you out.

====Local Wildlife====
Goblins aren't the only creatures that want you dead. [[grizzly bear|The]] [[elephant|obvious]] [[cougar|threats]] aside, some [[creature]]s with benign [[unicorn|natures]], [[carp|names]], or [[giant sponge|descriptions]] can be surprisingly deadly. A sudden wildlife attack can quickly cripple or destroy an unprepared fortress. Before you unpause a new game for the first time, hit {{k|u}}nits, and switch to the "Others" tab to see what's sharing your map. Learn to do this regularly—new creatures will frequently migrate onto your map and then off again to be replaced by others.

Consider arming up and thinning out any predictable threats.

Outdoor [[titan]]s and other [[megabeast]]s are a later stage hazard.

====Underground Life====
Underground life can be even more dangerous than surface life. Dig down to a cavern, and expect to be fending off hordes of smaller, weaker creatures as well as larger, more solitary creatures like [[giant cave spider]]s and [[blind cave ogre]]s. Arming up helps a lot, as there is usually only a small entrance they can get in by. A row of cage traps is exceptionally powerful there.
Underground Forgotten Beasts are a later stage hazard—and one that cage traps will offer very little protection against. Even if all the other creatures in the cavern are stopped by your cage traps, don't allow yourself to become complacent.

====Magma and its denizens====
[[Magma]] by itself is dangerous enough to destroy a fortress that fails to contain it properly, but magma sources are also home to [[fire imp|many]] [[fire man|dangerous]] [[magma crab|creatures]] that can destroy buildings, kill even the most skilled soldiers, and spread destruction throughout your fortress. While careful designs using [[fortification]]s, [[magma-safe]] [[floor grate]]s, and [[magma-safe]] [[bridge]]s can mitigate much of the danger, magma remains a prime source of [[fun]] even in experienced fortresses.

====Evil Biomes====
Evil [[surroundings]] are more inhospitable than ever. If it's not the [[Undead|zombies]] that kill all your dwarves, then it's their freshly animated body parts hungry for revenge. Or vile weather that makes dwarves caught in it vomit to death. Or, worst of all, an evil cloud that drifts by your settlement and starts a zombie plague in your population.

When embarking on an evil biome, it's a fairly good idea to skip a [[meat industry]] of any kind. Though meat obtained from [[butcher|butchering]] doesn't rise up, hair, skin and bones are fully capable of turning to kill you - and bringing [[hunter]]s in your party is near-suicidal. Embarking with a [[military]] is a must, if you want to stand any chance against the zombies. Of course, if things are ''really'' bad outside (for example, the aforementioned thralling clouds), you're best off just sealing yourself inside forever and never turning back. As with cavern wildlife, a row of [[cage trap]]s is a great boon to the safety of your fortress.

===Dwarf vs. You===
Sometimes you bring it on yourself.

====No Food====
A serious danger, generally in the more inhospitable [[climate]]s, is the loss of your [[dwarf|dwarves]] due to starvation. As dwarves begin to starve, they will become [[hungry]], then [[starving]]. This will cause them first to slow down all work, and then to become very [[unhappy]]. When they die, their friends will become upset and will become even more unhappy, potentially causing the remainder of your fortress to break out in a [[tantrum spiral|terminal hissy fit]].

Don't forget your alternative sources of [[food]]. If your [[farm]]s aren't doing the job and a [[caravan|trade caravan]] is months away, try [[butcher]]ing your [[domestic animal]]s, [[plant gathering|gathering plants]], [[hunting]] local wildlife, and [[cook]]ing any excess [[alcohol]].

====No Booze====
Equally as bad is no [[alcohol]], which dwarves ''require'' to be happy and productive. Some alcohol can be acquired from [[caravan]]s, but not enough for an entire fort until the next caravan arrives. You must gather or [[farm]] certain plants to then [[brew]] those in a [[still]] with an empty [[barrel]]—it's just part of being a dwarf. Be sure to make lots of barrels. Often a shortage of barrels is just as bad as a shortage of beer. A dwarf would rather die than lower themselves to drinking from a [[mug]] (though it doesn't stop them being produced by the tonne in your [[workshop]]s).

====Water====
Sometimes you just can't help but take a drink, and when you think it's safe, WHAM. Watch out for [[giant sponge]]s...

=====No water=====
Healthy dwarves will not die of thirst as long as they have alcohol, which in the current version can be [[Brewing|brewed]] without the use of water. However, injured dwarves must be given water, not alcohol, or they will die of dehydration.

[[Rain]] will refill stagnant [[pool]]s of water slowly. In a hot [[climate]], this may evaporate almost immediately. What's more, if the map is in a dry [[climate]], such as a desert (hot or cold), then there can be long periods of time with no water anywhere - in extreme cases, none ever. Snow will not refill pools, so you can also have a lack of water in very cold [[climate]]s. Also, if weather has been turned off in the [[init.txt]] file then there will be no rain and no water will accumulate, though it may be there at the beginning of the game.

If all else fails, the [[caverns]] may contain water somewhere, so you can put down a [[well]]. Watch out for [[Giant toad|other]] {{catlink|Humanoids|sources}} [[Cave crocodile|of fun.]]

=====Too Much Water (aka "Flooding accidents")=====
The opposite side of the dehydration spectrum is having too ''much'' water. Remember that water can [[flow]] in 10 directions (the 8 horizontal ones as well as down, and up to the level of its source.)

If your fortress is beginning to flood from [[Water#Sourced Water|sourced water]], abandon all of the levels the water can reach immediately—create a [[civilian alert]] and order your dwarves to a burrow upstairs. You will never be able to recover those areas unless you can manage to [[pump]] out the water faster than it floods in, which can take over a year or two of game time to establish a functioning automated pump system. Generally, a flooding accident spells doom for your fortress.

If the accident is causing your mine shafts to flood (those fishy diagonal flows into downstairs on the level below), you can sometimes save the dwarves that are working inside it: designate the highest level they can reach before the water reaches it with your civilian burrow. Try to dig your way up from there, since the water will take some time to fill the lower floors, and keep updating your burrow definition to the higher floors. Saving your valuable Legendary +5 Miners (and their picks) could be vital to your fortress.

Sometimes, a fortress is flooded with [[magma]]. This is even more [[fun]], and even harder to recover from. Magma doesn't rise as aggressively (via [[pressure]]) as water, and can be [[pump]]ed out with [[magma-safe]] equipment. Read up on it. Good luck.

==== Inability to mine ("Diggor Mortis") ====
i.e., no [[pick]]s.

Diggor Mortis: ''when a Dwarf with a pickaxe decides that digging where they shouldn't is a bloody good idea.''

Simply put, you need [[pick]]s to mine [[ore]], which is then [[smelting|smelted]] to make [[metal]] for items like more picks. If you are careless (or ignorant) of how to dig safely, and your [[miner]]s create a [[cave-in|collapse]] or flood and their equipment gets lost/destroyed/unrecoverable, ''and'' you have no materials to make more picks, you will be at a severe handicap until the problem is solved. Any dwarf can be given the [[mining]] [[labor]], but without a pick they can do nothing. There is no way to get new metals or stone (clay excluded) for any purpose (except from foreign traders and smelting other items) nor any way to dig new rooms/tunnels unless you have picks.

If you have [[ore]] or [[bar]]s to create a [[Arms industry|weapons-grade metal]] (other than silver), and a [[forge]] (and [[smelter]] if you need one), you can create new picks and continue. In a pinch, you can even [[melt]] other metal objects for metal. You might get lucky with a [[caravan]] - elves never carry picks, but humans sometimes have bronze ones, and dwarves generally bring some along. If the first dwarven caravan doesn't bring any, you can try to keep your fortress running long enough to request additional [[pick]]s from your [[outpost liaison]], who will arrive with the next dwarven trade [[caravan]] in a year. Or you can [[abandon]] and try again.

If you have [[axe]]s and [[tree]]s available, then you can build [[construction|structure]]s, [[building]]s and [[furniture]] of [[wood]], which is something.

Averting this fate is simple: stockpile at least one additional pick at the first possible opportunity, or some of the [[Metal#Weapon_and_armor_quality|raw material]] to make more, and away from current digging operations.

See also: [[Arms industry]]

===Dwarf vs Society===
Sometimes your traditions and morals conspire. Hell Is Other Dwarves?

====General Unhappiness====
Think it's no big deal to leave your dwarves with a mediocre [[dining room]], no-[[quality]] bed and a generally inadequate fortress?

If there is little in a fortress to give your dwarves happy [[thoughts]] and enough to give them unhappy [[thoughts]], then your dwarves will start to throw [[tantrum]]s, grow melancholy, and/or cause general chaos. In extreme (but sadly not ''rare'') examples, this can lead to a [[tantrum spiral]] and the loss of the entire fortress. Immigrants are typically [[marriage|married]], often with [[children]] in tow, and are primed and ready to start pumping out even more babies. This means that the loss of one dwarf is likely to lead to a whole family of very unhappy dwarves, and potentially a tantrum spiral. Unhappiness is more likely to occur if your fortress is suffering other kinds of downfall as well, so try to keep all the bases covered.

Another problem is if you don't have a [[justice]] system in place at the time of a spiral and manage to recover. If you later implement the justice system, the hammerer may kill the former tantrum throwers, starting another tantrum because of their deaths.

====Mandates====
While it doesn't happen often, those [[Noble]]s' mandates can occasionally cause your fortress to come to a halt, especially if they decide to imprison a dwarf that's fairly essential to your fortress, or if they for some reason decide that a dwarf deserves a hammering. This can lead to your dwarf's death, which, as noted above, can cause a tantrum spiral.

Then, there's also points at which, when trying to fulfill a mandate, you run into some rather nasty problems. This could lead to any of the other problems, such as a cave in killing your miner (If you're not paying attention!) running into HFS, or accidentally mining out a new tunnel to the surface that you don't close, and lets in a horde of goblins.

====Supernatural Rogues====
With DF2012 have come the additions of several [[night creature]]s that can potentially undo a fortress from within. A werebeast raid can not only bring trouble if you're lacking of a military, but its cursed bite can make more of its kind from your population. If you see a civilian survive a werebeast attack, you might be in for a surprise when he suddenly turns into a ravenous monster at the full moon and starts killing everything around him.

Vampires are a much more insidiously dangerous threat, as they hide themselves among the peasantry and may kill dozens of dwarves without being caught—and if they do, they might succeed at framing an essential member of your fortress into getting the hammer. As can be seen, this can easily lead into a tantrum spiral.

===Dwarf vs Goblins, Humans, Elves...===
Seizing goods from a friendly caravan will often lead to large shipment of fun next time the traders visit. Remember, it's not paranoia if they ''are'' out to get you.

====Ambush====
Goblin and elven [[ambush]]ers alike will infiltrate your map and charge into your fortress after they are discovered. They will retreat after suffering enough casualties or waiting around several seasons. Elves still arrive with caravans, and goblins can attack at any time. Even if your dwarves do not venture onto the surface, caravans will eventually trigger the ambushes.

See Also:
:* [[Defense guide]]
:* [[Defense design]]
:* [[Trap design]]
:* [[Military design]]

====Siege====
[[Siege]]s can be quite devastating to a fortress, but unlike most of the other ways of losing, they are unlikely to occur early on, even if you do something stupid to piss off another civilization.

Should hosts of goblins besiege your gates and drive your peasantry inside, trolls beat down your doors and force you to seal off from the outside world, you may have already lost the game. Even if you have built an utterly impenetrable fortress with drawbridges and moats, a sieging army may stick around for a long time. Although a dwarven fortress can be made self-contained, with [[list of crops|crops]], [[metal]] and [[fuel]] readily available, underground [[tree farm|wood source]] and your own [[livestock]], a fortress may not be able to sustain such a state indefinitely.

For example, [[trade]] with the outside world has now been shut off, leaving you only what [[ore]]s are on your map for the production of mandated goods. In the (very) long run even those will run out. This can result in a breakdown of social order if you do not prevent your [[Hammerer]] from killing or maiming your dwarves. [[Shell]], [[bone]] and [[leather]] commonly acquired by [[hunting]] and [[fishing]] need to be supplied by previously established livestock and access to suitable water. If these resources are no longer available to your workers, moody [[craftsdwarf|craftsdwarves]] will be driven into suicide or worse. Rotten [[vermin]] [[corpse]]s begin to heap in your food supply, forcing you to dump these into inside [[refuse|refuse pile]]s, generating [[miasma]]. Better build indoor refuse piles away from trafficked areas. Unless an [[well|interior water supply]] was established (or you find water in caverns) your wounded will die of dehydration.

With all these critical industries unproductive, dwarves dying, and friends mourning over the rotting heaps of slain loved ones, it's important to remember your dwarves have nothing to do but throw funeral receptions, hold grief counseling sessions and host the occasional keg stand. This means they've all become one big happy family of friends, manically depressed from the loss of any dwarf.

In short, the attacking army can simply wait until your dwarves emo themselves to death.

====Hidden Fun Stuff====

Hidden fun stuff awaits those who delve too deeply and too greedily. Due to the concentrated amounts of [[fun]], HFS has been the downfall of many a fortress.

===Dwarf vs. Player ===
Mod too much and the human caravan that comes in could spontaneously combust. Or just crash your game.

===Dwarf vs. Boredom===
Sometimes a fort's downfall comes not from fire and [[Fun]], but by the player deciding that enough's enough, and it's time to give in.

====Have I Won Yet?====
Even the most well-managed of forts will eventually fall. And if they don't, then what? Once you've fended off [[goblin]]s, [[bronze colossus|bronze colossuses]] and [[HFS|other fun things]], what's left to challenge your might defenses and legendary champions?

Eventually boredom takes its toll and you either hit abandon, or ease up on the impregnable defenses and effectively engineer your own doom.

====The Tantrum Fizzle====
So your dwarves are too busy punching each other to do any work, and the casualties are mounting while the goblins just point and laugh. Think the final chapter of your fort's saga will be a short one? Don't be so sure. Sometimes a little old-fashioned anarchy is enough to cripple a fortress, but not destroy it.

With good defenses and enough supplies, a well-managed fortress can run quite a while without any player input. And when you find this out the hard way, a few in-game months of fistfights might not be entertaining enough to offset the fact that you're not able to actually DO anything. If things don't calm down (or explode hilariously) soon enough, that "abandon fort" option will look awfully tempting...

{{Category|Guides}}

User talk:Loci

2014-02-05T22:39:40Z

Doktoro Reichard: /* Recent changes to the exploratory mining page */ new section

Military screen

2014-02-05T19:56:45Z

Doktoro Reichard: fixing redirect

#REDIRECT [[cv:military interface]]

v0.34:Underworld

2014-02-04T05:54:58Z

Doktoro Reichard: /* Hell itself */ - Adding "factual" information about Eerie Glowing Pits.

{{av}}{{Quality|Exceptional}}
{{spoiler}}

==Reaching Hell==
Upon digging sufficiently deep (usually z-level ~160, but it can vary wildly) you will find huge magma lakes. These are surrounded by semi molten rock, which cannot be cleared by digging but seems otherwise stable. Eventually, you will reach a layer which contains nothing but molten rock and little to no possibilities to pass. You can reach the critical layer by digging through solid rock which gets rarer the deeper you dig. There are three ways through the impassible layer:

'''Digging through an adamantine vein:''' [[raw adamantine|Adamantine]] veins are shaped like vertical tubes and breach through any layer of semi-molten rock, right down into Hell. The lower layers of the vein are often hollow and act as a tube, leading straight to your doom. Breaching into the hollow center of a vein has the same effect as breaching into Hell, so beware. You could easily dig around the hollow core provided you knew where it was, but every vein's hollow center is located a different height - the risk is all part of the [[fun]].
Note that adamantine veins always seem to end in mid air, so once you breached the final layer you face a horde of demons which hovers directly below your feet.

'''Entering a demonic fortress:''' These fortresses are found once per map tile, as frequent as the old [[40d:Eerie glowing pit|eerie glowing pits]]. They also go right through to Hell, however they are defended by undead creatures and demons on the lower levels. [[Demonic fortress|See the full page for more details]].

'''Tunneling through semi molten rock:''' A new method has been discovered that allows your dwarves to engineer a convoluted system involving controlled cavern collapsing and exploiting the odd behavior of a [[semi-molten rock|magma flow]] tile. Not only does it allow access to Hell, you can further exploit the Magma Flow tile to dig through Eerie Pits, duplicate any type of stone (including raw adamantine) and [[Slade|mine slade]]. The whole thing is documented and explained in this [http://www.bay12forums.com/smf/index.php?topic=108189.0 Forum Thread].

==Hell itself==

[[File:eerie_cavern.png]]

You will receive the above announcement upon piercing Hell. One frame later, you will get a second announcement: "Horrifying screams come from the darkness below!" At this point a massive number of [[demon]]s will be spawned - though the number is not fixed, the demons will likely fill many pages on the Units screen. You'd do well to prepare for the worst. If there are multiple adamantine pillars present on the map, only one will trigger the invasion when breached. Thus, it's possible to descend into Hell 'safely' if you guess a right pillar.

Hell takes the shape of a large open cavern made of [[slade]]. It expands out in all directions without bound with a height varying between 1 and 4 z. Its rough floor slopes up and down, making it possible to walk around and explore should you get an adventurer down there. In the floor are glowing cracks that shine purple light up into the main cavern of Hell - whence comes this light, mortal minds dare not speculate.

Those cracks are referred to in-game as an Eerie Glowing Pit. They are, as the name says, pits - falling into them is deathly, as it sends any creature (and item) to an unknown realm (short story, they die). As such, some precaution should be taken when engaging enemies near them, as they usually charge against any creature near them. Floors can be built over them. Deconstructing them will reveal the pits.

In Hell proper, demons spawn on the edges much like animals do on the surface; demons thus spawned will be content to meander Hell without going out of their way to extinguish all life they can reach. It is yet unclear whether the number of demons is finite; in information exported from the legends screen, the population of demonic species is listed as "unnumbered," a descriptor usually reserved for ants, worms, and other omnipresent vermin.

If you dig down through a hollow adamantine pillar, but had previously blocked off the particular hallway with a drawbridge and raise it, you can discover the location of all adamantine on the map with no negatives.

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

Eerie glowing pit

2014-02-04T05:26:08Z

Doktoro Reichard: fixing redirect

#REDIRECT [[cv:Hell]]

Body part

2014-02-04T04:28:48Z

Doktoro Reichard: fixing redirect

#REDIRECT [[cv:Body_parts]]

File:Barony appointment.PNG

2014-02-04T00:44:54Z

Doktoro Reichard: (adding more text)

This picture details the process by which a colony becomes a barony. The first action an outpost liaison does after the mayor interacts with the liaison is the one on the top. Selecting the first option will entail (after some time) the 2nd screen, where you can pick from a list of candidates. You can pick any number of candidates.
Some time after the liaison leaves, the colony is promoted to barony.

After the promotion takes place, and in the next year (assuming your fortress follows all requirements), it will show the last screen.