v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "40d:Item quality"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(→‎Skill and quality levels: Added expected value modifiers)
 
(62 intermediate revisions by 31 users not shown)
Line 1: Line 1:
 +
{{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.
 
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 [[weapons]].
+
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__
 
__TOC__
 
== Quality grades ==
 
== Quality grades ==
  
All crafted items ([[furniture]], [[armor]], [[bolts]], etc.) – but not intermediate materials ([[bars]], [[blocks]], etc. except [[cloth]], which does have quality levels) – 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. Alcohol has a hidden quality rating that controls the amount of happiness a dwarf gets from drinking it. It is not yet known whether the damage or destruction of masterful alcohol can cause tantrums.
+
All crafted items ([[furniture]], [[armor]], [[bolt]]s, etc.) – but not intermediate materials ([[bar]]s, [[block]]s, etc. except [[cloth]], which does have quality levels) – 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.
  
 
{|
 
{|
Line 23: Line 28:
 
| ☼Item Name☼ || Masterful || style="text-align: center;" | ×12  || style="text-align: center;" | ×2.0 
 
| ☼Item Name☼ || Masterful || style="text-align: center;" | ×12  || style="text-align: center;" | ×2.0 
 
|-
 
|-
| ''Unique name'' || Artifact || style="text-align: center;" | ×120  || style="text-align: center;" | ×2.0{{verify}}
+
| ''Unique name'' || Artifact || style="text-align: center;" | ×120  || style="text-align: center;" | ×2.0?*
 
|}
 
|}
  
When a masterful quality item is created, the game will announce, "<dwarf> has created a masterpiece!" The destruction or theft of such a masterpiece will cause the dwarf that created it to [[tantrum]] for a year due to an unhappy thought. [[Trading]] a masterpiece item to merchants is always safe. Masterpiece meals can be eaten safely, although allowing the food to rot will cause unhappy thoughts. Using masterpiece bolts will not cause a tantrum, even if the bolts break. However, if a kobold or wild animal steals a used masterpiece bolt which was lying around, then the maker's mood will decrease.  
+
:''(* 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).  
  
Since legendary dwarves are most likely to be the ones creating masterpieces, keeping these creations safe should be high priority; tantruming legendary dwarves can be very difficult to subdue.
+
The magnitude of the unhappy thought is equal to 1000{{verify}} 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.
  
[[Artifact]] items have a unique name instead of bracketing symbols and are worth 120x base value. Artifacts, like masterpiece items, will cause a significant mood drop in the creator when destroyed or stolen. According to inspections of the memory values, it seems that artifacts have the same quality value as masterpiece items, with presumably the same armor/weapon modifiers (&times;2.0).
+
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 ==
 
== Skill and quality levels ==
  
Tradesdwarves of different [[skill]] levels will produce items of differing quality. "Dabbling" dwarves never (without applicable preference) produce anything above a basic quality item, [[legendary]] dwarves usually produce Exceptional items, and the best legendary dwarves produce Masterful items approximately 27% of the time.
+
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 objects make a considerable difference. 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 have thus greatest impact when the dwarf is still relatively unskilled.
+
Preferences for particular materials and/or objects make a considerable difference in the odds of producing better quality items, with each matching preference boosting the effective skill (not quality) by one level (if the craftdwarf likes the item type, subtype and material) and overlapping preferences being cumulative (such as for both [[silver]] + [[axe]]s, or [[wood|birch]] + [[bed]]s, etc.).
  
 
{| border="1" cellpadding="5" cellspacing="0" valign="bottom"
 
{| border="1" cellpadding="5" cellspacing="0" valign="bottom"
 
|-
 
|-
!Chance for  !!No quality!!Well-crafted!!Finely-crafted!!Superior quality!!Exceptional!!Masterful!!Expected Value Modifier
+
!Lvl !! Skill of dwarf !! No quality !! -Well-crafted- !! +Finely-crafted+ !! *Superior quality* !! ≡Exceptional≡ !! ☼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
 
|-
 
|-
|Dabbling    || 100%    ||           ||             ||               ||          ||         ||1
+
|10 || Accomplished|| || || 14.4%    || 45.6%        || 35.6%        || 4.4% ||4.567||0.322
 
|-
 
|-
|Novice      || 80%    || 18%       || 1.9%         ||0.13%           ||0.007%     ||0.00009% ||1.2170
+
|11 || Great|| || || 10.2%   || 42.4%       || 41.4%       || 5.9% ||4.785||0.218
 
|-
 
|-
|No label    || 60%    || 32%      || 6.9%         || 1.0%           || 0.1%     ||0.003%   ||1.4924
+
|12 || Master|| || || 6.7%   || 38.2%       || 47.4%       || 7.7% ||5.021||0.236
 
|-
 
|-
|Competent  || 40%    || 42%      || 14%        || 3.1%           || 0.5%     ||0.02%   ||1.8114
+
|13 || High Master|| || || 3.9%     || 33.0%        || 53.3%       || 9.8% ||5.276||0.255
 
|-
 
|-
|Skilled    || 20%    || 48%       || 24%         || 6.8%           || 1.6%     ||0.09%    ||2.2392
+
|14 || Grand Master|| || || 1.6%     || 26.9%       || 59.2%       || 12.2%       ||5.552||0.276
 
|-
 
|-
|Proficient  ||         || 50%      || 33%         || 12%           || 4.0%     ||0.28%    ||2.7036
+
|15 || Legendary|| || || || 20.0%     || 65.0%       || 15.0%       ||5.850||0.298
 
|-
 
|-
|Talented    ||         || 40%       || 36%         || 17%           || 6.6%      ||0.58%    ||2.9596
+
|16 || Legendary+1|| || || || 15.7%   || 67.2%       || 17.1%       ||6.037||0.187
 
|-
 
|-
|Adept      ||         || 30%      || 37%        || 21%          || 10%     || 1.1%   ||3.182
+
|17 || Legendary+2|| || || || 11.6%   || 69.1%       || 19.3%        ||6.233||0.195
 
|-
 
|-
|Expert      ||         || 20%      || 37%         || 26%           || 15%     || 1.8%    ||3.516
+
|18 || Legendary+3|| || || || 7.6%   || 70.8%       || 21.6%       ||6.436||0.203
 
|-
 
|-
|Professional||         || 10%      || 36%         || 30%           || 21%     || 2.9%    ||3.878
+
|19 || Legendary+4|| || || || 3.7%   || 72.2%       || 24.1%       ||6.647||0.211
 
|-
 
|-
|Accomplished||         ||           || 33%        || 33%          || 29%      || 4.4%   ||4.288
+
|20 || Legendary+5|| || || || || 73.3%       || 26.7%       ||6.867||0.219
|-
 
|Great      ||          ||            ||  27%        ||  33%           || 34%      || 5.9%    ||4.538
 
 
|-
 
|-
|Master      ||         ||           || 20%        || 32%           || 40%     || 7.7%    ||4.804
+
|21 || ''Legendary+6''**|| || || || || 72.0%       || 28.0%       ||6.96||0.093
 
|-
 
|-
|High Master ||         ||           || 13%        || 31%           || 46%     || 9.8%    ||5.106
+
|22 || ''Legendary+7''**|| || || || || 70.7%       || 29.3%       ||7.053||0.093
 
|-
 
|-
|Grand Master||         ||           || 6.7%        || 28%           || 53%     || 12%    ||5.411
+
|23 || ''Legendary+8''***|| || || || || 69.3%       || 30.7%       ||7.146||0.093
 
|-
 
|-
|Legendary   ||         ||           ||             || 25%           || 60%     || 15%    ||5.8
+
|24 || ''Legendary+9''***|| || || || || 68.0%       || 32.0%       ||7.24||0.093
 
|-
 
|-
|Legendary+5 ||         ||           ||             ||               || 73%     || 27%   ||6.89
+
|25 || ''Legendary+10''***|| || || || || 66.7%       || 33.3%       ||7.333||0.093
 
|}
 
|}
  
The above table is based on the formula discovered by [[User:Bartavelle]]:
+
:''(* Proficient is the highest level a dwarf can have at embark.)''
 +
:''(** Legendary+6 and Legendary+7 can '''only''' be reached by making items that coincide with the dwarf's [[preference]]s)''
 +
:''(*** Legendary+8 thru Legendary+10 are only relevant for certain skills, such as [[farming]], [[fishing]], [[plant gathering]], and [[engraving]])''
 +
::''(The above table is based on the formula discovered by [[User:0x517A5D|0x517A5D]])''
  
First, a skill level is computed, apparently directly related to the dabbling...legendary indicators. No skill or dabbling is 0, legendary is 15. It's capped at 20.
+
===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. In most cases, skill levels are capped at 20 (so levels beyond Legendary +5 don't produce Masterpieces more often), but any bonuses from preferences are added ''afterwards''.
  
 
Item quality is set to 0.
 
Item quality is set to 0.
  
Then dice are rolled.
+
Then dice are rolled between 0 and the target number minus 1 (e.g. "d3" gives a 0, 1, or 2). Each roll is independent; all rolls are made even if a previous roll fails.
 
 
* If d5 < skill level, quality is bumped. Otherwise, it just returns quality 0.
 
* If d10 < skill level, quality is bumped. Otherwise, it just returns quality 1.
 
* If d15 < skill level, quality is bumped. Otherwise, it just returns quality 2.
 
* If d20 < skill level, quality is bumped. Otherwise, it just returns quality 3.
 
* If d25 < skill level and d3 == 1, quality is set to 5.  Otherwise, it just returns quality 4.
 
  
 +
* 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 == 0, quality is bumped.
 
This gives the 6 quality levels (0 to 5).
 
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.
 
According to inspections of the memory values, it seems that artifacts have a quality of 5.
  
== Effect of quality on weapon skill {{ver|0.23.130.23a}} ==
+
:::::::::''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:
 
To quote Toady:
 
<div style="width: 50em; padding: 0.5em; margin-bottom: 1em; border: 1px solid #ccc; background: #eee;">
 
<div style="width: 50em; padding: 0.5em; margin-bottom: 1em; border: 1px solid #ccc; background: #eee;">
The quality of any weapon, including crossbows 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
+
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
 
Skill<sub>new</sub> = Skill<sub>original</sub> &times; (1.0 + 0.2 &times; Q) + Q
Line 106: Line 378:
 
</div>
 
</div>
  
while equipped with a single masterpiece weapon, dwarves have skill increase to Accomplished, not Legendary. Still, the bonus is way too high. See this chart for the exact levels:
+
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.
 
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.
Line 146: Line 418:
 
# 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
 
# 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|*Quality]]
+
 
 +
----
 +
 
 +
 
 +
{{Category|Items|*}}

Latest revision as of 01:04, 14 May 2024

This article is about an older version of DF.

Also see Item designations.

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

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

Rooms also have a "quality grade" which determines their value in the eyes of those owning/using the room, which is the sum of the objects placed within their designated area plus the materials 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.

Quality grades[edit]

All crafted items (furniture, armor, bolts, etc.) – but not intermediate materials (bars, blocks, etc. except cloth, which does have quality levels) – 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.

Designation Description Value
Modifier
 Damage / To-Hit /
Armor Modifier
 Item Name —     ×1  ×1.0 
-Item Name- Well-crafted ×2  ×1.2 
+Item Name+ Finely-crafted ×3  ×1.4 
*Item Name* Superior quality ×4  ×1.6 
≡Item Name≡ Exceptional ×5  ×1.8 
☼Item Name☼ Masterful ×12  ×2.0 
Unique name Artifact ×120  ×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[edit]

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[Verify] 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; tantruming legendary dwarves can be very difficult to subdue.

Artifacts[edit]

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[edit]

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, with each matching preference boosting the effective skill (not quality) by one level (if the craftdwarf likes the item type, subtype and material) and overlapping preferences being cumulative (such as for both silver + axes, or birch + beds, etc.).

Lvl Skill of dwarf No quality -Well-crafted- +Finely-crafted+ *Superior quality* ≡Exceptional≡ ☼Masterful☼ Average
Value Multiplier
Jump in
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
21 Legendary+6** 72.0% 28.0% 6.96 0.093
22 Legendary+7** 70.7% 29.3% 7.053 0.093
23 Legendary+8*** 69.3% 30.7% 7.146 0.093
24 Legendary+9*** 68.0% 32.0% 7.24 0.093
25 Legendary+10*** 66.7% 33.3% 7.333 0.093
(* Proficient is the highest level a dwarf can have at embark.)
(** Legendary+6 and Legendary+7 can only be reached by making items that coincide with the dwarf's preferences)
(*** Legendary+8 thru Legendary+10 are only relevant for certain skills, such as farming, fishing, plant gathering, and engraving)
(The above table is based on the formula discovered by 0x517A5D)

The math behind the curtain[edit]

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. In most cases, skill levels are capped at 20 (so levels beyond Legendary +5 don't produce Masterpieces more often), but any bonuses from preferences are added afterwards.

Item quality is set to 0.

Then dice are rolled between 0 and the target number minus 1 (e.g. "d3" gives a 0, 1, or 2). 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 == 0, 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:


Effects of Quality[edit]

Most obviously, quality influences the monetary worth of an object, for purposes of 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[edit]

Higher quality prepared meals give dwarves who consume them more happiness.

Furniture[edit]

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 v0.23.130.23a[edit]

To quote Toady:

The quality of any weapon, including crossbows 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

Skillnew = Skilloriginal × (1.0 + 0.2 × Q) + Q

This is pretty extreme and will probably be reduced for all weapons.

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.

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:

  1. Train a couple dozen skilled miners
  2. Give them exceptional picks
  3. Draft them and give them decent armor
  4. 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