Dwarf Fortress Wiki - User contributions [en]

Alcohol

2017-12-30T14:51:03Z

Sasf54: Added brewer input stockpile helper page which helps setup the brewery input stockpile

{{Quality|Exceptional|19:04, 26 July 2014 (UTC)}}
{{av}}

[[File:Thirsty Dwarves.gif|thumb|right|A booze [[stockpile]] at work.]]
'''Alcohol''' is the favored drink of the [[Dwarf|dwarves]]; a dwarf will drink booze an average of five times per [[calendar|season]] to satisfy their [[thirst]], and although they can subsist on [[water]], without booze they will work increasingly slowly. Dwarves like to have some variety in what they drink, and will garner a bad thought if they are forced to drink the same variety of drink repeatedly ("has been tired of drinking the same old booze lately"). Every dwarf likewise has [[preferences]] for various types of drinks, starting hidden and then appearing as each type of drink becomes known to your fortress. Thus alcohol is important both for maintaining your fortress (at a minimum) and (with some investment in variety) for keeping your dwarves happy.

== Acquisition ==
Most of the [[crop|plants]] in the game can be turned into drink, and thus most drink is sourced from dwarven [[farming]], both indoor and out. Most of the plants [[plant gathering|gathered]] from the wild can also be used for brewing, but the reduced yields relative to farming makes it a less ideal solution. Drinks can be sourced at [[embark#supplies|embarkation]], and taking at least a few barrels with you is recommended to hold your initial dwarves over until you can build a [[still]]. [[Caravan]]s always bring some drinks along as well, although not enough to support a reasonably large fortress. Finally, [[honey]] acquired through [[beekeeping industry|beekeeping]] can be brewed into alcoholic mead, the only form of drink that is not derived from plants.

The most direct way to acquire the booze itself is through a [[still]]; large fortresses will usually have one or more dedicated [[brewer]]s keeping the dwarven drinks cellar well stocked. To brew a drink a dwarf will need an empty watertight container of some kind (either a [[barrel]] or a [[large pot]]) and a [[stack]] of brewables. Each brewing job produces five units of alcohol per brewable item and deposits the alcohol in the container, recovering any plant [[seed]]s in the process. The size of a stack does not affect how long it takes to brew it, which is based entirely on the brewer's [[skill]], making brewing jobs performed on large stacks much more efficient than those done on individual consumables. Stacks of alcohol do not have quality levels, and the strength of a happy thought obtained by drinking alcohol is based entirely on the value of the drink (including the stack size) and the dwarf's personal preferences.

== Mechanics ==
Dwarven thirst is constrained by the important {{token|ALCOHOL_DEPENDENT}} [[creature token]], which causes them to suffer severe performance penalties when deprived of alcohol. "Dry" dwarves increasingly lose [[gait|walking speed]] and [[Combat#Attack_Speed|attack speed]]. Alcohol withdrawal appears in the dwarf's thoughts and preferences as "starting to work slowly due to its scarcity" after 3 months, "really wants a drink" after 6 months, "has gone without a drink for far, far too long" after 9 months, and finally "can't even remember the last time he/she had some" after an entire year. Precisely how much dwarves trudge their feet due to alcohol withdrawal is unknown.

While dwarves rely on alcohol from the moment they are born, creatures of ''any'' race who are exposed to enough combat to become fully hardened ("doesn't really care about anything anymore") will also become alcoholics. All creatures can theoretically survive drinking nothing but alcohol for their entire lives, though they may be subject to [[#Alcohol poisoning|alcohol poisoning]] due to not having the same tolerance level as dwarves. Neither dwarves nor any race of creature will accept to drink alcohol if resting in a [[hospital]], and must instead be given fresh water until they recover.

[[Vampire]] dwarves are just as alcohol-dependent as the mortal kind. Despite this, in Fortress Mode, they will only ever drink [[blood]], ensuring they eventually suffer withdrawal even if your pantry is stocked to the brim with every beverage imaginable.

Setting booze on [[fire]] will not cause it to explode, but exposing it to high [[temperature]]s ''will'' cause it to boil away. If the container is flammable, it (and, subsequently, the booze) will be consumed by fire; [[magma-safe]] containers would never be destroyed by [[magma]], but any booze inside will likely quickly perish due to heat transfer (unless the container is made of [[nether-cap]]).

Alcohol, like all other liquids, does not have a quality modifier. The level of happy [[thought]] generated by drinking a [[preferences|preferred]] alcohol is dependent upon the value of the entire stack of alcohol.{{cite forum|120870.msg3901346#msg3901346}})

Dwarves prefer drinking alcohol out of a [[Finished goods#Goblets|mug, cup, or goblet]] and will receive an unhappy [[thought]] for drinking alcohol without one of the three. These may be placed in [[coffer]]s in designated [[tavern]]s. Visitors will drink alcohol too.{{version|0.42.01}}

=== Alcohol poisoning ===
{{new in v0.42}}

Over-consumption of alcohol can lead to harmful syndromes, progressing to inebriation, unconsciousness, and death. Each species has its own tolerance level (dwarves being higher than average) and each individual will consume more or less according to their [[need]] to drink. Mysterious deaths in your taverns are most likely cases of acute alcohol poisoning. Note that the lethal effects of alcohol poisoning is caused by impairing the function of a creature's lungs, making creatures that lack lungs, or the need to breathe, immune to death from alcohol poisoning.

== Types of Alcohol ==
{|style="margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;" width="90%" class="wikitable sortable"
|- style="background:#F2F2F2;text-align:center;"
!style="border:1px #AAA solid;padding:0.2em;"|Ingredient
!style="border:1px #AAA solid;padding:0.2em;"|Beverage Produced
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Beverage Value
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Type
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Source
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Plump helmet]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|rowspan="44" style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pig tail]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Ale
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cave wheat]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sweet pod]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Rum
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Muck root]]
|style="border:1px #AAA solid;padding:0.2em;"|Swamp Whiskey
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bloated tuber]]
|style="border:1px #AAA solid;padding:0.2em;"|Tuber Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Prickle berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Prickle Berry Wine
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Longland grass]]
|style="border:1px #AAA solid;padding:0.2em;"|Longland Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rat weed]]
|style="border:1px #AAA solid;padding:0.2em;"|Sewer Brew
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Fisher berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Fisher Berry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rope reed]]
|style="border:1px #AAA solid;padding:0.2em;"|River Spirits
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sliver barb]]
|style="border:1px #AAA solid;padding:0.2em;"|Gutter Cruor
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sun berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Sunshine
|style="border:1px #AAA solid;padding:0.2em;"|5
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Whip vine]]
|style="border:1px #AAA solid;padding:0.2em;"|Whip Wine
|style="border:1px #AAA solid;padding:0.2em;"|3
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Beet]]
|style="border:1px #AAA solid;padding:0.2em;"|Beetroot Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Wild carrot]]
|style="border:1px #AAA solid;padding:0.2em;"|Carrot Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cassava]]
|style="border:1px #AAA solid;padding:0.2em;"|Cassava Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Parsnip]]
|style="border:1px #AAA solid;padding:0.2em;"|Parsnip Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Potato]]
|style="border:1px #AAA solid;padding:0.2em;"|Potato Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Radish]]
|style="border:1px #AAA solid;padding:0.2em;"|Radish Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sweet potato]]
|style="border:1px #AAA solid;padding:0.2em;"|Sweet Potato Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Turnip]]
|style="border:1px #AAA solid;padding:0.2em;"|Turnip Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Single-grain wheat]]
|style="border:1px #AAA solid;padding:0.2em;"|Single-grain Wheat Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Two-grain wheat]]
|style="border:1px #AAA solid;padding:0.2em;"|Two-grain Wheat Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Soft wheat]]
|style="border:1px #AAA solid;padding:0.2em;"|Soft Wheat Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Hard wheat]]
|style="border:1px #AAA solid;padding:0.2em;"|Hard Wheat Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Spelt]]
|style="border:1px #AAA solid;padding:0.2em;"|Spelt Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Barley]]
|style="border:1px #AAA solid;padding:0.2em;"|Barley Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Buckwheat]]
|style="border:1px #AAA solid;padding:0.2em;"|Buckwheat Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rye]]
|style="border:1px #AAA solid;padding:0.2em;"|Rye Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sorghum]]
|style="border:1px #AAA solid;padding:0.2em;"|Sorghum Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rice]]
|style="border:1px #AAA solid;padding:0.2em;"|Rice Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Maize]]
|style="border:1px #AAA solid;padding:0.2em;"|Maize Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Quinoa]]
|style="border:1px #AAA solid;padding:0.2em;"|Quinoa Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Kaniwa]]
|style="border:1px #AAA solid;padding:0.2em;"|Kaniwa Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pendant amaranth]]
|style="border:1px #AAA solid;padding:0.2em;"|Pendant Amaranth Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Blood amaranth]]
|style="border:1px #AAA solid;padding:0.2em;"|Blood Amaranth Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Purple amaranth]]
|style="border:1px #AAA solid;padding:0.2em;"|Purple Amaranth Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pearl millet]]
|style="border:1px #AAA solid;padding:0.2em;"|Pearl Millet Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[White millet]]
|style="border:1px #AAA solid;padding:0.2em;"|White Millet Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Finger millet]]
|style="border:1px #AAA solid;padding:0.2em;"|Finger Millet Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Foxtail millet]]
|style="border:1px #AAA solid;padding:0.2em;"|Foxtail Millet Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Fonio]]
|style="border:1px #AAA solid;padding:0.2em;"|Fonio Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Teff]]
|style="border:1px #AAA solid;padding:0.2em;"|Teff Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Apple]]
|style="border:1px #AAA solid;padding:0.2em;"|Apple Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|rowspan="32" style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Apricot]]
|style="border:1px #AAA solid;padding:0.2em;"|Apricot Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Banana]]
|style="border:1px #AAA solid;padding:0.2em;"|Banana Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bayberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Bayberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Carambola]]
|style="border:1px #AAA solid;padding:0.2em;"|Carambola Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cherry]]
|style="border:1px #AAA solid;padding:0.2em;"|Cherry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Custard-apple]]
|style="border:1px #AAA solid;padding:0.2em;"|Custard Apple Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Date]]
|style="border:1px #AAA solid;padding:0.2em;"|Date Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Durian]]
|style="border:1px #AAA solid;padding:0.2em;"|Durian Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Guava]]
|style="border:1px #AAA solid;padding:0.2em;"|Guava Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Lychee]]
|style="border:1px #AAA solid;padding:0.2em;"|Lychee Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Mango]]
|style="border:1px #AAA solid;padding:0.2em;"|Mango Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Papaya]]
|style="border:1px #AAA solid;padding:0.2em;"|Papaya Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Peach]]
|style="border:1px #AAA solid;padding:0.2em;"|Peach Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pear]]
|style="border:1px #AAA solid;padding:0.2em;"|Perry
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Persimmon]]
|style="border:1px #AAA solid;padding:0.2em;"|Persimmon Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Plum]]
|style="border:1px #AAA solid;padding:0.2em;"|Plum Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pomegranate]]
|style="border:1px #AAA solid;padding:0.2em;"|Pomegranate Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rambutan]]
|style="border:1px #AAA solid;padding:0.2em;"|Rambutan Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sand pear]]
|style="border:1px #AAA solid;padding:0.2em;"|Sand Pear Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Artichoke]]
|style="border:1px #AAA solid;padding:0.2em;"|Artichoke Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Tomato]]
|style="border:1px #AAA solid;padding:0.2em;"|Tomato Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Tomatillo]]
|style="border:1px #AAA solid;padding:0.2em;"|Tomatillo Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Passion fruit]]
|style="border:1px #AAA solid;padding:0.2em;"|Passion Fruit Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Grape]]
|style="border:1px #AAA solid;padding:0.2em;"|Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cranberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Cranberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bilberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Bilberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Blueberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Blueberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Blackberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Blackberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Raspberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Raspberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pineapple]]
|style="border:1px #AAA solid;padding:0.2em;"|Pineapple Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Strawberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Strawberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Honey]]
|style="border:1px #AAA solid;padding:0.2em;"|Mead
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;background-color:#dddddd"|Animal-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|}

== See also ==
* [[Thirst]]
* [[Crop]]
* [[Brewer]]
* [[Beekeeping industry]]
* [[DF2014:Alcohol plant stockpile|Brewery input stockpile helper page]]

{{Industry}}

Alcohol plant stockpile

2017-12-30T14:47:53Z

Sasf54: Created page with "This is a helper page, to help setup a brewery plant input stockpile. It has the same list as the df2014:Alcohol page, but it's ordered to make stockpile setup easier. ;p..."

This is a helper page, to help setup a brewery plant input stockpile.
It has the same list as the [[df2014:Alcohol]] page, but it's ordered to make stockpile setup easier.

;padding:0.2em; background-color:#cfc"|Plant-based
;padding:0.2em; background-color:#fcc"|Plant-based

