Editing 40d:Item quality

{{av}}{{Quality|Exceptional}}
''Also see [[Item designations]].''

All items in the game have a [[item value|base value]], which is multiplied by what [[material value|material]] the item is made of and by the item's '''quality'''.  [[Decoration]]s (such as bone, gems, and studding) further increase the value.

Item quality can have an effect on an item's properties, especially [[armor]] and [[weapon]]s.

[[Room]]s also have a "quality grade" which determines their [[Room#Specific_room_quality_grades|value]] in the eyes of those owning/using the room, which is the sum of the objects placed within their designated area plus the [[material]]s that surround it plus improvements (such as [[engraving]]) to those materials.  See [[room]] for a more complete discussion of these values, and [[How do I increase the value of a room]] for a complete list of options.

__TOC__
== Quality grades ==

All crafted items ([[furniture]], [[armor]], [[bolt]]s, etc.) &ndash; but not intermediate materials ([[bar]]s, [[block]]s, etc. except [[cloth]], which does have quality levels) &ndash; are bracketed by characters that show the quality of their craftsdwarfship. Dyeing also has a quality level, as does Decorating/Encrusting (with gems, leathers, cloth, etc.). Prepared foods have quality levels.

{|
! style="padding-right: 35px;" | '''Designation''' || style="text-align: left;" | '''Description''' || style="padding-right: 20px; padding-left: 15px; text-align: center;" | '''Value <br>Modifier''' || style="text-align: center;" | '''&nbsp;Damage / To-Hit /<br>Armor Modifier'''
|-
| &nbsp;Item Name || style="text-align: center;" | &mdash;&nbsp;&nbsp;&nbsp;&nbsp; || style="text-align: center;" | &times;1&nbsp; || style="text-align: center;" | &times;1.0&nbsp;
|-
| -Item Name- || Well-crafted || style="text-align: center;" | &times;2&nbsp; || style="text-align: center;" | &times;1.2&nbsp;
|-
| +Item Name+ || Finely-crafted || style="text-align: center;" | &times;3&nbsp; || style="text-align: center;" | &times;1.4&nbsp;
|-
| *Item Name* || Superior quality || style="text-align: center;" | &times;4&nbsp; || style="text-align: center;" | &times;1.6&nbsp;
|-
| ≡Item Name≡ || Exceptional || style="text-align: center;" | &times;5&nbsp; || style="text-align: center;" | &times;1.8&nbsp;
|-
| ☼Item Name☼ || Masterful || style="text-align: center;" | &times;12&nbsp; || style="text-align: center;" | &times;2.0&nbsp;
|-
| ''Unique name'' || Artifact || style="text-align: center;" | &times;120&nbsp; || style="text-align: center;" | &times;2.0?*
|}

:''(* An analysis of game memory indicates a base multiplier of 2.0, however observational reports (and some other elements of the game code) imply that the multiplier might be (significantly?) higher.  As it stands, it's not perfectly clear - more research is needed.)''

====Masterpiece====
A '''masterpiece''' is more than the highest normal quality and value - it is an artistic expression that is of great importance to the dwarf who created it.

When a masterful quality item is created, the game will announce, "<dwarf> has created a masterpiece!"  The loss, destruction or theft of such a masterpiece will cause the dwarf that created it a ''very'' unhappy thought. [[Trading]] a masterpiece item to merchants is always safe. Masterpiece meals can be eaten safely, although allowing the food to rot will provoke the same response as theft or destruction. Using masterpiece bolts will not cause a tantrum, even if the bolts break - however, ''losing'' a bolt, even one left on the battlefield, will. So if a kobold or wild animal steals a used masterpiece bolt which was lying around, or misses its target and falls into the [[chasm]] or is melted by "the impertinent [[magma]]", this also counts as defacement, and the maker's mood will decrease (but not as much as might be - see below). 

The magnitude of the unhappy thought is equal to 1000 divided by the number of masterworks the dwarf has created.  So an engraver with hundreds of masterwork images on the walls of the fortress or a bonecarver with several dozen masterpiece bone bolts will be merely irked by the destruction of one of their many masterworks, while a dwarf who has only made a single masterwork item would be deeply and significantly affected.

Since [[legendary]] dwarves are most likely to be the ones creating masterpieces, keeping these creations safe should be high priority; [[tantrum]]ing legendary dwarves can be very difficult to subdue.

====Artifacts====
[[Artifact]] items have a unique name instead of bracketing symbols and are worth 120x base value. Unlike masterpiece items, the loss of an artifact will not result in any unhappiness in any of your dwarves, but it may result in a significant mood drop in the current overseer (i.e. ''you''). According to inspections of the memory values, it seems that artifacts have the same quality value as masterpiece items.  It is unclear if this is true for weapons/armor or not - opinions differ as to whether artifact weapons and armor have a 2.0 multiplier or something higher; nothing has been found in the game code to support such, but observation suggests otherwise.

== Skill and quality levels ==

Tradesdwarves of higher [[skill]] levels will ''tend'' to produce items of higher quality.  Looking at the table below, we see that "Dabbling" dwarves never (without an applicable [[preference]]) produce anything above a basic "no quality" item, Proficient dwarves (the highest possible skill level at [[embark]]) always produce at least some quality and usually +Finely Crafted items+, while [[legendary]] dwarves usually (65% of the time) produce ≡Exceptional items≡, and the best legendary dwarves produce nothing ''less'' than ≡Exceptional≡ and produce ☼Masterful items☼ approximately 27% of the time.

Preferences for particular materials and/or objects make a considerable difference in the odds of producing better quality items.  Although the exact adjustment is unknown, preliminary testing indicates that they can boost effective skill (not quality) by one to three levels (if the craftdwarf likes the item type, subtype and material), and overlapping preferences seem to be cumulative (such as for both [[silver]] + [[axe]]s, or [[wood|birch]] + [[bed]]s, etc.).<br /><br />
{| border="1" cellpadding="5" cellspacing="0" valign="bottom"
|-
!Lvl !! Skill of dwarf !! No quality !! -Well-crafted- !! +Finely-crafted+ !! *Superior quality* !! ≡Exceptional≡ !! <nowiki>☼</nowiki>Masterful☼ !! Average<br />[[Value]] Multiplier !! Jump in<br />Average Value
|-
| 0 || Dabbling|| 100.0%      || || || || || ||1.000||
|-
| 1 || Novice|| 63.0% || 31.4%        || 5.2% || 0.38%    || 0.01%    || 0.000089%    ||1.430||0.430
|-
| 2 || Adequate|| 36.4%     || 44.1%        || 16.7%        || 2.6% || 0.16%    || 0.0028%    ||1.860||0.430
|-
| 3 || Competent|| 18.3%      || 43.8%        || 29.4%        || 7.7% || 0.79%    || 0.022%    ||2.291||0.431
|-
| 4 || Skilled|| 6.7% || 35.6%        || 39.4%        || 15.8%        || 2.4% || 0.091%    ||2.725||0.434
|-
| 5 || ''Proficient''*|| || 23.3%  || 44.4%        || 26.4%        || 5.6% || 0.28%    ||3.167||0.441
|-
| 6 || Talented|| || 15.5%    || 41.5%        || 33.3%        || 9.2% || 0.58%    ||3.415||0.248
|-
| 7 || Adept|| || 9.4%        || 36.3%        || 39.2%        || 14.0%        || 1.1% ||3.674||0.259
|-
| 8 || Expert|| || 5.0%       || 29.7%        || 43.5%        || 20.0%        || 1.8% ||3.949||0.275
|-
| 9 || Professional|| || 1.9% || 22.2%        || 45.8%        || 27.2%        || 2.9% ||4.245||0.296
|-
|10 || Accomplished|| || || 14.4%     || 45.6%        || 35.6%        || 4.4% ||4.567||0.322
|-
|11 || Great|| || || 10.2%    || 42.4%        || 41.4%        || 5.9% ||4.785||0.218
|-
|12 || Master|| || || 6.7%    || 38.2%        || 47.4%        || 7.7% ||5.021||0.236
|-
|13 || High Master|| || || 3.9%      || 33.0%        || 53.3%        || 9.8% ||5.276||0.255
|-
|14 || Grand Master|| || || 1.6%     || 26.9%        || 59.2%        || 12.2%        ||5.552||0.276
|-
|15 || Legendary|| || || || 20.0%     || 65.0%        || 15.0%        ||5.850||0.298
|-
|16 || Legendary+1|| || || || 15.7%   || 67.2%        || 17.1%        ||6.037||0.187
|-
|17 || Legendary+2|| || || || 11.6%   || 69.1%        || 19.3%        ||6.233||0.195
|-
|18 || Legendary+3|| || || || 7.6%    || 70.8%        || 21.6%        ||6.436||0.203
|-
|19 || Legendary+4|| || || || 3.7%    || 72.2%        || 24.1%        ||6.647||0.211
|-
|20 || Legendary+5|| || || || || 73.3%        || 26.7%        ||6.867||0.219
|-
|}

:''(* Proficient is the highest level a dwarf can have at embark.)''

::''(The above table is based on the formula discovered by [[User:0x517A5D|0x517A5D]])''

===The math behind the curtain===
The in-game calculations to determine final quality of a product work like this: first, a skill level is computed, directly related to the dabbling through legendary+5 indicators and preferences of the particular crafter.  "No skill" or dabbling is 0, proficient is 5, legendary is 15, etc.  Skill levels are capped at 20 (so Legendary +5 don't appear to produce Masterpieces more often in their preferences).

Item quality is set to 0.

Then dice are rolled. Each roll is independent; all rolls are made even if a previous roll fails.

* If d5 < skill level, quality of final product is bumped.
* If d10 < skill level, quality is bumped.
* If d15 < skill level, quality is bumped.
* If d20 < skill level, quality is bumped.
* If d25 < skill level and d3 == 1, quality is bumped.
This gives the 6 quality levels (0 to 5).

According to inspections of the memory values, it seems that artifacts have a quality of 5.

:::::::::''Full code breakdown here:''
{{Spoil small|Here is Quietust's disassembly and analysis, up-to-date as of version 0.28.181.40d:<br /><br />

---------------------------------------------------------------------------------
<nowiki>
; First, check what skill is being used
                                        ; arg_4 is the job being completed
                mov     ebx, [esp+44h+arg_4]
                                        ; arg_0 is the unit performing the job
                mov     esi, [esp+44h+arg_0]
                push    1
                mov     ebp, ecx        ; ECX is the item being created
                call    job_getSkill
                cmp     eax, 0FFFFFFFFh
                jnz     short loc_6EA4EC
                xor     edi, edi
                jmp     short loc_6EA4F4

; Next, get the level of that skill, if there is one (if not, it will use 0 instead)
loc_6EA4EC:
                push    eax
                call    unit_getSkillLevel
                mov     edi, eax        ; Get the maker's uncapped skill level for the job

; Cap the skill level to a maximum of 20
loc_6EA4F4:
                cmp     edi, 20
                mov     [ebp+60h], edi
                jle     short loc_6EA501
                mov     edi, 20

; Check if the item's type/subtype match any Item preferences in the maker
loc_6EA501:
                mov     eax, [ebp+0]
                mov     edx, [eax+4]
                push    1
                push    0FFFFFFFFh
                push    0FFFFFFFFh
                mov     ecx, ebp
                call    edx             ; get the item subtype
                mov     ecx, ebp
                push    eax
                mov     eax, [ebp+0]
                mov     edx, [eax]
                call    edx             ; and the item type
                push    eax
                push    4               ; LikeItem
                call    unit_checkPreference
                test    al, al
                jz      short loc_6EA52A
                add     edi, 1          ; if so, increase skill level by 1

; Check if the item's material/matgloss match any Material preferences in the maker
loc_6EA52A:
                movzx   eax, word ptr [ebp+58h]
                cmp     ax, 0FFFFh      ; skip if item has no material
                jz      short loc_6EA54E
                movzx   ecx, word ptr [ebp+5Ah]
                push    1
                push    ecx             ;field 5Ah is matgloss
                push    eax             ;field 58h is material
                push    0FFFFFFFFh
                push    0FFFFFFFFh
                push    0               ; LikeMaterial
                call    unit_checkPreference
                test    al, al
                jz      short loc_6EA54E
                add     edi, 1          ; if so, increase skill level by 1

; We roll a d5 and compare the result with the creator's skill level.
; (Technically, we compare d5 - 1 against skill_level - 1.)

loc_6EA54E:                             ; field 5Eh is quality
                mov     word ptr [ebp+5Eh], 0

                call    mt_trandom      ; Get a random number (returned in EAX)

                mov     ecx, eax        ; This mess is a division by 5,
                mov     eax, 3          ; retaining the modulus.
                mul     ecx             ; It's done this way in the hope
                mov     eax, ecx        ; that three multiplies is less
                sub     eax, edx        ; expensive than a single divide.
                shr     eax, 1          ; This technique is called
                add     eax, edx        ; "multiplying by the reciprocal."
                shr     eax, 1Eh
                imul    eax, 80000001h
                add     ecx, eax
                mov     eax, 4FFFFFFFh
                mul     ecx
                shr     edx, 1Bh        ; now EDX is in the range [0..4]
                                        ; i.e. d5 - 1

                cmp     edx, edi        ; Compare the "die roll" against the
                                        ; 0-based skill level (still in EDI)
                jge     short loc_6EA588
                                        ; If the random number was less than
                                        ; the skill level,
                add     word ptr [ebp+5Eh], 1
                                        ; add 1 to the quality level

; Now we roll a d10 and compare.  It's important to note that the roll
; of the d10 is independent, not conditional, of the roll of the d5.

loc_6EA588:                             ; Random number
                call    mt_trandom
                mov     ecx, eax        ; Modulus
                mov     eax, 3
                mul     ecx
                mov     eax, ecx
                sub     eax, edx
                shr     eax, 1
                add     eax, edx
                shr     eax, 1Eh
                imul    eax, 80000001h
                add     ecx, eax
                mov     eax, 4FFFFFFFh
                mul     ecx
                shr     edx, 1Ah        ; now EDX is in the range [0..9]
                                        ; i.e. d10 - 1
                cmp     edx, edi        ; Compare
                jge     short loc_6EA5BC
                                        ; If d10 < skill, bump quality
                add     word ptr [ebp+5Eh], 1

loc_6EA5BC:                             ; Same thing for a d15
                call    mt_trandom
                mov     ecx, eax
                mov     eax, 3
                mul     ecx
                mov     eax, ecx
                sub     eax, edx
                shr     eax, 1
                add     eax, edx
                shr     eax, 1Eh
                imul    eax, 80000001h
                add     ecx, eax
                mov     eax, 0EFFFFFF3h
                mul     ecx
                shr     edx, 1Bh
                cmp     edx, ebx
                jge     short loc_6EA5F0
                                        ; If d15 < skill, bump quality
                add     word ptr [ebp+5Eh], 1

loc_6EA5F0:                             ; Same thing for a d20
                call    mt_trandom
                mov     ecx, eax
                mov     eax, 3
                mul     ecx
                mov     eax, ecx
                sub     eax, edx
                shr     eax, 1
                add     eax, edx
                shr     eax, 1Eh
                imul    eax, 80000001h
                add     ecx, eax
                mov     eax, 3FFFFFE3h
                mul     ecx
                sub     ecx, edx
                shr     ecx, 1
                add     ecx, edx
                shr     ecx, 1Ah
                cmp     ecx, edi
                jge     short loc_6EA62A
                                        ; If d20 < skill, bump quality
                add     word ptr [ebp+5Eh], 1

loc_6EA62A:                             ; Now we roll a d25
                call    mt_trandom
                mov     ecx, eax
                mov     eax, 3
                mul     ecx
                mov     eax, ecx
                sub     eax, edx
                shr     eax, 1
                add     eax, edx
                shr     eax, 1Eh
                imul    eax, 80000001h
                add     ecx, eax
                mov     eax, 0C7FFFFFDh
                mul     ecx
                shr     edx, 1Ah
                cmp     edx, edi        ; Compare against skill,
                jge     short loc_6EA68B
                call    mt_trandom      ; AND roll a d3
                mov     ecx, eax
                mov     eax, 3
                mul     ecx
                mov     eax, ecx
                sub     eax, edx
                shr     eax, 1
                add     eax, edx
                shr     eax, 1Eh
                imul    eax, 80000001h
                add     ecx, eax
                mov     eax, 0BFFFFFFFh
                mul     ecx
                shr     edx, 1Dh
                                        ; The d3 result must be 1.
                                        ; (Technically, d3-1 is tested against 0.)
                jnz     short loc_6EA68B
                                        ; If d25 < skill AND d3 = 1, bump
                add     word ptr [ebp+5Eh], 1

loc_6EA68B:
                cmp     word ptr [ebp+5Eh], 5
                jnz     loc_6EA7BB
                xor     edi, edi
                mov     [esp+44h+var_14], 0Fh
                mov     [esp+44h+var_18], edi
                mov     byte ptr [esp+44h+var_28], 0
                push    esi
                lea     ecx, [esp+48h+var_2C]
                mov     [esp+48h+__$EHRec$.state], edi
                call    formatLanguageName
                add     esp, 4
                push    1Bh
                push    offset aHasCreatedAMas ; " has created a masterpiece!"
                lea     eax, [esp+4Ch+var_2C]
                call    ??Y?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@QAEAAV01@PBD@Z
                ...
</nowiki>
}}

==Effects of Quality==

Most obviously, quality influences the [[value|monetary worth]] of an object, for purposes of [[trade|trading]] and determining price (the latter once [[economy]] starts). Destruction of a [[masterwork]] will also cause relevant unhappiness. However, for some items, quality may also influence other things.

Note that this is not a complete list.

===Food===

Higher quality [[prepared meal]]s give dwarves who consume them more [[thought|happiness]].

===Furniture===

Because [[room quality]] is based on total value of the furniture in a room, high-quality furniture will result in high quality rooms, which provide more satisfaction for the occupants.

===Weapons {{ver|0.23.130.23a}}===

To quote Toady:
<div style="width: 50em; padding: 0.5em; margin-bottom: 1em; border: 1px solid #ccc; background: #eee;">
The quality of any weapon, including [[crossbow]]s used as launchers, affects the skill of the shooter. I think this even leads to obscene things like master crossbows + master bolts causing recruits to shoot like legends. In general, if the quality Q is from 0 to 5, the skill is modified according to

Skill<sub>new</sub> = Skill<sub>original</sub> &times; (1.0 + 0.2 &times; Q) + Q

This is pretty extreme and will probably be reduced for all weapons.
</div>

See this chart for the exact levels:

Note: This chart is out of date/wrong due to the facts that the integer that represents a specific skill level is not known, how the formula rounds is not known, and the fact that higher legendaries exist is known.

{| border="1" cellpadding="5" cellspacing="0" valign="bottom"
|-
!Result for  !!Well-crafted!!Finely-crafted!!Superior quality!!Exceptional!!Masterful
|-
|Dabbling    ||No label    ||Skilled       ||Talented        ||Expert     ||Accomplished
|-
|Novice      ||Competent   ||Proficient    ||Expert          ||Accomplished||Master
|-
|No label    ||Skilled     ||Adept         ||Professional    ||Master     ||Grand Master
|-
|Competent   ||Talented    ||Expert        ||Great           ||High Master||Legendary
|-
|Skilled     ||Adept       ||Accomplished  ||Master          ||Legendary  ||Legendary
|-
|Proficient  ||Expert      ||Great         ||Grand Master    ||Legendary  ||Legendary
|-
|Talented    ||Professional||Master        ||Legendary       ||Legendary  ||Legendary
|-
|Adept       ||Accomplished||Grand Master  ||Legendary       ||Legendary  ||Legendary
|-
|Expert      ||Master      ||Legendary     ||Legendary       ||Legendary  ||Legendary
|-
|Professional||High Master ||Legendary     ||Legendary       ||Legendary  ||Legendary
|-
|Accomplished||Grand Master||Legendary     ||Legendary       ||Legendary  ||Legendary
|-
|Great and better||Legendary||Legendary    ||Legendary       ||Legendary  ||Legendary
|}

If this is true, then it would be possible to:

# Train a couple dozen skilled miners
# Give them exceptional picks
# Draft them and give them decent armor
# Kill a goblin siege with a couple dozen legendary speardwarves (picks = 70% damage spears) as long as there are no enemy champions to destroy your armour/shield/wrestling inept speardwarves


----


{{Category|Items|*}}