Editing v0.31:Stockpile

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

'''Stockpiles''' are where [[dwarf|dwarves]] will store items of various types, usually in a safer, closer or more convenient place for the consumers. Dwarves with the corresponding "[[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 [[bag|bags]], [[barrel|barrels]] or [[bin|bins]] (see [[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 [[wall]], a [[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 [[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 [[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 [[gem|gems]], your [[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 [[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 {{key|q}} menu, and highlight the ''destination'' stockpile. Press {{key|t}}, and, using the cursor, highlight another stockpile and press [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 first stockpile taking items from second use {{K|q}} menu on first, higlight 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 [[wood cutting|lumber harvesting]], [[carpentry]], ''and'' [[ash]] and [[charcoal]] production by putting several wood stockpiles near the various [[Chop_down_trees|tree-felling areas]], then one large "primary" stockpile near the [[carpenter's workshop]] that takes from those small ones, and then finally, a small stockpile near the [[wood furnace]] that takes from the primary one.

== Stockpile categories ==

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

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

===[[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 [[bin|bins]].

===[[Bar]]/[[Block]]===
Bars of smelted [[metal]] and blocks of cut stone and [[glass]] are kept here after being processed by the [[smelter]], [[mason's workshop|mason's workshops]], and [[glass furnace|glass furnaces]], before being used for other purposes. Weirdly, [[ash|ashes]], [[potash]], [[soap]], [[charcoal]], and [[coke]] from the [[wood furnace]], [[ashery]], [[soap maker's workshop]] 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. [[Bin|Bins]] can be used to consolidate up to 10 bars and blocks.

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

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

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

In practice, you should use a Corpse stockpile as a ''morgue'', only for temporary storage in case you run out of [[coffin]]s, since unburied dwarves can potentially come back to [[ghost|haunt]] you.

===[[Finished goods|Finished Goods]]===
Finished goods created by the [[craftsdwarf's workshop]], as well as the [[clothier's shop]] and the [[leather works]], are placed here before being used in trade or other uses. This type of stockpile can use [[bin|bins]] to consolidate up to 25 items.
Since this stockpile can also contain supplies that player might not want to trade away ([[splint]]s, [[crutch]]es, [[rope]]s, [[waterskin]]s...), it is suggested that player makes separate custom stockpiles for these goods.

=== [[Food]] ===

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

Note that [[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 [[seed]] stockpiles or meat stockpiles or unprepared fish stockpiles; there are simply too many things that go in them.

===[[Furniture]] Storage===
Completed items from the [[carpenter's workshop]], mason's workshop, and [[mechanic's workshop]] will be stored here, along with furniture created from other shops, until placed or used in another building. Bags filled with [[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.

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

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

===[[refuse stockpile|Refuse]]===
Since dwarves hate rot because of the [[miasma]] it spreads when in an enclosed place like a [[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, as rottable items on tiles that are {{DFtext|Outside |3:1}}{{DFtext|Light |6:1}}{{DFtext|Above Ground|2:1}} do not generate miasma.

If placed on a {{DFtext|Subterranean|0:1}} tile, 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 [[door|doors]] (preferably several, separated by a few tiles to create an airlock) to all of your indoor refuse stockpiles. 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 [[channel|channels]] down from the surface, creating an area of tiles considered to be {{DFtext|Light |6:1}}{{DFtext|Above Ground|2:1}}, yet still located within your fortress. You can place your refuse stockpile here, and whilst it will be in your fort, rotten items on those tiles will not generate miasma. If you choose to cover them with walls or floors for security and/or aesthetic reasons, it will  convert them to {{DFtext|Inside|6:0}}, but they will remain {{DFtext|Light |6:1}}{{DFtext|Above Ground|2:1}} tiles, which again do not generate miasma in rotten items. (For even more creative methods to restrict the spread of foul rotting stench, see the [[miasma]] page.)

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

Note that a refuse stockpile is not the same as a [[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.

===[[Stone]]===
Rough stone will be stored here, as well as [[ore]]. Given the extreme abundance of stone, it is very likely for this stockpile to fill up quickly, making stone stockpiles largely ineffective for [[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.

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

===[[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 [[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".

Note that traders consider amount of wood in stockpile to judge whether to bring logs for trade or not and in case of [[elves]], amount of wood you logged.

=== 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 [[turtle]], [[mechanism|mechanisms]] and all stone types apart from [[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 [[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.<br>{{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 [[kitchen|kitchens]], your [[floodgate|floodgates]] and mechanisms near the [[room|rooms]] that need [[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 '[[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: [[seed|seeds]] and [[potash]]. (If your [[ashery]] is nearby, include ashes and lye.  
* Smelter stock: [[ore|ores]] and [[flux]].
* Sandpile: [[sand]] bags.
* Clothes Plus: a cloth stockpile that also includes [[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 [[skin|skins]], a bit like the bone & shell stockpile above. Place near the tannery. 
* Brewer's stock: [[List of crops|brewable plants]]. 
* Refreshment stand: Since dwarves drink twice as often as they eat, having several small food stockpiles that only accept [[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 [[path]] to.
* Artifact materials: The massive value and effectiveness of [[artifact|artifacts]] means the materials used in them can have drastic effects, sometimes even into the ''[[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 [[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 [[thought]] for the creator. Keep valuable artifacts safe from [[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 [[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.

{{Category|Stockpiles|*}}
{{Category|Items}}