== Types of Alcohol ==
{|style="margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;" width="90%" class="wikitable sortable"
|- style="background:#F2F2F2;text-align:center;"
!style="border:1px #AAA solid;padding:0.2em;width:200px;"|Stockpile middle menu
!style="border:1px #AAA solid;padding:0.2em;"|Stockpile name
!style="border:1px #AAA solid;padding:0.2em;"|Plant name
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Single-grain wheat
|style="border:1px #AAA solid;padding:0.2em;"|[[Single-grain wheat]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Two-grain wheat
|style="border:1px #AAA solid;padding:0.2em;"|[[Two-grain wheat]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Soft wheat
|style="border:1px #AAA solid;padding:0.2em;"|[[Soft wheat]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Hard wheat
|style="border:1px #AAA solid;padding:0.2em;"|[[Hard wheat]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Spelt
|style="border:1px #AAA solid;padding:0.2em;"|[[Spelt]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Barley
|style="border:1px #AAA solid;padding:0.2em;"|[[Barley]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Buckwheat
|style="border:1px #AAA solid;padding:0.2em;"|[[Buckwheat]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Rye
|style="border:1px #AAA solid;padding:0.2em;"|[[Rye]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Sorghum
|style="border:1px #AAA solid;padding:0.2em;"|[[Sorghum]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Rice Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Rice]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Maize Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Maize]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Quinoa
|style="border:1px #AAA solid;padding:0.2em;"|[[Quinoa]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Kaniwa
|style="border:1px #AAA solid;padding:0.2em;"|[[Kaniwa]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Pendant Amaranth
|style="border:1px #AAA solid;padding:0.2em;"|[[Pendant amaranth]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Blood Amaranth
|style="border:1px #AAA solid;padding:0.2em;"|[[Blood amaranth]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Purple Amaranth
|style="border:1px #AAA solid;padding:0.2em;"|[[Purple amaranth]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Pearl Millet Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Pearl millet]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|White Millet Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[White millet]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Finger Millet Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Finger millet]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Foxtail Millet Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Foxtail millet]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Fonio Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Fonio]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Teff Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Teff]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Beet Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Beet]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Wild Carrot Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Wild carrot]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Cassava
|style="border:1px #AAA solid;padding:0.2em;"|[[Cassava]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Parsnip Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Parsnip]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Potato Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Potato]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Radish Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Radish]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Sweet Potato Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Sweet potato]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Tomato Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Tomato]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Turnip Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Turnip]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Passion Fruit Vine
|style="border:1px #AAA solid;padding:0.2em;"|[[Passion fruit]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Grape Vine
|style="border:1px #AAA solid;padding:0.2em;"|[[Grape]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Cranberry Vine
|style="border:1px #AAA solid;padding:0.2em;"|[[Cranberry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Bilberry Bush
|style="border:1px #AAA solid;padding:0.2em;"|[[Bilberry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Blueberry Bush
|style="border:1px #AAA solid;padding:0.2em;"|[[Blueberry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Blackberry Bush
|style="border:1px #AAA solid;padding:0.2em;"|[[Blackberry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Raspberry Bush
|style="border:1px #AAA solid;padding:0.2em;"|[[Raspberry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Pineapple Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Pineapple]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Plump Helmet
|style="border:1px #AAA solid;padding:0.2em;"|[[Plump helmet]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Pig tail
|style="border:1px #AAA solid;padding:0.2em;"|[[Pig tail]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Cave Wheat
|style="border:1px #AAA solid;padding:0.2em;"|[[Cave wheat]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Sweet Pod
|style="border:1px #AAA solid;padding:0.2em;"|[[Sweet pod]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Muck Root
|style="border:1px #AAA solid;padding:0.2em;"|[[Muck root]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Bloated Tuber
|style="border:1px #AAA solid;padding:0.2em;"|[[Bloated tuber]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Prickle Berry
|style="border:1px #AAA solid;padding:0.2em;"|[[Prickle berry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Strawberry Plant
|style="border:1px #AAA solid;padding:0.2em;"|[[Strawberry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Longland Grass
|style="border:1px #AAA solid;padding:0.2em;"|[[Longland grass]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Rat Weed
|style="border:1px #AAA solid;padding:0.2em;"|[[Rat weed]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Fisher Berry
|style="border:1px #AAA solid;padding:0.2em;"|[[Fisher berry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Rope Reed
|style="border:1px #AAA solid;padding:0.2em;"|[[Rope reed]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Silver Barb
|style="border:1px #AAA solid;padding:0.2em;"|[[DF2014:Sliver barb]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Sun Berry
|style="border:1px #AAA solid;padding:0.2em;"|[[Sun berry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Whip Vine
|style="border:1px #AAA solid;padding:0.2em;"|[[Whip vine]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Artichoke Heart
|style="border:1px #AAA solid;padding:0.2em;"|[[Artichoke]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Grape
|style="border:1px #AAA solid;padding:0.2em;"|[[Grape]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Banana
|style="border:1px #AAA solid;padding:0.2em;"|[[Banana]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Carambola
|style="border:1px #AAA solid;padding:0.2em;"|[[Carambola]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Durian
|style="border:1px #AAA solid;padding:0.2em;"|[[Durian]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Guava
|style="border:1px #AAA solid;padding:0.2em;"|[[Guava]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Papaya
|style="border:1px #AAA solid;padding:0.2em;"|[[Papaya]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Custard-apple
|style="border:1px #AAA solid;padding:0.2em;"|[[Custard-apple]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Date
|style="border:1px #AAA solid;padding:0.2em;"|[[Date]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Lychee
|style="border:1px #AAA solid;padding:0.2em;"|[[Lychee]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Apple
|style="border:1px #AAA solid;padding:0.2em;"|[[Apple]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Apricot
|style="border:1px #AAA solid;padding:0.2em;"|[[Apricot]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|bayberry
|style="border:1px #AAA solid;padding:0.2em;"|[[bayberry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Cherry
|style="border:1px #AAA solid;padding:0.2em;"|[[Cherry]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Peach
|style="border:1px #AAA solid;padding:0.2em;"|[[Peach]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Pear
|style="border:1px #AAA solid;padding:0.2em;"|[[Pear]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Persimmon
|style="border:1px #AAA solid;padding:0.2em;"|[[Persimmon]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Plum
|style="border:1px #AAA solid;padding:0.2em;"|[[Plum]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Sand Pear
|style="border:1px #AAA solid;padding:0.2em;"|[[Sand pear]]
|-
|style="border:1px #AAA solid;padding:0.2em; background-color:#fcc"|Fruit/Leaves
|style="border:1px #AAA solid;padding:0.2em;"|Mango
|style="border:1px #AAA solid;padding:0.2em;"|[[Mango]]
|}

v0.34:Screw pump

2012-03-10T15:57:28Z

Sasf54: /* Notes */

{{quality|Masterwork|21:05, 26 April 2011 (UTC)}}
{{Machine_component|name=Screw pump|key=s|job=[[Pump operator]]
|construction=
* [[Block]]
* [[Trap component#Enormous corkscrew|Enormous corkscrew]]
* [[Pipe section]]
|construction_job=
* [[Architecture]]
* 1 of
** [[Carpentry]]
** [[Masonry]]
** [[Metalsmithing]]
|power=Needs 10 power.
}}
{{av}}

A '''screw pump''' is a small [[building]] that can lift liquids ([[water]] or [[magma]]) from one level below onto the same [[Z-level]] as the pump. It is two tiles by one tile in size, and it can be either manually operated by a [[dwarf]] with the [[pump operator]] job or by being [[power]]ed by [[water wheel]]s and/or [[windmill]]s.

The direction you want the fluid to travel must be chosen at the time of construction. Pumping only occurs in a straight line, and involves a total of 4 tiles in a row - the liquid source, two for the pump, and the output. The "rise" in levels occurs on the first tile, the intake side, from one level below up to the level of the pump*. Pumped fluids can and will flow immediately after being pumped, as normal for that fluid. Pumped fluids will have a [[pressure]] equal to the exit [[z-level]] - a pump never "forces" water to a higher [[z-level]] than the output tile.

:''(* A DF pump can best be imagined as a simple [http://en.wikipedia.org/wiki/Archimedes%27_screw archimedes screw].)''

[[Water#Salt Water|Salt water]] pumped through a pump will desalinate and become drinkable, but only if the cistern has never contained salty water. [[Water#Stagnant Water|Stagnant water]] pumped through a pump will become clean, letting dwarves drink it without getting an unhappy [[thought]] and letting [[doctor]]s clean [[wound]]s without causing an [[Health care#Infection|infection]]. As with desalination, this only works if the cistern has never contained stagnant water.

''For a basic overview of how the different machine parts work and work together, see [[machinery]].''

== Construction ==

Building a screw pump requires an [[Trap component#Enormous corkscrew|enormous corkscrew]], a [[block]], and a [[pipe section]]. The construction itself is completed in two stages. First a dwarf with the [[architect]] labor must design it. Then a dwarf (the same or a different one) with the appropriate labor must complete the building. This could be [[carpentry]], [[metalsmithing]], or [[masonry]], depending on the material of the block.

To select pump, use keys {{k|b}}-{{k|M}}-{{k|s}}. It's important to choose the proper orientation for your pump, where it will draw water from and where it will deliver the water. This is determined before placement with the {{k|u}}, {{k|m}}, {{k|k}}, or {{k|h}} keys, and the text at the top of the sub-menu will change to confirm your choice. The default (as shown above in the sidebar), "pumps from the north" (top). The ''light'' green X must be next to the liquid source and the ''dark'' green X is where the liquid exits the pump.

[[Image:Small pump.jpg|thumb|right|300px|'''Basic Side View of a Pump'''. This pump "pumps from the west", from left to right. The area to the right may fill to the top of that level, but no more (See [[pressure]]; see [[Screw pump#Pump Stack|Pump stack]]). Note that the entire space required is 4 tiles long by 1 tile wide, not including any retaining walls for the outflow. If pumped manually, the [[pump operator]] stands in the light-colored area, as the dark-colored is impassable to both fluid and movement. ''(Although the "liquid" is shown as blue, this can work for [[magma]] as well, with the [[magma-safe|appropriate precautions]].)'']]

The example shown in the infobox above "pumps from the north" (top) to the south (bottom). If pumped manually, the dwarf stands on the light-colored tile, as the dark-colored is impassable.

The orientation is visible after placement by using {{k|q}}uery over or near that pump or during placement, using UMKH to select the direction of input. Orientation of a pump cannot be changed after being constructed, but, as with any building, it can be deconstructed into its component parts and rebuilt as and where desired.

Having specified the direction of travel, you must ensure that the source side of the pump is placed adjacent to and above (in the [[z-axis]]) a liquid. The screw pump will draw the liquid up from below its level, and distribute it out of the other side of the pump.

== Notes ==

* The source of the pump must be directionally adjacent to "Open Space" that is directly above a source of liquid. The adjacent space cannot be a floor, stairway or wall suspended over water. Screw pumps can pull water through a [[grate]], floor [[bars]], or a [[construction|constructed]] [[fortification]] on the Z-level below.
* The light pump tile is where a pump operator will stand (if the pump is not powered mechanically). Liquids to be pumped must be 1 level below the (empty) area adjacent to this tile.
* Dwarves must be able to access and stand on the light tile of the pump in order to build the pump and then to be able to operate the pump manually.
* The dark pump tile is on the output side. Liquids will appear in the tile adjacent to this.
* The dark pump tile blocks liquids flow and creature movement, and can be built between wall segments to create a solid barrier. The light tile of the pump does not block flow or movement.
* Pumps can also be used in conjunction with a [[water wheel]] or a [[windmill]] to become self-powered.
* Active mechanisms connected to the pump will automatically start the pump; to prevent this either restrict liquid flow using floodgates or hatches, or put in a [[gear assembly]] linked to a [[lever]] to disconnect the [[power]].
* Adjacent pumps ''automatically'' transfer mechanical power to any other adjacent pump(s); no [[axle]] or [[mechanism]] is required. If too many pumps are adjacent, there may be insufficient power to power them.
* Dwarves operating pumps do '''NOT''' generate power. Thus, one cannot use a single [[pump operator]] to power an entire pump stack.
* A hatch above the input tile (on the same level as the pump) that is linked to a trigger (a [[lever]] or [[pressure plate]]) makes an effective on/off switch for that pump.
* In order to build pumps in a "hanging" state, as in the stacked screw pump example (below), one of its tiles must be able to connect to a nearby machine, either already existing or designated to be built. If, when the screw pump's construction is completed, the supporting mechanism has not yet been completed, it will promptly collapse into its component parts.
* Pumps do '''not''' push liquids '''up''' additional Z-levels above them. They only deliver water to their own level. That is, if you direct the output of a screw pump into a 1-square space surrounded by walls, the water will not "overflow" the walls. Consequently, a pump will refuse to move liquid if the level it is pumping to is completely filled. Higher levels can be achieved using a "pump stack" (below). (See [[Pressure]])
* In order to safely pump magma, you must use [[magma-safe]] materials, though magma-unsafe metals have been observed to be safe unless the open tile is going to be submerged in magma. Wooden parts (except for [[nether-cap]]s) will burst into flames the instant the pump is activated, and magma-unsafe stone [[block]]s melt after a short time. Despite the requirement for magma-safe materials, the exterior of the pump does not heat up, and dwarves do not mind operating a magma pump directly.
* Magma, which normally has no pressure, will behave as though pressurized when pumped. For example, when pumped into an U-turn, magma will come out at the other end. Normal (non-pumped) magma would just pool at the lowest level. This may be either very useful (can be used to build pressure towers for magma) or deadly (forge level flooded with magma, because someone tried to pump magma into a volcano).
* Pump's pseudo-pressure doesn't work across diagonals. If there is a diagonal-only passage in your tunnel, liquids will seep slowly through it, instead of bursting through above their normal maximal speed, like they would if there was good passage.
* The liquid in a pump's intake tile must have a depth of at least 2/7 for the pump to be able to remove any amount of liquid from it.
* If a pump's intake tile on the z-level below the pump becomes blocked (e.g. cave-in, magma cooling into obsidian, or a sapling maturing into a [[tree]]) the pump will still run but not pump any fluid.
* Water cannot flow trough trees. This is true, if there's a one title wide channel with a tree in the middle.
* If a pump's output tile contains magma and the pump is pumping water or vice versa, the output tile will be turned into [[obsidian]].

====Common mistakes====
* Orienting a pump incorrectly, and/or not having a proper open liquid source.
* Pumping water into an area with a path to other parts of your fortress. (The pump may work perfectly - the fortress quickly [[flood]]s.)
* Expecting water to rise up above the same level of a pump.
* Building a wall attached only to the light tile - this leaves a diagonal leak between the wall and the dark tile unless sealed there. (If that's not a problem, don't worry about it.)
* Having stairs as input tile. Stairs block input tile, thus rendering the pump useless, even though liquids usually ignore stairs. Output tile can be any liquid-passable tile.
* Not channeling below the impassable tile of an individual pump in a pump stack. This is how power is transmitted to the pump below.
* Pumping magma into a lower z-level (same as the source) and then being surprised it is forced back up to the pump's z-level further down the line (where you were planning your magma forges, for example.)

== Example layouts ==
=== Single pump ===

[[Image:jt_screwpump.png|frame|left|A screw pump delivers from the level below to the tile in front. This pump pumps from the right to the left. The "dark tile" would be on the left - that entire tile is impassible to movement and fluids.]] 
=== Pump stack ===
[[File:PumpStack2010.png|thumb|right|300px|'''Illustrated Side View of a Pump Stack.''']]
[[File:PumpStackTopView.png|thumb|right|300px|'''Illustrated Top View of a Pump Stack Layer.''']]
[[File:Pumpstack.gif|thumb|right|'''Animation showing the general construction using an isometric projection.''']]

A Pump stack is a method used to draw water or magma vertically across multiple z-levels requiring a minimum of parts. The basic functionality is possible because the Output (dark) side of the pump can be built over open space with a machine component located directly below, in this case another Screw Pump. Note that for power to properly transfer the intake (light) side of the pump must line up with the output (dark) side of the pump on the floor above it through a space in the floor, as in the illustration.

A pump stack minimizes the amount of machinery required to lift water or magma by allowing for power to be supplied directly to only the most accessible pump (typically the topmost) which in turn allows the player to operate a stack limited only by how many windmills/water wheels they can fit into the area. The price of optimal parts density is fragility: each pump relies on the pump below it for support. If [[forgotten beast|anything]] breaks a pump in your stack, every pump above it will be disassembled. This means that a single pump accidentally assembled with non-[[magma-safe]] parts can cause an entire magma pump stack to spontaneously disassemble.

Typical applications for a pump stack include moving magma from a lower level (often the [[magma sea]]) up to a convenient level for forges and furnaces, extracting water from a flooded fort, raising water for a decorative [[waterfall]] (and extracting it afterwards), or any other purpose that requires water/magma on a z-level significantly above its current location.

The Illustrated Top View of a Pump Stack Layer shows a basic section of a pump stack. Only the door (or a floodgate) on the Containment side is strictly necessary in order to prevent flooding. Two doorways are used here, each lining up with the solid ground within the pump assembly, in order to prevent workers from trapping themselves after digging channels or assembling the pump.

Be warned: pump stacks move water '''fast.''' If you are pumping from a large reservoir into an open area, be prepared for a huge outflow, roughly akin to the kind of water dump you'd get if the whole reservoir was balanced above the pump output and then released. If you are using pumps to empty a large underground reservoir (or, say, a flooded fortress) onto open land, use an aqueduct or some other method to make sure the pump system outlet is a good distance away from anything you wouldn't want to get drenched.

As an alternative to a large reservoir, it is also possible to combine a [[Dwarven Atom Smasher]] with the top layer of the Pump Stack to create a "vacuum cleaner" of sorts.

====Tips====

* Ramps can be used in place of channeling. Liquids will transmit through ramps, unlike stairs, and when pumps are constructed they annihilate the ramp they're built on much as walls do. Power will still be transmitted, so they don't need to be removed by miners prior to pump construction. Ramps make it virtually impossible to strand your miners and allow the stack to be dug out using only access doorways on the intake side of the pump, so no construction or doors are later needed to eliminate leaks. A pump stack can be very rapidly carved out with this method as even if a miner/builder is trapped on the containment side of a pump, they can walk up the ramp to the intake side of the pump above and walk out.
* Power can be transmitted to the stack by channeling out the tile directly above the intake (light) tile of the topmost pump and mounting a gear assembly. If the gear assembly is supported by an adjacent gear assembly or horizontal axle on a stable floor (be careful to not have that adjacent gear assembly disengage via lever), this will allow the stack to hang from the gear assembly. If a lower pump needs to be removed, or should self-destruct, the problem of the entire pump stack disassembling described above is eliminated. Further, if the supported gear assembly is built first, the pump stack can be built both from the top and bottom simultaneously, halving construction time, assuming that sufficient attention is paid to make sure that the pumps will align with the proper orientation when the two partial stacks meet. Properly channeling/ramping out the stack should ensure this.
* When pumping water, make sure all tiles on the containment side of the stack are covered with a [[construction|constructed]] floor or [[fortification]] to prevent subterranean trees from growing and blocking flow of the stack. Fortifications have the added advantage that, when used with water, they will never become muddy.
* When using pumps to empty a large body of liquid, make sure that the pump output is properly isolated from the intake, otherwise the liquid can flow backwards into the pump's walkable tile and cause problems (such as flushing the dwarf operating it into the body of liquid being drained).

===Improved Magma Pump Stack===

Because a pump stack pumping magma is known to cause significant [[Maximizing_framerate|lag]], a [http://www.bay12forums.com/smf/index.php?topic=72296.0 new type of pump stack] was developed by [http://www.bay12forums.com/smf/index.php?action=profile;u=19835 NecroRebel] that causes a much smaller drop in [[FPS]]. Changing the single tile magma chamber at the output of every pump from a 1 by 1 to a 3 by 3 area reduces the lag to 1/15th of that caused by the original pump stack. The designer hypothesizes that the larger chamber requires many fewer temperature calculations when magma is pumped in or out; that also implies that there will be no improvement for water pumps.

====Newer Magma Pump Breakthroughs====

Newer breakthroughs in magma pump design has since made the 3x3 reservoir design obsolete.
NecroRebel has tested a [http://www.bay12forums.com/smf/index.php?topic=72296.msg1772802#msg1772802 1x3 head-over-tail variation] (which is very similar to [[Screw_pump#Pump_stack|the typical 1 by 1 pump stack]]) as well as a [http://www.bay12forums.com/smf/index.php?topic=72296.msg1795907#msg1795907 2x3 head-over-head variation]. Both of these new designs require less space and work as effective as his original 3x3 reservoir head-over-head design, with no significant drop in FPS. The 1x3 head-over-tail design has the advantages of requiring the least amount of space and being simple to refit from the standard 1 by 1 water pump stack.

{{buildings}}

v0.34:Lever

2012-03-09T23:07:59Z

Sasf54: /* Labeling */

{{quality|Exceptional|07:05, 18 August 2010 (UTC)}}{{av}}

A '''lever''' is a building constructed from one [[mechanism]] on an empty tile. Once in place, it can be linked to one or more devices such as [[door]]s, [[bridge]]s or [[support]]s, permitting you to control these other devices remotely. Order the lever to be pulled through its {{k|q}} menu. A free dwarf will get assigned the job of pulling the lever. This dwarf might be a long way away, and the delay in pulling the lever can result in [[fun]]. Levers also make good furniture choices when constructed with high-quality mechanisms.

[[Pressure plate]]s are like levers, but are triggered by creatures or fluids directly rather than by giving an order to a dwarf. If levers are too much [[fun]], a pressure plate may be a better choice. There is more information on trap design [[trap design|here]].

==Activation of the devices==
When a lever is pulled, the connected device(s) activates. What happens during activation depends on the linked device:

* [[Door]]s and [[Hatch]]es open and close.
* [[Support]]s collapse, potentially causing a cave-in (pulling the lever again won't re-assemble the support, cave-in or not).
* [[Bridge]]s raise and lower, or retract and extend, depending on the type of bridge.
* [[Floodgate]]s open and close.
* [[Gear assembly|Gear assemblies]] toggle between engaged and disengaged (disengaged assemblies can't support other machinery).
* [[Restraint]]s release the creature assigned to them (leaving the restraint attached to the creature and, at present, unrecoverable).
* [[Cage]]s are deconstructed, releasing their occupants (needless to say, this is irreversible!)
* [[Spike]]s raise and lower.

Different objects take different amounts of time to respond to activation; generally this is only a brief pause but it can be enough for a charging [[goblin]] to cover more than a few tiles.

==Linking==
One [[mechanism]] is required to construct a lever, and then two more are required to '''link''' the lever with a device. The link is made by selecting the lever with {{k|q}}, choosing the type of object you want to link the lever to, and then using {{k|-}} and {{k|+}} to choose the particular object. The list is chronological by order of construction, most recently designated last, and the map will recenter on each object as you scroll through the list.

Then you can choose what specific mechanisms you want to use to connect the device to the lever. The quality of a mechanism affects the accuracy of traps, but not the speed of activation. The first mechanism you choose is for the device end, the second for the lever end. This is important when working with [[magma]].

A lever can be linked to any number of objects, and each object can have any number of levers controlling it.

There is no way to de-link an object without disassembling either object or lever {{verify}}. When using a lever for a single-use purpose (cages or supports), the mechanism in the lever will remain in the lever, but the object and its mechanism will deconstruct. In this manner, a single lever might accumulate many mechanisms. Deconstructing the lever will free all these mechanisms and allow to reuse them - keep your permanent and one-time linkages to separate levers.

==On/Off vs Open/Close==
Levers normally have an "on" and an "off" state, seen as whether the small tag at the top of the lever is to the left ("off" state) or the right ("on" state). Upon being pulled, the state of the lever changes, and everything they're connected to updates to the ''corresponding'' state of that lever, and does not just ''change'' states ("toggle"). This becomes important if you have several levers attached to the same device, or one trigger attached to several systems.
:Example: 2 levers (both in "off" position) are connected to a drawbridge. After pulling the first lever, the bridge will lift. Pulling the second lever tells the bridge to "open", which it already has done - no visible effect. When it is pulled a second time it will let the bridge down. This in turn requires the ''first'' lever (still in "open/lift" position) to be pulled twice to trigger a change (lift again), and so on.

"On" and "off" state is fixed and dependent on the lever, not the object that lever is linked to:

* "dash to the right" ( '''ó''' ) is '''on'''
* "dash to the left" ( '''ò''' ) is '''off'''

Note, however, that gear assemblies are ''the sole exception'' to this: Instead of On/Off triggers, they indeed '''do''' toggle.

Several devices, such as [[floodgate]]s and [[bridge]]s, have a delayed response to all incoming signals, and will not respond to subsequent signals until the first has taken effect. For instance, if you pull a lever attached to a floodgate on then off in rapid succession, the floodgate will only respond to the first signal, independent of the position the lever rests in eventually.

In the unusual case that a device receives both an on and an off trigger in the exact same tick, the device will change states-- an open device will close, and a closed device will open.

==On/Off states==
Objects that can be controlled by levers include:

===== Multiple Uses =====

A "step" is not a step that a dwarf makes, and not based on [[Frames per second|FPS]]. It's one "step" that the game advances. When paused (via {{k|spacebar}} ), you can manually advance the game "1 step" by hitting the period ( {{k|.}} ) key.

* [[Bridge]] – Activates 100 steps after being triggered
** '''On:''' Turns the bridge into either a raised drawbridge, or a retracted bridge, depending on which option was chosen when the the bridge was constructed.
** '''Off:''' Returns the bridge to normal.

* [[Door]] – Activates instantly. Note that once you connect a door, it is either completely open or sealed shut. There is no "''closed, but can be opened by a dwarf''" state anymore.
** '''On:''' Opens the door.
** '''Off:''' Closes the door.

* [[Floodgate]] – Activates 100 steps after being triggered.
** '''On:''' Opens the floodgate.
** '''Off:''' Closes the floodgate.

* [[Floor hatch]] – Activates instantly. Note that, like doors, once you connect a hatch, it is either completely open or sealed shut.
** '''On:''' Opens the hatch.
** '''Off:''' Closes the hatch.

* [[Grate]] – Activates 100 steps after being triggered. When it is open, it just disappears. Liquids go through it just the same, but it will no longer function as a floor/wall (depending on its orientation).
** '''On:''' Opens the grate.
** '''Off:''' Closes the grate.

* [[Bars]] – Activates 100 steps after being triggered. When it is open, it just disappears. Liquids go through it just the same, but it will no longer function as a floor/wall (depending on its orientation).
** '''On:''' Opens the bars.
** '''Off:''' Closes the bars.

* [[Trap|Upright Spear/Spikes]] – Activates 40 steps after being triggered.
** '''On:''' Retracts spears/spikes.
** '''Off:''' Extends spears/spikes.

* [[Gear assembly]] – Activates instantly. When it is disengaged, no power goes through it and anything that is being kept up by its presence (like a [[windmill]] right on top of it) falls down.
** '''On:''' Toggles gear state.
** '''Off:''' Toggles gear state.

===== One-Shot =====

These items, when activated, deconstruct, and/or cannot be triggered again until re-linked.

* [[Cage]] – Deconstructs the cage and releases all of its contents. The cage and its attached mechanism will be left on the floor nearby; you recover the [[mechanism]] used on the cage but you do not recover the mechanism used in the lever until you deconstruct the lever itself.
* [[Restraint]] – Deconstructs the [[Restraint|chain/rope]] and releases whatever creature it held. The restraint's mechanism will be left on the floor nearby, and the restraint itself will remain attached to the creature's neck; again, you recover the [[mechanism]] used on the restraint but you do not recover the mechanism used in the lever until deconstructing the lever itself.
* [[Support]] – Deconstructs the support, ideally without a dwarf next to it. Most commonly used to cause controlled [[cave-in]]s. The support's building material and its attached mechanism can both be recovered (unless they happen to get destroyed in said cave-in).

==Labeling==
There is no built-in indication of what a lever does, and pulling them to see what will happen can be immensely [[fun]]. Using the [[note]] function is the most foolproof way of labeling levers; color-coding of levers can give some indication too.

However, it is possible to ascertain whether or not a building has been linked to a lever by finding the building under {{k|R}} "View Rooms/Buildings" and then selecting {{k|t}} "Zoom to building items". A device that is actuated by a lever not only lists the components of the building but will also include a mechanism item. Viewing the lever itself this way will display one mechanism for each building the lever is linked to (plus one mechanism from the construction of the lever itself).

There is way to ascertain which lever is linked to what, but it becomes very hard when you have many linkable items. Find the lever, use "q" and then select "add new task". Try for every linkable thing in your fortress, to link the lever to it. If an object isn't available for linking, that's because it is already linked. Though this method isn't very usable to find the single linked item in all of them, it is useful when you forgot whether the left or the right lever was linked to the support.

==Tipps==

If you have a larger (>5) lever / cage release fun house / arena, you may get confused sometimes, what lever is linked, and what are free. To '''mark''' your levers, you can do one or both of the following:
* use a dedicated direction for default (unlinked) state (start linking cages with a '''Pull Lever''' command) (You will able to most of the lever's state)
* Put a final '''Pull lever''' command in suspend mode. That way you will surely know, what lever is setup, and it's easier, to actually release :) (You can tell one-by-one examination of the levers)

{{buildings}}

v0.34:Trading

2012-03-07T19:01:45Z

Sasf54: /* Caravans */

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

'''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 [[Broker]] when dealing with merchants in a visiting caravan ({{key|r}} - "''Trader requested at Depot"''). As a [[profession]], the term usually only applies to visiting merchants, or to a dwarf whose highest [[skill]] is [[Appraiser]].

== Trade Depot ==
Building a [[Trade depot]] is a 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 of non-fortress members (only if they are alive, when they are dead they belong to you if you claim the items),{{Verify}}
* the items that are on merchant animals{{Verify}}
* the items that are on the trade depot (they belong to the caravan until they are moved out of it)

See the [[Trade depot]] article for more information on how to interact with it.

==Trading Flowchart ==
{{:Trading/Flowchart}}
After entering 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 broker 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 broker'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 broker.

With more experienced brokers 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 do not have base quality higher than superior, but decorations on a good may be of any quality.{{Verify}}

== Trading cue colors ==

* '''Brown''' Items have been created (or modified) by your fortress. They can be traded away or offered as a gift.
* '''White''' 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.
* '''Purple''' 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.{{Verify}}
* '''Green''' Items have just been gifted to the caravan and they will not trade it back.
* '''Red''' 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. However, a caravan from a different civilization ''may'' accept stolen goods without changing them first.{{verify}}

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 broker 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 (eg, 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]].{{Verify}}

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.{{Verify}}

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}}

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!{{Verify}}

==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.(5,000 in 0.31.25) You cannot offer items that were not made at your fortress; the traders do not want your spare goblin harvest clothes.

'''''Note:''' There are currently no benefits to offering goods to your king; the game developers have stated that this is to be changed in future versions.'' ("''Req174, REASON FOR OFFERING, (Future): There's no point of offering goods to your own king right now.)"''

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 - their refusal to accept back their wooden items is probably a bug which will be removed in a later release, though this has not been verified. It is also worth noting that in-game the only way to acquire wood is by chopping down trees, so it is likely that the elves have developed a method of growing and acquiring wood without killing trees which will be included in later development (unless they are just cutting down trees that have already died naturally).

== Miscellaneous Trading Advice ==

* Several small trades, exiting the trade window each time, '''no longer''' increases the Broker's relevant skills during the early game. {{Verify}}
* Food inside the Trade Depot can go bad. Have a food stockpile nearby so you can quickly haul goods inside.
* 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}}
* 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) to the entrance of the fort and line this with traps; 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) and wooden logs 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, whether stockpiled or utilized in buildings (such as wooden axles, water wheels, windmills, or workshops); 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.  This also seems to apply to elven caravans bringing [[cloth]] (except that cloth that's turned into [[clothing]], [[bag]]s or [[rope]] isn't counted). So if you want elven caravans to ''stop'' bringing cloth, buy up all the cloth that the first few caravans bring and stash them somewhere.
* 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.
* Elves will trade [[Tame]] exotic creatures; '''however,''' once purchased, these creatures will not show up on the Animal section of the [[Status]] screen if you do not have a [[Dungeon master]] (a noble position that is currently bugged).
* Each trade you make (regardless of value) will increase your broker'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.

== 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. In rare cases, goblins will show up in winter.{{verify}} However, in the first year only a dwarven caravan will arrive, although it will tend to arrive later than mid-autumn, unlike previous versions {{verify}}. 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.{{Verify}}

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 (ie. 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.

If a cavaran has a lot of junk to load up, it can take a while (>=2 months), but don't worry, the other caravan can unload / trade while the first one is still uploading

== Liaisons ==
[[Liaison]]s may be sent with caravans to speak to important 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). Liaisons allow you to choose the type of items that your fortress is interested in, and will focus on bringing more of that kind of item on the next caravan (however, those items will also be more expensive). In turn, they will present a list of the items they're willing to pay more for, which will be effective upon their next arrival.

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

If a liaison is prevented from leaving, they will eventually go [[insane]]. {{Verify}}

==== [[Dwarves]] ====
:''"Our fortunes rise and fall together"''

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 well 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).{{verify}}
* 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, as long as the dwarven civilization is not extinct.{{verify}}
* 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.]]

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.
* is 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. 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.

==== [[Human]]s ====
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.
* is moderately guarded.

==== [[Goblin]]s{{Verify}} ====
A goblin caravan ''may'' arrive if your civilization is at peace with the goblins.

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

== 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]].

== Caravan Delay ==
If a caravan has arrived at your trade depot and is unable to leave for about six months after they arrived, 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.{{Verify}}

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.{{Verify}}

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, specially, if you wish to keep the precious bins, and sell low value items, with low weight.

== Bugs ==

<s>*No one brings wagons, even if there is a clear path to your depot. {{bug|197}}</s> solved
*Wild animals cannot be traded; when a dwarf attempts to move the caged animal to the Depot, the creature is set free.Only aggressive animals?
*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}}

== Loyalty cascade ==
*If you order your military to kill merchants from your own civilization, your soldiers will simultaneously become members ''and'' enemies of your civilization, resulting in a civil war within your fortress. When this happens, all current members of the fortress (excluding incoming migrants) will turn on each other yet they will still be seen as normal working dwarves in the status screens. This will only last for those who were alive ''during'' the attack, they will always be hostile to everyone including incoming migrants (yet they still do their jobs/ follow military orders and work as dwarves although they will interrupt other's work. They will not be shown as enemies in the Units screen).

== Exploits ==

*If you destroy the Depot while they are unloaded you will get the leaving message but they will leave before the building is completely destroyed, so they will not reclaim any of their stuff because it is not available until the building is fully deconstructed. However any animals they had caged will only become friendly, you won't actually own them.

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 '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:Cleaning up macros

2012-03-05T00:40:11Z

Sasf54:

== Cleaning up Macros ==

This page is dedicated, on to describe, and help in cleaning macros. This is needed, because a recorded macro contains quite a lot of other interface interaction, what can really slow the executing.

Because DF has a cache for the macros, you must change at least the name of the macro inside it (use a counter, and increment it), otherwise, the oldest loaded version will be used :(

If you make your macros to do a repetative job in a single menu, you can easily use grep and a menu macro file. Grep[http://gnuwin32.sourceforge.net/packages/grep.htm] is a GNU utility, that process an input (text) file, and throws everything, that doesn't match the filtering options. It's a very powerful utility, so if you would like to know better, look into manual[http://unixhelp.ed.ac.uk/CGI/man-cgi?grep]. Because grep is case sensitive (CAPITAL non capital), you have to watch out for this, or use a -i (in-case sensitive) mode.

=== How to use them ===
Because grep is not saving the first line (name of macro), you have to make it manually.
You have two choices. You can create a file, with the appropriate menu name, for example build.menu, and then:
echo my1 > my1.mak
grep -f build.menu my.mak >> my1.mak
Don't forget, to clean up any empty lines from the '''.menu''' file, otherwise, nothing will then filtered out.
Second method, use a bunch of patterns
echo my2 > my2.mak
grep -e line_1_from_file -e line_2_from_file -e line_3_from_file my.mak >> my2.mak

For both cases the first line is writing my2 (the name of the macro) into the file. This operation will overwrite the existing content of the file. The second line is actually doing the filtering, and appending the file. (Don't run, otherwise you wish to double the macro, you will still have to delete the '''End of macro''' line from the middle of the file)).
=== Some useful filter ===
====Build menu====
If you wish to build anything, and you are not intended to leave the build menu, and the macro is not selecting the building type, you can use the following file / listing to filter your macro. (so, for 'you manually select the first position, and the building type, and then run the macro' type of macros).
SELECT
End of group
CURSOR_
End of macro

====Resizing menu====
If you wish to resize some building, you should use this filter, to speed things up. It will leave all the resizing commands, so it will be still valid for other building resizing. (If you recorded for bedrooms, you still can use for stone gardens...)
SELECT
SECONDSCROLL_
CURSOR_
_SIZE
End of group
End of macro

v0.34:Cleaning up macros

2012-03-04T23:34:55Z

Sasf54: Created page with "== Cleaning up Macros == This page is dedicated, on to describe, and help in cleaning macros. This is needed, because a recorded macro contains quite a lot of other interface in..."

== Cleaning up Macros ==

This page is dedicated, on to describe, and help in cleaning macros. This is needed, because a recorded macro contains quite a lot of other interface interaction, what can really slow the executing.

Because DF has a cache for the macros, you must change at least the name of the macro inside it (use a counter, and increment it), otherwise, the oldest loaded version will be used :(

If you make your macros to do a repetative job in a single menu, you can easily use grep and a menu macro file. Grep[http://gnuwin32.sourceforge.net/packages/grep.htm] is a GNU utility, that process an input (text) file, and throws everything, that doesn't match the filtering options. It's a very powerful utility, so if you would like to know better, look into manual[http://unixhelp.ed.ac.uk/CGI/man-cgi?grep]. Because grep is case sensitive (CAPITAL non capital), you have to watch out for this, or use a -i (in-case sensitive) mode.

=== How to use them ===
Because grep is not saving the first line (name of macro), you have to make it manually.
You have two choices. You can create a file, with the appropriate menu name, for example build.menu, and then:
echo my2 > my2.mak
grep -f build.menu my.mak >> my2.mak
The first line is writing my2 (the name of the macro) into the file. This operation will overwrite the existing content of the file.
The second line is actually doing the filtering, and appending the file. (Don't run, otherwise you wish to double the macro, you will still have to delete the '''End of macro''' line from the middle of the file)).
===Build menu===
If you wish to build anything, and you are not intended to leave the build menu, and the macro is not selecting the building type, you can use the following file / listing to filter your macro. (so, for 'you manually select the first position, and the building type, and then run the macro' type of macros).
SELECT
End of group
CURSOR_
End of macro

v0.34:Macros and keymaps

2012-03-04T23:13:27Z

Sasf54: /* Tuning macros */

{{av}}
{{Quality|Exceptional|14:18, 4 April 2011 (UTC)}}
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
*{{k|Ctrl}}+{{k|p}} = play
*{{k|Ctrl}}+{{k|s}} = save
*{{k|Ctrl}}+{{k|l}} = load

To create a macro press {{k|Ctrl}}+{{k|r}} to begin recording your actions. When you have recorded all the action 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 using {{k|Ctrl}}+{{k|p}}.

There is a directory data/init/macros for them. The macros are saved in .mak format. 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 it's 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. 
There seem to be problems with changing removing and adding macros while the game is running. Save, quit and restart the game when you want to change something.

=== 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. [[Cleaning up macros]]

The second and most effective way to increase speed is to remove all unnecessary commands DF recorded with an external texteditor. While the extra commands are ignored by the game, however they 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 d for example records more than 30 commands. Depending on what you do, you can increase the speed by 4 or more by reducing the number of commands in every group to the one you need. ''If you edit a macro, you'll have to restart DF afterwards.''

The third way is to change settings in the init-files. In the 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>
This means that the speed between macro commands will gradually increase until it hits the limit. The secondary command is when the gradual increase in speed increases.

== External utilities ==

=== [http://sun2design.com/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 ===
# Go to [[Utilities#AutoHotKey]] and download AutoHotKey. Installation is simple and the program uses few system resources.
# Write macro scripts (file type .ahk), which may contain any number of commands. You activate scripts by double-clicking .ahk files and deactivate them by right-clicking the AutoHotKey icon on the task bar. 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 executations
**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.'''

== Some macros ==
=== Large bedroom's bed placing ===

Ok, so you can record some macro, to build a large repeating bedroom. So you setup the build menu (select the bed, and go the position you want to place). Just start a new macro, and place a bed, select the first bed from the list, and move about 3-4 tiles right. Repeat this until you reach the limit, or you are satisfied. Turn off macro recording (don't exit the build menu). You can save your macro (not necessary). Go to 3-4 tile under the place, you first placed a bed (most left of the bed row). Make sure, the bed are selected from the build menu, and you are selecting position to build it. Press the play macro (Ctrl + p), and you have just another row. Repeat, until you have enough bedrooms, or out of beds.

=== Large bedroom's placing cabinets ===

You can reuse the above macro, for placing cabinets / coffers / bags / tables / chairs. Select the cabinet from build menu, and go above the first bed position, and press the play macro (Ctrl + p), and fill your bedrooms with cabinets.

=== Large bedroom's placing coffers ===

If you want to place coffers, but not bags, it's a bit trickier, but you will see how can done. Pause the game (will save you from a lot of spam from the dworfs). Go to stock, inventory, and bags and bins. Forbid all bags, regardless, what's in it /used for (this is temporary). Exit, to main screen. Build, coffers and bags, and go to where you wish to place the first coffer (maybe left of first bed). Press the play macro (Ctrl + p). Because all the items disabled what we don't want to build from that build category, only coffers will be build. Repeat until bedroom is filled with coffers / you're out of coffers. Don't forget to unforbid all the bags, so the dwarfs can carry on, as nothing has happened. You can unpause the game, and watch, as your working dwarfs hauls the big bedroom together. You can invert the forbidding to place only bags.

=== Large bedroom's resizing all beds ===

If the bedroom is finished (at least all the beds are hauled to place), you may want to create a new macro, to create the exact bedrooms. Use the info of a building (q), and select the first bed. Start a new macro (Ctrl + s), and press r and the + for a few times (resize the bedroom). If you are fine with the size of the bedroom, you can press enter, and go on for the next bed, and repeat this for the whole row. Remember, because this will be a macro, and if you want bedrooms that fill all the room, you may have to press + a bit more or less for the edge beds. If you finished the first row, stop the recording (Ctrl +r), and you can save this macro too. Repeat this for the rest of the rows.

=== Mass selector ===

With this macro, you can select a lot of things at once. Most helpful, if you want to sell a lot of junk to the caravans. So, basically, you just record: '''enter down''' in a row about 10-25 times. (can make an alternate with '''enter +'''.) So, the caravan arrives, your dwarfs haul all the bins for selling. At trade menu, you select for trade all the stuff, the trader have, and you would like to buy. go to your items, and load the macro, and play it as many times, as you want. Because if a bin is selected it will be sold with all the items inside. But if after any of the content is selected, the bin will not be sold. After you selected all the stuff for selling, it's a good idea to just brows what you exactly selling, just for sure (not to sell any wood to elfs).

=== Mass trap builder ===

It's basically just the same as the bed building, only with 1 tile moving. (It will build a bunch of traps next to each other).

==== Troubleshooting Scripts ====
Users may experience some issues in getting 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 loops 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.
* 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]].

{{av}}

v0.34:Macros and keymaps

2012-03-04T22:33:30Z

Sasf54: /* Fluxbox + xvkbd */

{{av}}
{{Quality|Exceptional|14:18, 4 April 2011 (UTC)}}
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
*{{k|Ctrl}}+{{k|p}} = play
*{{k|Ctrl}}+{{k|s}} = save
*{{k|Ctrl}}+{{k|l}} = load

To create a macro press {{k|Ctrl}}+{{k|r}} to begin recording your actions. When you have recorded all the action 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 using {{k|Ctrl}}+{{k|p}}.

There is a directory data/init/macros for them. The macros are saved in .mak format. 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 it's 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. 
There seem to be problems with changing removing and adding macros while the game is running. Save, quit and restart the game when you want to change something.

=== 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 with an external texteditor. While the extra commands are ignored by the game, however they 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 d for example records more than 30 commands. Depending on what you do, you can increase the speed by 4 or more by reducing the number of commands in every group to the one you need. ''If you edit a macro, you'll have to restart DF afterwards.''

The third way is to change settings in the init-files. In the 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>
This means that the speed between macro commands will gradually increase until it hits the limit. The secondary command is when the gradual increase in speed increases.

== External utilities ==

=== [http://sun2design.com/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 ===
# Go to [[Utilities#AutoHotKey]] and download AutoHotKey. Installation is simple and the program uses few system resources.
# Write macro scripts (file type .ahk), which may contain any number of commands. You activate scripts by double-clicking .ahk files and deactivate them by right-clicking the AutoHotKey icon on the task bar. 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 executations
**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.'''

== Some macros ==
=== Large bedroom's bed placing ===

Ok, so you can record some macro, to build a large repeating bedroom. So you setup the build menu (select the bed, and go the position you want to place). Just start a new macro, and place a bed, select the first bed from the list, and move about 3-4 tiles right. Repeat this until you reach the limit, or you are satisfied. Turn off macro recording (don't exit the build menu). You can save your macro (not necessary). Go to 3-4 tile under the place, you first placed a bed (most left of the bed row). Make sure, the bed are selected from the build menu, and you are selecting position to build it. Press the play macro (Ctrl + p), and you have just another row. Repeat, until you have enough bedrooms, or out of beds.

=== Large bedroom's placing cabinets ===

You can reuse the above macro, for placing cabinets / coffers / bags / tables / chairs. Select the cabinet from build menu, and go above the first bed position, and press the play macro (Ctrl + p), and fill your bedrooms with cabinets.

=== Large bedroom's placing coffers ===

If you want to place coffers, but not bags, it's a bit trickier, but you will see how can done. Pause the game (will save you from a lot of spam from the dworfs). Go to stock, inventory, and bags and bins. Forbid all bags, regardless, what's in it /used for (this is temporary). Exit, to main screen. Build, coffers and bags, and go to where you wish to place the first coffer (maybe left of first bed). Press the play macro (Ctrl + p). Because all the items disabled what we don't want to build from that build category, only coffers will be build. Repeat until bedroom is filled with coffers / you're out of coffers. Don't forget to unforbid all the bags, so the dwarfs can carry on, as nothing has happened. You can unpause the game, and watch, as your working dwarfs hauls the big bedroom together. You can invert the forbidding to place only bags.

=== Large bedroom's resizing all beds ===

If the bedroom is finished (at least all the beds are hauled to place), you may want to create a new macro, to create the exact bedrooms. Use the info of a building (q), and select the first bed. Start a new macro (Ctrl + s), and press r and the + for a few times (resize the bedroom). If you are fine with the size of the bedroom, you can press enter, and go on for the next bed, and repeat this for the whole row. Remember, because this will be a macro, and if you want bedrooms that fill all the room, you may have to press + a bit more or less for the edge beds. If you finished the first row, stop the recording (Ctrl +r), and you can save this macro too. Repeat this for the rest of the rows.

=== Mass selector ===

With this macro, you can select a lot of things at once. Most helpful, if you want to sell a lot of junk to the caravans. So, basically, you just record: '''enter down''' in a row about 10-25 times. (can make an alternate with '''enter +'''.) So, the caravan arrives, your dwarfs haul all the bins for selling. At trade menu, you select for trade all the stuff, the trader have, and you would like to buy. go to your items, and load the macro, and play it as many times, as you want. Because if a bin is selected it will be sold with all the items inside. But if after any of the content is selected, the bin will not be sold. After you selected all the stuff for selling, it's a good idea to just brows what you exactly selling, just for sure (not to sell any wood to elfs).

=== Mass trap builder ===

It's basically just the same as the bed building, only with 1 tile moving. (It will build a bunch of traps next to each other).

==== Troubleshooting Scripts ====
Users may experience some issues in getting 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 loops 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.
* 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]].

{{av}}

v0.34:Macros and keymaps

2012-03-01T23:38:47Z

Sasf54:

{{av}}
{{Quality|Exceptional|14:18, 4 April 2011 (UTC)}}
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
*{{k|Ctrl}}+{{k|p}} = play
*{{k|Ctrl}}+{{k|s}} = save
*{{k|Ctrl}}+{{k|l}} = load

To create a macro press {{k|Ctrl}}+{{k|r}} to begin recording your actions. When you have recorded all the action 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 using {{k|Ctrl}}+{{k|p}}.

There is a directory data/init/macros for them. The macros are saved in .mak format. 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 it's 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. 
There seem to be problems with changing removing and adding macros while the game is running. Save, quit and restart the game when you want to change something.

=== 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 with an external texteditor. While the extra commands are ignored by the game, however they 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 d for example records more than 30 commands. Depending on what you do, you can increase the speed by 4 or more by reducing the number of commands in every group to the one you need. ''If you edit a macro, you'll have to restart DF afterwards.''

The third way is to change settings in the init-files. In the 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>
This means that the speed between macro commands will gradually increase until it hits the limit. The secondary command is when the gradual increase in speed increases.

== External utilities ==

=== [http://sun2design.com/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 ===
# Go to [[Utilities#AutoHotKey]] and download AutoHotKey. Installation is simple and the program uses few system resources.
# Write macro scripts (file type .ahk), which may contain any number of commands. You activate scripts by double-clicking .ahk files and deactivate them by right-clicking the AutoHotKey icon on the task bar. 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]].

:'''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.'''

== Some macros ==
=== Large bedroom's bed placing ===

Ok, so you can record some macro, to build a large repeating bedroom. So you setup the build menu (select the bed, and go the position you want to place). Just start a new macro, and place a bed, select the first bed from the list, and move about 3-4 tiles right. Repeat this until you reach the limit, or you are satisfied. Turn off macro recording (don't exit the build menu). You can save your macro (not necessary). Go to 3-4 tile under the place, you first placed a bed (most left of the bed row). Make sure, the bed are selected from the build menu, and you are selecting position to build it. Press the play macro (Ctrl + p), and you have just another row. Repeat, until you have enough bedrooms, or out of beds.

=== Large bedroom's placing cabinets ===

You can reuse the above macro, for placing cabinets / coffers / bags / tables / chairs. Select the cabinet from build menu, and go above the first bed position, and press the play macro (Ctrl + p), and fill your bedrooms with cabinets.

=== Large bedroom's placing coffers ===

If you want to place coffers, but not bags, it's a bit trickier, but you will see how can done. Pause the game (will save you from a lot of spam from the dworfs). Go to stock, inventory, and bags and bins. Forbid all bags, regardless, what's in it /used for (this is temporary). Exit, to main screen. Build, coffers and bags, and go to where you wish to place the first coffer (maybe left of first bed). Press the play macro (Ctrl + p). Because all the items disabled what we don't want to build from that build category, only coffers will be build. Repeat until bedroom is filled with coffers / you're out of coffers. Don't forget to unforbid all the bags, so the dwarfs can carry on, as nothing has happened. You can unpause the game, and watch, as your working dwarfs hauls the big bedroom together. You can invert the forbidding to place only bags.

=== Large bedroom's resizing all beds ===

If the bedroom is finished (at least all the beds are hauled to place), you may want to create a new macro, to create the exact bedrooms. Use the info of a building (q), and select the first bed. Start a new macro (Ctrl + s), and press r and the + for a few times (resize the bedroom). If you are fine with the size of the bedroom, you can press enter, and go on for the next bed, and repeat this for the whole row. Remember, because this will be a macro, and if you want bedrooms that fill all the room, you may have to press + a bit more or less for the edge beds. If you finished the first row, stop the recording (Ctrl +r), and you can save this macro too. Repeat this for the rest of the rows.

=== Mass selector ===

With this macro, you can select a lot of things at once. Most helpful, if you want to sell a lot of junk to the caravans. So, basically, you just record: '''enter down''' in a row about 10-25 times. (can make an alternate with '''enter +'''.) So, the caravan arrives, your dwarfs haul all the bins for selling. At trade menu, you select for trade all the stuff, the trader have, and you would like to buy. go to your items, and load the macro, and play it as many times, as you want. Because if a bin is selected it will be sold with all the items inside. But if after any of the content is selected, the bin will not be sold. After you selected all the stuff for selling, it's a good idea to just brows what you exactly selling, just for sure (not to sell any wood to elfs).

=== Mass trap builder ===

It's basically just the same as the bed building, only with 1 tile moving. (It will build a bunch of traps next to each other).

==== Troubleshooting Scripts ====
Users may experience some issues in getting 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 loops 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.
* 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]].

{{av}}

v0.34:Fluxbox macros

2012-03-01T22:53:48Z

Sasf54: Created page with "{{av}} === Macros with fluxbox & xvkbd === In this context the macro is mean a set of keystrokes / input from the player. Keymap is a set of special key combinations to get spe..."

{{av}}

=== Macros with fluxbox & xvkbd ===

In this context the macro is mean a set of keystrokes / input from the player. Keymap is a set of special key combinations to get special function, or shorten input.

What this is good for?
Did you had a migrants of 20 or more, and you were in trouble of make enough accommodations for them, before they got unhappy thoughts? Were you bored, by the repetitive creation of of a big bedroom? Not to worry anymore, it's possible to break down the task into much less interaction, and to speed up things.

What you need:
under linux:
* fluxbox (or your steady window manager, or shortcut editor)
* xvkbd (or anything, that allows you to type something into an active window / program, as came from stdin)
winder windows:
*a good (free) program, that can do the same, and supports special characters

=== Fluxbox ===

Fluxbox is a tiny window manager, that allows a lot of powerful customization. If you don't want to install fluxbox just for this, you should look for other solutions in your distro (KDE / Gnome). If you use / successfully setup fluxbox [[http://fluxbox.org/help]] you only need to edit .fluxbox/keys files. This contains the keyboard shortcuts.

Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"

Mod1 means windows / command funciton key (If you use keychains, the order of the modificators seems important :( )
Mod4 means alt
m is for the key m (so this will be windows + alt + m (special enough not to used in any other application
(this is important, because if fluxbox is intercepting a hotkey, it not pass along to the active application!))
None the following combinations are not using modifications keys (Important: use your last key in keychain as
non-modified key, or a big enough delay, or else your macro input will be applied to the modifier, you currently
pressing (see below))
d is for key D (like Dwarf Fortress)
b is for key B (as bedroom)
: means, that this is the end of key combinations, and from here the command to apply.

So, to start this particular keychain (hotkey), '''(windows + alt + m) d b'''

:ExecCommand tells fluxbox, to execute the followings

xvkbd this the virtual keyboard we will use
-text tells xvkbd to don't display the virtual keyboard, just get the input from command line
(there's file input is available, but it does not support special keys so easily)
"\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r" This is the input, we will pass to
Dwarf Fortress (which will press r, and gives 12 + and a final enter)
The begining '''\D2''' commands xvkbd to wait 2*100ms. You might want to play with this, but I found,
that I need this, because the first input key is not passed always otherwise.

The + is used on keypad under DF, we access this by \[]. The enter is also a special character, used by \r. You might want to take a peek into the xvkbd's man page for some special keys.

So what this macro does at all:
if you press: if you have large bedroom, and you don't want to make the boring task to create a large bedroom for all the beds, you can manage the bed by '''q''' (task and preferences in DF), and then press '''(windows + alt + m) d b''', which will give the order of '''r''' ++++++++++++ and an enter.

=== Trouble shooting ===

* My first characters are missing from the input
** - You have most probably insufficient delay at the start of the text. Try a bigger number, or a delay at all ('''\D2''')
* My macro fails / I cannot get it work at, and not even prints into a textbox.
** - You might have a last keychain key with a modifier.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "Hello World"'''
This will most probably not give you any output, or even worst, start a few other applications. This is because the
keyboard interface is behaving additively. This means, if you plug 2 keyboards, and press a key on one of them, and
press another on the other one, the OS will see as both of them pressed. So, if you press on your keyboard Mod1 + Mod4,
and sending a stream of keys on the other, they will add up, and you will end up, as you typed the '''Hellow World'''
with Mod1 + Mod4 pressed (Windows + Alt).
Solutions:
**Set a big enough delay at the beginning of your string ('''\D5Hello World'''), so you can release them.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "\D5Hello World"'''
**Set the hotkey to a keychain that ends with a non-modified key
'''Mod1 Mod4 m None b :ExecCommand xvkbd -text "Hello World"'''

=== Some useful macros with a short description ===

* Quick resizes a (bed)room (from the 'q' and set into cursored the bed)
'''Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"'''
'''(Windows + Alt + m) d b'''

* Quick resizes 6 (bed)room, that are inline to the right with a distance of 2 title.
'''Mod1 Mod4 m None d v :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]"'''
'''(Windows + Alt + m) d v'''
b..b..b..b..b..b..x (and the cursor will be stopped at the next item)

* Mass selector. It selects a lot of items from a list ((enter then down) * 39) (this is about 3 page down)) I use this particular macro to sell Junk to traders, without selling the bins. ''(If you select the bin, and then select any item for trading, the bin will be deselected.)''
'''Mod1 Mod4 m None d t :ExecCommand xvkbd -text "\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]"'''
'''(Windows + Alt + m) d t'''
Warning, if you sell ~20 finished goods bins' contents, then you may expect that
the merchants will pack up for a while (probably for a few months).

* Quick macro to build a repeating pattern. For example, you want to build a bedroom, where the dwarf's items are 3 titles apart (2 title between them, and 6 of them). Will select the first available item, so if there's something, you don't want to used, forbid them (coffers / bags).
'''Mod1 Mod4 m None d 3 :ExecCommand xvkbd -text "\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]"'''
Build menu, and select the item, you want to build (with /*-+, not the keycode!, otherwise you end up
one wanted item, and 5 other armor stands) '''(Windows + Alt + m) d 3'''
b..b..b..b..b..x (and the cursor will be stopped at the next item)

Feel free, to add your own macros.

v0.34:Macros and keymaps

2012-03-01T22:36:42Z

Sasf54: /* Some useful macros with a short description */

{{av}}

=== Macros and Keymaps ===

In this context the macro is mean a set of keystrokes / input from the player. Keymap is a set of special key combinations to get special function, or shorten input.

What this is good for?
Did you had a migrants of 20 or more, and you were in trouble of make enough accommodations for them, before they got unhappy thoughts? Were you bored, by the repetitive creation of of a big bedroom? Not to worry anymore, it's possible to break down the task into much less interaction, and to speed up things.

What you need:
under linux:
* fluxbox (or your steady window manager, or shortcut editor)
* xvkbd (or anything, that allows you to type something into an active window / program, as came from stdin)
winder windows:
*a good (free) program, that can do the same, and supports special characters

=== Fluxbox ===

Fluxbox is a tiny window manager, that allows a lot of powerful customization. If you don't want to install fluxbox just for this, you should look for other solutions in your distro (KDE / Gnome). If you use / successfully setup fluxbox [[http://fluxbox.org/help]] you only need to edit .fluxbox/keys files. This contains the keyboard shortcuts.

Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"

Mod1 means windows / command funciton key (If you use keychains, the order of the modificators seems important :( )
Mod4 means alt
m is for the key m (so this will be windows + alt + m (special enough not to used in any other application
(this is important, because if fluxbox is intercepting a hotkey, it not pass along to the active application!))
None the following combinations are not using modifications keys (Important: use your last key in keychain as
non-modified key, or a big enough delay, or else your macro input will be applied to the modifier, you currently
pressing (see below))
d is for key D (like Dwarf Fortress)
b is for key B (as bedroom)
: means, that this is the end of key combinations, and from here the command to apply.

So, to start this particular keychain (hotkey), '''(windows + alt + m) d b'''

:ExecCommand tells fluxbox, to execute the followings

xvkbd this the virtual keyboard we will use
-text tells xvkbd to don't display the virtual keyboard, just get the input from command line
(there's file input is available, but it does not support special keys so easily)
"\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r" This is the input, we will pass to
Dwarf Fortress (which will press r, and gives 12 + and a final enter)
The begining '''\D2''' commands xvkbd to wait 2*100ms. You might want to play with this, but I found,
that I need this, because the first input key is not passed always otherwise.

The + is used on keypad under DF, we access this by \[]. The enter is also a special character, used by \r. You might want to take a peek into the xvkbd's man page for some special keys.

So what this macro does at all:
if you press: if you have large bedroom, and you don't want to make the boring task to create a large bedroom for all the beds, you can manage the bed by '''q''' (task and preferences in DF), and then press '''(windows + alt + m) d b''', which will give the order of '''r''' ++++++++++++ and an enter.

=== Trouble shooting ===

* My first characters are missing from the input
** - You have most probably insufficient delay at the start of the text. Try a bigger number, or a delay at all ('''\D2''')
* My macro fails / I cannot get it work at, and not even prints into a textbox.
** - You might have a last keychain key with a modifier.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "Hello World"'''
This will most probably not give you any output, or even worst, start a few other applications. This is because the
keyboard interface is behaving additively. This means, if you plug 2 keyboards, and press a key on one of them, and
press another on the other one, the OS will see as both of them pressed. So, if you press on your keyboard Mod1 + Mod4,
and sending a stream of keys on the other, they will add up, and you will end up, as you typed the '''Hellow World'''
with Mod1 + Mod4 pressed (Windows + Alt).
Solutions:
**Set a big enough delay at the beginning of your string ('''\D5Hello World'''), so you can release them.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "\D5Hello World"'''
**Set the hotkey to a keychain that ends with a non-modified key
'''Mod1 Mod4 m None b :ExecCommand xvkbd -text "Hello World"'''

=== Some useful macros with a short description ===

* Quick resizes a (bed)room (from the 'q' and set into cursored the bed)
'''Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"'''
'''(Windows + Alt + m) d b'''

* Quick resizes 6 (bed)room, that are inline to the right with a distance of 2 title.
'''Mod1 Mod4 m None d v :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]"'''
'''(Windows + Alt + m) d v'''
b..b..b..b..b..b..x (and the cursor will be stopped at the next item)

* Mass selector. It selects a lot of items from a list ((enter then down) * 39) (this is about 3 page down)) I use this particular macro to sell Junk to traders, without selling the bins. ''(If you select the bin, and then select any item for trading, the bin will be deselected.)''
'''Mod1 Mod4 m None d t :ExecCommand xvkbd -text "\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]"'''
'''(Windows + Alt + m) d t'''
Warning, if you sell ~20 finished goods bins' contents, then you may expect that
the merchants will pack up for a while (probably for a few months).

* Quick macro to build a repeating pattern. For example, you want to build a bedroom, where the dwarf's items are 3 titles apart (2 title between them, and 6 of them). Will select the first available item, so if there's something, you don't want to used, forbid them (coffers / bags).
'''Mod1 Mod4 m None d 3 :ExecCommand xvkbd -text "\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]"'''
Build menu, and select the item, you want to build (with /*-+, not the keycode!, otherwise you end up
one wanted item, and 5 other armor stands) '''(Windows + Alt + m) d 3'''
b..b..b..b..b..x (and the cursor will be stopped at the next item)

Feel free, to add your own macros.

v0.34:Macros and keymaps

2012-03-01T22:33:28Z

Sasf54: /* Important mistakes */

{{av}}

=== Macros and Keymaps ===

In this context the macro is mean a set of keystrokes / input from the player. Keymap is a set of special key combinations to get special function, or shorten input.

What this is good for?
Did you had a migrants of 20 or more, and you were in trouble of make enough accommodations for them, before they got unhappy thoughts? Were you bored, by the repetitive creation of of a big bedroom? Not to worry anymore, it's possible to break down the task into much less interaction, and to speed up things.

What you need:
under linux:
* fluxbox (or your steady window manager, or shortcut editor)
* xvkbd (or anything, that allows you to type something into an active window / program, as came from stdin)
winder windows:
*a good (free) program, that can do the same, and supports special characters

=== Fluxbox ===

Fluxbox is a tiny window manager, that allows a lot of powerful customization. If you don't want to install fluxbox just for this, you should look for other solutions in your distro (KDE / Gnome). If you use / successfully setup fluxbox [[http://fluxbox.org/help]] you only need to edit .fluxbox/keys files. This contains the keyboard shortcuts.

Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"

Mod1 means windows / command funciton key (If you use keychains, the order of the modificators seems important :( )
Mod4 means alt
m is for the key m (so this will be windows + alt + m (special enough not to used in any other application
(this is important, because if fluxbox is intercepting a hotkey, it not pass along to the active application!))
None the following combinations are not using modifications keys (Important: use your last key in keychain as
non-modified key, or a big enough delay, or else your macro input will be applied to the modifier, you currently
pressing (see below))
d is for key D (like Dwarf Fortress)
b is for key B (as bedroom)
: means, that this is the end of key combinations, and from here the command to apply.

So, to start this particular keychain (hotkey), '''(windows + alt + m) d b'''

:ExecCommand tells fluxbox, to execute the followings

xvkbd this the virtual keyboard we will use
-text tells xvkbd to don't display the virtual keyboard, just get the input from command line
(there's file input is available, but it does not support special keys so easily)
"\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r" This is the input, we will pass to
Dwarf Fortress (which will press r, and gives 12 + and a final enter)
The begining '''\D2''' commands xvkbd to wait 2*100ms. You might want to play with this, but I found,
that I need this, because the first input key is not passed always otherwise.

The + is used on keypad under DF, we access this by \[]. The enter is also a special character, used by \r. You might want to take a peek into the xvkbd's man page for some special keys.

So what this macro does at all:
if you press: if you have large bedroom, and you don't want to make the boring task to create a large bedroom for all the beds, you can manage the bed by '''q''' (task and preferences in DF), and then press '''(windows + alt + m) d b''', which will give the order of '''r''' ++++++++++++ and an enter.

=== Trouble shooting ===

* My first characters are missing from the input
** - You have most probably insufficient delay at the start of the text. Try a bigger number, or a delay at all ('''\D2''')
* My macro fails / I cannot get it work at, and not even prints into a textbox.
** - You might have a last keychain key with a modifier.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "Hello World"'''
This will most probably not give you any output, or even worst, start a few other applications. This is because the
keyboard interface is behaving additively. This means, if you plug 2 keyboards, and press a key on one of them, and
press another on the other one, the OS will see as both of them pressed. So, if you press on your keyboard Mod1 + Mod4,
and sending a stream of keys on the other, they will add up, and you will end up, as you typed the '''Hellow World'''
with Mod1 + Mod4 pressed (Windows + Alt).
Solutions:
**Set a big enough delay at the beginning of your string ('''\D5Hello World'''), so you can release them.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "\D5Hello World"'''
**Set the hotkey to a keychain that ends with a non-modified key
'''Mod1 Mod4 m None b :ExecCommand xvkbd -text "Hello World"'''

=== Some useful macros with a short description ===

* Quick resizes a (bed)room (from the 'q' and set into cursored the bed)
'''Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"'''
'''Windows + Alt + m d b'''

* Quick resizes 6 (bed)room, that are inline to the right with a distance of 2 title.
'''Mod1 Mod4 m None d v :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]"'''
'''Windows + Alt + m d v'''
b b b b b b x (and the cursor will be stopped at the next item)

* Mass selector. It selects a lot of items from a list ((enter then down) * 39) (this is about 3 page down)) I use this particular macro to sell Junk to traders, without selling the bins. ''(If you select the bin, and then select any item for trading, the bin will be deselected.)''
'''Mod1 Mod4 m None d t :ExecCommand xvkbd -text "\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]"'''
'''Windows + Alt + m d t'''
Warning, if you sell ~20 finished goods bins' contents, then you may expect that
the merchants will pack up for a while (probably for a few months).

* Quick macro to build a repeating pattern. For example, you want to build a bedroom, where the dwarf's items are 2 titles apart (6 of them). Will select the first available item, so if there's something, you don't want to used, forbid them (coffers / bags).
'''Mod1 Mod4 m None d 3 :ExecCommand xvkbd -text "\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]"'''
Build menu, and select the item, you want to build (with /*-+, not the keycode!, otherwise you end up
one wanted item, and 5 other armor stands) '''Windows + Alt + m d 3'''

Feel free, to add your own macros.

v0.34:Grate

2012-03-01T21:19:01Z

Sasf54: /* Notes */

{{av}}
{{Quality|Fine}}
{{buggy|bugsection=Bugs}}

A '''grate''' is a [[furniture]]-type item. It is used as a construction material for wall grates and floor grates. Grates can be constructed from [[stone]] or [[ore]] (with the [[masonry]] [[labor]] at a [[mason's workshop]]), wood (with the [[carpentry]] labor in a [[carpenter's workshop]]), [[Metal|metal bar]]s (with the [[blacksmithing]] labor at a [[forge]]), or [[glass]] (with the [[glassmaking]] labor at a [[glass furnace]]).

== Wall Grate ==

A wall grate is basically a [[fortification]], but with two differences:
* It is a [[building]] instead of a [[construction]]. It doesn't overwrite the tile below it, and it can be smashed by building destroyers.
* It can be linked to a [[lever]] or [[pressure plate]]. Once linked, it works like a linked [[door]] which doesn't stop fluids, [[arrow]]s or [[Miasma]] when closed.
Wall grates set the boundary for the room being resized, but they do not provide support for the doors construction.
Unlike a constructed wall, the grate has some quality level and can be decorated.

== Floor Grate ==
A floor grate blocks [[creature]] and item movement like a [[floor hatch]], but it lets [[water]], [[magma]], <s>and ranged attacks</s> through like an open tile. <s>It doesn't block line of sight</s>. It can be linked. Triggered, it opens like a hatch, but with a 100-tick delay.

Floor grates must be attached [[orthogonal]]ly (i.e. not diagonally) to firm ground or some solid construction (a [[wall]], [[floor]], etc) if they are to be supported over empty space, not (just) other grates. Floor grates can also be placed directly on top of a non-constructed floor or [[stair]]case, rather than empty space, in which case it doesn't need any support next to it.

A floor grate does NOT count as solid construction. It will not support any buildings or constructions. However, you can designate a construction to be built orthogonally to it with no other supports. This will cause the construction to [[cave-in]] immediately after being completed. This can be useful for controlled cave-ins.

[[Stockpile]]s cannot be placed over floor grates.

Like [[bridge]]s and [[floor hatch]]es, floor grates will mark areas beneath them as being "inside", even if they are retracted.

If a floor grate is place right on top of a [[soil]] floor or [[mud]]dy floor it will prevent [[grass]], [[shrub]]s and [[tree|saplings]] from growing.

Floor grates do not block [[fishing]] or taking water directly from a [[activity zone#Water_Source|water source]], nor do they block collecting [[sand]] or [[clay]], though they do prevent [[well]]s from working if between the well and the water.

== Bars vs. Grates ==

Vertical/horizontal [[bars]] seem to be functionally identical to wall/floor grates. The only notable difference between grates and bars is that grates are finished goods (which must be produced from raw materials) and have [[quality]] levels (and thus boost your fortress's architecture value significantly), while bars are simply raw materials that can be thrown into place at a moment's notice and then deconstructed later should they be needed later for other jobs.

== Notes ==
* If you wish to remove a floor piece that is linked to a grate, make sure that the dwarf that carries out the job does not stand on the grate, or remove all grates first. The grate will not be supported, and fall (with your uncareful dwarf on it), and you will experience the famous equation: "It's not the fall that kills you, it's the sudden stop at the end."
* If you wish to construct a multi strip of floor grate + floor, make sure, the floor is layed first. Otherwise you may experience the floor tearing the floor grates down in a collapse, if a floor title is attached to a floor grate, and no floor title is holding it.

== Bugs ==

* Creatures and dwarves pushed by water flow can be pushed through wall grates. {{Bug|5458}}

{{buildings}}

v0.34:Grate

2012-03-01T21:18:31Z

Sasf54: /* Notes */

{{av}}
{{Quality|Fine}}
{{buggy|bugsection=Bugs}}

A '''grate''' is a [[furniture]]-type item. It is used as a construction material for wall grates and floor grates. Grates can be constructed from [[stone]] or [[ore]] (with the [[masonry]] [[labor]] at a [[mason's workshop]]), wood (with the [[carpentry]] labor in a [[carpenter's workshop]]), [[Metal|metal bar]]s (with the [[blacksmithing]] labor at a [[forge]]), or [[glass]] (with the [[glassmaking]] labor at a [[glass furnace]]).

== Wall Grate ==

A wall grate is basically a [[fortification]], but with two differences:
* It is a [[building]] instead of a [[construction]]. It doesn't overwrite the tile below it, and it can be smashed by building destroyers.
* It can be linked to a [[lever]] or [[pressure plate]]. Once linked, it works like a linked [[door]] which doesn't stop fluids, [[arrow]]s or [[Miasma]] when closed.
Wall grates set the boundary for the room being resized, but they do not provide support for the doors construction.
Unlike a constructed wall, the grate has some quality level and can be decorated.

== Floor Grate ==
A floor grate blocks [[creature]] and item movement like a [[floor hatch]], but it lets [[water]], [[magma]], <s>and ranged attacks</s> through like an open tile. <s>It doesn't block line of sight</s>. It can be linked. Triggered, it opens like a hatch, but with a 100-tick delay.

Floor grates must be attached [[orthogonal]]ly (i.e. not diagonally) to firm ground or some solid construction (a [[wall]], [[floor]], etc) if they are to be supported over empty space, not (just) other grates. Floor grates can also be placed directly on top of a non-constructed floor or [[stair]]case, rather than empty space, in which case it doesn't need any support next to it.

A floor grate does NOT count as solid construction. It will not support any buildings or constructions. However, you can designate a construction to be built orthogonally to it with no other supports. This will cause the construction to [[cave-in]] immediately after being completed. This can be useful for controlled cave-ins.

[[Stockpile]]s cannot be placed over floor grates.

Like [[bridge]]s and [[floor hatch]]es, floor grates will mark areas beneath them as being "inside", even if they are retracted.

If a floor grate is place right on top of a [[soil]] floor or [[mud]]dy floor it will prevent [[grass]], [[shrub]]s and [[tree|saplings]] from growing.

Floor grates do not block [[fishing]] or taking water directly from a [[activity zone#Water_Source|water source]], nor do they block collecting [[sand]] or [[clay]], though they do prevent [[well]]s from working if between the well and the water.

== Bars vs. Grates ==

Vertical/horizontal [[bars]] seem to be functionally identical to wall/floor grates. The only notable difference between grates and bars is that grates are finished goods (which must be produced from raw materials) and have [[quality]] levels (and thus boost your fortress's architecture value significantly), while bars are simply raw materials that can be thrown into place at a moment's notice and then deconstructed later should they be needed later for other jobs.

== Notes ==
* If you wish to remove a floor piece that is linked to a grate, make sure that the dwarf that carries out the job does not stand on the grate, or remove all grates first. The grate will not be supported, and fall (with your uncareful dwarf on it), and you will experience the famous equation: "It's not the fall that kills you, it's the sudden stop at the end."
* If you wish to construct a multi strip of floor grate + floor, make sure, the floor is layed first. Otherwise you may experience the floor tearing the floor grates down in a collapse.

== Bugs ==

* Creatures and dwarves pushed by water flow can be pushed through wall grates. {{Bug|5458}}

{{buildings}}

v0.34:Macros and keymaps

2012-02-29T22:09:41Z

Sasf54: /* Some useful macros with a short description */

=== Macros and Keymaps ===

In this context the macro is mean a set of keystrokes / input from the player. Keymap is a set of special key combinations to get special function, or shorten input.

What this is good for?
Did you had a migrants of 20 or more, and you were in trouble of make enough accommodations for them, before they got unhappy thoughts? Were you bored, by the repetitive creation of of a big bedroom? Not to worry anymore, it's possible to break down the task into much less interaction, and to speed up things.

What you need:
under linux:
* fluxbox (or your steady window manager, or shortcut editor)
* xvkbd (or anything, that allows you to type something into an active window / program, as came from stdin)
winder windows:
*a good (free) program, that can do the same, and supports special characters

=== Fluxbox ===

Fluxbox is a tiny window manager, that allows a lot of powerful customization. If you don't want to install fluxbox just for this, you should look for other solutions in your distro (KDE / Gnome). If you use / successfully setup fluxbox [[http://fluxbox.org/help]] you only need to edit .fluxbox/keys files. This contains the keyboard shortcuts.

Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"

Mod1 means windows / command funciton key (If you use keychains, the order of the modificators seems important :( )
Mod4 means alt
m is for the key m (so this will be windows + alt + m (special enough not to used in any other application
(this is important, because if fluxbox is intercepting a hotkey, it not pass along to the active application!))
None the following combinations are not using modifications keys (Important: use your last key in keychain as
non-modified key, or a big enough delay, or else your macro input will be applied to the modifier, you currently
pressing (see below))
d is for key D (like Dwarf Fortress)
b is for key B (as bedroom)
: means, that this is the end of key combinations, and from here the command to apply.

So, to start this particular keychain (hotkey), '''(windows + alt + m) d b'''

:ExecCommand tells fluxbox, to execute the followings

xvkbd this the virtual keyboard we will use
-text tells xvkbd to don't display the virtual keyboard, just get the input from command line
(there's file input is available, but it does not support special keys so easily)
"\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r" This is the input, we will pass to
Dwarf Fortress (which will press r, and gives 12 + and a final enter)
The begining '''\D2''' commands xvkbd to wait 2*100ms. You might want to play with this, but I found,
that I need this, because the first input key is not passed always otherwise.

The + is used on keypad under DF, we access this by \[]. The enter is also a special character, used by \r. You might want to take a peek into the xvkbd's man page for some special keys.

So what this macro does at all:
if you press: if you have large bedroom, and you don't want to make the boring task to create a large bedroom for all the beds, you can manage the bed by '''q''' (task and preferences in DF), and then press '''(windows + alt + m) d b''', which will give the order of '''r''' ++++++++++++ and an enter.

=== Important mistakes ===

* My first characters are missing from the input
** - You have most probably insufficient delay at the start of the text. Try a bigger number, or a delay at all ('''\D2''')
* My macro fails / I cannot get it work at, and not even prints into a textbox.
** - You might have a last keychain key with a modifier.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "Hello World"'''
This will most probably not give you any output, or even worst, start a few other applications. This is because the
keyboard interface is behaving additively. This means, if you plug 2 keyboards, and press a key on one of them, and
press another on the other one, the OS will see as both of them pressed. So, if you press on your keyboard Mod1 + Mod4,
and sending a stream of keys on the other, they will add up, and you will end up, as you typed the '''Hellow World'''
with Mod1 + Mod4 pressed (Windows + Alt).
Solutions:
**Set a big enough delay at the beginning of your string ('''\D5Hello World'''), so you can release them.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "\D5Hello World"'''
**Set the hotkey to a keychain that ends with a non-modified key
'''Mod1 Mod4 m None b :ExecCommand xvkbd -text "Hello World"'''

=== Some useful macros with a short description ===

* Quick resizes a (bed)room (from the 'q' and set into cursored the bed)
'''Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"'''
'''Windows + Alt + m d b'''

* Quick resizes 6 (bed)room, that are inline to the right with a distance of 2 title.
'''Mod1 Mod4 m None d v :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]"'''
'''Windows + Alt + m d v'''
b b b b b b x (and the cursor will be stopped at the next item)

* Mass selector. It selects a lot of items from a list ((enter then down) * 39) (this is about 3 page down)) I use this particular macro to sell Junk to traders, without selling the bins. ''(If you select the bin, and then select any item for trading, the bin will be deselected.)''
'''Mod1 Mod4 m None d t :ExecCommand xvkbd -text "\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]"'''
'''Windows + Alt + m d t'''
Warning, if you sell ~20 finished goods bins' contents, then you may expect that
the merchants will pack up for a while (probably for a few months).

* Quick macro to build a repeating pattern. For example, you want to build a bedroom, where the dwarf's items are 2 titles apart (6 of them). Will select the first available item, so if there's something, you don't want to used, forbid them (coffers / bags).
'''Mod1 Mod4 m None d 3 :ExecCommand xvkbd -text "\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]"'''
Build menu, and select the item, you want to build (with /*-+, not the keycode!, otherwise you end up
one wanted item, and 5 other armor stands) '''Windows + Alt + m d 3'''

Feel free, to add your own macros.

v0.31:Bedroom design

2012-02-29T21:29:11Z

Sasf54: /* Fractal modified for 3d */

{{av}}
{{quality|Masterwork|02:13, 08 November 2010 (UTC)}}
There are many ways to design the layout of [[bedroom]]s. Simplicity, ease of designating, efficiency, and aesthetics are all important factors in designing dwarven housing. The ability to modify the design to enlarge, improve, or add rooms can be important as well. Proximity of the rooms to [[noise]] should also be considered.

The simplest approach resolving dwarven sleeping requirements is to have all your dwarves sleep in a large communal [[dormitory]]. The smallest ''bedroom design'' possible is a corridor with notched spaces for beds.

Players frequently want designs which maximize positive thought and minimize the path distance between a dwarf's food, drink, job and home. This process is further complicated when the [[dwarven economy]] kicks in, and a wide range of "[[Room#Specific room quality grades|room qualities]]" are needed, and low-budget dwarves are kicked out of any over-priced quarters. To this end, a number of solutions, some surprisingly elegant, have been produced.

Many of the designs shown here were taken from [http://www.bay12games.com/forum/index.php?topic=16901.0 this forum post].

=Minimalism=

Sometimes, simpler is better... not always, but sometimes...

=== 1x1 bed only, no walls ===

By far the most minimal design is to take a bed, place it anywhere you want, then set it as a 1x1 room. This bed 'room' can be assigned to a dwarf early on, or rented once the economy kicks in, and will at least serve the bare minimum purpose of avoiding unhappy thoughts from the lack of a room. It will not, of course, leave the dwarves with any space to store any possessions at all -- but with the economy active, it will also have an absolute minimal rent, which makes it worth having a few such rooms set up. And, of course, it requires the absolute minimum work to set up; all you need is existing empty space, preferably with no noise nearby, and a bed to place in it.

An additional refinement is to expand the room area of each bed to 3x3, deliberately causing them to overlap. This lowers the value of each bed, which in turn lowers the rent and provides some low-rent housing for impoverished dwarves to stay -- it can drop as low as 7 coins depending on the arrangement.

Alternatively if you are building compact merely to save space or improve framerate, a 1x1 bedroom on a smoothed, engraved floor can have quite a high room value, particularly if the beds are packed into a mined out vein of valuable metal or gemstones.

=== Communal dormitory ===

The simplest form of dwarven housing. Stick a bunch of beds in a room, designate a [[dormitory]] from one of them (do not assign the bed to anyone), and voilà, instant flophouse. On maps with no [[tree]]s, this is pretty much your only option for sleeping quarters before breaching a cavern or importing large amounts of wood. (Dwarves will sleep on the floor of the dormitory if no beds are available, which at least keeps them from sleeping in the wilderness.)

This setup only causes a single negative thought ("slept without a proper room recently"), although you miss out the benefit of the happy thoughts generated by personally-owned furniture. However, as long as you compensate by offering your dwarves high-quality [[food]], [[alcohol]], an expansive [[dining room]], and other luxuries, your dwarves will remain happy enough to be productive throughout the life of a fortress. (You may still wish to give [[noble]]s their own rooms, however; they tend to [[mandate|get]] [[demand|upset]] when their [[Noble#Room Requirements Summary|requirements]] are not met)

More than one dormitory can be built in a fortress; if they do not own their own bedroom, dwarves will gravitate to the nearest empty bed when it is time for them to sleep.{{verify}}

=== Plain square design ===
[[Image:square_bedroom.png|right]]
If it is 2×2, 3×3 or more, square designs are probably the first choice of many players. Easy to plan, easy to put in place, this kind of design is one of the best when the player values his playing time instead of the overall layout of his fortress. While square designs are easy to reproduce en masse, most are not optimized either for beauty or space efficiency, two aspects that other designs excel at.

=== Line design ===
[[Image:line_bedroom.png|right|thumb| '''Line design''', laid out (left) and finished (right)]]
Line designs have the advantage of being very space efficient and very adaptative. From 1×1 to 1×4 and longer, it can fit almost anywhere, can be upgraded later on as long as you have the space behind your first original line and do not need excessive corridor space for the bedroom access. Simply dig a few lines out of an access tunnel already in use in your fortress and voilà, you have new living quarters. This kind of minimalistic design is perfect for when the economy kicks in, as it can be adapted in a flash for any kind of low wage citizen.

===Decentralized living===
In larger fortresses, one of the bigger problems is traffic. Dwarves have a tendency to all get hungry, thirsty, and tired in waves, and a crowd of 50 of them storming your centralized food stockpiles, one big dining room, and dormitory tunnels can cause a lot of lost time while the hordes shuffle by each other. A good solution to this is decentralized architecture, incorporating most of the essentials of every day life into numerous smaller areas. This isn't to suggest that you shouldn't have a legendary dining hall set as a meeting area, capable of holding half your fortress at once. You definitely should! But decentralizing from that dining hall relieves a lot of congestion in the halls surrounding the main dining hall, and makes it easier for dwarves just to pass through.

[[image:Living.GIF|right]]
In this image, the access stairwell (blue fields in the center), spread out in all directions to a public dormitory and dining room for poorer dwarves on the left/right and to 3x3 private rooms on the top/bottom. The design allows for two small stockpiles of food (gray fields) to minimize the walk to a dining hall.

There are also built-in areas for impressive things like [[Main:statues|statues]] and [[Main:cages|cages]] (for zoos) to keep dwarves admiring your handiwork. The 3x3 rooms are easy to get up to decent or higher to keep your most useful dwarves happy as clams. They're also convenient for impromptu noble housing, since you can just knock out a wall between two rooms and convert one into a dining room for a whiny noble. You could even expand the corner rooms a bit more on both the X and Y axes to make four 3x3 rooms to give the noble a dining room, tomb, and office all in one area. This is especially useful for the mayor, who gets replaced every so often. When a new Mayor is elected, one can reassign all the trappings to the new mayor in one go. If you want an even more decentralized and calm traffic pattern, put tables and chairs in all the private rooms; dwarves will prefer to eat in their quarters. The walls between the doors leading to the dormitory and Dining Room allow for 2 entrances and 2 exits to each predictably higher-traffic room while leaving a pillar of rock for an engraving. The main corridor also allows you to branch off into 4 restraints per floor in a private 1x2 prison. Since it's flanked by an animal cage and a statue (or alternatively, 2 statues. This may be better because Statues block movement and it's effectively the same as surrounding the prisoner with walls). Additionally, in an area you want smoothed and engraved to begin with, it gives prisoners a leg upon their happiness immediately and -- once again -- prevents traffic jams from convicts being brought food and water in larger prisons.

Another option for maximizing traffic throughput is to put a 1x3 line of upward stairwells on one end of the blue field, and a 1x3 line of downward stairwells on the other. This simulates a 3-wide vertical corridor without the safety risks of up/down stairwells.

You may also, at your discretion, knock out the statues and cages near the stairwell to make the entire plan a little more compact (though you lose the easy prisons in this case). This plan can stretch on the x axis as much as you like, but note that the 1 wide corridors leading to individual rooms can get crowded if more than 10 dwarves are living along each one. Even with the given layout, though, one floor supports 26 private rooms and as many as 14 public beds. This works out quite nicely since one floor is enough to handle most immigrant waves, while existing floors' public beds can handle a decent amount of overflow. The public dormitory rooms can also be converted into prisons very easily (just put chains next to every bed) if you decide not to go with the main design.

=== High density single floor housing ===

[[Image:Housing_by_Marble_Dice.png|thumb|244px|This is the 61x61 housing plan]]

This fractal-inspired design combines space efficiency with wider access hallways to alleviate traffic. Stairs are placed in the middle, and the design can expand indefinitely. To decrease the size, remove the outermost perimeter hallway, and all connected bedrooms. To increase the size, use the picture as a guide and follow the same radial pattern.

{| class="wikitable" style="padding:"
|-
! style="text-align:left;" | Size
! style="text-align:left;" | Capacity
! style="text-align:left;" | Max walk distance from center
|-
| style="padding-right:26px;" | 29x29 tiles
| style="padding-right:26px;" | 48 dwarves
| style="padding-right:26px;" | 23 steps
|-
| style="padding-right:26px;" | 45x45 tiles
| style="padding-right:26px;" | 120 dwarves
| style="padding-right:26px;" | 39 steps
|-
| style="padding-right:26px;" | 61x61 tiles
| style="padding-right:26px;" | 224 dwarves
| style="padding-right:26px;" | 55 steps
|-
| style="padding-right:26px;" | 77x77 tiles
| style="padding-right:26px;" | 360 dwarves
| style="padding-right:26px;" | 71 steps
|}

 

=High density,single floor, quick housing=

[[Image:Dwarf-bedroom-simple.jpg|thumb|250px|This is a 35x35 housing plan]]

This design is nice in that it is very quick to lay since using shift to move the cursor moves in steps of 11 tiles. Additionally the rooms made this way can be used even after the economy activates since it is very easy to increase or decrease their value. Each 1-tile wide walkway is shared by 10 dwarves reducing congestion and each room can fit a bed, a chest and a cabinet leaving 1 free space for any miscellaneous items such as a statue for legendary dwarves, the free space is in the back of the room for the reason that it allows you to place blocking items that cannot be moved over there without sealing your dwarves in/out.

=High density, multi-level=

Optimizing space, minimizing walking distance, these are good things... for some...

===Magical Three-way Doors===

The main point of this design is that it squeezes six bedrooms in a space of six by seven squares. It's meant to be built across several Z-levels, making it take up a minimal amount of practical space. It can be easily mirrored, although that requires a wider corridor (or the use of four bedrooms instead of six on the other side).

{{diagram|spaces=yes|\
Level -1 ¦ Level 0 ¦ Level 1
+-----+ ¦ +-----+ ¦ +-----+
¦..¦..¦ ¦ ¦..¦..¦ ¦ ¦..¦..¦
+-+.¦.+-+ ¦ +-+.¦.+-+ ¦ +-+.¦.+-+
¦.++-++.¦ ¦ ¦.++-++.¦ ¦ ¦.++-++.¦
¦..¦X¦..¦ ¦ ¦..¦X¦..¦ ¦ ¦..¦X¦..¦
¦---+---¦ ¦ ---+.+--- ¦ ¦---+---¦
¦...¦...¦ ¦ ......... ¦ ¦...¦...¦
+-------+ ¦ ¦ +-------+}}

===Sandwich===

A design to move bedrooms vertically spread across many unused Z levels easily. The rooms can be preferentially scaled up or down depending on needs. If space is reserved serves well for expansion of each bedroom as suitable.

The sandwich basically consists of a three tile wide hallway or wider. Up/Down Stairways are evenly distributed in increments which lead to one or more bedrooms as needed. Hatches can be used between the individual bedrooms as vertical doors.

{{diagram|spaces=yes|\
Level -1 ¦ Level 0 ¦ Level 1
+-----------+ ¦ ¦ +-----------+
¦B.¦B.¦B.¦B.¦ ¦ ¦ ¦B.¦B.¦B.¦B.¦
¦..¦..¦..¦..¦ ¦ ------------- ¦ ¦..¦..¦..¦..¦
¦X.¦X.¦X.¦X.¦ ¦ .X..X..X..X.. ¦ ¦X.¦X.¦X.¦X.¦
¦--+--+--+--¦ ¦ ............. ¦ ¦--+--+--+--¦
¦X.¦X.¦X.¦X.¦ ¦ .X..X..X..X.. ¦ ¦X.¦X.¦X.¦X.¦
¦..¦..¦..¦..¦ ¦ ------------- ¦ ¦..¦..¦..¦..¦
¦B.¦B.¦B.¦B.¦ ¦ ¦ ¦B.¦B.¦B.¦B.¦
+-----------+ ¦ ¦ +-----------+}}

The bedroom design can be copied several times further up and down starting from Level 1 or -1 to exploit available space in neighbouring Z levels. The design is excellent as the space surrounding the hallway can be used for directly tying to the dining/meeting hall.

===6-room clusters===

[[File:ClusterBedrooms.png|thumb|350 pix|'''6-room clusters''' ''(click to enlarge)'']]
This one is quite dense. There are six bedroom clusters. They can be built close to each other.

There are 7 6-room clusters here. If 5 Z-Levels of this are built, that's 5*7*6=210, which is plenty for most any fortress.

=== Living Pods (Residential Flats) ===

This design is compact and allows for a large number of rooms. Each room has 3 tiles plus a door. To add to the complex build an apartment level one level above or below the lobby - the stairs allow direct access. The design can be stretched to make the rooms 3x2 or 3x3, or to allow more rooms per floor, depending on your preference. Though not as visually impressive as the fractal patterns it is very efficient in that it can allow for large numbers of dwarves to easily access the main hallway. The pods are very quick to deploy as the interior (mined out) width of the pods exactly equals one {{k|Shift}}+move of the cursor. Highlight a full square with a horizontal shift+move then a vertical. Then ''un''mark the 3 internal walls in both horizontal and vertical directions (each also 1 shift+move distance long), and finally mark in the four staircases. Sixteen bedrooms with extremely efficient pathing laid out in as many seconds.
{{diagram|spaces=yes|\
Upper/lower
Apartment Level: Lobby Level:
+-----------+ +-----------+..
¦..¦..¦..¦..¦ ¦..¦..¦..¦..¦.. O
¦.+-+.¦.+-+.¦ ¦.+-+.¦.+-+.¦.. u
¦-¦X¦-+-¦X¦-¦ ¦-¦X+---+X+-+.. t
¦.+-+.¦.+-+.¦ ¦.++..O........ e
¦..¦..¦..¦..¦ ¦..¦........... r
¦--+--+--+--¦ ¦--¦O...O+--+..
¦..¦..¦..¦..¦ ¦..¦.....¦..¦.. H
¦.+-+.¦.+-+.¦ ¦.++..O..++.¦.. a
¦-¦X¦-+-¦X¦-¦ ¦-¦X+---+X¦-¦.. l
¦.+-+.¦.+-+.¦ ¦.+-+.¦.+-+.¦.. l
¦..¦..¦..¦..¦ ¦..¦..¦..¦..¦..
+-----------+ +-----------+..}}

==== Pod variant ====

This is an example of varying the above to suit personal taste. Three significant changes have been made:

:1) 2 pair of vertical access stairs feed upward, instead of one horizontal hallway.

:2) The entire design has been expanded (to 15x15, vs 13x13 above), but rooms have not been expanded to fill all available space - not yet. That will be done if/as need arises, and many of the 3-tile rooms can become 5- or 7-tile1, or two joined together to become 12-tile suites2.

:3) Allow for a central waterfall with drain system*.

<pre>
Upper Apartment Level(s*): Lobby Level: Lower Apartment Level(s*):
+-----+ +-----+ +-----+ +-----+ +-----+ +-----+
¦..¦..¦ ¦..¦..¦ ¦..¦..¦ ¦..¦..¦ ¦..¦..¦ ¦..¦..¦
¦.+-+.¦ ¦.+-+.¦ ¦.+-+.¦ ¦.+-+.¦ ¦.+-+.¦ ¦.+-+.¦
¦-¦X¦-¦ ¦-¦X¦-¦ ¦-¦X¦-----¦X¦-¦ ¦-¦X¦-----¦X¦-¦
¦.+¦+.¦ ¦.+-+.¦ ¦.+¦+.OOO.+-+.¦ ¦.+¦+..¦..+-+.¦
¦..¦..¦ ¦..¦..¦ ¦..¦.......¦..¦ ¦..¦.+---+.¦..¦
+--+-------+--+ +--¦..###..¦--+ +--¦.¦~~~¦.¦--+
¦XX#~#XX¦ ¦<<#~#<<¦ ¦-¦~¦~¦-¦
+--+-------+--+ +--¦..###..¦--+ +--¦.¦~~~¦.¦--+
¦..¦..¦ ¦..¦..¦ ¦..¦.......¦..¦ ¦..¦.+---+.¦..¦
¦.+-+.¦ ¦.+-+.¦ ¦.+-+.OOO.+-+.¦ ¦.+-+..¦..+-+.¦
¦-¦X¦-¦ ¦-¦X¦-¦ ¦-¦X¦-----¦X¦-¦ ¦-¦X¦-----¦X¦-¦
¦.+-+.¦ ¦.+-+.¦ ¦.+-+.¦ ¦.+-+.¦ ¦.+-+.¦ ¦.+-+.¦
¦..¦..¦ ¦..¦..¦ ¦..¦..¦ ¦..¦..¦ ¦..¦..¦ ¦..¦..¦
+-----+ +-----+ +-----+ +-----+ +-----+ +-----+</pre>Legend:
:X = up/down stair
:< = up stair
:~ = flowing water, in waterfall and drain
:<nowiki>#</nowiki> = [[grate]] or floor [[bars]] over drain
:¦ = solid block at base of waterfall
:O = [[statue]]s (though a [[zoo]] or booze stockpiles could work as well)

Notes:
:1) Expanding out one more tile can create size 5-11 rooms, or size 19 if two are connected.
:2) A size 15 room is ample for any noble, with the possible exception of a [[king|king/queen]].

:<nowiki>*</nowiki> The floor plan for the waterfall/drain system may vary from floor to floor, and by personal taste. Eventually it can be routed off and out one side, and the full interior area of all levels below that reserved for apartments.

''(Note - It's easy to [[flood]] an area with a waterfall such as this - be sure you are familiar with the technique before risking an entire dormitory (or the lower parts, at least) on it.)''

=== Greek Cross design===
[[image:VaniverGreek48.png|right|thumb| 48 tile design]]
Minimizing walking distances requires good use of vertical space. This plan is simple, scalable, and only takes up a few floors - 6 if you have 32 per floor, 4 if you have 48. The maximum walking distance should be less than 20 (walking up/down stairs counts as one distance.).[[image:VaniverGreek32.png|center|thumb| 32 tile design]]

=== Shaft design ===

[[Image:Shaft_bedroom_design.gif|thumb|Shaft bedroom design with a few possible variations.]]

The Shaft design allows various options for entry direction and central "shaft" use. The central shaft may be altered to create dining rooms and offices for minor nobles, "deluxe" bedrooms, hospital beds, or simply more bedrooms. The design can easily accommodate several different room sizes while maintaining efficiency. However, the design utilizes Z-levels for efficiency, and you must build several levels of Shaft designs to accommodate a fully grown fortress.

The Shaft design can fit 20 2x2 rooms, or 30 1x1 rooms.

=== Tileable shaft design ===

The tileable shaft design is a further expansion of the general shaft design above, coming in somewhere between the simple geometric designs and the vastly more complex fractal designs. These are designs that can be symmetrically tiled, that means concatenated in all six directions and are thus suited both for manual design as well as macro-automation. They allow the user to extend the same pattern over very large areas and to easily extend the available space per room up to a given size by tearing down just a few walls. Additionally, they can be suited for bedrooms as well as work and storage.[[Image:tileable_shaft_big.png|thumb|Tileable shaft design with a few possible variations.]]

The downsides are that they're not especially optimized for walking distance or large hallways, and the necessity of the main access shaft on the z-level (stairs) having to be in the central-most tile (marked red in the examples) to allow z-level stacking.

=== Modified Windmill Villas ===

This is the most efficient method I have seen, and it keeps the central stair case as well.

(Calculations use 8 levels)
*Dwarfs per level = 28
*Levels needed for 200 = 7.1
*Max distance (including Z) = 15
*Average distance = 10.2
*Average distance per level = 5.4

[[Image:Modified_Windmill_Villas.png|Modified windmill villas]]

=Repeating patterns & fractals=

Art for art's sake... and if it's functional, so much the better...

=== Tessellated Apartments ===

[[File:Tessellatedrooms.jpg]]

Access can be from above and/or below by the stairs, or a hallway can be run into the dining room level by removing the bedroom at one of the cardinal points. This design can be repeated as far as desired in the X, Y, and Z directions.

===Noble Hive Pods===

A geometric pattern for Noble housing trying for interesting aesthetics and high mobility. The basic tiling pattern is shown on the left; one possible way to join them, involving surrounding corridors and a central staircase and a jillion doors, on the right.

[[File:Noblehive.png]]

=== Fractal designs ===

Betting on design beauty and on geometrical symmetry first, fractal designs can also be, at the same time, very space and walk efficient. They however require a lot of time and space both to plan and execute and are most likely out of reach of all but the most serious players. Fortunately, most of the designs displayed below would be avoided by the most serious players, due to their lack of serious Z-level access and incongruity with almost any general access plan. Most players however agree that they are the most incredible of all the designs around, if not for the sheer challenge of successfully executing something as complex, as for the extra touch it gives to the fortress as a whole once it is done.

[[image:Raynard_square_delight1.png]] [[image:Raynard1.png]]

[[image:Raynard_whirlpool_housing.png]]

[[image:Hactar1_3_branch_tree.png]] [[image:Hactar1_Mandelbrot_Tree.png]]

[[Image:SavokisLeaf08a032.png]]

[[image:Andrelius_Windmill_Villas.png]]

[[image:4bh0r53n_h-fractal.jpg]]

More fractal bedroom designs based upon the H-Tree (pictured above) can be found at [[User:Tenebrous|this user page]].

===Fractal modified for 3d===
This was created by palin88 from [http://www.bay12games.com/forum/index.php?topic=17784.msg17413 Bay12Games forum] in order to make a three-dimensional version of Raynard's Fractal Design.

[[File:Palin88_Bedroom_Design.png]]

===Make placing furniture faster===

If you chosen your design, and it's vertical / horizontal repetitive, you can use keyboard [[macros]] to place all the stuff you're dwarfs need.

{{Buildings}}
{{Category|Design}}

v0.34:Trading

2012-02-27T23:13:09Z

Sasf54: /* Caravan Delay */

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

'''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 [[Broker]] when dealing with merchants in a visiting caravan ({{key|r}} - "''Trader requested at Depot"''). As a [[profession]], the term usually only applies to visiting merchants, or to a dwarf whose highest [[skill]] is [[Appraiser]].

== Trade Depot ==
Building a [[Trade depot]] is a 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 of non-fortress members (only if they are alive, when they are dead they belong to you if you claim the items),{{Verify}}
* the items that are on merchant animals{{Verify}}
* the items that are on the trade depot (they belong to the caravan until they are moved out of it)

See the [[Trade depot]] article for more information on how to interact with it.

==Trading Flowchart ==
{{:Trading/Flowchart}}
After entering 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 broker 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 broker'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 broker.

With more experienced brokers 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 do not have base quality higher than superior, but decorations on a good may be of any quality.{{Verify}}

== Trading cue colors ==

* '''Brown''' Items have been created (or modified) by your fortress. They can be traded away or offered as a gift.
* '''White''' 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.
* '''Purple''' 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.{{Verify}}
* '''Green''' Items have just been gifted to the caravan and they will not trade it back.
* '''Red''' 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. However, a caravan from a different civilization ''may'' accept stolen goods without changing them first.{{verify}}

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 broker 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 (eg, 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]].{{Verify}}

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.{{Verify}}

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}}

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!{{Verify}}

==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.(5,000 in 0.31.25) You cannot offer items that were not made at your fortress; the traders do not want your spare goblin harvest clothes.

'''''Note:''' There are currently no benefits to offering goods to your king; the game developers have stated that this is to be changed in future versions.'' ("''Req174, REASON FOR OFFERING, (Future): There's no point of offering goods to your own king right now.)"''

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 - their refusal to accept back their wooden items is probably a bug which will be removed in a later release, though this has not been verified. It is also worth noting that in-game the only way to acquire wood is by chopping down trees, so it is likely that the elves have developed a method of growing and acquiring wood without killing trees which will be included in later development (unless they are just cutting down trees that have already died naturally).

== Miscellaneous Trading Advice ==

* Several small trades, exiting the trade window each time, '''no longer''' increases the Broker's relevant skills during the early game. {{Verify}}
* Food inside the Trade Depot can go bad. Have a food stockpile nearby so you can quickly haul goods inside.
* 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}}
* 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) to the entrance of the fort and line this with traps; 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) and wooden logs 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, whether stockpiled or utilized in buildings (such as wooden axles, water wheels, windmills, or workshops); 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.  This also seems to apply to elven caravans bringing [[cloth]] (except that cloth that's turned into [[clothing]], [[bag]]s or [[rope]] isn't counted). So if you want elven caravans to ''stop'' bringing cloth, buy up all the cloth that the first few caravans bring and stash them somewhere.
* 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.
* Elves will trade [[Tame]] exotic creatures; '''however,''' once purchased, these creatures will not show up on the Animal section of the [[Status]] screen if you do not have a [[Dungeon master]] (a noble position that is currently bugged).

== 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. In rare cases, goblins will show up in winter.{{verify}} However, in the first year only a dwarven caravan will arrive, although it will tend to arrive later than mid-autumn, unlike previous versions {{verify}}. 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.{{Verify}}

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 (ie. 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.

== Liaisons ==
[[Liaison]]s may be sent with caravans to speak to important 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). Liaisons allow you to choose the type of items that your fortress is interested in, and will focus on bringing more of that kind of item on the next caravan (however, those items will also be more expensive). In turn, they will present a list of the items they're willing to pay more for, which will be effective upon their next arrival.

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

If a liaison is prevented from leaving, they will eventually go [[insane]]. {{Verify}}

==== [[Dwarves]] ====
:''"Our fortunes rise and fall together"''

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 well 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).{{verify}}
* 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, as long as the dwarven civilization is not extinct.{{verify}}
* 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.]]

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.
* is 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. 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.

==== [[Human]]s ====
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.
* is moderately guarded.

==== [[Goblin]]s{{Verify}} ====
A goblin caravan ''may'' arrive if your civilization is at peace with the goblins.

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

== 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]].

== Caravan Delay ==
If a caravan has arrived at your trade depot and is unable to leave for about six months after they arrived, 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.{{Verify}}

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.{{Verify}}

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, specially, if you wish to keep the precious bins, and sell low value items, with low weight.

== Bugs ==

<s>*No one brings wagons, even if there is a clear path to your depot. {{bug|197}}</s> solved
*Wild animals cannot be traded; when a dwarf attempts to move the caged animal to the Depot, the creature is set free.Only aggressive animals?
*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}}

== Loyalty cascade ==
*If you order your military to kill merchants from your own civilization, your soldiers will simultaneously become members ''and'' enemies of your civilization, resulting in a civil war within your fortress. When this happens, all current members of the fortress (excluding incoming migrants) will turn on each other yet they will still be seen as normal working dwarves in the status screens. This will only last for those who were alive ''during'' the attack, they will always be hostile to everyone including incoming migrants (yet they still do their jobs/ follow military orders and work as dwarves although they will interrupt other's work. They will not be shown as enemies in the Units screen).

== Exploits ==

*If you destroy the Depot while they are unloaded you will get the leaving message but they will leave before the building is completely destroyed, so they will not reclaim any of their stuff because it is not available until the building is fully deconstructed. However any animals they had caged will only become friendly, you won't actually own them.

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 '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:Macros and keymaps

2012-02-27T23:05:35Z

Sasf54: Created page with "=== Macros and Keymaps === In this context the macro is mean a set of keystrokes / input from the player. Keymap is a set of special key combinations to get special function, or..."

=== Macros and Keymaps ===

In this context the macro is mean a set of keystrokes / input from the player. Keymap is a set of special key combinations to get special function, or shorten input.

What this is good for?
Did you had a migrants of 20 or more, and you were in trouble of make enough accommodations for them, before they got unhappy thoughts? Were you bored, by the repetitive creation of of a big bedroom? Not to worry anymore, it's possible to break down the task into much less interaction, and to speed up things.

What you need:
under linux:
* fluxbox (or your steady window manager, or shortcut editor)
* xvkbd (or anything, that allows you to type something into an active window / program, as came from stdin)
winder windows:
*a good (free) program, that can do the same, and supports special characters

=== Fluxbox ===

Fluxbox is a tiny window manager, that allows a lot of powerful customization. If you don't want to install fluxbox just for this, you should look for other solutions in your distro (KDE / Gnome). If you use / successfully setup fluxbox [[http://fluxbox.org/help]] you only need to edit .fluxbox/keys files. This contains the keyboard shortcuts.

Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"

Mod1 means windows / command funciton key (If you use keychains, the order of the modificators seems important :( )
Mod4 means alt
m is for the key m (so this will be windows + alt + m (special enough not to used in any other application
(this is important, because if fluxbox is intercepting a hotkey, it not pass along to the active application!))
None the following combinations are not using modifications keys (Important: use your last key in keychain as
non-modified key, or a big enough delay, or else your macro input will be applied to the modifier, you currently
pressing (see below))
d is for key D (like Dwarf Fortress)
b is for key B (as bedroom)
: means, that this is the end of key combinations, and from here the command to apply.

So, to start this particular keychain (hotkey), '''(windows + alt + m) d b'''

:ExecCommand tells fluxbox, to execute the followings

xvkbd this the virtual keyboard we will use
-text tells xvkbd to don't display the virtual keyboard, just get the input from command line
(there's file input is available, but it does not support special keys so easily)
"\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r" This is the input, we will pass to
Dwarf Fortress (which will press r, and gives 12 + and a final enter)
The begining '''\D2''' commands xvkbd to wait 2*100ms. You might want to play with this, but I found,
that I need this, because the first input key is not passed always otherwise.

The + is used on keypad under DF, we access this by \[]. The enter is also a special character, used by \r. You might want to take a peek into the xvkbd's man page for some special keys.

So what this macro does at all:
if you press: if you have large bedroom, and you don't want to make the boring task to create a large bedroom for all the beds, you can manage the bed by '''q''' (task and preferences in DF), and then press '''(windows + alt + m) d b''', which will give the order of '''r''' ++++++++++++ and an enter.

=== Important mistakes ===

* My first characters are missing from the input
** - You have most probably insufficient delay at the start of the text. Try a bigger number, or a delay at all ('''\D2''')
* My macro fails / I cannot get it work at, and not even prints into a textbox.
** - You might have a last keychain key with a modifier.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "Hello World"'''
This will most probably not give you any output, or even worst, start a few other applications. This is because the
keyboard interface is behaving additively. This means, if you plug 2 keyboards, and press a key on one of them, and
press another on the other one, the OS will see as both of them pressed. So, if you press on your keyboard Mod1 + Mod4,
and sending a stream of keys on the other, they will add up, and you will end up, as you typed the '''Hellow World'''
with Mod1 + Mod4 pressed (Windows + Alt).
Solutions:
**Set a big enough delay at the beginning of your string ('''\D5Hello World'''), so you can release them.
'''Mod1 Mod4 b :ExecCommand xvkbd -text "\D5Hello World"'''
**Set the hotkey to a keychain that ends with a non-modified key
'''Mod1 Mod4 m None b :ExecCommand xvkbd -text "Hello World"'''

=== Some useful macros with a short description ===

* Quick resizes a (bed)room (from the 'q' and set into cursored the bed)
'''Mod1 Mod4 m None d b :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r"'''
'''Windows + Alt + m d b'''

* Quick resizes 6 (bed)room, that are inline to the right with a distance of 2 title.
'''Mod1 Mod4 m None d v :ExecCommand xvkbd -text "\D2r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]r\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\[+]\r\[Right]\[Right]\[Right]"'''
'''Windows + Alt + m d v'''
b b b b b b x (and the cursor will be stopped at the next item)

* Quick select items at the trading depot. If you hate to sell the bins too (or trading with elves).
'''Mod1 Mod4 m None d t :ExecCommand xvkbd -text "\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]\r\[Down]"'''
'''Windows + Alt + m d t'''
Warning, if you sell ~20 finished goods bins' contents, then you may expect that
the merchants will pack up for a while (probably for a few months).

* Quick macro to build a repeating pattern. For example, you want to build a bedroom, where the dwarf's items are 2 titles apart (6 of them). Will select the first available item, so if there's something, you don't want to used, forbid them (coffers / bags).
'''Mod1 Mod4 m None d 3 :ExecCommand xvkbd -text "\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]\r\r\r\[Right]\[Right]\[Right]"'''
Build menu, and select the item, you want to build (with /*-+, not the keycode!, otherwise you end up
one wanted item, and 5 other armor stands) '''Windows + Alt + m d 3'''

Feel free, to add your own macros.

v0.34:Crossbow

2012-02-27T17:55:45Z

Sasf54: /* Crossbows in Melee */

{{quality|Fine|08:05, 27 September 2010 (UTC)}}{{av}}{{Buggy}}

:''See [[Weapon]] for a general overview of weapons and related information.''
'''Crossbows''' can be made from [[wood]], [[bone]] or [[metal]]. Wooden and bone crossbows are made at a [[bowyer's workshop]] using the [[crossbow-making]] skill; metal crossbows are made at a [[metalsmith's forge]] using the [[weaponsmithing]] skill.
A dwarf will open fire at a range of '''20''' tiles, but the bolts may travel further and hit something by accident.

== Crossbows in Ranged Combat ==
Crossbows use [[Bolt|bolts]] as their [[ammunition]]. The quality of the crossbow affects the accuracy of the shot, while the material of the crossbow is unimportant.

== Crossbows in Melee ==
In melee combat, crossbows use the [[Hammerer]] skill. [[Cross-training]] your marksdwarves so that they can hold their own in a melee is advisable. Choosing a better material will, of course, result in a more damaging butt-stroke - but crossbows make a poor melee weapon anyway.

== Hunters and Crossbows ==
[[ambusher|Hunters]] use crossbows to hunt with, and will automatically pick one up if they don't already have one. They'll also carry a quiver and bolts. You can modify their ammunition allotment using the [[Military_interface#Ammunition|Military screen]].

Hunters will typically give up on hunting if they run out of ammunition, thus the material of their crossbows is unimportant.

==Bugs==
*If squad is assigned multiple ammo types, dwarves with "individual choice ranged" carry wrong ammo{{bug|1374}}.
{{Category|Weapons}}
{{Category|Military}}

v0.34:Screw pump

2012-02-22T22:00:32Z

Sasf54:

{{quality|Masterwork|21:05, 26 April 2011 (UTC)}}
{{Machine_component|name=Screw pump|key=s|job=[[Pump operator]]
|construction=
* [[Block]]
* [[Trap component#Enormous corkscrew|Enormous corkscrew]]
* [[Pipe section]]
|construction_job=
* [[Architecture]]
* 1 of
** [[Carpentry]]
** [[Masonry]]
** [[Metalsmithing]]
|power=Needs 10 power.
}}
{{av}}

A '''screw pump''' is a small [[building]] that can lift liquids ([[water]] or [[magma]]) from one level below onto the same [[Z-level]] as the pump. It is two tiles by one tile in size, and it can be either manually operated by a [[dwarf]] with the [[pump operator]] job or by being [[power]]ed by [[water wheel]]s and/or [[windmill]]s.

The direction you want the fluid to travel must be chosen at the time of construction. Pumping only occurs in a straight line, and involves a total of 4 tiles in a row - the liquid source, two for the pump, and the output. The "rise" in levels occurs on the first tile, the intake side, from one level below up to the level of the pump*. Pumped fluids can and will flow immediately after being pumped, as normal for that fluid. Pumped fluids will have a [[pressure]] equal to the exit [[z-level]] - a pump never "forces" water to a higher [[z-level]] than the output tile.

:''(* A DF pump can best be imagined as a simple [http://en.wikipedia.org/wiki/Archimedes%27_screw archimedes screw].)''

[[Water#Salt Water|Salt water]] pumped through a pump will desalinate and become drinkable, but only if the cistern has never contained salty water. [[Water#Stagnant Water|Stagnant water]] pumped through a pump will become clean, letting dwarves drink it without getting an unhappy [[thought]] and letting [[doctor]]s clean [[wound]]s without causing an [[Health care#Infection|infection]]. As with desalination, this only works if the cistern has never contained stagnant water.

''For a basic overview of how the different machine parts work and work together, see [[machinery]].''

== Construction ==

Building a screw pump requires an [[Trap component#Enormous corkscrew|enormous corkscrew]], a [[block]], and a [[pipe section]]. The construction itself is completed in two stages. First a dwarf with the [[architect]] labor must design it. Then a dwarf (the same or a different one) with the appropriate labor must complete the building. This could be [[carpentry]], [[metalsmithing]], or [[masonry]], depending on the material of the block.

To select pump, use keys {{k|b}}-{{k|M}}-{{k|s}}. It's important to choose the proper orientation for your pump, where it will draw water from and where it will deliver the water. This is determined before placement with the {{k|u}}, {{k|m}}, {{k|k}}, or {{k|h}} keys, and the text at the top of the sub-menu will change to confirm your choice. The default (as shown above in the sidebar), "pumps from the north" (top). The ''light'' green X must be next to the liquid source and the ''dark'' green X is where the liquid exits the pump.

[[Image:Small pump.jpg|thumb|right|300px|'''Basic Side View of a Pump'''. This pump "pumps from the west", from left to right. The area to the right may fill to the top of that level, but no more (See [[pressure]]; see [[Screw pump#Pump Stack|Pump stack]]). Note that the entire space required is 4 tiles long by 1 tile wide, not including any retaining walls for the outflow. If pumped manually, the [[pump operator]] stands in the light-colored area, as the dark-colored is impassable to both fluid and movement. ''(Although the "liquid" is shown as blue, this can work for [[magma]] as well, with the [[magma-safe|appropriate precautions]].)'']]

The example shown in the infobox above "pumps from the north" (top) to the south (bottom). If pumped manually, the dwarf stands on the light-colored tile, as the dark-colored is impassable.

The orientation is visible after placement by using {{k|q}}uery over or near that pump or during placement, using UMKH to select the direction of input. Orientation of a pump cannot be changed after being constructed, but, as with any building, it can be deconstructed into its component parts and rebuilt as and where desired.

Having specified the direction of travel, you must ensure that the source side of the pump is placed adjacent to and above (in the [[z-axis]]) a liquid. The screw pump will draw the liquid up from below its level, and distribute it out of the other side of the pump.

== Notes ==

* The source of the pump must be directionally adjacent to "Open Space" that is directly above a source of liquid. The adjacent space cannot be a floor, stairway or wall suspended over water. Screw pumps can pull water through a [[grate]], floor [[bars]], or a [[construction|constructed]] [[fortification]] on the Z-level below.
* The light pump tile is where a pump operator will stand (if the pump is not powered mechanically). Liquids to be pumped must be 1 level below the (empty) area adjacent to this tile.
* Dwarves must be able to access and stand on the light tile of the pump in order to build the pump and then to be able to operate the pump manually.
* The dark pump tile is on the output side. Liquids will appear in the tile adjacent to this.
* The dark pump tile blocks liquids flow and creature movement, and can be built between wall segments to create a solid barrier. The light tile of the pump does not block flow or movement.
* Pumps can also be used in conjunction with a [[water wheel]] or a [[windmill]] to become self-powered.
* Active mechanisms connected to the pump will automatically start the pump; to prevent this either restrict liquid flow using floodgates or hatches, or put in a [[gear assembly]] linked to a [[lever]] to disconnect the [[power]].
* Adjacent pumps ''automatically'' transfer mechanical power to any other adjacent pump(s); no [[axle]] or [[mechanism]] is required. If too many pumps are adjacent, there may be insufficient power to power them.
* Dwarves operating pumps do '''NOT''' generate power. Thus, one cannot use a single [[pump operator]] to power an entire pump stack.
* A hatch above the input tile (on the same level as the pump) that is linked to a trigger (a [[lever]] or [[pressure plate]]) makes an effective on/off switch for that pump.
* In order to build pumps in a "hanging" state, as in the stacked screw pump example (below), one of its tiles must be able to connect to a nearby machine, either already existing or designated to be built. If, when the screw pump's construction is completed, the supporting mechanism has not yet been completed, it will promptly collapse into its component parts.
* Pumps do '''not''' push liquids '''up''' additional Z-levels above them. They only deliver water to their own level. That is, if you direct the output of a screw pump into a 1-square space surrounded by walls, the water will not "overflow" the walls. Consequently, a pump will refuse to move liquid if the level it is pumping to is completely filled. Higher levels can be achieved using a "pump stack" (below). (See [[Pressure]])
* In order to safely pump magma, you must use [[magma-safe]] materials, though magma-unsafe metals have been observed to be safe unless the open tile is going to be submerged in magma. Wooden parts (except for [[nether-cap]]s) will burst into flames the instant the pump is activated, and magma-unsafe stone [[block]]s melt after a short time. Despite the requirement for magma-safe materials, the exterior of the pump does not heat up, and dwarves do not mind operating a magma pump directly.
* Magma, which normally has no pressure, will behave as though pressurized when pumped. For example, when pumped into an U-turn, magma will come out at the other end. Normal (non-pumped) magma would just pool at the lowest level. This may be either very useful (can be used to build pressure towers for magma) or deadly (forge level flooded with magma, because someone tried to pump magma into a volcano).
* Pump's pseudo-pressure doesn't work across diagonals. If there is a diagonal-only passage in your tunnel, liquids will seep slowly through it, instead of bursting through above their normal maximal speed, like they would if there was good passage.
* The liquid in a pump's intake tile must have a depth of at least 2/7 for the pump to be able to remove any amount of liquid from it.
* If a pump's intake tile on the z-level below the pump becomes blocked (as with a cave-in or magma cooling into obsidian) the pump will still run but not pump any fluid.
* If a pump's output tile contains magma and the pump is pumping water or vice versa, the output tile will be turned into [[obsidian]].

====Common mistakes====
* Orienting a pump incorrectly, and/or not having a proper open liquid source.
* Pumping water into an area with a path to other parts of your fortress. (The pump may work perfectly - the fortress quickly [[flood]]s.)
* Expecting water to rise up above the same level of a pump.
* Building a wall attached only to the light tile - this leaves a diagonal leak between the wall and the dark tile unless sealed there. (If that's not a problem, don't worry about it.)
* Having stairs as input tile. Stairs block input tile, thus rendering the pump useless, even though liquids usually ignore stairs. Output tile can be any liquid-passable tile.
* Not channeling below the impassable tile of an individual pump in a pump stack. This is how power is transmitted to the pump below.
* Pumping magma into a lower z-level (same as the source) and then being surprised it is forced back up to the pump's z-level further down the line (where you were planning your magma forges, for example.)

== Example layouts ==
=== Single pump ===

[[Image:jt_screwpump.png|frame|left|A screw pump delivers from the level below to the tile in front. This pump pumps from the right to the left. The "dark tile" would be on the left - that entire tile is impassible to movement and fluids.]] 
=== Pump stack ===
[[File:PumpStack2010.png|thumb|right|300px|'''Illustrated Side View of a Pump Stack.''']]
[[File:PumpStackTopView.png|thumb|right|300px|'''Illustrated Top View of a Pump Stack Layer.''']]
[[File:Pumpstack.gif|thumb|right|'''Animation showing the general construction using an isometric projection.''']]

A Pump stack is a method used to draw water or magma vertically across multiple z-levels requiring a minimum of parts. The basic functionality is possible because the Output (dark) side of the pump can be built over open space with a machine component located directly below, in this case another Screw Pump. Note that for power to properly transfer the intake (light) side of the pump must line up with the output (dark) side of the pump on the floor above it through a space in the floor, as in the illustration.

A pump stack minimizes the amount of machinery required to lift water or magma by allowing for power to be supplied directly to only the most accessible pump (typically the topmost) which in turn allows the player to operate a stack limited only by how many windmills/water wheels they can fit into the area. The price of optimal parts density is fragility: each pump relies on the pump below it for support. If [[forgotten beast|anything]] breaks a pump in your stack, every pump above it will be disassembled. This means that a single pump accidentally assembled with non-[[magma-safe]] parts can cause an entire magma pump stack to spontaneously disassemble.

Typical applications for a pump stack include moving magma from a lower level (often the [[magma sea]]) up to a convenient level for forges and furnaces, extracting water from a flooded fort, raising water for a decorative [[waterfall]] (and extracting it afterwards), or any other purpose that requires water/magma on a z-level significantly above its current location.

The Illustrated Top View of a Pump Stack Layer shows a basic section of a pump stack. Only the door (or a floodgate) on the Containment side is strictly necessary in order to prevent flooding. Two doorways are used here, each lining up with the solid ground within the pump assembly, in order to prevent workers from trapping themselves after digging channels or assembling the pump.

Be warned: pump stacks move water '''fast.''' If you are pumping from a large reservoir into an open area, be prepared for a huge outflow, roughly akin to the kind of water dump you'd get if the whole reservoir was balanced above the pump output and then released. If you are using pumps to empty a large underground reservoir (or, say, a flooded fortress) onto open land, use an aqueduct or some other method to make sure the pump system outlet is a good distance away from anything you wouldn't want to get drenched.

As an alternative to a large reservoir, it is also possible to combine a [[Dwarven Atom Smasher]] with the top layer of the Pump Stack to create a "vacuum cleaner" of sorts.

====Tips====

* Ramps can be used in place of channeling. Liquids will transmit through ramps, unlike stairs, and when pumps are constructed they annihilate the ramp they're built on much as walls do. Power will still be transmitted, so they don't need to be removed by miners prior to pump construction. Ramps make it virtually impossible to strand your miners and allow the stack to be dug out using only access doorways on the intake side of the pump, so no construction or doors are later needed to eliminate leaks. A pump stack can be very rapidly carved out with this method as even if a miner/builder is trapped on the containment side of a pump, they can walk up the ramp to the intake side of the pump above and walk out.
* Power can be transmitted to the stack by channeling out the tile directly above the intake (light) tile of the topmost pump and mounting a gear assembly. If the gear assembly is supported by an adjacent gear assembly or horizontal axle on a stable floor (be careful to not have that adjacent gear assembly disengage via lever), this will allow the stack to hang from the gear assembly. If a lower pump needs to be removed, or should self-destruct, the problem of the entire pump stack disassembling described above is eliminated. Further, if the supported gear assembly is built first, the pump stack can be built both from the top and bottom simultaneously, halving construction time, assuming that sufficient attention is paid to make sure that the pumps will align with the proper orientation when the two partial stacks meet. Properly channeling/ramping out the stack should ensure this.
* When pumping water or magma, make sure any underground soil tiles on the containment side of the stack are covered with a [[construction|constructed]] floor or [[fortification]] to prevent subterranean trees from growing and blocking flow of the stack. The material need not be magma-safe, and fortifications have the added advantage that, when used with water, they will never become muddy.

===Improved Magma Pump Stack===

Because a pump stack pumping magma is known to cause significant [[Maximizing_framerate|lag]], a [http://www.bay12forums.com/smf/index.php?topic=72296.0 new type of pump stack] was developed by [http://www.bay12forums.com/smf/index.php?action=profile;u=19835 NecroRebel] that causes a much smaller drop in [[FPS]]. Changing the single tile magma chamber at the output of every pump from a 1 by 1 to a 3 by 3 area reduces the lag to 1/15th of that caused by the original pump stack. The designer hypothesizes that the larger chamber requires many fewer temperature calculations when magma is pumped in or out; that also implies that there will be no improvement for water pumps.

====Newer Magma Pump Breakthroughs====

Newer breakthroughs in magma pump design has since made the 3x3 reservoir design obsolete.
NecroRebel has tested a [http://www.bay12forums.com/smf/index.php?topic=72296.msg1772802#msg1772802 1x3 head-over-tail variation] (which is very similar to [[Screw_pump#Pump_stack|the typical 1 by 1 pump stack]]) as well as a [http://www.bay12forums.com/smf/index.php?topic=72296.msg1795907#msg1795907 2x3 head-over-head variation]. Both of these new designs require less space and work as effective as his original 3x3 reservoir head-over-head design, with no significant drop in FPS. The 1x3 head-over-tail design has the advantages of requiring the least amount of space and being simple to refit from the standard 1 by 1 water pump stack.

====Some other Notes====

* If pump is not used for a time, and the title under dries up, on some rare occasions a tree can grow under the intake. Pumps don't like this (maybe the tree's branches (mushroom's hat) plug the pump), and will not work.
* If a pump output is not directed, and the water is flowing everywhere around, than the pumping dwarf can easily scared of the splashing waves. (Trying to drain a lake?)

{{buildings}}

v0.34:Grimeling

2012-02-19T23:26:49Z

Sasf54:

{{quality|Fine|19:32, 11 October 2010 (UTC)}}
{{Creaturelookup/0
|wiki=no
|contrib=yes
}}
{{av}}
{{creaturedesc}}

Very tough monster, avoid combat with unexperienced dwarves. Very difficult to kill with smashing weapons, best to just chop its head off.

Unarmored, civilian dwarf have no chance. However a common metal armor make an excellent protection. After quipping your soldiers with metal armor it's very good for combat practice, even with training weapons. I tried with 4 soldier against 1 Grimeling. Will give you quite an arena show for your money, so be prepared to have the heavy dwarf ready, when your trainingies getting tired.
{{gamedata}}
{{Creatures}}
{{Category|Animals}}

v0.31:Ogre

2012-02-19T23:06:59Z

Sasf54:

{{Quality|Exceptional|01:53, 14 September 2010 (UTC)}}
{{Creaturelookup/0
|wiki=no
|contrib=no
|death=nobutcher
}}
{{av}}
{{creaturedesc}}

'''Ogres''' are huge, violent humanoids found in evil plains. They are highly aggressive, able to destroy buildings and strong enough to make short work of [[dog|war dogs]] and inexperienced dwarves. Ogres usually appear in groups of 1-3, which can prove a deadly threat to a new fortress. An attack by ogres in the very beginning will make short work of most unprepared embarking attempts.
Ogres are now also seen in sieges, where goblins may bring them instead of trolls. It is interesting to note that a clothed ogre is a lot tougher than a troll, as in able to often shrug off masterfully wielded, masterwork steel battleaxe strikes.

Ogres, Ogresses are easy to give in to pain, from a couple of bone bolts.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.34:Grimeling

2012-02-19T23:01:57Z

Sasf54:

v0.31:Activity zone

2011-05-31T21:16:46Z

Sasf54: /* Garbage Dump */

{{quality|Fine|08:37, 14 September 2010 (UTC)}}{{av}}

'''Activity zones''' are areas in which {{l|dwarf|dwarves}} are instructed to perform specific tasks, such as {{l|fishing}}, dumping objects, or collecting {{l|water}}. While activity zones are optional for the performance of certain tasks (fishing, collecting water) and obligatory for certain others (dumping), they can also be used to help keep dwarves out of {{l|fun|danger}}.

Activity zones can be placed in any {{l|revealed tile}}, including in {{l|open space}} or over a {{l|river}} or on top of a {{l|building}} or {{l|stockpile}}. They are placed in one of three ways: rectangular, flow, or floor flow. From within the Zones {{l|menu}}, ({{K|i}})Pressing {{K|e}} in the Zones menu cycles through each method, and pressing {{K|Enter}} begins designation. Rectangular zones are placed in the same manner as stockpiles, specifying two corners of the rectangle. Flow and floor flow are placed similarly to designating rooms from pieces of furniture using {{K|+}}/{{K|-}} to adjust the size (floor flow excludes walls). After that the zone has to be assigned to one of the listed tasks to become functional, by pressing the proper key. In some cases ({{l|healthcare|hospital}}, pit/pond) additional orders can then be set from the same menu.

The location of a zone is only visible while in the Zones menu, and any object lying on the ground will hide the presence of a zone tile.

== Water Source ==
:Shortcut {{k|w}}
Dwarves will draw water from this zone to satisfy their thirst, to tend to another thirsty dwarf, or to fill a Pond zone.

Only tiles '''adjacent''' to water qualify as usable water sources - thus, if you want to place a single-tile zone, place the zone onto a ground tile next to the water, not over the water itself.

== Fishing ==
:Shortcut {{k|f}}
The same above advice for '''water source''' zones is applicable to fishing zones. You cannot fish through a {{L|grate}} or {{L|well}} {{verify}}, it must be an open source of water.

== Garbage Dump ==
:Shortcut {{k|g}}

Garbage dump zones are areas in which dwarves will throw items specifically designated by using {{k|k}} then {{k|d}} for single items at a time, or {{key|d}}, {{key|b}}, {{key|d}} to designate a larger area to be dumped (or use the mouse to point and click). Garbage dumps are not the same as {{l|Refuse#Refuse|refuse}} stockpiles, which can be designated to accept any specific type(s) of refuse-type item, such as animal {{l|corpse}}s or {{l|bones}}, and then are randomly filled by haulers as the items become available on the map.

Garbage dumps:
:* Only accept items that have been marked for dumping.
:* Require dwarfs to have {{L|refuse hauling}} {{L|labor}} enabled.
::* Are subject to refuse orders (''{{k|o}}: Set Orders and Options -> {{k|r}}: Refuse Orders''). Most notably, dwarves will not dump items that are outside unless you allow them to ({{k|o}}->{{k|r}}->{{k|o}}).

To place a garbage dump, trace a zone on either a relatively empty plot of land or adjacent to a cliff face or hole. If a garbage zone is designated beside a {{L|cliff}} or hole (both natural or dwarf made) garbage will be thrown off/in the z-space. Each ground tile within that zone is considered a garbage dump tile; thus, if you want to place a single-tile zone, place the zone onto a ground tile (optionally adjacent to a cliff or {{L|pit}}), not onto an {{L|open space}}.
Items dumped into {{L|magma}} (provided they are not {{L|magma safe}}) will disappear permanently. Otherwise a single tile (either a dump zone, or the ground below the open space) will hold any number of dumped objects.

Once items are dumped they are automatically marked as "{{l|forbid}}den" however they will not dump items that are also forbidden. If you wish to use dumped items, you need to reclaim them. Press {{k|k}} to view the item and {{k|f}} to toggle forbid status. You may also use the reclaim {{L|designation}} to reclaim simultaneously all of the items dumped by using {{key|d}}, {{key|b}}, {{key|c}} and tracing the designation over top of the objects.

If a garbage dump is located next to open space, dwarves will always stand on a garbage dump square when throwing ''into that open space'', even if it could potentially be done more efficiently. If a garbage dump is located next to multiple tiles of open space, they seem to prefer the one farthest to the northwest. If a tile to the north and a tile to the west are the only tiles available, they will throw to the west. Since falling objects do not hurt dwarves, such garbage dumps can be a very efficient method of moving materials to the lower levels of your fortress.

Dwarves seem to throw dumped items in the nearest available garbage dump, although this is probably not reliable given that they don't always use the nearest available item to make things at workshops. If a nearer zone becomes available as they are traveling to a zone they will ignore it. Also, they seem to prefer dumps that allow them to throw things in to open space regardless of how far away they are.

Probably due to a bug, dwarves periodically ignore items that are meant to be dumped. Viewing the item by pressing {{k|k}} then toggling forbid and dump status on, then off again {{k|f}}->{{k|f}}->{{k|d}}->{{k|d}} seems to correct this problem.

Previously dumped items are regarded as 'refuse' and will not be recognized (or re-dumped) unless 'gather refuse from outside' is enabled in your orders.

:Notes
* Garbage dumps are great space savers, becuase can hold infinite items on one title. If the dump is designated inside a workshop, it does not even cluttered because of this.
* It may be a good idea, to set a garbage dump in a stone workshop, than fill it with nearby stones. Reclaim them {{k|d}}{{k|b}}{{k|c}}, but make sure, that your dwarfs will not haul them into a far stone stockpile.
* However, if you put a garbage dump inside a magma workshop with the intent of dumping ores there, make sure the zone does not overlap any open pits of magma you may have carelessly left around, or as per the intended behavior, items will be dumped into the magma.
* If you designate an area {{k|d}}{{k|b}}{{k|d}} to dump, please notice, everything in that area will be dumped, starting from the deepest item. This means, if you have a food stockpile, with a barrel, inside some bags with dwarven flour, than both the barrel, bag, and flour will be designated for dump, and the order will be: flour (you will lose any milled plant / liquid if hauled from the container), bag, barrel.
* if you want to quick sort out a stockpile (make several plant specific ones instead of one plant stockpile), dump your barrels (one by one {{k|k}}{{k|d}}), and all your barrels are inside the garbage dump, you can area dump it {{k|d}}{{k|b}}{{k|d}} making your dwarfs to run much less. (Technicall they should just stay still, and unload the contents). After you finished (and redesignated your new plant specific stockpiles), claim your plants and barrels {{k|d}}{{k|b}}{{k|c}}.
* If you designated items for dumping, but forget to mark an active garbage dump, your dwarfs will continue hauling / using the item, till an active garbage dump is marked.

== Pen/{{L|Pasture}} ==
:shortcut {{k|n}}

A pen or a pasture is used to contain tame animals. Once one is created, animals must be assigned to it individually by pressing {{k|N}} from the zone information screen. Dwarves will drag the assigned animals to the pen or pasture automatically. As of version .31.19, many domestic animals will become hungry and starve if not assigned to a pasture with [[grass]] or fungus (note that the assigned creatures can eat all of the grass in a pen/pasture and then starve). Any tame creature with the "grazer" token in the raws should be assigned to a pasture. This includes pigs, mules, cows, goats, horses, yaks, unicorns etc. Animals will not typically wander out of their assigned pasture even if it is not walled in, however an exposed pasture may lead to premature slaughter at the hands of invaders. Since pets can be assigned to pen/pastures and a zone can be created under a [[dwarven atom smasher]], this is one of the easiest ways to prevent [[Catsplosion|catsplosions]].

== Pit/Pond ==
:Shortcut {{k|p}}

A Pit/Pond requires a {{L|ramp}} or hole with adjacent flooring on which a dwarf can stand. Designate the zone from the top of the ramp or hole, such that the zone designation is floating in the open space above the floor of the pit/pond. By default, the zone will be a pit. To change it to a pond, press {{k|P}} then {{k|f}}. It can be changed back to a pit the same way.

Creatures can be assigned to a pit/pond through the {{k|P}} menu. A dwarf will lead the beast to the ramp or hole and throw it in. If the pit is a ramp rather than a hole, the creature will then wander back out, as it will if the pit has some other exit path (which would include straight back up the hole for flying creatures).

Note that not all hostile creatures can safely be dragged to a pit opening. Large creatures and thieves/snatchers will escape on being released from their cage. See {{L|Mass pitting}} for more information on pit design involving hostile creatures.

The only real difference between a pit and a pond is that dwarves will attempt to fill a pond with {{L|water}}, carried by {{L|bucket}} from a water source. They will stand on the floor adjacent to the top of the ramp or hole, and toss the water onto the ramp or into the hole. Each bucketful increases the depth of the water in the tile below by 1/7. Once the water is dumped from the bucket, the dwarf will either drop the bucket and perform a different task, or choose to fill a pond zone tile again using the bucket (s)he currently holds.

Dwarves will stop scheduling the Fill Pond job when the water depth reaches 6/7.

Specifying a pond zone is one technique used for {{L|irrigation}}, in order to make {{L|mud}} for {{L|farming}} on areas without soil.

Currently, no matter how large the designated pond area, only one dwarf at a time will try to fill the pond. In order to fill a large area quickly, it is necessary to designate multiple smaller pond zones (or several zones overlapping the same area).

If you have more than one pond designated as a water source, your dwarves may endlessly try to fill each pond with the other pond's water, making a loop of useless duty.

== Sand Collection ==
:Shortcut {{k|s}}

Sand collection zones are important in the {{L|glass industry}}. They may be placed anywhere, but are only useful when actually placed on {{L|sand}}.

== Clay Collection ==
:shortcut {{k|c}}

Clay collection zones are important in the [[ceramic industry|ceramics industry]].

== Meeting Area ==
:Shortcut {{k|m}}

Meeting area zones are zones in which idle dwarves and animals will congregate, similar to meeting halls. Additionally, immigrants will collect at a meeting area until their "migrant" status wears off.

Note that the {{l|wagon (embark)|wagon}} you {{l|embark|arrive with}} constitutes a meeting area until you designate the first meeting area of your own. If you start in hostile surroundings it is important to get your dwarves and animals out of danger quickly.

It is a good idea to have at least one meeting area, of one form or another: it allows you to make off-duty dwarves and animals gather in an area where they are not vulnerable, such as within the fortress.

There are several ways to designate a meeting hall. The preferred method is to use an Activity zone; type {{k|i}}, set up a zone, and mark it both "active" and "meeting". {{L|Sculpture garden|Statue gardens}} and {{L|zoo}}s are intrinsically meeting halls, as are {{L|room}}s defined from a {{L|well}}. However, you can also create a Meeting Hall.

A meeting area filled with dwarves increases the social skills of idlers. It makes idle dwarves a little less idle, and makes selecting a replacement broker easier. Because almost every dwarf visits a meeting hall at least occasionally, it's an ideal place to site valuable objects and buildings. A meeting hall exposed to sunlight will prevent dwarves from becoming {{L|cave adaptation|cave-adapted}}.

Be warned that having dwarves socialize will often result in them becoming {{L|friend}}s (or forming a {{L|grudge}}).

== Hospital ==
:Shortcut {{k|h}}

A Hospital zone is an area designated for the {{L|Healthcare|care and treatment}} of sick and {{L|Wound|wounded}} dwarves.

===Setting up a Hospital===

While there are no particular restrictions on the areas that can be set as hospital zones, a hospital requires certain {{l|furniture}} and supplies to function properly:

{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
|-
! Furniture
! Function
|-
| {{L|Bed|Beds}}
| Allow sick dwarves to {{L|Rest|rest}}
|-
| {{L|Table|Tables}}
| Used in surgery{{Verify}}
|-
| {{L|Traction bench|Traction benches}}
| Immobilize dwarves who need to stay still to heal
|-
| {{L|Container|Boxes/Bags}}
| Storage for medical supplies
|}

{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
|-
! Medical equipment
! Function
! Unit quantity*
|-
| {{L|Thread}}
| Required for suturing wounds
| 15000
|-
| {{L|Cloth}}
| Required for bandages
| 10000
|-
| {{L|Splint|Splints}}
| Used to bind broken bones{{verify}}
| 1
|-
| {{L|Crutch|Crutches}}
| Walking aid for dwarves with leg injuries
| 1
|-
| {{L|Gypsum plaster|Powder for casts}}
| Used to make plaster casts for setting bones{{Verify}}
| 150{{Verify}}
|-
| {{L|Bucket|Buckets }}
|
*Used by doctors to carry water for cleaning patients
*Used by dwarves with the Feed Patients/Prisoners labor to water patients
| 1
|-
| {{L|Soap }}
| Used to reduce infections when washing patients
| 150
|}

''*The unit quantity is the quantity of each item that appears in the Hospital Information screen when one object of that type is stored. For example, if one bolt of cloth is stored in the hospital zone, the hospital will report that it contains 10000 cloth.''

In addition to furniture and medical supplies, a {{L|Water|source of water}} is more or less mandatory, as sick dwarves need it for drinking as well as cleaning. The water source need not be in the hospital zone, although the shorter the distance between the two the better.

When the Zones menu ({{k|i}}) is open and the cursor is in a hospital zone, {{k|H}} will bring up the Hospital Information screen. This screen shows the quantity of each type of furniture piece and medical equipment present in the Hospital, and allows you to set the desired quantity of each type of equipment. Note that you must have boxes or bags constructed in the hospital zone for supplies to be stored for medical use; items in a stockpile do not count for the hospital, even if the stockpile is in the hospital zone.

===Hospital Beds===

When a dwarf becomes sick or {{l|wound}}ed, he will be carried to a {{l|bed}} in a hospital zone by a dwarf with the Recovering Wounded labor set, assuming such a bed is available; otherwise, he may be carried to a bed in a {{L|barracks}} or {{L|dormitory}}, or to an unassigned bed. If an injured dwarf is resting in a bed outside a hospital zone, he will remain there even if hospital beds become available. Deconstructing the sick dwarf's bed may cause him to be move to a hospital bed, however, and it may be possible for doctors to treat patients who are resting outside of a hospital zone, so long as adequate supplies are available.{{verify}}

v0.31:Grate

2011-05-31T21:15:02Z

Sasf54: /* Notes */

{{av}}
{{Quality|Fine}}

A '''grate''' is a {{L|furniture}}-type item. It is used as a construction material for wall grates and floor grates. Grates can be constructed from {{L|stone}} or {{L|ore}} (with the {{L|masonry}} {{L|labor}} at a {{L|mason's workshop}}), wood (with the {{L|carpentry}} labor in a {{L|carpenter's workshop}}), {{L|Metal|metal bar}}s (with the {{L|blacksmithing}} labor at a {{L|forge}}), or {{L|glass}} (with the {{L|glassmaking}} labor at a {{L|glass furnace}}).

== Wall Grate ==

A wall grate is basically a {{L|fortification}}, but with 2 differences:
* It is a {{L|building}} instead of a {{L|construction}}. It doesn't overwrite the tile below it, and it can be smashed by building destroyers.
* It can be linked to a {{L|lever}} or {{L|pressure plate}}. Once linked, it works like a linked {{L|door}} which doesn't stop fluids, {{L|arrow}}s or {{L|Miasma}} when closed.
Wall grates set the boundary for the room being resized, but they do not provide support for the doors construction.
Unlike a constructed wall, the grate has some quality level and can be decorated.

== Floor Grate ==
A floor grate blocks {{L|creatures|creature}} and item movement like a {{L|floor hatch}}, but it lets {{L|water}}, {{L|magma}}, and ranged attacks through like an open tile. It doesn't block line of sight. It can be linked. Triggered, it opens like a hatch, but with a 100-tick delay.

Floor grates must be attached {{L|orthogonal|orthogonally}} (i.e. not diagonally) to firm ground or some solid construction (a wall, floor, etc), not (just) other grates.

A floor grate does NOT count as solid construction. It will not support any buildings or constructions. However, you can designate a construction to be built orthogonally to it with no other supports. This will cause the construction to cave-in immediately after being completed. This can be useful for controlled cave-ins.

You can not have a {{L|stockpile}} on floor grates.

Tiles below a floor grate do count as inside. They will not stop light.

== Bars vs. Grates ==

Vertical and horizontal {{L|bars}} seem to be functionally identical. The difference between grates and bars is that bars can only be made of metal (and other materials that come in {{L|bar}}s) but they can be constructed by any dwarf from {{L|bar|raw metal bars}} and do not require an intermediate production step.

== Notes ==
* If you wish to remove a floor piece, that is linked to a grate, make sure, that your dwarf, that outcarries the job, does not stands on the grate, or remove all grates first. If it happens, the grate will loose the hold, and fall (with your uncarefull dwarf), and can experience the famous quation: "Not the gravity kills you. It's the sudden stop."

{{buildings}}

v0.31:Grate

2011-05-31T19:12:03Z

Sasf54: /* Bars vs. Grates */

{{av}}
{{Quality|Fine}}

A '''grate''' is a {{L|furniture}}-type item. It is used as a construction material for wall grates and floor grates. Grates can be constructed from {{L|stone}} or {{L|ore}} (with the {{L|masonry}} {{L|labor}} at a {{L|mason's workshop}}), wood (with the {{L|carpentry}} labor in a {{L|carpenter's workshop}}), {{L|Metal|metal bar}}s (with the {{L|blacksmithing}} labor at a {{L|forge}}), or {{L|glass}} (with the {{L|glassmaking}} labor at a {{L|glass furnace}}).

== Wall Grate ==

A wall grate is basically a {{L|fortification}}, but with 2 differences:
* It is a {{L|building}} instead of a {{L|construction}}. It doesn't overwrite the tile below it, and it can be smashed by building destroyers.
* It can be linked to a {{L|lever}} or {{L|pressure plate}}. Once linked, it works like a linked {{L|door}} which doesn't stop fluids, {{L|arrow}}s or {{L|Miasma}} when closed.
Wall grates set the boundary for the room being resized, but they do not provide support for the doors construction.
Unlike a constructed wall, the grate has some quality level and can be decorated.

== Floor Grate ==
A floor grate blocks {{L|creatures|creature}} and item movement like a {{L|floor hatch}}, but it lets {{L|water}}, {{L|magma}}, and ranged attacks through like an open tile. It doesn't block line of sight. It can be linked. Triggered, it opens like a hatch, but with a 100-tick delay.

Floor grates must be attached {{L|orthogonal|orthogonally}} (i.e. not diagonally) to firm ground or some solid construction (a wall, floor, etc), not (just) other grates.

A floor grate does NOT count as solid construction. It will not support any buildings or constructions. However, you can designate a construction to be built orthogonally to it with no other supports. This will cause the construction to cave-in immediately after being completed. This can be useful for controlled cave-ins.

You can not have a {{L|stockpile}} on floor grates.

Tiles below a floor grate do count as inside. They will not stop light.

== Bars vs. Grates ==

Vertical and horizontal {{L|bars}} seem to be functionally identical. The difference between grates and bars is that bars can only be made of metal (and other materials that come in {{L|bar}}s) but they can be constructed by any dwarf from {{L|bar|raw metal bars}} and do not require an intermediate production step.

== Notes ==
* If you wish to remove a floor piece, that is linked to a grate, make sure, that your dwarf, that outcarries the job, does not stands on the grate title. If it happens, the grate will loose the hold, and fall (with your uncarefull dwarf), and can experience the famous quation: "Not the gravity kills you. It's the sudden stop."

{{buildings}}

v0.31:Domestic animal

2011-05-26T22:38:47Z

Sasf54: /* Notes */

{{quality|Exceptional|06:12, 27 December 2010 (UTC)}}{{av}}

Domestic {{L|animal}}s are creatures that can be used by dwarves one way or another without taming or training, usually for security or food. Distinguished by having the [COMMON_DOMESTIC] tag in the {{L|raw file|raws}}, they can be bought at {{L|embark}} or {{L|trade}}d for with {{L|caravan}}s. Wild versions of domesticated animals (horses, muskoxen, etc) can be {{L|tame}}d and used normally.

Every embark starts with two free domestic '''draft animals''' which pulls the {{L|Wagon (embark)|wagon}} to the fortress site. This can be any of the animals in the list below with the [WAGON_PULLER] tag (Horses, Yaks and Water Buffalos) which are available at embark. Embarking with a sufficient quantity of goods can result in multiple wagons, each of which comes with another two animals. A fortress has no use for wagons after embark except, so these animals can be slaughtered or kept for breeding and making your dwarves {{L|preferences|happy}} as pets. The wagons can be deconstructed for {{L|wood}}.

The player may choose which gender of animals to bring at embark. Only one male is necessary for breeding. {{L|cat|Depending on the animal}}, you may wish to limit breeding altogether.

== Comparison of domestic mammals ==
When butchered, all adult domestic mammals yield one {{L|skull}} and one {{L|leather|raw hide}}. All milkable mammals give the same value {{L|milk}} and appear to be milkable at the same frequency. The embark costs shown apply to both adults and juveniles of either sex.
{| border="1px #AAA solid;" style="text-align:center;" class="wikitable sortable"

!style="border:1px #AAA solid;background:#DDD;"| Animal
!style="border:1px #AAA solid;background:#DDD;"| Embark cost
!style="border:1px #AAA solid;background:#DDD;"| Pet value
!style="border:1px #AAA solid;background:#DDD;"| Size when full-grown*
!style="border:1px #AAA solid;background:#DDD;"| Total edible†‡
!style="border:1px #AAA solid;background:#DDD;"| Bones‡
!style="border:1px #AAA solid;background:#DDD;"| Horns + hooves
!style="border:1px #AAA solid;background:#DDD;"| Milkable?
!style="border:1px #AAA solid;background:#DDD;"| Shearable?
!style="border:1px #AAA solid;background:#DDD;"| Grazer#
!style="border:1px #AAA solid;background:#DDD;"| Notes
|-
|style="padding:0.2em;"|{{L|Alpaca}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|70,000
|style="padding:0.2em;"|?
|style="padding:0.2em;"|?
|style="padding:0.2em;"|?
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|857
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Cavy}}
|style="padding:0.2em;"|2
|style="padding:0.2em;"|3
|style="padding:0.2em;"|800
|style="padding:0.2em;"|0
|style="padding:0.2em;"|0
|style="padding:0.2em;"|0
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"|75,000
|style="padding:0.2em;"|Commonly called ''guinea pigs''
|-
|style="padding:0.2em;"|{{L|Cat}}
|style="padding:0.2em;"|11
|style="padding:0.2em;"|20
|style="padding:0.2em;"|5,000
|style="padding:0.2em;"|14
|style="padding:0.2em;"|4
|style="padding:0.2em;"|0
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"| -
|style="padding:0.2em;"|Adopts owners. Hunts {{L|vermin}}. Beware {{L|Catsplosion}}!
|-
|style="padding:0.2em;"|{{L|Cow}}
|style="padding:0.2em;"|151
|style="padding:0.2em;"|300
|style="padding:0.2em;"|600,000
|style="padding:0.2em;"|37
|style="padding:0.2em;"|15
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|100
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Dog}}
|style="padding:0.2em;"|16
|style="padding:0.2em;"|30
|style="padding:0.2em;"|30,000
|style="padding:0.2em;"|37
|style="padding:0.2em;"|11
|style="padding:0.2em;"|0
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"| -
|style="padding:0.2em;"|{{L|Kennel|Trainable}} as war dogs or hunting dogs, which can also be bought for 31☼
|-
|style="padding:0.2em;"|{{L|Donkey}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|300,000
|style="padding:0.2em;"|30
|style="padding:0.2em;"|13
|style="padding:0.2em;"|4
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|200
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Goat}}
|style="padding:0.2em;"|26
|style="padding:0.2em;"|50
|style="padding:0.2em;"|50,000
|style="padding:0.2em;"|27
|style="padding:0.2em;"|10
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|1,200
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Horse}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|500,000
|style="padding:0.2em;"|32
|style="padding:0.2em;"|13
|style="padding:0.2em;"|4
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|120
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Llama}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|180,000
|style="padding:0.2em;"|36
|style="padding:0.2em;"|18
|style="padding:0.2em;"|0
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|333
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Mule}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|400,000
|style="padding:0.2em;"|34
|style="padding:0.2em;"|13
|style="padding:0.2em;"|4
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"|150
|style="padding:0.2em;"|Sterile in real life; all male in Dwarf Fortress
|-
|style="padding:0.2em;"|{{L|Pig}}
|style="padding:0.2em;"|51
|style="padding:0.2em;"|100
|style="padding:0.2em;"|60,000
|style="padding:0.2em;"|?
|style="padding:0.2em;"|?
|style="padding:0.2em;"|4
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|1,000
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Sheep}}
|style="padding:0.2em;"|51
|style="padding:0.2em;"|100
|style="padding:0.2em;"|50,000
|style="padding:0.2em;"|27
|style="padding:0.2em;"|8 or 10@
|style="padding:0.2em;"|4 or 6@
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|1,200
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Rabbit}}
|style="padding:0.2em;"|2
|style="padding:0.2em;"|3
|style="padding:0.2em;"|500
|style="padding:0.2em;"|0
|style="padding:0.2em;"|0
|style="padding:0.2em;"|0
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"|120,000
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Reindeer}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|130,000
|style="padding:0.2em;"|28
|style="padding:0.2em;"|16
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|461
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|water_buffalo|Water Buffalo}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|1,000,000
|style="padding:0.2em;"|70
|style="padding:0.2em;"|20
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|60
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Yak}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|700,000
|style="padding:0.2em;"|42
|style="padding:0.2em;"|16
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|86
|style="padding:0.2em;"|
|}

:<nowiki>*</nowiki> Gives a crude estimate of ability in combat, and thus danger to hunters. This number comes from the raws, so it might also be a better estimate of butchering results than the dodgy numbers from this wiki. 
:† Total of meat, fat, and offal. 
:‡ Maximum reported in infoboxes in this wiki, April 2011. Strongly influenced by individual attributes, especially for larger animals. Use with caution! 
:<nowiki>#</nowiki> A lower number means the animal needs to graze more often, and will thus need a larger {{L|pasture}}. Cats and dogs have the [CARNIVORE] tag and do not graze or require pasture. 
:@ The higher number is for rams.

== Comparison of domestic poultry == 
All domestic poultry have a {{L|pet}} value of 10 and cost 6{{L|currency|☼}} at embark. Blue peafowl, geese, and guinea fowl reach adolescence at six months and are full-grown after one year; ducks, chickens and turkeys reach adolescence at one year and are full-grown after two years. When butchered, all full-grown poultry yield one {{L|skull}}; those that yield bones also yield a {{L|leather|raw hide}}.

{| border="1px #AAA solid;" style="text-align:center;" class="wikitable sortable"

!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Animal
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Min. eggs
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Max. eggs
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Avg. eggs*
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Egg size
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Years til full-grown
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Size when full-grown
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Total edible†‡
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Bones‡
|-
|style="padding:0.2em;text-align:center;"|{{L|Blue peafowl}}
|style="padding:0.2em;text-align:center;"|6
|style="padding:0.2em;text-align:center;"|8
|style="padding:0.2em;text-align:center;"|7
|style="padding:0.2em;text-align:center;"|102
|style="padding:0.2em;text-align:center;"|1
|style="padding:0.2em;text-align:center;"|4000
|style="padding:0.2em;text-align:center;"|17
|style="padding:0.2em;text-align:center;"|6
|-
|style="padding:0.2em;text-align:center;"|{{L|Chicken}}
|style="padding:0.2em;text-align:center;"|4
|style="padding:0.2em;text-align:center;"|15
|style="padding:0.2em;text-align:center;"|9.5
|style="padding:0.2em;text-align:center;"|62
|style="padding:0.2em;text-align:center;"|2
|style="padding:0.2em;text-align:center;"|3000
|style="padding:0.2em;text-align:center;"|13
|style="padding:0.2em;text-align:center;"|4
|-
|style="padding:0.2em;text-align:center;"|{{L|Duck}}
|style="padding:0.2em;text-align:center;"|8
|style="padding:0.2em;text-align:center;"|13
|style="padding:0.2em;text-align:center;"|10.5
|style="padding:0.2em;text-align:center;"|52
|style="padding:0.2em;text-align:center;"|2
|style="padding:0.2em;text-align:center;"|1000
|style="padding:0.2em;text-align:center;"|0
|style="padding:0.2em;text-align:center;"|0
|-
|style="padding:0.2em;text-align:center;"|{{L|Goose}}
|style="padding:0.2em;text-align:center;"|3
|style="padding:0.2em;text-align:center;"|8
|style="padding:0.2em;text-align:center;"|5.5
|style="padding:0.2em;text-align:center;"|152
|style="padding:0.2em;text-align:center;"|1
|style="padding:0.2em;text-align:center;"|4500
|style="padding:0.2em;text-align:center;"|17-18
|style="padding:0.2em;text-align:center;"|6
|-
|style="padding:0.2em;text-align:center;"|{{L|Guineafowl}}
|style="padding:0.2em;text-align:center;"|4
|style="padding:0.2em;text-align:center;"|15
|style="padding:0.2em;text-align:center;"|9.5
|style="padding:0.2em;text-align:center;"|42
|style="padding:0.2em;text-align:center;"|1
|style="padding:0.2em;text-align:center;"|1500
|style="padding:0.2em;text-align:center;"|0
|style="padding:0.2em;text-align:center;"|0
|-
|style="padding:0.2em;text-align:center;"|{{L|Turkey}}
|style="padding:0.2em;text-align:center;"|10
|style="padding:0.2em;text-align:center;"|14
|style="padding:0.2em;text-align:center;"|12
|style="padding:0.2em;text-align:center;"|87
|style="padding:0.2em;text-align:center;"|2
|style="padding:0.2em;text-align:center;"|5000
|style="padding:0.2em;text-align:center;"|19
|style="padding:0.2em;text-align:center;"|6
|}
:<nowiki>*</nowiki> Estimate based on mean of minimum and maximum clutch sizes. 
:† Total of meat, fat, and intestines. 
:‡ Reported in infoboxes in this wiki, April 2011. Might be influenced by individual attributes. Use with caution! 

==Notes ==
* It seems that for some reason, there's a natural contraceptive. This is causing, that only one nest will hatch once, so the other eggs must "rehatch". This means, if you have a room, with 10 nests, full of chicken eggs (layed the same time), only one nest will hatch, the other have to wait the next few months to hatch. This means, that {{L|catsplosion#Birdsplosion|chickensplosion}} is reduced greatly.

{{Category|Creatures}}
{{Category|Animals}}

v0.31:Domestic animal

2011-05-26T22:37:25Z

Sasf54: /* Comparison of domestic poultry */

{{quality|Exceptional|06:12, 27 December 2010 (UTC)}}{{av}}

Domestic {{L|animal}}s are creatures that can be used by dwarves one way or another without taming or training, usually for security or food. Distinguished by having the [COMMON_DOMESTIC] tag in the {{L|raw file|raws}}, they can be bought at {{L|embark}} or {{L|trade}}d for with {{L|caravan}}s. Wild versions of domesticated animals (horses, muskoxen, etc) can be {{L|tame}}d and used normally.

Every embark starts with two free domestic '''draft animals''' which pulls the {{L|Wagon (embark)|wagon}} to the fortress site. This can be any of the animals in the list below with the [WAGON_PULLER] tag (Horses, Yaks and Water Buffalos) which are available at embark. Embarking with a sufficient quantity of goods can result in multiple wagons, each of which comes with another two animals. A fortress has no use for wagons after embark except, so these animals can be slaughtered or kept for breeding and making your dwarves {{L|preferences|happy}} as pets. The wagons can be deconstructed for {{L|wood}}.

The player may choose which gender of animals to bring at embark. Only one male is necessary for breeding. {{L|cat|Depending on the animal}}, you may wish to limit breeding altogether.

== Comparison of domestic mammals ==
When butchered, all adult domestic mammals yield one {{L|skull}} and one {{L|leather|raw hide}}. All milkable mammals give the same value {{L|milk}} and appear to be milkable at the same frequency. The embark costs shown apply to both adults and juveniles of either sex.
{| border="1px #AAA solid;" style="text-align:center;" class="wikitable sortable"

!style="border:1px #AAA solid;background:#DDD;"| Animal
!style="border:1px #AAA solid;background:#DDD;"| Embark cost
!style="border:1px #AAA solid;background:#DDD;"| Pet value
!style="border:1px #AAA solid;background:#DDD;"| Size when full-grown*
!style="border:1px #AAA solid;background:#DDD;"| Total edible†‡
!style="border:1px #AAA solid;background:#DDD;"| Bones‡
!style="border:1px #AAA solid;background:#DDD;"| Horns + hooves
!style="border:1px #AAA solid;background:#DDD;"| Milkable?
!style="border:1px #AAA solid;background:#DDD;"| Shearable?
!style="border:1px #AAA solid;background:#DDD;"| Grazer#
!style="border:1px #AAA solid;background:#DDD;"| Notes
|-
|style="padding:0.2em;"|{{L|Alpaca}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|70,000
|style="padding:0.2em;"|?
|style="padding:0.2em;"|?
|style="padding:0.2em;"|?
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|857
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Cavy}}
|style="padding:0.2em;"|2
|style="padding:0.2em;"|3
|style="padding:0.2em;"|800
|style="padding:0.2em;"|0
|style="padding:0.2em;"|0
|style="padding:0.2em;"|0
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"|75,000
|style="padding:0.2em;"|Commonly called ''guinea pigs''
|-
|style="padding:0.2em;"|{{L|Cat}}
|style="padding:0.2em;"|11
|style="padding:0.2em;"|20
|style="padding:0.2em;"|5,000
|style="padding:0.2em;"|14
|style="padding:0.2em;"|4
|style="padding:0.2em;"|0
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"| -
|style="padding:0.2em;"|Adopts owners. Hunts {{L|vermin}}. Beware {{L|Catsplosion}}!
|-
|style="padding:0.2em;"|{{L|Cow}}
|style="padding:0.2em;"|151
|style="padding:0.2em;"|300
|style="padding:0.2em;"|600,000
|style="padding:0.2em;"|37
|style="padding:0.2em;"|15
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|100
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Dog}}
|style="padding:0.2em;"|16
|style="padding:0.2em;"|30
|style="padding:0.2em;"|30,000
|style="padding:0.2em;"|37
|style="padding:0.2em;"|11
|style="padding:0.2em;"|0
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"| -
|style="padding:0.2em;"|{{L|Kennel|Trainable}} as war dogs or hunting dogs, which can also be bought for 31☼
|-
|style="padding:0.2em;"|{{L|Donkey}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|300,000
|style="padding:0.2em;"|30
|style="padding:0.2em;"|13
|style="padding:0.2em;"|4
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|200
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Goat}}
|style="padding:0.2em;"|26
|style="padding:0.2em;"|50
|style="padding:0.2em;"|50,000
|style="padding:0.2em;"|27
|style="padding:0.2em;"|10
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|1,200
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Horse}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|500,000
|style="padding:0.2em;"|32
|style="padding:0.2em;"|13
|style="padding:0.2em;"|4
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|120
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Llama}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|180,000
|style="padding:0.2em;"|36
|style="padding:0.2em;"|18
|style="padding:0.2em;"|0
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|333
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Mule}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|400,000
|style="padding:0.2em;"|34
|style="padding:0.2em;"|13
|style="padding:0.2em;"|4
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"|150
|style="padding:0.2em;"|Sterile in real life; all male in Dwarf Fortress
|-
|style="padding:0.2em;"|{{L|Pig}}
|style="padding:0.2em;"|51
|style="padding:0.2em;"|100
|style="padding:0.2em;"|60,000
|style="padding:0.2em;"|?
|style="padding:0.2em;"|?
|style="padding:0.2em;"|4
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|1,000
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Sheep}}
|style="padding:0.2em;"|51
|style="padding:0.2em;"|100
|style="padding:0.2em;"|50,000
|style="padding:0.2em;"|27
|style="padding:0.2em;"|8 or 10@
|style="padding:0.2em;"|4 or 6@
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|1,200
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Rabbit}}
|style="padding:0.2em;"|2
|style="padding:0.2em;"|3
|style="padding:0.2em;"|500
|style="padding:0.2em;"|0
|style="padding:0.2em;"|0
|style="padding:0.2em;"|0
|style="padding:0.2em;"|No
|style="padding:0.2em;"|No
|style="padding:0.2em;"|120,000
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Reindeer}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|130,000
|style="padding:0.2em;"|28
|style="padding:0.2em;"|16
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|461
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|water_buffalo|Water Buffalo}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|1,000,000
|style="padding:0.2em;"|70
|style="padding:0.2em;"|20
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|60
|style="padding:0.2em;"|
|-
|style="padding:0.2em;"|{{L|Yak}}
|style="padding:0.2em;"|101
|style="padding:0.2em;"|200
|style="padding:0.2em;"|700,000
|style="padding:0.2em;"|42
|style="padding:0.2em;"|16
|style="padding:0.2em;"|6
|style="padding:0.2em;"|Yes
|style="padding:0.2em;"|No
|style="padding:0.2em;"|86
|style="padding:0.2em;"|
|}

:<nowiki>*</nowiki> Gives a crude estimate of ability in combat, and thus danger to hunters. This number comes from the raws, so it might also be a better estimate of butchering results than the dodgy numbers from this wiki. 
:† Total of meat, fat, and offal. 
:‡ Maximum reported in infoboxes in this wiki, April 2011. Strongly influenced by individual attributes, especially for larger animals. Use with caution! 
:<nowiki>#</nowiki> A lower number means the animal needs to graze more often, and will thus need a larger {{L|pasture}}. Cats and dogs have the [CARNIVORE] tag and do not graze or require pasture. 
:@ The higher number is for rams.

== Comparison of domestic poultry == 
All domestic poultry have a {{L|pet}} value of 10 and cost 6{{L|currency|☼}} at embark. Blue peafowl, geese, and guinea fowl reach adolescence at six months and are full-grown after one year; ducks, chickens and turkeys reach adolescence at one year and are full-grown after two years. When butchered, all full-grown poultry yield one {{L|skull}}; those that yield bones also yield a {{L|leather|raw hide}}.

{| border="1px #AAA solid;" style="text-align:center;" class="wikitable sortable"

!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Animal
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Min. eggs
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Max. eggs
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Avg. eggs*
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Egg size
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Years til full-grown
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Size when full-grown
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Total edible†‡
!style="border:1px #AAA solid;background:#DDD;text-align:center;"| Bones‡
|-
|style="padding:0.2em;text-align:center;"|{{L|Blue peafowl}}
|style="padding:0.2em;text-align:center;"|6
|style="padding:0.2em;text-align:center;"|8
|style="padding:0.2em;text-align:center;"|7
|style="padding:0.2em;text-align:center;"|102
|style="padding:0.2em;text-align:center;"|1
|style="padding:0.2em;text-align:center;"|4000
|style="padding:0.2em;text-align:center;"|17
|style="padding:0.2em;text-align:center;"|6
|-
|style="padding:0.2em;text-align:center;"|{{L|Chicken}}
|style="padding:0.2em;text-align:center;"|4
|style="padding:0.2em;text-align:center;"|15
|style="padding:0.2em;text-align:center;"|9.5
|style="padding:0.2em;text-align:center;"|62
|style="padding:0.2em;text-align:center;"|2
|style="padding:0.2em;text-align:center;"|3000
|style="padding:0.2em;text-align:center;"|13
|style="padding:0.2em;text-align:center;"|4
|-
|style="padding:0.2em;text-align:center;"|{{L|Duck}}
|style="padding:0.2em;text-align:center;"|8
|style="padding:0.2em;text-align:center;"|13
|style="padding:0.2em;text-align:center;"|10.5
|style="padding:0.2em;text-align:center;"|52
|style="padding:0.2em;text-align:center;"|2
|style="padding:0.2em;text-align:center;"|1000
|style="padding:0.2em;text-align:center;"|0
|style="padding:0.2em;text-align:center;"|0
|-
|style="padding:0.2em;text-align:center;"|{{L|Goose}}
|style="padding:0.2em;text-align:center;"|3
|style="padding:0.2em;text-align:center;"|8
|style="padding:0.2em;text-align:center;"|5.5
|style="padding:0.2em;text-align:center;"|152
|style="padding:0.2em;text-align:center;"|1
|style="padding:0.2em;text-align:center;"|4500
|style="padding:0.2em;text-align:center;"|17-18
|style="padding:0.2em;text-align:center;"|6
|-
|style="padding:0.2em;text-align:center;"|{{L|Guineafowl}}
|style="padding:0.2em;text-align:center;"|4
|style="padding:0.2em;text-align:center;"|15
|style="padding:0.2em;text-align:center;"|9.5
|style="padding:0.2em;text-align:center;"|42
|style="padding:0.2em;text-align:center;"|1
|style="padding:0.2em;text-align:center;"|1500
|style="padding:0.2em;text-align:center;"|0
|style="padding:0.2em;text-align:center;"|0
|-
|style="padding:0.2em;text-align:center;"|{{L|Turkey}}
|style="padding:0.2em;text-align:center;"|10
|style="padding:0.2em;text-align:center;"|14
|style="padding:0.2em;text-align:center;"|12
|style="padding:0.2em;text-align:center;"|87
|style="padding:0.2em;text-align:center;"|2
|style="padding:0.2em;text-align:center;"|5000
|style="padding:0.2em;text-align:center;"|19
|style="padding:0.2em;text-align:center;"|6
|}
:<nowiki>*</nowiki> Estimate based on mean of minimum and maximum clutch sizes. 
:† Total of meat, fat, and intestines. 
:‡ Reported in infoboxes in this wiki, April 2011. Might be influenced by individual attributes. Use with caution! 

==Notes ==
* It seems that for some reason, there's a natural contraceptive. This is causing, that only one nest will hatch once, so the other eggs must "rehatch". This means, if you have a room, with 10 nests, full of chicken eggs (layed the same time), only one nest will hatch, the other have to wait the next few months to hatch. This means, that {{L|chickenplosion}} is reduced greatly.

{{Category|Creatures}}
{{Category|Animals}}

v0.31:Butcher's shop

2011-05-25T21:21:04Z

Sasf54: /* Notes */

{{Quality|Exceptional|09:44, 9 August 2010 (UTC)}}
{{Workshop
|name=Butcher's shop
|key=u
|job=*{{L|Butcher|Butchery}}
|construction=
1 of
*{{L|Block}}
*{{L|Stone}}
*{{L|Wood}}
|construction_job=
1 of
*{{L|Butchery}}
*{{L|Small animal dissection}}
*{{L|Trapping}}
|use=
* {{L|Tame animals}}
* Corpses of untamed non-sentient animals
|production=
* {{L|Skin}}
* {{L|Fat}}
* {{L|Meat}}
* {{L|Bone}}
* {{L|Prepared organs}}
* {{L|Skull}}
* {{L|Scale}}
* {{L|Hooves}}
* {{L|Ivory}}
* {{L|Tooth}}
* {{L|Hair}}
* {{L|Wool}}
}}{{av}}

The '''butcher's shop''' is used to butcher {{L|Tame animals|tame animals}}, corpses of certain slain animals, and to process skeletons of wild animals. Tame animals can be designated for butchering either by pressing {{key|v}}, moving the curser over the animal and pressing {{key|s}}, or by going into the animal list by pressing {{key|z}}, {{key|Enter}} and then by choosing the animal(s) for butchering by pressing {{key|b}} while they are highlighted. It can also be used to butcher already dead animals, but only if their corpses have been placed in a '''refuse''' stockpile nearby beforehand.

A butchered animal results into various items with different uses:

{| {{prettytable}}
!Item
!Uses
|-
|{{L|Meat}} and {{L|Prepared organs}}
|Eaten raw or {{L|kitchen|cooked}}
|-
|{{L|Fat}}
|{{L|kitchen|Cooked}} to {{L|tallow}}
|-
|{{L|Skull}}
|Crafting skull {{L|totem||totems}}
|-
|{{L|Bone|Bones}}
|Crafting bone {{L|bolt|bolts}}, bone {{L|craft|crafts}}, or used as a {{L|decoration}} material
|-
|{{L|Hoof|Hooves}}, {{L|Horn}}s, {{L|Shell}}s, {{L|Nail}}s,{{L|Tooth|Teeth}}
|Used for {{L|crafts}} or used as a {{L|decoration}} material
|-
|Skin, Scale, and Chitin
|Tanned into {{L|Leather}}
|-
|{{L|Hair}}
|Spun into {{L|thread}}, but not weaved into {{L|cloth}}
|-
|{{L|Cartilage}}
|Currently no uses. {{version|0.31.25}}
|-
|Nervous tissue
|Currently no uses. {{version|0.31.25}}
|-
|Feather
|Currently no uses. {{version|0.31.25}}
|-
|Wool
|Spun into {{L|Yarn}}
|}

==Menu==
'''Butcher's Shop'''

*{{k|b}}'''Butcher a dead animal'''
Renders a dead animal into its component parts of {{L|meat}}, {{L|fat}}, {{L|skin}}, {{L|bone}}s, and {{L|skull}}s. Usually used on animals that your {{L|hunter}} brings back, or tame animals you chose for slaughter.

*{{k|e}}'''Extract from a dead animal'''
Requires a caged {{L|fire snake}}, {{L|cave spider}}, or {{L|phantom spider}} and {{L|Animal dissector|animal dissection}}. Contrary to the name of the task, the vermin must be alive (though it will be dead once the task is done).
Produces {{L|Fire snake|liquid fire}} and {{L|venom}}, respectively.

*{{k|a}}'''Capture a live land animal'''
Requires an {{L|animal trap}} and {{L|trapping}}.
The trapper will take the trap and chase vermin until it catches one.

==Common Uses==
*Produce meat for food.
*Produce skin for leather.
*Produce bones for bolts.

==Helpful Strategies==

=== Hauling and stockpile considerations ===

One thing to beware of is that butchered creatures will practically explode into piles of meat, bones, fat, organs and more; this can quickly clutter up a butchers shop or risk rotting the entire pile if not enough haulers and a suitable stockpile are available. Refuse also can not be stored in containers, so every item will use up one stockpile tile. For any jobs, such as cooking meat, rendering fat, and carving bones, the entire stack will become tasked and unavailable to other workshops.

The initial corpse or body part must be in a stockpile close enough to the butcher's shop to automatically trigger the '''Butcher a dead animal''' job. Similarly, there is a maximum distance for the [[Tanner's shop]] to notice a skin and automatically trigger a '''Tan a skin''' job. It is not known precisely what "close enough" is, in either case.

=== Clutter Reduction and Rotting Prevention ===

A good way to cut down on clutter and to prevent your butchered animals from rotting is to build a Quantum Stockpile right by your butcher shops and then place a stockpile at the bottom. This way as meat is produced you can order it dumped into the stockpile so it is stored easily and will not rot.
To prevent rotten meat from producing miasma channel out a shaft above your butcher shops and build a wall around it on the surface. This way if meat rots it will not produce miasma.

=== Difference between slaughter and butcher ===

A tamed animal can be marked for slaughtering. This means, the butcher leads the animal to the butcher shop, and butcher it in an instance. There's no time to process the body, the body parts just "explodes" out of the animal. If you have some corpse for butchering, your butcher hauls it into the butcher's shop, and starts the slicing / dicing. This may take a while, depending on how cluttered the workshop.

==Notes==
*A butcher's shop is operated by any dwarf with the 'butchery' {{L|labor}} enabled.
*There's some huge animals, that clutters your workshop. Yak, cow, horse. This means, a single animal can clutter your butcher workshop, or just the bones, skull other workshops. Be prepared for that.
*Corpses left to rot will become skeletons. Only those of wild animals (typically killed from hunting or traps) can be processed at the butcher's shop. Products will be bone, skull, hoof, horn and the like (no meat, fat, prepared organs or skin).
*Partial corpses as well as mutilated corpses do not provide the "full set"; the number of bones may be lower, organs may be missing.
*You can't butcher vermin fish, that is done at the [[Fishery]]. But you can butcher underwater creatures. For instance, you can butcher 'Carp corpse', but you can't butcher 'Oyster'.
*Some tamed animals may seem to be unbutcherable, such as those that die of starvation.
*Tamed birds may leave only a skull, if they have not fully reached adulthood. For more info see the [[Domestic_animal|Domesticated animals page]]

==See Also==

:*{{L|Creature}} pages for butchering results.
:*{{L|Meat industry}}
:*{{L|Stockpile}}

{{Workshops}}

v0.31:Butcher's shop

2011-05-25T21:19:02Z

Sasf54: /* Helpful Strategies */

{{Quality|Exceptional|09:44, 9 August 2010 (UTC)}}
{{Workshop
|name=Butcher's shop
|key=u
|job=*{{L|Butcher|Butchery}}
|construction=
1 of
*{{L|Block}}
*{{L|Stone}}
*{{L|Wood}}
|construction_job=
1 of
*{{L|Butchery}}
*{{L|Small animal dissection}}
*{{L|Trapping}}
|use=
* {{L|Tame animals}}
* Corpses of untamed non-sentient animals
|production=
* {{L|Skin}}
* {{L|Fat}}
* {{L|Meat}}
* {{L|Bone}}
* {{L|Prepared organs}}
* {{L|Skull}}
* {{L|Scale}}
* {{L|Hooves}}
* {{L|Ivory}}
* {{L|Tooth}}
* {{L|Hair}}
* {{L|Wool}}
}}{{av}}

The '''butcher's shop''' is used to butcher {{L|Tame animals|tame animals}}, corpses of certain slain animals, and to process skeletons of wild animals. Tame animals can be designated for butchering either by pressing {{key|v}}, moving the curser over the animal and pressing {{key|s}}, or by going into the animal list by pressing {{key|z}}, {{key|Enter}} and then by choosing the animal(s) for butchering by pressing {{key|b}} while they are highlighted. It can also be used to butcher already dead animals, but only if their corpses have been placed in a '''refuse''' stockpile nearby beforehand.

A butchered animal results into various items with different uses:

{| {{prettytable}}
!Item
!Uses
|-
|{{L|Meat}} and {{L|Prepared organs}}
|Eaten raw or {{L|kitchen|cooked}}
|-
|{{L|Fat}}
|{{L|kitchen|Cooked}} to {{L|tallow}}
|-
|{{L|Skull}}
|Crafting skull {{L|totem||totems}}
|-
|{{L|Bone|Bones}}
|Crafting bone {{L|bolt|bolts}}, bone {{L|craft|crafts}}, or used as a {{L|decoration}} material
|-
|{{L|Hoof|Hooves}}, {{L|Horn}}s, {{L|Shell}}s, {{L|Nail}}s,{{L|Tooth|Teeth}}
|Used for {{L|crafts}} or used as a {{L|decoration}} material
|-
|Skin, Scale, and Chitin
|Tanned into {{L|Leather}}
|-
|{{L|Hair}}
|Spun into {{L|thread}}, but not weaved into {{L|cloth}}
|-
|{{L|Cartilage}}
|Currently no uses. {{version|0.31.25}}
|-
|Nervous tissue
|Currently no uses. {{version|0.31.25}}
|-
|Feather
|Currently no uses. {{version|0.31.25}}
|-
|Wool
|Spun into {{L|Yarn}}
|}

==Menu==
'''Butcher's Shop'''

*{{k|b}}'''Butcher a dead animal'''
Renders a dead animal into its component parts of {{L|meat}}, {{L|fat}}, {{L|skin}}, {{L|bone}}s, and {{L|skull}}s. Usually used on animals that your {{L|hunter}} brings back, or tame animals you chose for slaughter.

*{{k|e}}'''Extract from a dead animal'''
Requires a caged {{L|fire snake}}, {{L|cave spider}}, or {{L|phantom spider}} and {{L|Animal dissector|animal dissection}}. Contrary to the name of the task, the vermin must be alive (though it will be dead once the task is done).
Produces {{L|Fire snake|liquid fire}} and {{L|venom}}, respectively.

*{{k|a}}'''Capture a live land animal'''
Requires an {{L|animal trap}} and {{L|trapping}}.
The trapper will take the trap and chase vermin until it catches one.

==Common Uses==
*Produce meat for food.
*Produce skin for leather.
*Produce bones for bolts.

==Helpful Strategies==

=== Hauling and stockpile considerations ===

One thing to beware of is that butchered creatures will practically explode into piles of meat, bones, fat, organs and more; this can quickly clutter up a butchers shop or risk rotting the entire pile if not enough haulers and a suitable stockpile are available. Refuse also can not be stored in containers, so every item will use up one stockpile tile. For any jobs, such as cooking meat, rendering fat, and carving bones, the entire stack will become tasked and unavailable to other workshops.

The initial corpse or body part must be in a stockpile close enough to the butcher's shop to automatically trigger the '''Butcher a dead animal''' job. Similarly, there is a maximum distance for the [[Tanner's shop]] to notice a skin and automatically trigger a '''Tan a skin''' job. It is not known precisely what "close enough" is, in either case.

=== Clutter Reduction and Rotting Prevention ===

A good way to cut down on clutter and to prevent your butchered animals from rotting is to build a Quantum Stockpile right by your butcher shops and then place a stockpile at the bottom. This way as meat is produced you can order it dumped into the stockpile so it is stored easily and will not rot.
To prevent rotten meat from producing miasma channel out a shaft above your butcher shops and build a wall around it on the surface. This way if meat rots it will not produce miasma.

=== Difference between slaughter and butcher ===

A tamed animal can be marked for slaughtering. This means, the butcher leads the animal to the butcher shop, and butcher it in an instance. There's no time to process the body, the body parts just "explodes" out of the animal. If you have some corpse for butchering, your butcher hauls it into the butcher's shop, and starts the slicing / dicing. This may take a while, depending on how cluttered the workshop.

==Notes==
*A butcher's shop is operated by any dwarf with the 'butchery' {{L|labor}} enabled.
*Corpses left to rot will become skeletons. Only those of wild animals (typically killed from hunting or traps) can be processed at the butcher's shop. Products will be bone, skull, hoof, horn and the like (no meat, fat, prepared organs or skin).
*Partial corpses as well as mutilated corpses do not provide the "full set"; the number of bones may be lower, organs may be missing.
*You can't butcher vermin fish, that is done at the [[Fishery]]. But you can butcher underwater creatures. For instance, you can butcher 'Carp corpse', but you can't butcher 'Oyster'.
*Some tamed animals may seem to be unbutcherable, such as those that die of starvation.
*Tamed birds may leave only a skull, if they have not fully reached adulthood. For more info see the [[Domestic_animal|Domesticated animals page]]

==See Also==

:*{{L|Creature}} pages for butchering results.
:*{{L|Meat industry}}
:*{{L|Stockpile}}

{{Workshops}}

v0.31:Horse

2011-05-25T21:09:40Z

Sasf54:

{{Quality|Exceptional|07:23, 7 July 2010 (UTC)}}
{{Creaturelookup/0
|contrib=no
|bone=13
|meat=9-10
|fat=8-9
|skull=1
|skin=hide
|hoof=4
|eye=2
|lung=2
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
}}
{{av}}
{{creaturedesc}}

'''Horses''' are {{L|domestic animal}}s, and can often be seen in {{L|caravan}}s pulling {{L|wagon}}s. In addition to producing a large amount of {{L|meat}}, {{L|fat}} and {{L|bone}}s when {{L|butcher}}ed, horses can also be {{L|milker|milked}} and serve as a viable base for a {{L|cheese}} industry. {{L|dwarf|Dwarves}} cannot ride horses, but {{L|human}}s and {{L|elf|elves}} can. They require a {{l|pasture}} to survive.

Horses can be bought before embarking, but are quite expensive. Horses are sometimes brought along by {{L|Immigration|immigrants}}, as {{L|pet}}s or strays. Horses also occur very often as wild animals in herds. They are non-aggressive and will avoid dwarves, but an inexperienced {{L|hunter}} who engages them in melee will soon find out that they are much bigger than dwarves. As they appear quite frequently and in numbers, they are ideal targets for hunting and military practice, being also a good source of butchering products.

== Notes ==
* Horses are left a big amount of horse blood ad-hoc on the map, making mess.
* Horse leftovers clutters your workshops. (Even if a bone cravler take only the bones / skull to the workshop, it's cluttered.)

{{Gamedata}}
{{Creatures}}
{{Category|Animals}}

v0.31:Cage

2011-05-24T21:06:33Z

Sasf54:

{{quality|Exceptional|22:58, 6 January 2011 (UTC)}}{{av}}

{{furniture|name=Cage
|tile=‼|col=0:6:0
|wood=y
|metal=y
|glass=y
|rooms=
* {{L|Jail}} (if metal)
}}
For cage traps, see [[Traps#Cage_Trap|traps]].

'''Cages''' are used in {{L|cage trap}}s, {{L|jail}}s, and zoos, {{L|pit}}s and aquariums.

A glass cage is called a terrarium or, if filled with water for holding {{L|Captured live fish|captured}} live {{L|fish}}, an aquarium.

Cages are stored on the Animal Stockpile.

==Building and using a cage==
Cages can be constructed from {{L|wood}} at a {{L|carpenter's workshop}}, from {{L|metal}} at a {{L|metalsmith's forge}}, and from {{L|glass}} at a {{L|glass furnace}}.

You can then either build them to a tile via {{k|b}} - {{k|j}} (this is needed for linking a lever to them, or assigning a pet to it) or simply keep them stockpiled so they can be used to load cage {{L|trap}}s.

When building a cage, you can use a cage that already has something inside. To precisely choose which cage to use, you can expand the list of the cages of a certain type via {{k|x}}.

===Creature containment===

To assign creatures to a cage, press {{k|q}} and move the cursor over the cage. Use {{k|+}} and {{k|-}} to scroll up and down the list of {{L|creatures}}, and {{k|Enter}} to assign them to the cage. A major change in version .31.19 is that grazing creatures will starve if left in cages. Grazing creatures require access to {{L|grass}}, {{L|moss}} or {{L|floor fungus}} for survival, which can be achieved by assigning them to a {{L|zone|pasture}} that has plenty of tasty grass/moss.

Multiple creatures can be assigned to the same cage with no penalty. It is completely possible to fit hundreds of {{L|dog|puppies}} in a cage with dozens of {{L|blind cave ogre}}s with no ill effects or a {{L|dragon}}, a thousand cats plus more, 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 in cages. Use {{k|q}} to examine the cage (it must first be "built," not just stored), {{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. For more information, see {{L|captured creatures}}.

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 Donkey is male or female, which is interesting if your intention is to keep milkable animals near a farmer's workshop.

Vermins can also assigned to cages, to save up space, animal traps. Howerer, if you try to release them ({{k|q}},{{k|a}}), instead a dwarf will pickup an animal trap, and put the poor creature in it. You must have a triggered (linked to a lever) cage, to release tamed small cratures (like birds).

Bees shows up in the list of creatures, that assignable to a cage, but however the dwarf will not start the task (will not shown on jobs list ({{k|j}}).

===Prisons===

To set a cage as a {{L|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 {{L|metal}} cages may be used in this way, despite {{L|wood}}en cages being strong enough to hold {{L|dragon}}s.

Dwarves in cages must be fed by other dwarves.

===Remotely Opening Cages===

A built cage can be linked to a {{L|lever}} to remotely open it. When the cage opens, the occupant(s) inside are released, the cage and {{L|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.

===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, the creature inside will be released. be sure to disarm the creature beforehand...

Another way to get creatures out of cages which are not built, is to assign the creatures to pastures (which is possible for any living thing except dwarves). The same precautions as for trading the cage should be taken first.

===Cages and Fluids===

A cage will protect a creature inside it from {{L|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 {{L|magma}}, making this a somewhat faster option, as it doesn't require linking each cage to a lever. Cages which are not {{L|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 {{L|fire}}. Any items the creature had equipped will teleport to wherever the creature was caged, typically a tile with a {{L|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.

===Buying Cages ===
Traders may bring cages for sale. If these cages contain a {{L|tame}}d {{L|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 {{L|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).

=== How to disarm hostiles in cages ===
The easiest way to take away all prisoner-held armor and clothing is via the mass designation tool. Use {{K|d}}-{{K|b}}-{{K|c}} and {{K|d}}-{{K|b}}-{{K|d}} to designate an area (i.e. your animal {{L|stockpile}}, filled with caged hostiles) from which all items will be reclaimed and dumped. Afterwards, hit {{K|k}}, go over each cage and press {{K|d}} for each of them - this stops the dumping on the cages themselves. The end result will be that prisoners will be stripped naked but the cages themselves (and the creatures within) will remain in place, ready to be used for whatever purpose. If you want to keep the items, you need only place your garbage dump zone somewhere near your armor stockpiles and unforbid all the stuff after it is dumped there.

You can also find the items carried by caged {{L|troll}}s, {{L|kobold}}s, etc. in the {{L|stocks}} menu and designate them for dumping. While it is easy to identify troll/kobold clothes because they will always be described as "large"/"small", it is harder to make sure you have found the right weapons; you can verify that you are targeting the right items by using the zoom function; it should point you to the cage. Mark the items for dumping, and dwarves will come to the cage and take them.

If you want to use caged invaders for target practice, it may be wise to go into the Stocks screen and remove the Dump designation from all of their armor - this way, only their weapons will be taken away, allowing them to take significantly more damage (and provide more experience).

=== How to quickly empty out many cages ===
If you have many {{L|Trap#Cage_Trap|cage traps}} then you may have trouble emptying out cages quickly enough at times. See {{L|Mass pitting}} for suggestions on how to quickly recycle cages.

{{buildings}}

==Bugs==

Creatures in cages that come from dead merchants cannot be freed. They can only be transferred between cages.

'''Update:''' Creatures in cages that come from dead merchants CAN 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.

{{Category|Justice}}

v0.31:Wall

2011-05-23T18:07:50Z

Sasf54:

{{quality|Exceptional|13:50, 7 March 2011 (UTC)}}{{av}}

A '''wall''' is a either a {{L|map tile}} or a {{L|construction}} that blocks access to {{L|creatures}}. The appearance of a constructed wall is similar to that of a {{L|smoothing|smoothed}} natural wall but it works the same as any filled tile composed of mountain rock, {{L|clay}} or {{L|soil}}. Walls either occur naturally (e.g. a Rough-hewn Andesite Wall), or can be constructed. With constructed walls it is possible to create multi-level {{L|building}}s such as {{L|tower}}s complete with roofs by creating {{L|floor}}s on the layer above. A wall fills the tile it is in and creates a walkable space above it.

== Digging ==
As explained on the {{L|digging}} page, naturally occurring walls can be dug out using the {{Key|d}}esignations {{Key|d}}ig command, or c{{Key|h}}annel command. These tasks are carried out by dwarves with the {{L|mining}} labor activated.

Natural walls can be designated for {{K|s}}moothing and {{K|e}}ngraving to improve the appearance and value of the wall. These tasks are carried out by dwarves with the {{L|stone detailing}} labor activated.

== Construction ==

Walls can be built ''en masse''. To do this, use the {{K|b}}uild -> {{K|C}}onstruction -> {{K|w}}all command. The keys {{K|u}},{{K|m}},{{K|k}} and {{K|h}} are used to change size. Walls may be built on any square which does not already contain a structure, provided your dwarves can reach an adjacent square (this includes building a wall over empty air next to a floor, allowing for the construction of inverted pyramids). Diagonals can neither be built from, nor will they support constructions.

The important thing to remember is that all walls, floors and anything built with the {{K|b}}-{{K|C}} keys are LIFO - "Last In, First Out". That means that the very last designation you make will be the very first thing your masons will work on next! Once you master this concept, it can be used to your advantage, but only if you can plan ahead.

It is also important to remember that you cannot build on top of a constructed floor, but you can build a wall on top of another constructed wall, even though the upper surface of a wall is otherwise indistinguishable from a constructed floor.

Constructed walls cannot be engraved, but can be carved into {{L|fortification}}s ({{K|d}}esignate - c{{K|a}}rve fortifications). They will block movement, but not {{L|liquid}}s or small objects such as {{L|bolt}}s.

Normal walls are considered 'rough'. By using {{L|stone}}, {{L|glass}}, {{L|wood}}, or {{L|metal}} {{L|block}}s, higher quality constructions can be built with increased value. This can be particularly important when trying to maximize the value of a {{L|noble|}}'s {{L|room}}.

As with all {{L|construction}}s, the material used dictates which {{L|labor}} is required to perform the construction.

When building walls, your masons will carry the rocks themselves. A useful tip when building defences is to first make a rock stockpile nearby, and only allow one type of rock in it. When it fills up, remove it, and build the wall.

== Removing Walls ==

To remove a wall, open the {{Key|d}}esignations menu and select {{Key|n}} Remove Construction. This task will be carried out by any unoccupied dwarf, including {{L|children}} and {{L|noble}}s.

== Notes ==
* Wall does not absorb {{L|Noise}}. Walls have 3 purpose: permit movment of creatures, permit flow of liquids, suspend structures. So your dwarfs / hostile creatures can't get trough directly, and directs your liquids ({{L|water}}, {{L|lava}}) flow.
* If a strucutre is not supperted, it will collapse. If you have channeled a piece of rock / ground around, and dig every wall from under it, it will collapse, most likely to hurt your dwarf under / on it.

==See also==
*{{L|How do I construct a wall from a particular direction}}?

{{Buildings}}
{{Category|Buildings}}
{{Category|Constructions}}

v0.31:Chicken

2011-05-22T15:11:36Z

Sasf54:

{{Quality|Fine|17:50, 11 March 2011 (UTC)}}
{{Creaturelookup/0
|bone=4
|meat=6
|fat=6
|intestine=1
|skull=1
|skin=hide
}}
{{av}}
{{creaturedesc}}

Male chickens are known as roosters, and female chickens are known as hens. Young chickens are known as chicks.

Hens will lay between 4 and 15 eggs and require a {{L|nest box}} to lay the eggs in. A rooster is required to fertilize the eggs however fertilization is not guaranteed. Once hatched, chicks will grow into adults in 1 year.

Economically speaking, eggs are a very good source of food (1 egg = 1 meal) - starting out with 5 hens and rooster on embark is an easy way to keep a new fortress fed until larger scale food production can be established. {{L|Turkey}}s are more effective in the long run, as they have larger bodies (and therefore more butcherable meat) and lay larger clutches of eggs (10-14) at once; while chickens have a longer lifespan, permitting a number of turkey eggs to hatch will make this largely moot.

Be warned that large groups of chickens will require a significant amount of space for them to roam, otherwise they will quickly get into fights; additionally, failing to collect eggs may rapidly lead to a {{L|catsplosion#Birdsplosion|chickensplosion}}.

{{D for Dwarf}}
For some reason, roosters give a skull more often than anything else. This may be because the butcher holds it by the throat when cut. It's a well known fact that chickens can run even after being beheaded. For more info see {{L|Domestic_animal|domestic animals' page}}

== See also ==

* {{L|Domestic_animal#Comparison_of_domestic_poultry|Comparison of domestic poultry}}

{{Gamedata}}
{{Creatures}}
{{Category|Animals}}

v0.31:Butcher's shop

2011-05-22T15:09:33Z

Sasf54: /* Notes */

{{Quality|Exceptional|09:44, 9 August 2010 (UTC)}}
{{Workshop
|name=Butcher's shop
|key=u
|job=*{{L|Butcher|Butchery}}
|construction=
1 of
*{{L|Block}}
*{{L|Stone}}
*{{L|Wood}}
|construction_job=
1 of
*{{L|Butchery}}
*{{L|Small animal dissection}}
*{{L|Trapping}}
|use=
* {{L|Tame animals}}
* Corpses of untamed non-sentient animals
|production=
* {{L|Skin}}
* {{L|Fat}}
* {{L|Meat}}
* {{L|Bone}}
* {{L|Prepared organs}}
* {{L|Skull}}
* {{L|Scale}}
* {{L|Hooves}}
* {{L|Ivory}}
* {{L|Tooth}}
* {{L|Hair}}
* {{L|Wool}}
}}{{av}}

The '''butcher's shop''' is used to butcher {{L|Tame animals|tame animals}}, corpses of certain slain animals, and to process skeletons of wild animals. Tame animals can be designated for butchering either by pressing {{key|v}}, moving the curser over the animal and pressing {{key|s}}, or by going into the animal list by pressing {{key|z}}, {{key|Enter}} and then by choosing the animal(s) for butchering by pressing {{key|b}} while they are highlighted. It can also be used to butcher already dead animals, but only if their corpses have been placed in a '''refuse''' stockpile nearby beforehand.

A butchered animal results into various items with different uses:

{| {{prettytable}}
!Item
!Uses
|-
|{{L|Meat}} and {{L|Prepared organs}}
|Eaten raw or {{L|kitchen|cooked}}
|-
|{{L|Fat}}
|{{L|kitchen|Cooked}} to {{L|tallow}}
|-
|{{L|Skull}}
|Crafting skull {{L|totem||totems}}
|-
|{{L|Bone|Bones}}
|Crafting bone {{L|bolt|bolts}}, bone {{L|craft|crafts}}, or used as a {{L|decoration}} material
|-
|{{L|Hoof|Hooves}}, {{L|Horn}}s, {{L|Shell}}s, {{L|Nail}}s,{{L|Tooth|Teeth}}
|Used for {{L|crafts}} or used as a {{L|decoration}} material
|-
|Skin, Scale, and Chitin
|Tanned into {{L|Leather}}
|-
|{{L|Hair}}
|Spun into {{L|thread}}, but not weaved into {{L|cloth}}
|-
|{{L|Cartilage}}
|Currently no uses. {{version|0.31.25}}
|-
|Nervous tissue
|Currently no uses. {{version|0.31.25}}
|-
|Feather
|Currently no uses. {{version|0.31.25}}
|-
|Wool
|Spun into {{L|Yarn}}
|}

==Menu==
'''Butcher's Shop'''

*{{k|b}}'''Butcher a dead animal'''
Renders a dead animal into its component parts of {{L|meat}}, {{L|fat}}, {{L|skin}}, {{L|bone}}s, and {{L|skull}}s. Usually used on animals that your {{L|hunter}} brings back, or tame animals you chose for slaughter.

*{{k|e}}'''Extract from a dead animal'''
Requires a caged {{L|fire snake}}, {{L|cave spider}}, or {{L|phantom spider}} and {{L|Animal dissector|animal dissection}}. Contrary to the name of the task, the vermin must be alive (though it will be dead once the task is done).
Produces {{L|Fire snake|liquid fire}} and {{L|venom}}, respectively.

*{{k|a}}'''Capture a live land animal'''
Requires an {{L|animal trap}} and {{L|trapping}}.
The trapper will take the trap and chase vermin until it catches one.

==Common Uses==
*Produce meat for food.
*Produce skin for leather.
*Produce bones for bolts.

==Helpful Strategies==

=== Hauling and stockpile considerations ===

One thing to beware of is that butchered creatures will practically explode into piles of meat, bones, fat, organs and more; this can quickly clutter up a butchers shop or risk rotting the entire pile if not enough haulers and a suitable stockpile are available. Refuse also can not be stored in containers, so every item will use up one stockpile tile. For any jobs, such as cooking meat, rendering fat, and carving bones, the entire stack will become tasked and unavailable to other workshops.

The initial corpse or body part must be in a stockpile close enough to the butcher's shop to automatically trigger the '''Butcher a dead animal''' job. Similarly, there is a maximum distance for the [[Tanner's shop]] to notice a skin and automatically trigger a '''Tan a skin''' job. It is not known precisely what "close enough" is, in either case.

=== Clutter Reduction and Rotting Prevention ===

A good way to cut down on clutter and to prevent your butchered animals from rotting is to build a Quantum Stockpile right by your butcher shops and then place a stockpile at the bottom. This way as meat is produced you can order it dumped into the stockpile so it is stored easily and will not rot.
To prevent rotten meat from producing miasma channel out a shaft above your butcher shops and build a wall around it on the surface. This way if meat rots it will not produce miasma.

==Notes==
*A butcher's shop is operated by any dwarf with the 'butchery' {{L|labor}} enabled.
*Corpses left to rot will become skeletons. Only those of wild animals (typically killed from hunting or traps) can be processed at the butcher's shop. Products will be bone, skull, hoof, horn and the like (no meat, fat, prepared organs or skin).
*Partial corpses as well as mutilated corpses do not provide the "full set"; the number of bones may be lower, organs may be missing.
*You can't butcher vermin fish, that is done at the [[Fishery]]. But you can butcher underwater creatures. For instance, you can butcher 'Carp corpse', but you can't butcher 'Oyster'.
*Some tamed animals may seems to be unbutcherable, such as those that die of starvation.
*Tamed birds may leave only skull, if not reached fully adulthood. For more info see [[Domestic_animal|Domesticated animals page]]

==See Also==

:*{{L|Creature}} pages for butchering results.
:*{{L|Meat industry}}
:*{{L|Stockpile}}

{{Workshops}}

v0.31:Sand

2011-05-21T14:52:07Z

Sasf54:

{{quality|Exceptional|13:18, 19 October 2010 (UTC)}}{{av}}

'''Sand''' is one of the many specific types of {{L|soil}} that can be found in Dwarf Fortress. As all sand types are {{L|soil}}s, above ground {{L|farm plot}}s can be built on them without need for irrigation. Sand can also be used to make {{L|glass}} (see below).

There are five different colors of sand – {{L|yellow sand}}, {{L|white sand}}, {{L|black sand}}, {{L|red sand}}, and {{L|sand (tan)|tan sand}} – but their only difference is their appearance on the ground, as there is no difference between them for purposes of {{L|Glass industry|glassmaking}}. Sand typically appears in {{L|desert}}s and along {{L|ocean}} beaches, but is often found in other {{L|biome}}s as well.

Sandy clay, sandy clay loam, sandy loam, and loamy sand are '''not''' considered sand by the game and thus cannot be used for glassmaking.

When an underground {{L|tree}} grows on a muddy stone floor tile (after discovering a {{L|cavern}}) and is either trampled or cut down, the floor tile turns into a soil type appropriate to the {{L|biome}} - for biomes which lack soil layers altogether (such as mountains and glaciers), a random soil type will be selected, which might sometimes be sand.{{verify}}

Sand, unlike normal soil, is always depicted using the {{Tile|≈|6:0}} and {{Tile|~|6:0}} symbols and cannot be furrowed, thus causing unpaved sand {{L|road}}s to be covered in grass and vegetation much more quickly.

Grass or fungus can grow on sand, which causes the underlying sand to be temporarily unavailable for collection, giving the message "Urist McBagger cancels Collect Sand: Sand vanished" if the job is in progress, or "Urist McBagger cancels Collect Sand: Need valid, active sand collection zone" if the job is new. Letting some creatures trample back and forth over the grass seems to correct this problem; in more recent versions, you may also {{L|pasture}} some hungry animal on the zone to eat the offending vegetation.

==Glass==
Sand is used in the production of {{L|glass|green and clear glass}} items at a {{L|glass furnace}} ({{L|glass|crystal glass}} requires rough {{L|rock crystal}} in its place). To collect sand, first locate some appropriate sand tiles. They will appear as "[Color] Sand [Tile]" when inspected with the loo{{k|k}} tool. Next, set an {{L|activity zone}} over the sand tiles by pressing {{k|i}} and then designating the sand tiles as an activity zone (note that sand cannot be collected from sand walls). Once you've done this, activate sand collection by pressing {{k|s}}; however, this will not yet result in any sand being collected. You must build a {{L|glass furnace}} and activate the collect sand task. Each Dwarf collecting sand will require a {{L|bag}}, only one dwarf will collect sand per furnace, and no other tasks can be performed at the furnace while sand is being collected. Sand collection requires the "Item Hauling" {{L|labor}}. The bags of sand will not be taken to the glass furnace; they are left in the sand collection zone, until hauled or dumped or selected for a glass-making job.

Filled bags of sand are considered {{L|furniture}}, and as such require the "Furniture Hauling" labor to move. Sand bags are stored in furniture {{L|stockpile}}s with "sand bags" enabled ({{k|u}} in the bottom right corner).

Collected sand is listed under {{L|powder}} on the {{L|stocks}} menu. However, if you attempt to dump the sand from this section, the dwarves will [http://www.bay12games.com/dwarves/mantisbt/view.php?id=3220 remove it from the bags] and drop it in useless piles on the floor (as if it were a {{L|contaminant}}). Sand bags can also be found in the "boxes and bags" section on the stocks menu, but they are not marked separately as sand bags on this menu. You must press {{k|Tab}} to switch to the individual item mode, then tediously scroll through the list.

To get bags to fill with sand for your fortress, create a {{L|leather}} bag at a {{L|leather works}} or a {{L|cloth}} bag at a {{L|clothier's shop}}, or buy the bags from a caravan. To have sand bags stored near your glass furnace, create a furniture {{L|stockpile}} with only "sand bags" enabled (this is selected via the {{k|u}} key in the furniture/siege ammo submenu of the stockpile settings menu) but with all materials and quality levels still permitted. It may be useful to construct several glass furnaces so that you can have several "collect sand" jobs queued on them at the same time, which helps ensure that you have enough filled sand bags on hand to keep your glassmaker(s) supplied.

==Availability==
Not all embark locations have sand available. While this may prevent the establishment of a full glass industry, it does not outright prevent the making of glass at all - individual bags of sand may be purchased during {{L|embark}} for 1 point apiece (with a free {{L|bag}} included), and caravans will frequently bring several bags of sand with them each year (plus more if requested from the {{L|liaison}}).

It is wise to always keep several bags of sand on hand in order to deal with {{L|strange mood}}s requiring glass. In cases where {{L|noble}}s make frequent production {{L|mandate}}s for glass items, requesting all types of sand at maximum priority from the {{L|liaison}} is highly advised.

==Storing==
Sand can be stored in bags. Sandbags are stored inside the furniture stockpile (Specail option). If you want to make a dedicated sand bag stockpile, turn everithing else off ({{k|f}}, except the Core quality, and Total quality. If you forget to enable the qualities, then no sanbag will hauled into your stockpile.
If you want to a garbage dump to store sandbags, please, don't forget, the mass dumping {{k|d}}{{k|b}}{{k|d}} is recursive. So in this case the sand is marked for dumping (not just the bags), and the dwarfs will dump the sand first. You can use mass dumping, if you don't forget to undump the sand from your Stocks ({{k|z}},Stocks).
{{Category|Materials}}

v0.31:Farming

2011-05-12T18:47:30Z

Sasf54: /* Farm plots in action */

{{quality|Exceptional|19:03, 16 April 2011 (UTC)}}{{av}}
[[Image:Df-crops-diagram.png|thumb|200px|General farming flowchart.]]

'''Farming''' is the action of growing {{l|crops}} for {{l|food}}, {{l|alcohol}} production and {{l|cloth}} manufacturing. While small forts can easily be sustained by plant gathering, {{l|hunting}} and trading, farming is vital to large settlements.

Farming is done at a '''farm plot''' building ({{k|b}}-{{k|p}}, resize with {{k|u}}{{k|m}}{{k|k}}{{k|h}}). It requires {{l|seeds}} and a worker with the "Farming (Fields)" {{l|labor}} enabled.

Depending on where the farm plot is constructed, different crops may be planted. Farm plots built {{l|above ground}} are not suitable for the crops grown on {{L|subterranean}} farm plots and vice versa. Note that the attributes {{DFtext|Inside |6:0:0}}, {{DFtext|Dark |0:0:1}}, {{DFtext|Outside|3:0:1}} and {{DFtext|Light|6:0:1}} are of no relevance.

See the article on {{L|crop}}s for details on the conditions needed to grow the available plants.

== Introduction to Farming ==

After building a farm plot building ({{k|b}}-{{k|p}}, resize with {{k|u}}{{k|m}}{{k|k}}{{k|h}}), you must select which crops to plant there.

Press {{k|q}} and move the cursor over the farm, you will see a list of crops you can select to grow in the current season. You can change which season is displayed by pressing {{k|a}},{{k|b}},{{k|c}}, or {{k|d}}. Move the blue selector up and down with {{k|-}} and {{k|+}}, and press {{k|Enter}} to choose a crop to plant during that season (highlighted in white).

You must have the appropriate {{L|seed}}s to plant a crop there. To easily see how many of each seeds you have you can go to the Kitchen menu ({{k|z}} {{k|right}} {{k|Enter}}). {{L|Plump helmet}}s are a good beginning crop for a first cave farm, and {{L|wild strawberries}} are a good choice for outdoor fields. Check the {{L|crop}}s page for details on different seeds. Only some plants are edible so make sure the seeds you're using will produce food. It's often a good idea to pick a seed which produces a plant which can be {{L|brew}}ed. This will create {{L|alcohol}} and also give you a seed to plant again next season.

Instructing a plot to remain fallow {{k|z}} during a particular season will instruct dwarves not to plant in that plot during that season.

=== Fertilization ===
<Table BORDER=1 align="right"><tr><td align="center">Farm Size</td><td>Potash</td><td>Per Square</td></tr>
<tr><td align="center">1</td><td align="center">1</td><td align="center">1.000</td></tr>
<tr><td align="center">2</td><td align="center">1</td><td align="center">0.500</td></tr>
<tr><td align="center">3</td><td align="center">1</td><td align="center">0.333</td></tr>
<tr><td align="center">4</td><td align="center">2</td><td align="center">0.500</td></tr>
<tr><td align="center">5</td><td align="center">2</td><td align="center">0.400</td></tr>
<tr><td align="center">6</td><td align="center">2</td><td align="center">0.333</td></tr>
<tr><td align="center">7</td><td align="center">2</td><td align="center">0.286</td></tr>
<tr><td align="center">8</td><td align="center">3</td><td align="center">0.375</td></tr></table>

Pressing {{k|f}} lets you toggle fertilization on or off. To fertilize a farm plot, one needs {{L|potash}}, which is produced by processing {{L|ash}}. It greatly increases the yield of a plot (approx. multiplied by four). However fertilization only lasts for one season, and requires plot size / 4 (round down) + 1 of {{L|potash}} for saturation. Therefore fully fertilizing a farm would require burning a large amount of trees each season. The table on the right illustrates the effect of the formula on potash needed per square. Generally, larger farms use less, approaching a limit of 1/4 bar ber square. The worst sizes are multiples of 4, it's better to have plots one or two less than a multiple of 4. While costly, fertilization enhances productivity of not only farmers, but many industries down the line, e.g. brewing, cooking, milling and threshing, due to the large increase in stack size of the plants, which are still processed in a single action.

=== Subterranean Farming ===

To grow the six "dwarven" plants, including the {{l|plump helmet}}, you will need an underground farm plot. The seeds and spawn available to your dwarves at embark will only grow underground. Underground farm plots must be placed on soil or {{L|mud}}dy stone.{{version|0.31.19}}

Muddying a stone floor requires temporarily covering it with water: common methods include a bucket brigade or '''controlled''' flooding (see: {{l|Irrigation}}) by temporarily diverting a river or pool, using a floodgate or door to stop the flow. You may also find a muddied area in a {{L|cavern}}, but note that each tile underneath the farm plot must be muddied. Most caverns have entire open areas which will be permanently covered in mud, but if you dig into the walls of a cavern or chisel away a pillar, the freshly cut floor area will not be muddied until you get it wet. Underground caverns are dirty, and frequently contain {{L|Mud|piles of mud}} that are perfect for quickly setting up farms. However, given the wide variety of creatures found in caverns, you may want to take precautions. Consider keeping a {{L|squad}} close at hand to guard the farm, or walling off a muddied area for your dwarves' exclusive use.

Underground farming is not restricted to soil layers and caverns: underground floor of any material -- rough stone, smoothed stone, ore, gem -- can support subterranean farm plots once there is a layer of mud covering it. See {{L|irrigation}} for tips on getting the right amount of water to the farm plots.

=== Above Ground Farming ===
Above ground crops farming is impossible in Ocean and Mountain biomes, even if the farm is built on mud.

Above ground farming is basically the same as underground farming, with the simplifying distinction that above ground plots typically do not require preparatory work. However, there are some complications.

The first complication is that seeds cannot be chosen at embark, as dwarven civilizations do not have access to those sort of plants. They can be bought from {{L|Elves|elven}} and {{L|human}} caravans; above-ground plants can be gathered using the {{L|Plant gathering}} designation, and then {{L|brewer|brewed}}, {{L|mill}}ed, {{L|thresher|threshed}} or {{L|dining hall|eaten}} directly (depending on the plant) to produce seeds.

The second complication is that the farming must be done on {{L|soil}} or muddied rock, being {{L|above ground}}. Typically, it is done on the surface, which is dangerous (due to aggressive animals, ambushes and sieges). However, any land which has ever been exposed to sunlight becomes permanently marked as "above ground". So, if you have multiple Z-layers of soil, you can channel some above-ground land, remove the resulting ramps, then construct a floor above, where the surface once was. The (now inside and protected) lower soil will still be suitable for farming outdoor plants like {{L|wild strawberry|wild strawberries}}, {{L|longland grass}}, {{L|rope reed}}, and anything else you may find. If your soil is not thick enough, you may still get a secure above ground farm by doing the same with any rock and muddying it. Alternatively, you may build a greenhouse around some soil.

Above ground farms built on unmuddied rock layers will show the message "No seeds available for this location", and you ''will not'' be able to plant anything in them.

Some crops require a particular temperature range to grow; so although it may be possible to plant them in any season, to obtain optimal usage of farm plots it may be necessary to coordinate planting with seasonal temperature variations.

== Farm plots in action ==

Once a farm plot has been built and crops have been selected for the current season, dwarves with the {{l|growing}} labor enabled will begin planting the selected seed. The higher a Dwarf's grower skill in planting, the more plants will be harvested from each seed planted. The farming labor is fairly low in priority, so if you want a full time farmer, it is best to disable all other labors.

Plants take time to grow, depending on their type. Once a plant is fully grown, a dwarf will harvest it. By default, any dwarf will do this. Harvesting plants is not affected by any skill, although it provides a small amount of grower experience. So it's a good idea to set only your planters to harvest, not anyone. To do that, set option "Only Farmers Harvest" {{k|o}}{{k|h}}.

Plants that remain in the field for too long will wither. These plants will eventually rot away. There's no any use of wittered plants other than to dump it.

Depending on the number of growers and their experience and the rate at which the plant grows, not all squares of large plots may be used. {{verify}}

== Management ==

Create a custom {{L|stockpile}} near your {{L|farm}} which will only accept {{L|seed}}s. This will consolidate your seeds into one place, instead of having them littered all through the {{L|dining room}}. As a large number of seeds can be stored in a single barrel, this stockpile can be only three or four tiles. Alternately, you can make a more traditional sized custom stockpile, which only accepts seeds and bars of {{L|potash}} for fertilizing.

You can also create a custom stockpile that will only accept {{L|plant}}s, to avoid having it all mixed up with your {{L|meat}} and {{L|drink}}s. It would be a good idea to have this stockpile near your {{L|still}}, {{L|farmer's workshop}}, {{L|kitchen}}, etc.

Use the {{L|stocks}} menu, and go to the Kitchen tab. From here you can see how many of each kind of food you have. If you're running out of a certain kind of seed, toggle the corresponding plant "Cook" setting to red. {{L|Cooking}} plants doesn't leave a seed. If you have too many of a certain kind of seed, toggle the seed "Cook" setting to blue. Just make sure you check on the stocks (or just forbid one seed and leave it for emergency) and toggle it back before you run out!

{{Farming FAQ}}

== See also ==
* {{L|Irrigation}}
* {{L|Tile attributes}}
* {{L|Crops}}

{{Category|Buildings}}

v0.31:Activity zone

2011-05-11T21:09:15Z

Sasf54: /* Garbage Dump */

{{quality|Fine|08:37, 14 September 2010 (UTC)}}{{av}}

'''Activity zones''' are areas in which {{l|dwarf|dwarves}} are instructed to perform specific tasks, such as {{l|fishing}}, dumping objects, or collecting {{l|water}}. While activity zones are optional for the performance of certain tasks (fishing, collecting water) and obligatory for certain others (dumping), they can also be used to help keep dwarves out of {{l|fun|danger}}.

Activity zones can be placed in any {{l|revealed tile}}, including in {{l|open space}} or over a {{l|river}} or on top of a {{l|building}} or {{l|stockpile}}. They are placed in one of three ways: rectangular, flow, or floor flow. From within the Zones {{l|menu}}, ({{K|i}})Pressing {{K|e}} in the Zones menu cycles through each method, and pressing {{K|Enter}} begins designation. Rectangular zones are placed in the same manner as stockpiles, specifying two corners of the rectangle. Flow and floor flow are placed similarly to designating rooms from pieces of furniture using {{K|+}}/{{K|-}} to adjust the size (floor flow excludes walls). After that the zone has to be assigned to one of the listed tasks to become functional, by pressing the proper key. In some cases ({{l|healthcare|hospital}}, pit/pond) additional orders can then be set from the same menu.

The location of a zone is only visible while in the Zones menu, and any object lying on the ground will hide the presence of a zone tile.

== Water Source ==
:Shortcut {{k|w}}
Dwarves will draw water from this zone to satisfy their thirst, to tend to another thirsty dwarf, or to fill a Pond zone.

Only tiles '''adjacent''' to water qualify as usable water sources - thus, if you want to place a single-tile zone, place the zone onto a ground tile next to the water, not over the water itself.

== Fishing ==
:Shortcut {{k|f}}
The same above advice for '''water source''' zones is applicable to fishing zones. You cannot fish through a {{L|grate}} or {{L|well}} {{verify}}, it must be an open source of water.

== Garbage Dump ==
:Shortcut {{k|g}}

Garbage dump zones are areas in which dwarves will throw items specifically designated by using {{k|k}} then {{k|d}} for single items at a time, or {{key|d}}, {{key|b}}, {{key|d}} to designate a larger area to be dumped (or use the mouse to point and click). Garbage dumps are not the same as {{l|Refuse#Refuse|refuse}} stockpiles, which can be designated to accept any specific type(s) of refuse-type item, such as animal {{l|corpse}}s or {{l|bones}}, and then are randomly filled by haulers as the items become available on the map.

Garbage dumps:
:* Only accept items that have been marked for dumping.
:* Require dwarfs to have {{L|refuse hauling}} {{L|labor}} enabled.
::* Are subject to refuse orders (''{{k|o}}: Set Orders and Options -> {{k|r}}: Refuse Orders''). Most notably, dwarves will not dump items that are outside unless you allow them to ({{k|o}}->{{k|r}}->{{k|o}}).

To place a garbage dump, trace a zone on either a relatively empty plot of land or adjacent to a cliff face or hole. If a garbage zone is designated beside a {{L|cliff}} or hole (both natural or dwarf made) garbage will be thrown off/in the z-space. Each ground tile within that zone is considered a garbage dump tile; thus, if you want to place a single-tile zone, place the zone onto a ground tile (optionally adjacent to a cliff or {{L|pit}}), not onto an {{L|open space}}.
Items dumped into {{L|magma}} (provided they are not {{L|magma safe}}) will disappear permanently. Otherwise a single tile (either a dump zone, or the ground below the open space) will hold any number of dumped objects.

Once items are dumped they are automatically marked as "{{l|forbid}}den" however they will not dump items that are also forbidden. If you wish to use dumped items, you need to reclaim them. Press {{k|k}} to view the item and {{k|f}} to toggle forbid status. You may also use the reclaim {{L|designation}} to reclaim simultaneously all of the items dumped by using {{key|d}}, {{key|b}}, {{key|c}} and tracing the designation over top of the objects.

If a garbage dump is located next to open space, dwarves will always stand on a garbage dump square when throwing ''into that open space'', even if it could potentially be done more efficiently. If a garbage dump is located next to multiple tiles of open space, they seem to prefer the one farthest to the northwest. If a tile to the north and a tile to the west are the only tiles available, they will throw to the west. Since falling objects do not hurt dwarves, such garbage dumps can be a very efficient method of moving materials to the lower levels of your fortress.

Dwarves seem to throw dumped items in the nearest available garbage dump, although this is probably not reliable given that they don't always use the nearest available item to make things at workshops. If a nearer zone becomes available as they are traveling to a zone they will ignore it. Also, they seem to prefer dumps that allow them to throw things in to open space regardless of how far away they are.

Probably due to a bug, dwarves periodically ignore items that are meant to be dumped. Viewing the item by pressing {{k|k}} then toggling forbid and dump status on, then off again {{k|f}}->{{k|f}}->{{k|d}}->{{k|d}} seems to correct this problem.

Previously dumped items are regarded as 'refuse' and will not be recognized (or re-dumped) unless 'gather refuse from outside' is enabled in your orders.

:Notes
* Garbage dumps are great space savers, becuase can hold infinite items on one title. If the dump is designated inside a workshop, it does not even cluttered because of this.
* It may be a good idea, to set a garbage dump in a stone workshop, than fill it with nearby stones. Reclaim them {{k|d}}{{k|b}}{{k|c}}, but make sure, that your dwarfs will not haul them into a far stone stockpile.
* '''Do not for any reason mark a garbage stockpile inside a magma workshop, other than destroy the dumped items.''' Your dwarf will more than happy, to see your precious metal ore melt inside the flaming magma, and melt away.
* If you designate an area {{k|d}}{{k|b}}{{k|d}} to dump, please notice, everything in that area will be dumped, starting from the deepest item. This means, if you have a food stockpile, with a barrel, inside some bags with dwarven floor, than both the barrel, bag, and floor will be designatet for dump, and the order will be: floor (you will lose any milled plant / liquid if hauled from the container), bag, barrel.
* if you want to quick sort out a stockpile (make several plant specific ones instead of one plant stockpile), dump your barrels (one by one {{k|k}}{{k|d}}), and all your barrels are inside the garbage dump, you can area dump it {{k|d}}{{k|b}}{{k|d}} making your dwarfs to run much less. (Technicall they should just stay still, and unload the contents). After you finished (and redesignated your new plant specific stockpiles), claim your plants and barrels {{k|d}}{{k|b}}{{k|c}}.

== Pen/{{L|Pasture}} ==
:shortcut {{k|n}}

A pen or a pasture is used to contain tame animals. Once one is created, animals must be assigned to it individually by pressing {{k|N}} from the zone information screen. Dwarves will drag the assigned animals to the pen or pasture automatically. As of version .31.19, many domestic animals will become hungry and starve if not assigned to a pasture with [[grass]] or fungus (note that the assigned creatures can eat all of the grass in a pen/pasture and then starve). Any tame creature with the "grazer" token in the raws should be assigned to a pasture. This includes pigs, mules, cows, goats, horses, yaks, unicorns etc. Animals will not typically wander out of their assigned pasture even if it is not walled in, however an exposed pasture may lead to premature slaughter at the hands of invaders. Since pets can be assigned to pen/pastures and a zone can be created under a [[dwarven atom smasher]], this is one of the easiest ways to prevent [[Catsplosion|catsplosions]].

== Pit/Pond ==
:Shortcut {{k|p}}

A Pit/Pond requires a {{L|ramp}} or hole with adjacent flooring on which a dwarf can stand. Designate the zone from the top of the ramp or hole, such that the zone designation is floating in the open space above the floor of the pit/pond. By default, the zone will be a pit. To change it to a pond, press {{k|P}} then {{k|f}}. It can be changed back to a pit the same way.

Creatures can be assigned to a pit/pond through the {{k|P}} menu. A dwarf will lead the beast to the ramp or hole and throw it in. If the pit is a ramp rather than a hole, the creature will then wander back out, as it will if the pit has some other exit path (which would include straight back up the hole for flying creatures).

Note that not all hostile creatures can safely be dragged to a pit opening. Large creatures and thieves/snatchers will escape on being released from their cage. See {{L|Mass Pitting}} for more information on pit design involving hostile creatures.

The only real difference between a pit and a pond is that dwarves will attempt to fill a pond with {{L|water}}, carried by {{L|bucket}} from a water source. They will stand on the floor adjacent to the top of the ramp or hole, and toss the water onto the ramp or into the hole. Each bucketful increases the depth of the water in the tile below by 1/7. Once the water is dumped from the bucket, the dwarf will either drop the bucket and perform a different task, or choose to fill a pond zone tile again using the bucket (s)he currently holds.

Dwarves will stop scheduling the Fill Pond job when the water depth reaches 6/7.

Specifying a pond zone is one technique used for {{L|irrigation}}, in order to make {{L|mud}} for {{L|farming}} on areas without soil.

Currently, no matter how large the designated pond area, only one dwarf at a time will try to fill the pond. In order to fill a large area quickly, it is necessary to designate multiple smaller pond zones (or several zones overlapping the same area).

If you have more than one pond designated as a water source, your dwarves may endlessly try to fill each pond with the other pond's water, making a loop of useless duty.

== Sand Collection ==
:Shortcut {{k|s}}

Sand collection zones are important in the {{L|glass industry}}. They may be placed anywhere, but are only useful when actually placed on {{L|sand}}.

== Clay Collection ==
:shortcut {{k|c}}

Clay collection zones are important in the [[ceramic industry|ceramics industry]].

== Meeting Area ==
:Shortcut {{k|m}}

Meeting area zones are zones in which idle dwarves and animals will congregate, similar to meeting halls. Additionally, immigrants will collect at a meeting area until their "migrant" status wears off.

Note that the {{l|wagon (embark)|wagon}} you {{l|embark|arrive with}} constitutes a meeting area until you designate the first meeting area of your own. If you start in hostile surroundings it is important to get your dwarves and animals out of danger quickly.

It is a good idea to have at least one meeting area, of one form or another: it allows you to make off-duty dwarves and animals gather in an area where they are not vulnerable, such as within the fortress.

There are several ways to designate a meeting hall. The preferred method is to use an Activity zone; type {{k|i}}, set up a zone, and mark it both "active" and "meeting". {{L|Sculpture garden|Statue gardens}} and {{L|zoo}}s are intrinsically meeting halls, as are {{L|room}}s defined from a {{L|well}}. However, you can also create a Meeting Hall.

A meeting area filled with dwarves increases the social skills of idlers. It makes idle dwarves a little less idle, and makes selecting a replacement broker easier. Because almost every dwarf visits a meeting hall at least occasionally, it's an ideal place to site valuable objects and buildings. A meeting hall exposed to sunlight will prevent dwarves from becoming {{L|cave adaptation|cave-adapted}}.

Be warned that having dwarves socialize will often result in them becoming {{L|friend}}s (or forming a {{L|grudge}}).

== Hospital ==
:Shortcut {{k|h}}

A Hospital zone is an area designated for the {{L|Healthcare|care and treatment}} of sick and {{L|Wound|wounded}} dwarves.

===Setting up a Hospital===

While there are no particular restrictions on the areas that can be set as hospital zones, a hospital requires certain {{l|furniture}} and supplies to function properly:

{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
|-
! Furniture
! Function
|-
| {{L|Bed|Beds}}
| Allow sick dwarves to {{L|Rest|rest}}
|-
| {{L|Table|Tables}}
| Used in surgery{{Verify}}
|-
| {{L|Traction bench|Traction benches}}
| Immobilize dwarves who need to stay still to heal
|-
| {{L|Container|Boxes/Bags}}
| Storage for medical supplies
|}

{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
|-
! Medical equipment
! Function
! Unit quantity*
|-
| {{L|Thread}}
| Required for suturing wounds
| 15000
|-
| {{L|Cloth}}
| Required for bandages
| 10000
|-
| {{L|Splint|Splints}}
| Used to bind broken bones{{verify}}
| 1
|-
| {{L|Crutch|Crutches}}
| Walking aid for dwarves with leg injuries
| 1
|-
| {{L|Gypsum plaster|Powder for casts}}
| Used to make plaster casts for setting bones{{Verify}}
| 150{{Verify}}
|-
| {{L|Bucket|Buckets }}
|
*Used by doctors to carry water for cleaning patients
*Used by dwarves with the Feed Patients/Prisoners labor to water patients
| 1
|-
| {{L|Soap }}
| Used to reduce infections when washing patients
| 150
|}

''*The unit quantity is the quantity of each item that appears in the Hospital Information screen when one object of that type is stored. For example, if one bolt of cloth is stored in the hospital zone, the hospital will report that it contains 10000 cloth.''

In addition to furniture and medical supplies, a {{L|Water|source of water}} is more or less mandatory, as sick dwarves need it for drinking as well as cleaning. The water source need not be in the hospital zone, although the shorter the distance between the two the better.

When the Zones menu ({{k|i}}) is open and the cursor is in a hospital zone, {{k|H}} will bring up the Hospital Information screen. This screen shows the quantity of each type of furniture piece and medical equipment present in the Hospital, and allows you to set the desired quantity of each type of equipment. Note that you must have boxes or bags constructed in the hospital zone for supplies to be stored for medical use; items in a stockpile do not count for the hospital, even if the stockpile is in the hospital zone.

===Hospital Beds===

When a dwarf becomes sick or {{l|wound}}ed, he will be carried to a {{l|bed}} in a hospital zone by a dwarf with the Recovering Wounded labor set, assuming such a bed is available; otherwise, he may be carried to a bed in a {{L|barracks}} or {{L|dormitory}}, or to an unassigned bed. If an injured dwarf is resting in a bed outside a hospital zone, he will remain there even if hospital beds become available. Deconstructing the sick dwarf's bed may cause him to be move to a hospital bed, however, and it may be possible for doctors to treat patients who are resting outside of a hospital zone, so long as adequate supplies are available.{{verify}}

v0.31:Activity zone

2011-05-11T21:06:25Z

Sasf54: /* Garbage Dump */

{{quality|Fine|08:37, 14 September 2010 (UTC)}}{{av}}

'''Activity zones''' are areas in which {{l|dwarf|dwarves}} are instructed to perform specific tasks, such as {{l|fishing}}, dumping objects, or collecting {{l|water}}. While activity zones are optional for the performance of certain tasks (fishing, collecting water) and obligatory for certain others (dumping), they can also be used to help keep dwarves out of {{l|fun|danger}}.

Activity zones can be placed in any {{l|revealed tile}}, including in {{l|open space}} or over a {{l|river}} or on top of a {{l|building}} or {{l|stockpile}}. They are placed in one of three ways: rectangular, flow, or floor flow. From within the Zones {{l|menu}}, ({{K|i}})Pressing {{K|e}} in the Zones menu cycles through each method, and pressing {{K|Enter}} begins designation. Rectangular zones are placed in the same manner as stockpiles, specifying two corners of the rectangle. Flow and floor flow are placed similarly to designating rooms from pieces of furniture using {{K|+}}/{{K|-}} to adjust the size (floor flow excludes walls). After that the zone has to be assigned to one of the listed tasks to become functional, by pressing the proper key. In some cases ({{l|healthcare|hospital}}, pit/pond) additional orders can then be set from the same menu.

The location of a zone is only visible while in the Zones menu, and any object lying on the ground will hide the presence of a zone tile.

== Water Source ==
:Shortcut {{k|w}}
Dwarves will draw water from this zone to satisfy their thirst, to tend to another thirsty dwarf, or to fill a Pond zone.

Only tiles '''adjacent''' to water qualify as usable water sources - thus, if you want to place a single-tile zone, place the zone onto a ground tile next to the water, not over the water itself.

== Fishing ==
:Shortcut {{k|f}}
The same above advice for '''water source''' zones is applicable to fishing zones. You cannot fish through a {{L|grate}} or {{L|well}} {{verify}}, it must be an open source of water.

== Garbage Dump ==
:Shortcut {{k|g}}

Garbage dump zones are areas in which dwarves will throw items specifically designated by using {{k|k}} then {{k|d}} for single items at a time, or {{key|d}}, {{key|b}}, {{key|d}} to designate a larger area to be dumped (or use the mouse to point and click). Garbage dumps are not the same as {{l|Refuse#Refuse|refuse}} stockpiles, which can be designated to accept any specific type(s) of refuse-type item, such as animal {{l|corpse}}s or {{l|bones}}, and then are randomly filled by haulers as the items become available on the map.

Garbage dumps:
:* Only accept items that have been marked for dumping.
:* Require dwarfs to have {{L|refuse hauling}} {{L|labor}} enabled.
::* Are subject to refuse orders (''{{k|o}}: Set Orders and Options -> {{k|r}}: Refuse Orders''). Most notably, dwarves will not dump items that are outside unless you allow them to ({{k|o}}->{{k|r}}->{{k|o}}).

To place a garbage dump, trace a zone on either a relatively empty plot of land or adjacent to a cliff face or hole. If a garbage zone is designated beside a {{L|cliff}} or hole (both natural or dwarf made) garbage will be thrown off/in the z-space. Each ground tile within that zone is considered a garbage dump tile; thus, if you want to place a single-tile zone, place the zone onto a ground tile (optionally adjacent to a cliff or {{L|pit}}), not onto an {{L|open space}}.
Items dumped into {{L|magma}} (provided they are not {{L|magma safe}}) will disappear permanently. Otherwise a single tile (either a dump zone, or the ground below the open space) will hold any number of dumped objects.

Once items are dumped they are automatically marked as "{{l|forbid}}den" however they will not dump items that are also forbidden. If you wish to use dumped items, you need to reclaim them. Press {{k|k}} to view the item and {{k|f}} to toggle forbid status. You may also use the reclaim {{L|designation}} to reclaim simultaneously all of the items dumped by using {{key|d}}, {{key|b}}, {{key|c}} and tracing the designation over top of the objects.

If a garbage dump is located next to open space, dwarves will always stand on a garbage dump square when throwing ''into that open space'', even if it could potentially be done more efficiently. If a garbage dump is located next to multiple tiles of open space, they seem to prefer the one farthest to the northwest. If a tile to the north and a tile to the west are the only tiles available, they will throw to the west. Since falling objects do not hurt dwarves, such garbage dumps can be a very efficient method of moving materials to the lower levels of your fortress.

Dwarves seem to throw dumped items in the nearest available garbage dump, although this is probably not reliable given that they don't always use the nearest available item to make things at workshops. If a nearer zone becomes available as they are traveling to a zone they will ignore it. Also, they seem to prefer dumps that allow them to throw things in to open space regardless of how far away they are.

Probably due to a bug, dwarves periodically ignore items that are meant to be dumped. Viewing the item by pressing {{k|k}} then toggling forbid and dump status on, then off again {{k|f}}->{{k|f}}->{{k|d}}->{{k|d}} seems to correct this problem.

Previously dumped items are regarded as 'refuse' and will not be recognized (or re-dumped) unless 'gather refuse from outside' is enabled in your orders.

:Notes
* Garbage dumps are great space savers, becuase can hold infinite items on one title. If the dump is designated inside a workshop, it does not even cluttered because of this.
* It may be a good idea, to set a garbage dump in a stone workshop, than fill it with nearby stones. Reclaim them {{k|d}}{{k|b}}{{k|c}}, but make sure, that your dwarfs will not haul them into a far stone stockpile.
* If you designate an area {{k|d}}{{k|b}}{{k|d}} to dump, please notice, everything in that area will be dumped, starting from the deepest item. This means, if you have a food stockpile, with a barrel, inside some bags with dwarven floor, than both the barrel, bag, and floor will be designatet for dump, and the order will be: floor (you will lose any milled plant / liquid if hauled from the container), bag, barrel.
* if you want to quick sort out a stockpile (make several plant specific ones instead of one plant stockpile), dump your barrels (one by one {{k|k}}{{k|d}}), and all your barrels are inside the garbage dump, you can area dump it {{k|d}}{{k|b}}{{k|d}} making your dwarfs to run much less. (Technicall they should just stay still, and unload the contents). After you finished (and redesignated your new plant specific stockpiles), claim your plants and barrels {{k|d}}{{k|b}}{{k|c}}.

== Pen/{{L|Pasture}} ==
:shortcut {{k|n}}

A pen or a pasture is used to contain tame animals. Once one is created, animals must be assigned to it individually by pressing {{k|N}} from the zone information screen. Dwarves will drag the assigned animals to the pen or pasture automatically. As of version .31.19, many domestic animals will become hungry and starve if not assigned to a pasture with [[grass]] or fungus (note that the assigned creatures can eat all of the grass in a pen/pasture and then starve). Any tame creature with the "grazer" token in the raws should be assigned to a pasture. This includes pigs, mules, cows, goats, horses, yaks, unicorns etc. Animals will not typically wander out of their assigned pasture even if it is not walled in, however an exposed pasture may lead to premature slaughter at the hands of invaders. Since pets can be assigned to pen/pastures and a zone can be created under a [[dwarven atom smasher]], this is one of the easiest ways to prevent [[Catsplosion|catsplosions]].

== Pit/Pond ==
:Shortcut {{k|p}}

A Pit/Pond requires a {{L|ramp}} or hole with adjacent flooring on which a dwarf can stand. Designate the zone from the top of the ramp or hole, such that the zone designation is floating in the open space above the floor of the pit/pond. By default, the zone will be a pit. To change it to a pond, press {{k|P}} then {{k|f}}. It can be changed back to a pit the same way.

Creatures can be assigned to a pit/pond through the {{k|P}} menu. A dwarf will lead the beast to the ramp or hole and throw it in. If the pit is a ramp rather than a hole, the creature will then wander back out, as it will if the pit has some other exit path (which would include straight back up the hole for flying creatures).

Note that not all hostile creatures can safely be dragged to a pit opening. Large creatures and thieves/snatchers will escape on being released from their cage. See {{L|Mass Pitting}} for more information on pit design involving hostile creatures.

The only real difference between a pit and a pond is that dwarves will attempt to fill a pond with {{L|water}}, carried by {{L|bucket}} from a water source. They will stand on the floor adjacent to the top of the ramp or hole, and toss the water onto the ramp or into the hole. Each bucketful increases the depth of the water in the tile below by 1/7. Once the water is dumped from the bucket, the dwarf will either drop the bucket and perform a different task, or choose to fill a pond zone tile again using the bucket (s)he currently holds.

Dwarves will stop scheduling the Fill Pond job when the water depth reaches 6/7.

Specifying a pond zone is one technique used for {{L|irrigation}}, in order to make {{L|mud}} for {{L|farming}} on areas without soil.

Currently, no matter how large the designated pond area, only one dwarf at a time will try to fill the pond. In order to fill a large area quickly, it is necessary to designate multiple smaller pond zones (or several zones overlapping the same area).

If you have more than one pond designated as a water source, your dwarves may endlessly try to fill each pond with the other pond's water, making a loop of useless duty.

== Sand Collection ==
:Shortcut {{k|s}}

Sand collection zones are important in the {{L|glass industry}}. They may be placed anywhere, but are only useful when actually placed on {{L|sand}}.

== Clay Collection ==
:shortcut {{k|c}}

Clay collection zones are important in the [[ceramic industry|ceramics industry]].

== Meeting Area ==
:Shortcut {{k|m}}

Meeting area zones are zones in which idle dwarves and animals will congregate, similar to meeting halls. Additionally, immigrants will collect at a meeting area until their "migrant" status wears off.

Note that the {{l|wagon (embark)|wagon}} you {{l|embark|arrive with}} constitutes a meeting area until you designate the first meeting area of your own. If you start in hostile surroundings it is important to get your dwarves and animals out of danger quickly.

It is a good idea to have at least one meeting area, of one form or another: it allows you to make off-duty dwarves and animals gather in an area where they are not vulnerable, such as within the fortress.

There are several ways to designate a meeting hall. The preferred method is to use an Activity zone; type {{k|i}}, set up a zone, and mark it both "active" and "meeting". {{L|Sculpture garden|Statue gardens}} and {{L|zoo}}s are intrinsically meeting halls, as are {{L|room}}s defined from a {{L|well}}. However, you can also create a Meeting Hall.

A meeting area filled with dwarves increases the social skills of idlers. It makes idle dwarves a little less idle, and makes selecting a replacement broker easier. Because almost every dwarf visits a meeting hall at least occasionally, it's an ideal place to site valuable objects and buildings. A meeting hall exposed to sunlight will prevent dwarves from becoming {{L|cave adaptation|cave-adapted}}.

Be warned that having dwarves socialize will often result in them becoming {{L|friend}}s (or forming a {{L|grudge}}).

== Hospital ==
:Shortcut {{k|h}}

A Hospital zone is an area designated for the {{L|Healthcare|care and treatment}} of sick and {{L|Wound|wounded}} dwarves.

===Setting up a Hospital===

While there are no particular restrictions on the areas that can be set as hospital zones, a hospital requires certain {{l|furniture}} and supplies to function properly:

{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
|-
! Furniture
! Function
|-
| {{L|Bed|Beds}}
| Allow sick dwarves to {{L|Rest|rest}}
|-
| {{L|Table|Tables}}
| Used in surgery{{Verify}}
|-
| {{L|Traction bench|Traction benches}}
| Immobilize dwarves who need to stay still to heal
|-
| {{L|Container|Boxes/Bags}}
| Storage for medical supplies
|}

{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
|-
! Medical equipment
! Function
! Unit quantity*
|-
| {{L|Thread}}
| Required for suturing wounds
| 15000
|-
| {{L|Cloth}}
| Required for bandages
| 10000
|-
| {{L|Splint|Splints}}
| Used to bind broken bones{{verify}}
| 1
|-
| {{L|Crutch|Crutches}}
| Walking aid for dwarves with leg injuries
| 1
|-
| {{L|Gypsum plaster|Powder for casts}}
| Used to make plaster casts for setting bones{{Verify}}
| 150{{Verify}}
|-
| {{L|Bucket|Buckets }}
|
*Used by doctors to carry water for cleaning patients
*Used by dwarves with the Feed Patients/Prisoners labor to water patients
| 1
|-
| {{L|Soap }}
| Used to reduce infections when washing patients
| 150
|}

''*The unit quantity is the quantity of each item that appears in the Hospital Information screen when one object of that type is stored. For example, if one bolt of cloth is stored in the hospital zone, the hospital will report that it contains 10000 cloth.''

In addition to furniture and medical supplies, a {{L|Water|source of water}} is more or less mandatory, as sick dwarves need it for drinking as well as cleaning. The water source need not be in the hospital zone, although the shorter the distance between the two the better.

When the Zones menu ({{k|i}}) is open and the cursor is in a hospital zone, {{k|H}} will bring up the Hospital Information screen. This screen shows the quantity of each type of furniture piece and medical equipment present in the Hospital, and allows you to set the desired quantity of each type of equipment. Note that you must have boxes or bags constructed in the hospital zone for supplies to be stored for medical use; items in a stockpile do not count for the hospital, even if the stockpile is in the hospital zone.

===Hospital Beds===

When a dwarf becomes sick or {{l|wound}}ed, he will be carried to a {{l|bed}} in a hospital zone by a dwarf with the Recovering Wounded labor set, assuming such a bed is available; otherwise, he may be carried to a bed in a {{L|barracks}} or {{L|dormitory}}, or to an unassigned bed. If an injured dwarf is resting in a bed outside a hospital zone, he will remain there even if hospital beds become available. Deconstructing the sick dwarf's bed may cause him to be move to a hospital bed, however, and it may be possible for doctors to treat patients who are resting outside of a hospital zone, so long as adequate supplies are available.{{verify}}

v0.31:Stockpile

2011-05-10T00:52:26Z

Sasf54: /* Bugs */

{{quality|Exceptional|21:03, 7 January 2011 (UTC)}}{{av}}

'''Stockpiles''' are where {{L|dwarf|dwarves}} will store items of various types. Dwarves with the corresponding "{{L|hauling}}" job on will seek out items that aren't already on a stockpile that accepts them and carry them to the appropriate stockpile. It's important to place your stockpiles carefully to minimize the amount of time spent carrying items to and from them. Items in a stockpile may be stored in {{L|bag|bags}}, {{L|barrel|barrels}} or {{L|bin|bins}} (see {{L|Using bins and barrels}}). Seed bags can go inside barrels.

== Allocating stockpiles ==

To allocate an area as a stockpile, use the {{key|p}} menu. The right-hand menu pane will list all the stockpile categories, and the appropriate key to press to begin allocating that type. Allocating an area works exactly the same as designating an area. Press {{k|Enter}} to specify the first corner of the stockpile, use the primary movement keys to move the cursor to the opposite corner, and press {{k|Enter}} again. This will create a stockpile of the chosen type that occupies the area between the two corners specified. If the chosen area has parts that cannot be made into a stockpile, like a {{L|wall}}, a {{L|workshop}}, or an already existing stockpile, a stockpile will be created but they will not be part of it.

Removing a stockpile works exactly the same, but choose {{key|x}}: Remove Designation. This will un-designate the specified area. It is possible to create a single stockpile with a shape other than a rectangle by using the Remove Designation tool to remove only part of the stockpile.

Stockpiles cannot be expanded once created; you must delete the pile and create a new one.

== Using stockpiles ==

Once a stockpile has been allocated, dwarves will automatically move items to the stockpile when they are available, and as long as the stockpile has available space. Note that the dwarves will place the item into the empty spot that is nearest to the item, ''not counting any obstructions''{{verify}}. Additional behavior also includes the fact that dwarves will stockpile the ''newest'' item first, which may not necessarily be the nearest item to the stockpile.

When dwarves need an item for a particular task, they will head to the nearest (again, not counting any obstructions that may lie in the way) item of the correct type, regardless of whether it is in a stockpile or not. Apart from some exceptions, items do not have to be stockpiled at all. Players are generally advised to avoid stone stockpiles, because stone {{L|hauling}} jobs take an extreme amount of time for unskilled dwarves, due to the weight hauled.

One method to ensure a workshop has raw material on hand is to place a small stockpile next to the workshop. This will speed up production as the crafter in question only has to take a few steps to obtain the material. It also has a useful side-effect, in that as soon as the crafter picks up the piece of material, the stockpile will issue a new task to fetch another piece of that material. Because that crafter is busy, that hauling job will be taken by another {{L|dwarf}}. This speeds up a queue of jobs, as other dwarves perform the time-consuming distant haul whilst the crafter actually makes the items.

It's not necessary to place stockpiles for all types of objects. If no storage is available for a certain item type, dwarves will seek out items wherever they might lie as mentioned earlier. This can be advantageous -- if you don't have a stockpile for {{L|gem|gems}}, your {{L|jeweler}} will go pick up fresh gems without waiting for them to be carried to a pile first. However, this also means your jeweler has to spend a lot of time fetching the gems. If you have enough haulers available, it's generally more advantageous to designate stockpiles than not. Also remember that your workshops will get {{L|clutter|cluttered}} and suffer production slowdowns if you let items pile up in them, so it's important to regularly clear out workshops when they get cluttered. This can be done either by having a stockpile available so that haulers will remove the items or by removing and rebuilding the workshop, which will empty its contents onto the ground.

== Take from a stockpile ==

Another feature of stockpiles, currently in a limited form, allows you to tell dwarves to fill one stockpile not only with unstockpiled items, but also those located on another stockpile that accepts those items. To specify such a flow, use the {{k|q}} menu, and highlight the ''destination'' stockpile. Press {{k|t}}, and, using the cursor, highlight another stockpile and press {{k|Enter}}. Your chosen stockpile will now list the stockpile it will take from. This will cause items in the second stockpile to be hauled to the first stockpile. To stop the first stockpile from taking items from the second, use the {{K|q}} menu on the first one, highlight the unneeded stockpile in the list using {{K|+}} and {{K|-}} and press {{K|d}}'''elete Selected'''.

Each stockpile can take from any number of other stockpiles, but can only have one stockpile taking from it in turn. This limit applies even if the two stockpiles you want it to feed into don't share a single material that can be stored in both of them. Additionally, you can't make two stockpiles feed into each other, although larger loops (e.g. 3 stockpiles that feed into each other in a circle) are allowed.

However, despite these limitations, enough micromanagement will allow for effective and (relatively) streamlined supply chains. For example, you can speed up {{L|wood cutting|lumber harvesting}}, {{L|carpentry}}, ''and'' {{L|ash}} and {{L|charcoal}} production by putting several wood stockpiles near the various {{L|Chop_down_trees|tree-felling areas}}, then one large "primary" stockpile near the {{L|carpenter's workshop}} that takes from those small ones, and then finally, a small stockpile near the {{L|wood furnace}} that takes from the primary one.

== Stockpile categories ==

==={{L|Ammo}}===
This stockpile contains ammo for all forms of ammunition-requiring weaponry (except siege engines). It can use {{L|bin|bins}} to consolidate up to 100 units of ammo.

==={{L|Animal}}===
{{L|Creature|Animals}} stored in {{L|cage|cages}} that are not affixed to a location will be stored in these stockpiles. {{L|Animal trap|Traps}} used for capturing wild animals and empty {{L|cage|cages}} are also stored here.

==={{L|Armor}}===
Armor of all types is stored here. This kind of stockpile can use bins to consolidate up to 10 items. There is no preference for specific body parts. All types of armor can be stored in {{L|bin|bins}}.

==={{L|Bar}}/{{L|Block}}===
Bars of smelted {{L|metal}} and blocks of cut stone and {{L|glass}} are kept here after being processed by the {{L|smelter}}, {{L|mason's workshop|mason's workshops}}, and {{L|glass furnace|glass furnaces}}, before being used for other purposes. Weirdly, {{L|ash|ashes}}, {{L|potash}}, {{L|soap}}, {{L|charcoal}}, and {{L|coke}} from the {{L|wood furnace}}, {{L|ashery}}, {{L|alchemist's laboratory}} and smelter will also be stored here. Like with all stockpiles, this can be changed to allow for specific blocks and bars to be stored with custom settings. {{L|Bin|Bins}} can be used to consolidate up to 10 bars and blocks.

==={{L|Cloth}}===
Woven cloth and {{L|thread}} from the {{L|loom}} is stored here. {{L|Bin|Bins}} can be used to consolidate up to 10 items.

==={{L|Currency|Coins}}===
Minted coins are kept here. Bins can be used to consolidate up to 3000 coins, which is equivalent to six new coins stacks.

==={{L|Corpse | Corpses}}===
Dead dwarves and {{L|pet|pets}} that have no burial location will be placed here. If placed indoors, decaying bodies will generate {{L|miasma}}, but {{L|bone|bones}} will not be removed at the end of the season. Rotting {{L|pet|pets}} or {{L|friend|friends}} gives dwarves unhappy {{L|thought|thoughts}} unless they are given a proper burial in a {{L|Coffin|burial receptacle}}.

==={{L|Finished goods|Finished Goods}}===
Finished goods created by the {{L|craftsdwarf's workshop}}, as well as the {{L|clothier's shop}} and the {{L|leather works}}, are placed here before being used in trade or other uses. This type of stockpile can use {{L|bin|bins}} to consolidate up to 25 items.

=== {{L|Food}} ===

As one would assume based on the name, food is stored here. Unexpectedly, {{L|lye}}, {{L|giant desert scorpion}} venom, bags of {{L|dye}}, and {{L|Fire snake|liquid fire}} are as well. Raw {{L|fish}} is brought here before being processed by {{L|fishery}} and turned into edible {{L|meat}}. Drinks are always stored in {{L|barrel|barrels}}. Seeds can be stored in {{L|bag|bags}}, whereas other food items can be stored in {{L|barrel|barrels}} (up to 10 items per barrel, but note that
the stack +Cow meat roast [8]+ would count as eight items.)

Note that {{L|prepared meal|prepared meals}} in stacks larger than ten (☼Dwarven Beer Roast [200]☼ is possible) will not fit in a barrel, but will not rot once placed in a food stockpile, and still only take up one space. To free up barrels, you may decide to have separate prepared food stockpiles that do not accept barrels. If you cook larger meals, this shouldn't be a problem.

Food stockpiles should in most cases be specified as things like {{L|seed}} stockpiles or meat stockpiles or unprepared fish stockpiles; there are simply too many things that go in them.

==={{L|Furniture}} Storage===
Completed items from the {{L|carpenter's workshop}}, mason's workshop, and {{L|mechanic's workshop}} will be stored here, along with furniture created from other shops, until placed or used in another building. Bags filled with {{L|sand}} can also be stored in furniture stockpiles.

Since this is a very broad category, it may be useful to create stockpiles for a specific type of item (like barrels, bags, bins, mechanisms) via the stockpile settings.

==={{L|Gem}}===
This stockpile stores gems and raw {{L|glass}}, both cut and uncut, before being used in a construction. It can use {{L|bin|bins}} to consolidate up to 10 gems.

==={{L|Leather}}===
Leather, which is produced at a {{L|Tanner's shop}}, will be kept here. Like most stockpiles, it can use {{L|bin|bins}} to consolidate up to 10 items.

==={{L|refuse stockpile|Refuse}}===
Since dwarves hate rot because of the miasma it spreads when in an enclosed place like a {{L|cave}}, any garbage item that can rot will be stored in a refuse stockpile. Also, any XXdamaged itemsXX will be moved to the refuse stockpile. Many players prefer to place this stockpile outside their cavern, usually a small distance from the entrance. If placed indoors, decaying items will generate miasma, which will spread through your fortress and generate a small unhappy thought in any dwarf passing through it. For this reason it is sensible to build {{L|door|doors}} to all of your indoor refuse stockpiles - the miasma won't spread through a closed door so only dwarves with business in the room will be bothered by the rot. An alternative to this is to dig {{L|channel|channels}} down from the surface, creating an outside area inside your fortress. You can place your refuse stockpile here and whilst it will be in your fort it will technically be outside and won't generate miasma.

{{L|Bone}}s, {{L|skull}}s, and {{L|shell}}s are also stored here, whether they be from defeated enemies or raw food processing. If left in an area with high {{L|vermin}} levels, these will randomly disappear. Refuse stockpiles can be restricted to store only {{L|bone}}s, {{L|skull}}s, {{L|shell}}s, teeth, and horns/hooves.

Note that a refuse stockpile is not the same as a {{L|Activity_zone#Garbage_Dump|garbage dump}}. A garbage dump is only for things manually marked to be dumped. Additionally, refuse types specifically marked as '''Dwarves Dump '''''refuse type'' in {{k|o}}-{{k|r}} will be hauled to the garbage dump instead of the refuse stockpile.

Also note that if you allow bins to be used on your refuse pile, damaged clothing will be stored in it, allowing for more efficient use of your pile.

==={{L|Stone}}===
Rough stone will be stored here, as well as {{L|ore}}. Given the extreme abundance of stone, it is very likely for this stockpile to fill up quickly, making stone stockpiles largely ineffective for {{L|Stone_management|dealing with excess stone}}. Probably the best use of stone stockpiles is to make sure that workshops and smelters, catapults, and impending construction projects have their materials close at hand. Be aware that these things can use up a lot of stone very quickly, leading to your dwarves scurrying around the fortress trying to keep up. To avoid stone hauling when you don't want it, you can slow down or stop the nearby usage, allowing the stockpile to fill back up (and thus no longer need more stone), or you can set the dwarves to ignore minerals in {{key|o}}rders and options.

==={{L|Weapon|Weapons}}===
Weapons of all types are stored here by default, including the weapons that dwarves do not use, picks, and trap components. {{L|Bin|Bins}} can be used to consolidate up to 10 weapons of any type.

==={{L|Wood}}===
Chopped trees are brought to the wood stockpile before being used by the carpenter's, woodburner's or siege workshop. Because wood takes a long time to haul and tends to travel a long way, the stockpile should be rather close to a fortress entrance (which does not necessarily mean on the upper z-levels - moving down one z-level is only one tile), unless you have an {{L|Tower-cap|underground tree farm}}. It is a good idea to position this stockpile close to your carpenter's workshop (or the other way round) since he is likely to be the main "customer".

=== Custom stockpiles ===

With custom stockpiles you can change which types of materials, goods, etc, can be stored in that pile. Any types of things can be mixed, so you could have a stockpile that will hold raw {{L|turtle}}, {{L|mechanism|mechanisms}} and all stone types apart from {{L|onyx}} if you wanted, or only high-quality steel crossbow bolts (Ammo), all quivers (a Finished Good), and metal Crossbows (a Weapon) - the combinations are endless, and can be finely tuned. Highlighting a stockpile with {{key|q}}, then pressing {{key|s}} will allow you to adjust the stockpile settings or in the {{key|p}} menu you can press {{key|t}} to adjust a custom stockpiles settings before placing it with {{key|c}}. Note that many sub-menus consist of several pages ( the 'other' menu of stone e.g. consists of several pages while 'metal {{L|ore|ores}}' and 'economic' consist of only one ).

Note that using {{key|q}} also allows you to adjust the number of bins or barrels that a stockpile will use. By default, if the item can be stored, it will try to fill the entire stockpile with that type of container. This can be troublesome, especially early in the game when you don't have nearly enough to go around.

== Stockpile Settings ==
The '''Stockpile Settings''' screen is weird to use. In the first column are the major categories. In the second column there may or may not be subcategories. In the third you will see the individual items. The second and third columns are only visible when a category is enabled and selected.

You navigate this screen with {{key|+}} and {{key|-}}, and left and right on the arrow keys. {{key|e}} and {{key|d}} are used to enable and disable the categories. {{key|a}} and {{key|b}} are used to allow or disallow all the subcategories. {{key|p}} and {{key|f}} will permit or forbid individual subcategories. These six keys work no matter which column you have selected, though the last 4 will not always be available. {{key|Enter}} will toggle individual item types.

Be careful when selecting 'block all' on the subcategories as it can make your stockpiles useless. For example, if you block all the furniture subcategories and then re-enable beds under types, the stockpile won't actually accept anything because it still registers all materials as forbidden. The correct way would be to 'forbid types' and then re-enable beds.

== Notes ==
Some categories will have a special extra type of item(s) that can be toggled with {{key|u}} and sometimes {{key|j}}.

{| border="1" cellpadding="4"
|+
! Categories
! Item type
|-
| Animals
| Empty cages and Empty animal traps
|-
| Food
| Prepared food
|-
| Furniture
| Sand bag
|-
| Weapons
| usable and unusable
|-
| Armor
| usable and unusable
|}

If you disable an item or items that are already sitting in a stockpile then they become loose items and your dwarves will move them to a more suitable stockpile should one exist.

== Uses for Custom Stockpiles ==

A custom stockpile is most useful for food, furniture, and bar/block stockpiles, to prevent your lye and venom sitting next to the {{L|kitchen|kitchens}}, your {{L|floodgate|floodgates}} and mechanisms near the {{L|room|rooms}} that need {{L|statue|statues}} and doors, your stone blocks next to the forges, and your metal bars by the farms.

One use for this is to have an outdoor stockpile next to your gate that will accept all refuse except bones, shells, skins and skulls, and then an indoor pile near your craftsdwarf's workshop that will '''only''' accept these things. If you have set the option for dwarves to gather refuse from outside, the bones will be brought in once all the meat has rotted off of any carcasses outside. This means added risk to your dwarves if they try to gather refuse that is far from your gate, and additional hauling.

Another effective use of custom stockpiles is Elven trading. Make a stockpile just for elf-safe trade goods: most categories where it's relevant have a 'materials' option.

A highly efficient method is to have wood burning furnaces feeding into a '{{L|charcoal}} only' bar/blocks stockpile, which in turn is near the smelting furnaces and forges. Bonus points if you also place a small wood stockpile near the wood furnaces.

Other good uses:
* Planter's stock: {{L|seed|seeds}} and {{L|potash}}. (If your {{L|ashery}} is nearby, include ashes and lye.
* Smelter stock: {{L|ore|ores}} and {{L|flux}}.
* Sandpile: {{L|sand}} bags.
* Clothes Plus: a cloth stockpile that also includes {{L|dye|dyes}}. (Dyes normally count as food.)
* Food Plus: a food stockpile that includes barrels. This spares your dwarves from carrying empty barrels to and from the furniture stores.
* Skins: a refuse stockpile limited to {{L|skin|skins}}, a bit like the bone & shell stockpile above. Place near the tannery.
* Brewer's stock: {{L|List of crops|brewable plants}}.
* Refreshment stand: Since dwarves drink twice as often as they eat, having several small food stockpiles that only accept {{L|Alcohol|drinks}} scattered strategically through your fort can minimize [http://en.wikipedia.org/wiki/Smoko smoko breaks]. The usefulness of this kind of stockpile is often disputed as dwarves go to the fullest barrel first, so if you can't keep your stockpile constantly filled with new full barrels of alcohol your masons might decide to run all the way over to the alcohol stockpile you have setup for your brewers or your metalsmiths. If you can keep each stockpile constantly being filled with fresh supplies of full barrels of alcohol then this can increase productivity greatly. A simple way of doing this is by keeping a brewery near each separate alcohol stockpile, or locking dwarves in so that local stockpile is the only one they can {{L|path}} to.
* Artifact materials: The massive value and effectiveness of {{L|artifact|artifacts}} means the materials used in them can have drastic effects, sometimes even into the ''{{L|Value|millions}}''. Having special stockpiles for high-value metals, stones, gems, and other such materials will make it that much easier to ensure that you will get the most out of each {{L|strange mood}}. (However, even with materials-specific stockpiles, it can take a fair amount of micromanagement to get a moody dwarf to use a specific material.)
* Artifact storage: Artifacts add a great deal to the created wealth of the fortress and the loss of an artifact can result in a very bad {{L|thought}} for the creator. Keep valuable artifacts safe from {{L|thief|thieves}} in a special stockpile.
* Ingredients: Store things that are cookable but not edible, like milk and quarry bush leaves, near kitchens. For that matter, store both fat and tallow near kitchens for efficient rendering.
* Mason's Stone: Since a mason's workshop doesn't let you pick what type of stone to use, use customized stone stockpiles to provide some of that control. On maps with mass {{L|flux}} stone, a small stockpile for flux stone near masons' workshops can boost the values of stone furniture in general.

==Bugs==
* Currently{{version|0.31.25}} there is no stockpile category for finished goods made of gems {{Bug|4430}}
*Any 'metal' in second column have stones, oozes, jewels in third column. Very unexpectedly.
* It seems for food, the stockpile creation is matters. For some case, dwarfs may refuse, to pile up food in a stockpile created as custom (even if it shown with {{k|t}} (items in buildings), that is in fact it's a food stockpile). The solution for this create a food {{k|p}}{{k|f}} stockpile, and limit later.
[[Category:Stockpiles]]
[[Category:Items]]

v0.31:Siege engine

2011-05-08T15:32:14Z

Sasf54:

{{quality|Masterwork}}{{av}}
A '''siege engine''' in Dwarf Fortress is half building/half heavy weapon, and includes both the '''catapult''' and the '''ballista'''. Both are capable of launching hazardous projectiles at a tremendous range ''(more than a screen-width, around 80 to 100 tiles for a catapult and between 130 and 200 tiles for a ballista).'' A {{L|ballista arrow}} can kill or injure each creature in its path indiscriminate of friend or foe, but a stone launched from a catapult cannot harm dwarves or tamed animals.

Siege engines can be made to face any cardinal direction, but they cannot be moved after placement. They can, however, be deconstructed back into their 3 parts, to be moved elsewhere (individually or together). Both the construction of siege equipment and the engine itself require a dwarf with the "Siege Engineering" {{L|labor}} designated, which uses the "{{L|Siege_engineer|Siege Engineer}}" {{L|skill}}.

The player determines when/if each engine is actively firing or not; when active, a single engine is crewed by a single {{L|siege operator}}. Ballistae require specially made {{L|ammo}}, {{L|ballista arrow}}s, made from wooden {{L|log}}s at the siege workshop (and optionally tipped with {{L|metal}} {{L|ballista arrowhead}}s that have been made at a {{L|forge}} by a {{L|weaponsmith}}). Catapults use simple {{L|stone}} as ammunition.

==Building Siege Engines==

In order to build a siege engine, you first need to produce (at least) three catapult or ballista parts in the {{L|siege workshop}}; catapults are made from any 3 '''catapult parts''', and ballistae are made from any 3 '''ballista parts'''. All parts are made from any type of wood at the siege workshop. Beyond that, "parts" are generic - there are no particular "sub-types" of parts beyond the distinction between those for the two different engine types. The quality of the parts determines the overall rate of fire and accuracy of the engine - the best are made with 3 masterwork parts. This won't make up for an untrained siege operator, but every little bit helps.

Once you have the parts, you may then build the respective siege engine like any other building, selecting the parts that you wish to construct that particular engine with. It is not known whether the skill of the dwarf assembling the siege engine has any effect, but the quality of the parts certainly has: siege engines put together from {{L|quality|masterwork}} parts have a much higher rate of fire and accuracy.

The assembled siege engine is, effectively, a 3x3 building. It cannot be moved about other than by taking it down and re-assembling it at the new site. Siege engines do not impede movement, though, so you don't have to worry about building them in a corridor.

==Using Siege Engines (simple)==
{{key|o}} will let you change the orientation, whether the siege engine is pointing north / south / east / west. This takes effect immediately, it does not require a dwarf to come and turn the engine.

{{key|f}} toggles the current status between:
*Not In Use: Dwarves with the {{L|Siege operator}} {{L|job}} will reload unloaded engines and leave them unattended.
*Prepare to Fire: Siege Operators will load the engine and remain stationed for further commands.
*Fire at Will: Siege Operators will fire and load normally.

Once an engine is given orders to fire (or prepare to), a dwarf with the {{L|Siege operator|siege operating}} labor designated will respond and report to the engine. The dwarf(s) will (re-)load any siege engine that is not currently loaded; there's no way to prevent this short of disabling the labor on all dwarves or forbidding every piece of ammo (or otherwise blocking a {{L|path}} to it, perhaps by locking {{L|door}}s.)

{{L|Ammo}} is destroyed upon landing, unless it falls a z-level, and then it falls harmlessly. (See [[#Catapults as stone movers|below]].)

########
CCC..._#
CCC..._#
CCC..._#
########

The {{L|channel}} at the end of this firing range preserves the stone. For catapults there is usually so much spare stone that this is not necessary, but it could be used for fast stone transport, or simply to set up a self-contained training area. A similar effect can sometimes be observed when firing a catapult over bumpy ground outside.

The design can be further improved by using a {{L|drawbridge}} rather than a wall, this way when the drawbridge is raised it acts like a wall deflecting the stone into the channel below. In the case of an attack on your {{L|fortress}} the drawbridge can be lowered allowing the catapult to fire.

#####################
CCC..._¦.............
CCC..._¦.............
CCC..._¦.............
#####################

Drawbridge raised deflecting stones into channel.

#####################
CCC...[].............
CCC...[].............
CCC...[].............
#####################

Drawbridge lowered allowing catapult to shoot down the corridor.

==Special considerations==

* Both catapults and ballistae have narrow fields of fire - they will only shoot at creatures basically "in front" of them, and so cannot target anything off at an angle. They can be turned 90 degrees, but that often will not solve the problem. (The field of fire is perhaps only 10-20 degrees wide. Wild shots may go (well) beyond this, but those are not aimed.)
* Both catapults and ballistae aim and fire only along one z-level. While ammo from both may drop down z-levels, they do no damage to creatures there. This also means that no "head room" is necessary - ammo just flies out, never up.
* Catapults have a minimum range - at least 30 tiles.
* Catapults can and will fire over any creatures between them and their target.
* Neither are affected by {{L|fortification}}s.
* {{L|Siege operator}}s are "civilians", and as such they will run in fear if enemy units come too close to them. "Too close" varies somewhat, but may be as far as 10 tiles.

===Safety Warning===

'''Ballistae can and will kill anything in their path!''' Ballista arrows appear to hit any units in any square that the head passes through. They are devastatingly dangerous weapons, and should never be used with friendlies anywhere in their cone of fire, including the space the ballista arrowhead occupies when loaded on the engine. Always designate a {{L|traffic|restricted traffic area}} for a lot of tiles along the firing arc and keep dwarves out of the area or, better, wall off anything in front of them with fortifications to prevent all friendly traffic, or both. The shots appear to travel until they hit a wall or fly off the screen; the maximum range is about 150 tiles for an ordinary ballista. If the bolt passes through a {{L|tree}}, the tree will disappear, presumably reduced to toothpicks.

Surprisingly, catapults are relatively safe. Catapult operators will target enemies (and wild [[animals]]) if there are any in their field of fire. If not, they will lose the shot in a high arc (not requiring additional [[z-level]]s, though) that misses everything until it lands. It is perfectly safe to operate a catapult in the cave: just point it at a nearby wall of solid rock. A nice side effect is that this will in due time clear the whole area of stone.

Using catapults to shoot into the open may provide some [[meat]]: as said above, the operators will target animals if there are any. However, {{L|elephant}}s don't take nicely if you slay some of them. You also have a slight risk of killing your own dwarves or {{L|caravan}} escorts if they happen to be hunting the selfsame animal (and hence are close to it).

'''"Fire at Will" does ''not'' mean there has to be anything to shoot at!''' The siege engine will simply continue to be loaded and fired, simply launching ammo (stone or arrows) downrange with no (visible) target if given this command. This can be good against unseen {{L|ambush}}es, or if you wish to move {{L|stone}} across a map, but not if you are worried about depleting an ammo stockpile.

==Using Siege Engines (advanced)==
===Placement===
Siege engines can almost only shoot at targets right in front of them on the same Z-level. The target may deviate only slightly, as the field of fire is about 20-30 degrees wide. Because of the huge blind spots, it is advisable to {{L|Security_design#Siege_Engines|prepare the position}} so that the enemy will be channeled through the field of fire.

Siege operators are civilians! They will drop their work and run if the enemy comes too close, which is around 20 tiles. You should therefore place the engines behind a {{L|moat}} or a wall of {{L|fortification}}s that will keep the enemy at a safe distance, or shield access to their location in some other fashion.

Siege engines can shoot through {{L|fortification}}s, just like any other projectile weapon. As fortifications appear to provide some protection against incoming {{L|bolt}}s and {{L|arrow}}s, it's usually a good idea to protect the siege engine in that way. The siege engine only needs a one tile wide fortification to shoot out.

===Skill and Quality===

The quality of the siege engine parts affects the engine's accuracy and reload time. It is not known whether the siege engine itself also can be of a certain quality. The quality and material of the ammunition (in case of ballista arrows) affects the damage and possibly accuracy as well.

The only way of obtaining high-quality siege engine parts is to have them made by a trained engineer; the only way to train an engineer is to make parts or ammunition. Assembling and disassembling siege engines does not train the {{L|siege engineer}} skill. Dwarves will occasionally produce masterpieces long before reaching {{L|Legendary}} skill level, but be prepared to waste hundreds of logs until you have three masterpiece parts. Bringing an engineer to {{L|Experience|Proficient}} level (the highest you could buy when starting a new fortress) will take about 120 logs. Becoming Legendary requires the wood of 600 trees.

The operator skill certainly affects reload time. It will take a whole month for an unskilled dwarf to load a catapult; a Legendary operator with nearby ammo will get several shots at a running enemy. Operator skill has little or no effect on accuracy.

Operators are best trained on catapults, as these require nothing but cheap stone for ammo. It is recommended to have a number of dedicated operators that will follow no other line of work, and enough catapults for all of them to play with. As they're often going for a drink or sleep, you may get along with three catapults for four operators, and even two pieces would go a long way. Since the dwarf must hold the heavy stone in his inventory during the entire loading procedure, dwarves that have increased their strength statistic load catapults much more rapidly than others, making them good candidates for operator duty. You should start training early: it can take one year for an operator to become Proficient, and two more years until he finally reaches Legendary level; by then he will have spent 300 rounds.

Loading ballista arrows seems to be much faster than loading catapults, probably due to the much lighter weight of the projectile.

An alternative approach is cross-training any highly-skilled dwarves who aren't doing anything useful at the moment. With a couple levels each in strength and agility, a decent-quality catapult, and an ample supply of ammunition nearby, a dwarf can become a Legendary siege operator within a few seasons at most, giving more flexibility in defense and several more levels for the fortunate dwarf. {{L|Cross-training|Rotating}} Legendary {{L|miner}}s out to siege-operation and then to stone-hauling duties sets up an efficient cycle.

===In Battle===

Catapults are generally less effective in battle situations than are ballistae (as of version 0.31.08). The launched rocks will often glance off chain mail armor, making them poorly suited for killing even {{L|goblin}}s. ''It is still faster to fire stones than carry them, at least.'' Catapults are very inaccurate, but they are less likely to harm friendly creatures, and their ammo is easily replenished, making them ideal for target practice.

Ballista arrows tipped with softer materials (such as wood) can glance off ordinary clothes, making the choice of arrowhead significant. However, the arrows penetrate through any unit they strike, allowing them to hit many multiple targets in a single launch. This makes ballistae many times more efficient than catapults, which fire in an arc that hits only a few tiles per shot and is nearly useless against anything larger than smaller, poorly-armored foes. Ballista arrows fired through too many successive targets will be lost or destroyed; the limit seems to be roughly 5-6 goblin-sized targets hit before the arrow is lost.

A siege engine you want to use for actual defense should be not set to fire at will, as this likely means that it's not loaded and ready at the time you actually need it. You should train your operators on other pieces.

When the time comes, switch off all training engines and set all of the ones you'll be using to prepare to fire so the operators will be on-station; if some of them are currently not loaded, designate them to be disassembled so to prevent your operators from loading the training weapons instead of firing the real ones.

Remember, operators are civilians. They do not care that the fortress is at stake: hunger, thirst, sleep and breaks will always come first. It's wise to train more operators than you have engines, and disable all other work for them in times of need. The most effective way to ensure that your operators won't run off is to lock them in with the siege engine during the moment of truth.

===Ballista battery===

If you place ballistae close enough together, you can completely cover a two or three tile wide corridor. Because siege engines are 3x3, they need to be staggered, so each one fires through the edge of the one ahead of it. This can be dangerous for your operators. To minimize risk, place {{L|fortification}}s to keep dwarves from wandering too far, and have only one entrance to the ballista room. There is still some risk that dwarves might wander into the line of fire, even with no reason to do so.

: '''Three tile-wide corridor''' (battery room 5 tiles wide)

╔═══
══════════════════════════╦══╦══╝▐▀\
Entrance++++++++++++▼·····╬++╬▐▀\◄═« (~ammo~)
Entrance++++++++++++▼·····╬▐▀\◄═«▐▄/
Entrance++++++++++++▼·····╬◄═«▐▄/+(~ammo~)
══════════════════════════╣▐▄/+(~ammo~)
╚═════════
:*<tt>+</tt> - floor
:*<tt>═</tt> - wall
:*<tt>▼</tt> - ramp (down)
:*<tt>·</tt> - channel (aka "empty space" on this level)
:*<tt>╬</tt> - fortification

Due to the rare wild shot, the staggering should always be from one side to the other, and not put one ballista far ahead of the one it overlaps, as this may increase friendly-fire accidents.

Ammo storage can be on the same level, or via {{L|stair}}s or {{L|ramp}}s on another {{L|z-level}}. Expand the room as desired for more storage. Also note that ballista arrows are stored in {{L|Stockpile#Furniture_Storage|furniture stockpiles}}, not ammo stockpiles.

An alternate strategy could be to place a {{L|floodgate}} or retracting {{L|bridge}} in the center of the 3x3 hallway, and activate it during times of crisis so that the Goblins are forced to fight in two separate 1x1 corridors rather than a single 3x3 corridor. If the corridors are further lined with spike traps and weapon traps, this combined defense can assure your dwarfs that any attempts to assault your base will be very, very bloody.

A drawbridge can be combined with the channeled area to provide a practice area, as discussed above. The channels would be accessible from the battery area via a staircase, keeping the dwarfs below/behind the lines of fire at all times.

==Catapults as stone movers==
When a catapult throws a stone, that stone is destroyed upon landing, unless it falls a z-level, where it lands harmlessly. That means that if you can arrange it so ammo hits a wall (or door, or raised bridge), and there is empty space immediately under that, the stones arrive at that point. If ammo reaches its maximum range, again, it falls harmlessly. Even with a single, no-quality catapult and an untrained crew, this is massively faster than hauling stone by hand. Ammo that hits {{L|stair}}s is destroyed, even if it can fall a z-level.

==Gatling Catapults==
This involves a catapult, a garbage stockpile, and a legendary siege opereator. Setup your catapult, as you wish to use. Train at least one operator to about Legendary. Mark a garbage stockpile in the middle of the catapult. Dump enought ammo for train / usage. Reclaim the ammo({{k|d}}-{{k|b}}-{{k|c}}), and off you go. With a good quality catapult you can easily manage 2-3 stones flying at once per catapult.

----

'''See Also:'''
:*{{L|Defense design}}
:*{{L|cross-training#Army corps of engineers|Army corps of engineers}}
{{buildings}}

{{Category|Buildings}}
{{Category|Fortress defense}}

v0.31:Chicken

2011-05-07T20:13:15Z

Sasf54:

{{Quality|Fine|17:50, 11 March 2011 (UTC)}}
{{D for Dwarf}}
{{Creaturelookup/0
|bone=4
|meat=6
|fat=6
|intestine=1
|skull=1
|skin=hide
}}
{{av}}
{{creaturedesc}}
Male chickens are known as roosters, and female chickens are known as hens. Young chickens are known as chicks.

Hens will lay between 4 and 15 eggs and require a {{L|nest box}} to lay the eggs in. A rooster is required to fertilize the eggs however fertilization is not guaranteed. Once hatched, chicks will grow into adults in 1 year.

Economically speaking, eggs are a very good source of food (1 egg = 1 meal) - starting out with 5 hens and rooster on embark is an easy way to keep a new fortress fed until larger scale food production can be established. {{L|Turkey}}s are more effective in the long run, as they have larger bodies (and therefore more butcherable meat) and lay larger clutches of eggs (10-14) at once; while chickens have a longer lifespan, permitting a number of turkey eggs to hatch will make this largely moot.

Be warned that large groups of chickens will require a significant amount of space for them to roam, otherwise they will quickly get into fights; additionally, failing to collect eggs may rapidly lead to a {{L|catsplosion#Birdsplosion|chickensplosion}}.

== See also ==

* For some reason, the roosters give mostly just a skull, than anything else. This may from, that the butcher holds the animals by it's head / throat, when cut. It's a well known fact, that chickens can run for even minutes after beheaded. The rest of the body never found.

* {{L|Domestic_animal#Comparison_of_domestic_poultry|Comparison of domestic poultry}}

{{Gamedata}}
{{Creatures}}
{{Category|Animals}}

v0.31:Jug

2011-05-06T20:28:00Z

Sasf54:

{{quality|Fine|03:21, 18 April 2011 (UTC)}}{{av}}

'''Jugs''' are a type of {{L|container}}, made from {{L|ceramic}} at a {{L|kiln}}, from {{L|glass}} at a {{L|glass furnace}} or from stone by a {{L|stone crafter}}. They are used in {{l|Beekeeping industry|beekeeping}} to store royal jelly or at a {{L|screw press}} to store honey or rock nut oil. Jugs made from earthenware need to be {{L|glaze}}d before they can be used to hold liquids like honey. Jugs are stored in the Tools section of the Finished Goods stockpile.

Jugs are stored in bins. Jugs with royal jelly / honey can be stored in two stockpiles:
- Finished goods / tools (stored as JUGS)
- food / extract animal / honey, royal jelly (Stored based on content)

'''Note''': Jugs with royal jelly, that stored as finished goods are '''NOT''' used for processing royal jelly, like screw press.

{{Category|Items}}