Editing Item quality

{{migrated article}}
{{Quality|Unrated}}
{{av}}

{{for/see|information on [[room]] quality|[[Room#Quality|Room/Quality]]}}
{{for/see|article quality ratings|[[DF:Quality]]}}
{{for/see|the Masterwork Mod|the [[Masterwork:Main_Page|Masterwork Mod wiki]]}}
[[File:value_icon.png|100px|right]]'''Quality''' is - by definition - the standard of something as measured against other things of a similar kind; the degree of excellence of something. Within the world of ''Dwarf Fortress'', the primary factors of the quality of something are determined by the skill of the creator, as well as the materials used to make it. Quality also determines an object's financial value, and can strongly dictate someone's reception of said object when using it.
== Quality grades ==
All crafted items (e.g. [[furniture]], [[armor]], [[clothing|clothes]] and [[Kitchen#Types_of_meals|prepared meals]], but not [[drink]]s) have quality levels. If the quality of their craftsdwarfship is above-standard, the item name is bracketed by characters that show it (see table below). [[Coin]]s are an unusual case. The image on the coin may have a quality level, but this does not affect the value of the coin, and the coin's quality level is not shown by special characters. 

Item quality depends on the [[skill]] and [[attributes]] of the crafter. Past a certain skill level they will almost always make at least level 4 (exceptional) quality items. Level 5 (masterworks) are capped to a flat 1/3rd chance.

Images on floors or walls that are engraved by an [[engraver]] have quality levels, which can be seen by examining the engraving. Note that engraving values are calculated differently than crafted items (they still use pre-v50 values), and while a wall will appear to be engraved on all four sides, the only rooms that benefit from a wall engraving are those containing the square the engraver was standing on at the time of engraving. Keep this in mind if you want to improve a specific room or improve multiple rooms!

Raw materials used for crafting items (e.g. [[stone]]s, [[log]]s, [[bar]]s, [[thread]], [[dye]], [[food]]) have no quality levels, with the exception of [[cloth]]. [[Block]]s, an intermediary building material, also lack quality levels, as do smoothed floor tiles, walls, and carved [[fortification]]s.


{{/Table}}

For named weapons that are not artifacts, see [[Weapon#Attachment|here]].

'''Note:''' Items may also be surrounded by braces {}, which indicates the item is [[forbidden]], or parentheses (), which indicates the item came from off-site (i.e. it arrived as [[Goblinite]], was purchased in a trade, or was part of the original [[Embark#Supplies|embark supplies]]). See [[Item designations]] for a summary.

Almost all [[decoration]]s have quality levels, too. An item of any quality (except [[artifact]]-level) can have a decoration of any quality. (Artifacts can't be decorated manually, but have inherent decorations depending on the materials used to make them.) The quality level of a decoration is shown by the same signs (-, +, *, ≡, ☼) just outside the double angle-brackets («,»). Thus, a *«+steel battle axe+»* is a finely-crafted steel battle axe with superior decorations on it, and a «☼steel battle axe☼» is a masterfully crafted steel battle axe with decorations of standard quality. Each decoration imparts its flat bonus and multiplier, so high-quality decorations can quickly create extremely-valuable items, even if those items were low-quality to begin with.

Dyeing is considered a (type of) decoration with quality levels, as are [[glaze]]s, the latter having the effect of making an [[earthenware]] [[jug]] or [[pot]] waterproof and capable of holding liquid. For example, some [[rope reed]] thread may be finely dyed with emerald dye. Dye can be applied to either thread or cloth, but not other goods made of cloth. If thread is dyed, and then woven into cloth, the new cloth will retain the dye and whatever quality level the dye had. The same is true for cloth made into clothes and other goods.

Note that destroying a ☼masterwork☼ item (e.g. by melting) may cause the dwarf who made it to get unhappy [[thought]]s. Covering an engraved image on the floor with [[water]] will remove the image, and cause an unhappy thought if the image was masterwork.  The same is true for mining through a wall with a masterwork image on it. An unhappy thought can also happen if a [[thief]] steals a masterwork item. It also happens in the unusual case where a creature was shot with a masterwork crossbow bolt and the bolt gets stuck in the creature when they leave the map.{{verify|check to see if this was fixed in v50}} Eating a masterwork prepared meal will not cause an unhappy thought.

Dismantling a masterwork building will not cause an unhappy thought. Having a masterwork building destroyed by a [[cave-in]] or [[building destroyer]], however, will.

== Quality levels of imported goods ==

The vast majority of goods brought by caravans, immigrants, visitors, and invaders are superior-quality or less. Exceptional or masterwork-quality items are extremely rare. As a result, you can eventually make better-quality goods yourself, provided your dwarves are trained in the appropriate skill. This is important to keep in mind for your military, since the quality level of [[weapon]]s and [[armor]] can make a big difference in combat performance.

There are goods that you can't produce that foreign civilizations can. Typically, these include uninteresting [[clothing]] items like skirts or useless [[tool]]s like pestles, but also include some exotic weapons like [[whip]]s and [[dagger]]s. If you want to use those weapons, you have to settle for whatever is available, so it can take some time to find one made with decent quality and made from a good metal like [[iron]].

== Quality levels in stockpile settings ==

[[Stockpile]]s can be set to accept only goods of certain quality levels. However, the ''Core quality'' and the ''Total quality'' which can be set in a stockpile's settings are in a difficult relation to the crafting and decoration quality.

=== Core Quality ===

''Core quality'' means the quality of the ''craftsdwarfship of the item''. A masterfully crafted armor (made from qualityless metal bars) has masterful core quality. A finely-crafted dress (made from an exceptional pig tail fiber cloth) has fine core quality (because the craftsdwarfship ''of the item'' is fine).

=== Total Quality ===

''Total quality'' means the highest quality level between the craftsdwarfship of the item and the craftsdwarfship of its components (or decorations). The finely-crafted dress from our previous example has a fine core quality, but its total quality is exceptional because its component — a pig tail fiber cloth — is of exceptional quality. Likewise, a superior quality steel gauntlet, masterfully studded with copper is of masterful total quality (and superior core quality).

A more complex example: A rope reed fiber sock is superiorly decorated with pond turtle shell. Is masterfully crafted from a rope reed fiber cloth which was finely dyed with redroot dye. Core quality: masterful, Total quality: masterful. (Remember, for total quality, the best of either the item's quality, the quality of its components, or the quality of its decorations is chosen.)

See also [http://www.bay12forums.com/smf/index.php?topic=96501.msg2765710 Crafting Skills, Quality and Statistics research].

==Admiring furniture==
Quality has an impact on the amount of [[thought|happiness]] a dwarf gets from admiring furniture only to the extent that it contributes to the furniture's [[value]]. That is, if there's a no-quality statue and a masterwork statue which have exactly the same monetary value, they'll each give the same amount of happiness when admired (assuming Urist has no [[Preferences|preference]] for the material of either statue). Furniture quality has no influence on how often a piece of furniture is admired.

==Changes to artifact weapons==
Toady gave us a [http://www.bay12forums.com/smf/index.php?topic=30026.msg1012311#msg1012311 quote] on weapon and armor quality, giving the game qualities of an "artifact" in v0.31:
<div style="width: 50em; padding: 0.5em; margin-bottom: 1em; border: 1px solid #ccc; background: #eee;">
#Additional value multiplier of 10 over masterwork, so a total multiplier of 120. 
#Cannot be owned (can be equipped, you might have to do it explicitly though).
#Armor deflection roll has ×3 roll modifier instead of the masterwork's ×2.
#Same for melee attack and archery rolls.
#It looks like the artifact edges are the maximum edge for the material, which is also what a masterwork gets, so beyond a masterwork you'd just be getting the hit roll modifier. *
#Things like artifact bone spears will likely be crap against steel, yeah. We don't have actual magical artifacts yet, and that's what would be required.
</div>
<nowiki>*</nowiki> Due to a long-standing bug, artifact edged weapons only have half the maximum edge (sharpness) instead.{{Bug|9549}}
{{Category|Items|*}}
[[ru:Item quality]]