Editing v0.31:Stonegears/Examining items

:''Back to the [[Main:../|main tutorial page]]''

==Listing items==
There are multiple ways of listing items:

# If the item is simply laying on the ground, use {{K|k}} to enter "look" mode, the user arrow keys to move the cursor over the item you wish to examine.
# If the item is held/worn by a dwarf or other creature, use {{K|v}}-{{K|i}} to look at the creature's inventory.
# If the item is inside of a [[workshop]], [[trade depot]], [[wagon]] or other [[building]]  you can look inside the building with {{K|t}}.  The first few lines, which contain a {{DFtext|[B]|white}} on the right hand side, are the items the building is made from.
# If the item you wish to examine is an installed piece of [[furniture]] like a [[bed]], then use {{K|t}} to examine it, since an installed piece of furniture is considered to be a building made from the furniture item.
# To list and examine items by item category, use the [[Main:../Status screen#Stocks|stocks screen]].

For everything but the stocks screen, if there's multiple items you can change which one is selected via {{K|-}} and {{K|+}}.  When you have an item selected, you can press {{K|Enter}} to examine it in more detail.

==Item modifier symbols==
There are certain symbols that will bracket an item to indicate that it's different than normal.

* Bracketing with {{DFtext|-}}, {{DFtext|+}}, {{DFtext|*}}, {{DFtext|≡}} or {{DFtext|☼}} indicates that the item is of higher than normal [[quality]].
** For many items quality merely increases the item's value.
** For [[cooking|cooked]] food it increases the amount of [[thought|happiness]] a dwarf gains from eating it if one of the ingredients is among the dwarf's list of [[preference|preferred]] foods.
** For [[mechanism]]s used in [[Trap#Weapon_Trap|weapon traps]] it controls the how well the weapons strike.
** For weapons and armor their effectiveness is increased, up to double for masterful/masterwork (☼) quality.
** If a masterwork  (☼) item is destroyed or stolen the creator of the item will get an unhappy [[thought]].
* Bracketing with {{DFtext|« »}} indicates that the item is [[decoration|decorated]]. A decoration and the item it decorates can have separate quality levels, like a {{DFtext|*«+steel battle axe+»*|olive}}.
* Bracketing with {{DFtext|( )}} indicates that the item was not produced by your dwarves.  This includes all items you start the game with, all items [[immigration|immigrants]] bring with them, and all items belonging to [[caravan|traders]] and [[siege|invaders]].  You can make an item count as being produced by your dwarves either by transforming it into something else (like turning a [[log]] into a [[bed]]) or by [[decoration|decorating]] it.
* Bracketing with {{DFtext|<nowiki>{ }</nowiki>}} indicates that the item is [[#Forbidding_items|forbidden]].
* Bracketing with {{DFtext|x}}, {{DFtext|X}}, or {{DFtext|XX}} indicates that the item is partially [[wear|worn out]]. This applies mainly to [[clothing]] that's wearing out, [[food]] that's going rotten, and [[building]]s that are being attacked by [[building destroyer]]s.
* Bracketing with {{DFtext|‼}} indicates that the item is on [[fire]].

==Item stacks==
Often identical items will be grouped together in a pile called a [[stack]], where the number of items in the stack is indicated by a number inside of square brackets.  For example, {{DFtext|plump helmets [5]|olive}} it a stack of five {{DFtext|plump helmet|olive}}.  Item stacks like this have several advantages:

* An item stack acts as a single item for the purposes of a dwarf [[hauling]] it from one place to another, which saves time since the dwarf won't have to make a round trip of each individual item.
* An item stack acts as a single item for the purposes of storing it directly on the ground in a [[Main:../Stockpiles|stockpile]], saving space.  It doesn't make any difference if the items are consolidated in [[containers]], though.
* Many jobs which process items act on a whole stack at once, and process the whole stack in the same amount of time it takes to process a single item, no matter how large the stack, thus saving time.

Note that individual items which seem identical can't be merged into stacks, nor can two stacks of seemingly identical items be merged into a a single stack.  Also, there's no way to manually split an item stack into smaller stacks or into individual items.

==Container names==
The names of [[container]]s can change based on what they do (or don't) contain and where they are.  An empty [[barrel]] made from cedar will be called {{DFtext|cedar barrel|olive}}.  If it is filled with [[booze|dwarven rum]] then it will be called {{DFtext|dwarven rum Barrel (cedar)|olive}}. If a container is placed in a [[Main:../Stockpiles|stockpile]] then its stockpile number will be appended inside of {{DFtext|&lt; >}}, like {{DFtext|dwarven rum Barrel (cedar) &lt;#1>|olive}}.

==Forbidding items==
When examining an item in detail, or having it selected in a list, you can use {{K|f}} to [[forbid|(un)forbid]] it.  You can also {{K|d}}-{{K|b}}-{{K|f}} to designate an area in which all items are forbidden, and {{K|d}}-{{K|b}}-{{K|c}} to unforbid (reclaim) all items in an area.

* If an item lying on the ground (or in a container on the ground) is forbidden then dwarves will completely ignore it.  This can be used to reserve certain raw materials for future use, or to prevent your dwarves from gathering raw materials in a section of the fortress which you're about to wall off. You can mass-forbid all but one type of raw material from the [[Main:../Status screen#Stocks|stocks screen]] in order to force a craftsdwarf to use the unforbidden raw material.
* If the material a [[building]] is made from is forbidden, then your dwarves won't use it (this includes [[workshop]]s and installed pieces of [[furniture]]).  If you mass forbid raw material from the stocks screen then you might accidentally forbid the raw material some of your buildings are made from, unintentionally keeping your dwarves from using them.
* If an item your dwarf is wearing or wielding is forbidden then the dwarf will continue to use the item as if you'd done nothing.  If the dwarf later drop the item for an unrelated reason then your dwarves will start ignoring it.

==Dumping items==
When examining an item in detail, or having it selected in a list, you can use {{K|d}} to (un)mark it for [[dumping]] it.  You can also {{K|d}}-{{K|b}}-{{K|d}} to designate an area in which all items are marked for dumping, and {{K|d}}-{{K|b}}-{{K|D}} to to remove the dumping order from all items in an area.

An item marked for dumping will have a {{DFtext|D|magenta}} next to its name, and will be taken by a dwarf with the Refuse Hauling [[labor]] enabled to the nearest [[activity zone|garbage dump activity zone]], at which point the {{DFtext|D|magenta}} will be removed and it will be marked as [[#Forbidding items|forbidden]].  You cannot dump items which are owned by a dwarf.  Note that if you want to dump items which are outdoors you have to change the [[standing orders]] setting ({{K|o}}-{{K|r}}-{{K|o}}).

If you mark for dumping a non-owned item which is held or worn by a dwarf, then another dwarf with the Refuse Hauling labor will come along, rip the item away from the first dwarf, and dump the item in a garbage dump.  This can be useful if there's a bug where a dwarf refuses to relinquish an item.

Note that if an item is marked for dumping ''and'' forbidden that your dwarves will ignore the dumping order, since being forbidden takes precedence over dumping

==Detailed examination==
When an item is selected from an item list, pressing {{K|Enter}} will examine it in more detail.

===Weight===
[[Weight]] is indicated in the upper left-hand corner, in units of {{DFtext|Γ|yellow}}, informally known as an "urist", which is identical to a kilogram (2.2 pounds).  For a container with items inside of it, the displayed weight is the total weight of the container plus all of its contents.

The effects that weight has on the game:
* The more weight a dwarf is carrying, the slower s/he moves, but there is no limit to the amount of weight a dwarf can carry.  For instance, a single dwarf can carry an entire whale corpse, though s/he will move at a snail's pace.
* Blunt [[weapon]]s like maces and hammers do more damage the heavier they are.
* The [[caravan]]s which [[trade]] with your fortress have a weight limit to how much they can carry, so if the items you trade to them are heavy you might have to offer to buy some of their heavier goods to lighten their load.
* Heavier stones do more damage in [[trap#Stone-fall_trap|stone fall traps]].

===Owner===
If an item is owned by a particular dwarf this will be listed on the left, under the weight.  An owned item cannot be [[dump]]ed.

===Value===
If you've appointed a [[broker]] who is at least a [[experience|novice]] at the [[appraisal]] skill, then an item's [[value]] will be listed in the upper right-hand corner, in units of {{DFtext|☼|yellow}}, informally known as "[[currency|dwarf bucks]]". For a container with items inside of it, the displayed value is the total value of the container plus all of its contents.

The effects value has on the game:
* The value of installed [[furniture]] and other [[building]]s in a [[room]] increases its quality level, which can help to meet the requirements of some [[noble]]s, plus the usage of [[bedroom]]s and [[dining room]]s will generate a happier [[thought]] the higher the room's quality level.
* If a dwarf passed next to or over an installed piece of furniture then s/he might admire it, giving a happy thought.  The thought it happier the greater the value of the furniture.
* The total value of all of the items created at your fortress which remain in in your fortress (plus the value of all the architecture in your fortress) is your fortress' ''[[wealth|created wealth]]'' (items which were created in your fortress but are no longer present don't count).  Created wealth is the primary means of attracting more [[immigration|immigrants]], a certain amount is required to gain a [[baron]], and certain amounts can trigger [[ambush]]es if the INVADERS [[Main:../Options|option]] is set to YES.
* The more valuable the items you have to offer for [[trade]], the more you can buy off of [[caravan]]s.

===Description===
Using {{K|v}} will give a plain-English description of the item.

===Contents===
If the item is a [[container]] with other items in it, they will be listed down the left-hand side of the screen under {{DFtext|Contents:|white}}.  You can use {{K|-}} and {{K|+}} to scroll among the contents, and press {{K|Enter}} to get a detailed view of the selected item.  Note that {{K|d}} to dump, {{K|f}} to forbid or {{K|v}} to get a description will work on the container rather than the contents until you use {{K|Enter}} to view a particular contained item.  Forbidding a container will not prevent dwarves from using its contents.