Dwarf Fortress Wiki - User contributions [en]

Need

2017-05-03T20:16:12Z

Witty:

{{Quality|Superior|01:25, 31 October 2016 (UTC)}}
{{av}}
{{new in v0.42}}

'''Needs''' affect a creature's focus. Needs that are unmet for long enough will become bad [[thought]]s.

The need system replaces the generalized [[on break]] feature of previous versions. Dwarves will sometimes perform jobs that satisfy their personal needs, instead of working for the betterment of the fortress. These personal fulfillment jobs generally come in two varieties: low-priority (indicated by green text, e.g. {{DFtext|Listen to Poetry|2:1}}), or high-priority (magenta text with an exclamation point, e.g. {{DFtext|Pray to Lorsïth!|5:1}}). Low-priority jobs may be cancelled to undertake a fortress job. High-priority jobs will not be cancelled for fortress jobs.

Needs are affected by [[personality trait]]s. For instance, a dwarf that values romance will be unfocused "after being unable to make romance", while a dwarf that personally values nature will be unfettered "after seeing animals".

Needs are shown in a dwarf's [[thoughts and preferences]] description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Degree of focus/unfocus:
{| class = "wikitable sortable"
|-
| {{DFtext|Unfettered|2:1}}|| 300 - 400
|-
| {{DFtext|Level-headed|2:0}}|| 200 - 299
|-
| {{DFtext|Untroubled|7:1}}|| 100 - 199
|-
| {{DFtext|Not distracted|7:0}}|| -999 - 99
|-
| {{DFtext|Unfocused|6:0}}|| -9999 - -1000
|-
| {{DFtext|Distracted|6:1}}|| -99999 - -10000
|-
| {{DFtext|Badly distracted|4:1}}|| < -100000
|}

When a Need is satisfied, its value is refreshed to maximum (400), regardless of previous value. There is no minimum to how {{DFtext|Badly distracted|4:1}} a need can get. A deeper negative value won't further reduce total Focus, which is based on a ratio of all Need's Focus rating.

{| class = "wikitable sortable"
!Positive
!Negative
!Related [[Belief]] or [[Facet]]
!Adventurer activity
|-
|spending time with people
|being away from people
|GREGARIOUSNESS
|Spea{{k|k}} to anyone or reply to greeting
|-
|drinking
|being kept from alcohol
|IMMODERATION, SELF-CONTROL
|drink alcohol
|-
|communing with [deity] / meditation
|being unable to pray (to [deity])
|
|Spea{{k|k}}, Pray to <Deity>
|-
|staying occupied
|being unoccupied
|HARD_WORK, ACTIVITY_LEVEL
|Very wide variety of actions
|-
|doing something creative
|doing nothing creative
|ARTWORK
|Perform or compose any work
|-
|doing something exciting
|leading an unexciting life
|EXCITEMENT_SEEKING
|A wide variety of actions
|-
|learning something
|not learning anything
|KNOWLEDGE, CURIOUS
|Gain a rank in any Skill, learn a new subject from written content.
|-
|being with family
|being away from family
|FAMILY
|Unimplemented
|-
|being with friends
|being away from friends
|FRIENDSHIP
|Unimplemented
|-
|hearing eloquent speech
|being unable to hear eloquent speech
|ELOQUENCE
|Hear or recite poetry
|-
|upholding tradition
|being away from traditions
|TRADITION
|Perform any improvisational form
|-
|self-examination
|a lack of introspection
|INTROSPECTION
|Unknown
|-
|making merry
|being unable to make merry
|MERRIMENT, HUMOR
|Recite any poem
|-
|practicing a craft
|being unable to practice a craft
|CRAFTMANSHIP
|Craft an item (ie, Knapping, Bone Carving)
|-
|practicing a martial art
|being unable to practice a martial art
|MARTIAL_PROWESS
|Gain a rank in any combat Skill
|-
|practicing a skill
|being unable to practice a skill
|SKILL
|Use any Skill
|-
|taking it easy
|being unable to take it easy
|LEISURE_TIME
|Unknown
|-
|making romance
|being unable to make romance
|ROMANCE, LOVE PROPENSITY
|Unimplemented
|-
|seeing animals
|being away from animals
|NATURE
|Animal must also see you
|-
|seeing a great beast
|being away from great beasts
|EXCITEMENT_SEEKING, NATURE, CURIOSITY
|Uncertain, possibly encounter LARGE_ROAMING?
|-
|acquiring something
|being unable to acquire something
|GREED, COMMERCE
|Acquire any item by trade or demand
|-
|eating a good meal
|a lack of decent meals
|IMMODERATION
|Unknown, possibly eating a preferred food
|-
|fighting
|being unable to fight
|VIOLENT
|Engage in any combat of any lethality
|-
|causing trouble
|a lack of trouble-making
|HARMONY, DISCORD
|Fight or Argue
|-
|arguing
|being unable to argue
|FRIENDLINESS
|Get into any disagreement about values
|-
|being extravagant
|being unable to be extravagant
|IMMODESTY
|Wear any item with a quality modifier
|-
|wandering
|being unable to wander
|NATURE, ACTIVITY LEVEL
|Move to/from any site or region tile
|-
|helping somebody
|being unable to help anybody
|ALTRUISM, SACRIFICE
|Reunite family members
|-
|thinking abstractly
|a lack of abstract thinking
|ABSTRACT_INCLINED
|Read or write any written content, or compose music or a poem
|-
|admiring art
|being unable to admire art
|ARTWORK
|Exposure to artistic crafts, examining adornments and coins
|}

Satisfying any need will result in a good thought and a decrease in stress.

{{Category|Creatures}}

Noble

2016-04-24T14:45:35Z

Witty: /* Notes */

{{Quality|Superior|12:12, 1 February 2015 (UTC)}}
{{av}}

'''Nobles''' are <s>snotty, good-for-nothing parasites</s> dwarves appointed to office and rule over your fortress. They provide a critical happiness bonus to unhappy and stressed dwarves, who yell at or cry on the nobles. This provides a safety valve for your most stressed dwarves. They also are responsible for interacting with outpost liaisons.

However, some of them can make [[demand]]s and set [[mandate]]s which if not met will upset the noble and result in random punishments of your dwarves. They also are aware of their status and do not want a lesser dwarf to have a better room. If the noble is too much of a problem and cannot be fired, it is possible to <s>arrange</s> experience an [[unfortunate accident]].

It is possible for some of your dwarves to hold noble titles over other parts of the kingdom. These dwarves are still capable of issuing mandates in your fort, however, and demand the same sort of privileged treatment as any other noble.

== Needs ==
Below are the room demands made by each Position. For details on Room values see: [[Room]]. It also lists the number of chests, cabinets, weapon racks, and armor stands they demand. Finally it shows the max number of [[demand]]s and [[mandate]]s they can issue at any given point.



{| class="sortable" border="1" style="margin:1em 1em 1em 0;text-align:center;border-collapse:collapse;"
|- style="background:#F2F2F2;"
!Position!!Quarters!!Dining Room!!Office!!Tomb!!Chests!!Cabinets!!Racks!!Stands!!Demands!!Mandates

|-
![[Baron]]
|bgcolor="#FFFF80"|4Decent Quarters
|bgcolor="#FFFF80"|4Decent Dining Room
|bgcolor="#FFFF80"|4Decent Office
|bgcolor="#FFFF80"|4Tomb
|2
|1
|1
|1
|2
|1

|-
![[Bookkeeper]]
|0—
|0—
|bgcolor="#FFFFE0"|1Meager Office
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Broker]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Captain of the guard|Captain of the Guard]]
|bgcolor="#FFFFA0"|3Quarters
|bgcolor="#FFFFA0"|3Dining Room
|bgcolor="#FFFFA0"|3Office
|0—
|1
|1
|1
|1
|0—
|0—

|-
![[Champion]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|1
|0—

|-
![[Chief medical dwarf]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Count]]
|bgcolor="#FFFF40"|6Great Bedroom
|bgcolor="#FFFF40"|6Great Dining Room
|bgcolor="#FFFF40"|6Throne Room
|bgcolor="#FFFF40"|6Mausoleum
|3
|2
|2
|2
|3
|2

|-
![[Duke]]
|bgcolor="#FFFF20"|7Grand Bedroom
|bgcolor="#FFFF20"|7Grand Dining Room
|bgcolor="#FFFF20"|7Opulent Throne Room
|bgcolor="#FFFF20"|7Grand Mausoleum
|5
|3
|3
|3
|5
|3

|-
![[Expedition leader]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[General]]
|bgcolor="#FFFFA0"|3Quarters
|bgcolor="#FFFFA0"|3Dining Room
|bgcolor="#FFFF80"|4Decent Office
|bgcolor="#FFFFE0"|1Grave
|2
|1
|3
|3
|2
|0—

|-
![[Hammerer]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Manager]]
|0—
|0—
|bgcolor="#FFFFE0"|1Meager Office
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Mayor]]
|bgcolor="#FFFF80"|4Decent Quarters
|bgcolor="#FFFF80"|4Decent Dining Room
|bgcolor="#FFFF80"|4Decent Office
|0—
|2
|1
|1
|1
|2
|1

|-
![[Militia captain]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Militia commander]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Monarch]]
|bgcolor="#FFFF00"|8Royal Bedroom
|bgcolor="#FFFF00"|8Royal Dining Room
|bgcolor="#FFFF00"|8Royal Throne Room
|bgcolor="#FFFF00"|8Royal Mausoleum
|910
|5
|5
|5
|910
|5

|-
![[Outpost liaison]]
|bgcolor="#FFFF40"|6Great Bedroom
|bgcolor="#FFFF40"|6Great Dining Room
|bgcolor="#FFFF40"|6Throne Room
|0—
|3
|2
|2
|2
|3
|0—

|-
![[Sheriff]]
|bgcolor="#FFFFC0"|2Modest Quarters
|bgcolor="#FFFFC0"|2Modest Dining Room
|bgcolor="#FFFFC0"|2Modest Office
|0—
|1
|1
|1
|1
|0—
|0—

|}

== Notes ==
This shows various notes for each position taken from the [[raws]].

*'''#''' - lists whether one or more dwarves can have this position. Duke/Count/Baron don't have a number listed, but each fortress can only have one.
*'''Squad''' - Lists the number and type of dwarf that this position leads
*'''Spouse''' - Is this noble's spouse also considered a noble? In 0.34.11, the titles of noble consorts are mere courtesy titles. No privileges are attached to them, except of course the fact that they share the rooms with their spouse.
*'''Heir''' - Is this individual replaced by an heir when they die? Inheritance doesn't take place in fortresses right now. If a landed noble or monarch dies, that position is permanently erased.
*'''Appointed By''' - Which position appoints this person initially? Note that the player actually controls all appointments via the noble screen; this is, in effect, only which dwarf is ''necessary'' before the player can make the appointment. Barons aren't directly appointed but elevated (presumably by the mountainhome) upon recommendation of the player. They cannot be replaced via the 'n'obles screen. Once a baron/countess/duke dies, no new noble can be created, either.
*'''Replaced By''' - What position replaces this one?
*'''Pop Req''' - Minimum population required for this position to become available.
*'''Wealth Req''' - Minimum created & exported wealth (respectively) for this position to become available.
*'''Elected''' - Is this dwarf elected?
*'''Lazy''' - If this dwarf is lazy they won't do any regular work aside from pulling levers, deconstructing walls, and some other things. In all 0.34.xx versions, this appears to be broken, i.e. "lazy" nobles can still be assigned to perform any labor. This is still the case for 42.xx versions.
*'''Immunity''' - Immune dwarves aren't punished for any crimes.
*'''Econ Exempt''' - These dwarves don't need money to pay for goods or rooms after the [[Economy]] arrives. The economy is currently disabled, so this privilege goes unused for now.
*'''Military Screen Only''' - This position is only listed on the military screen.
*'''Jealous''' - These dwarves will become [[thought|upset]] if their rooms are not better than those of "lesser" dwarves. They don't have to see the rooms to become upset, since they somehow just know such rooms exist.

{| class="sortable" border="1" style="margin:1em 1em 1em 0;text-align:center;border-collapse:collapse;"
|- style="background:#F2F2F2;"
| '''Position'''
| width=5% | '''#'''
| '''Squad'''
| width=5% | '''Spouse'''
| width=5% | '''Heir'''
| '''Appointed By'''
| '''Replaced By'''
| width=5% | '''Pop Req'''
| width=7% | '''Wealth Req'''
| width=5% | '''Elected'''
| '''Lazy'''
| width=5% | '''Immunity'''
| width=5% | '''Econ Exempt'''
| width=5% | '''Military Screen Only'''
| '''Jealous'''

|-
! Baron
| -
| -
| Yes
| Yes
| Monarch
| Count
| 20
| 100k / 10k
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Bookkeeper
| 1
| -
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Broker
| 1
| -
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Captain of the Guard
| 1
| 10:Fortress Guard
| -
| -
| Exp.Leader/Mayor
| -
| 50
| -
| -
| -
| -
| Yes
| -
| -

|-
! Champion
| 1
| -
| -
| -
| Duke/Count/Baron
| -
| -
| -
| -
| Yes
| Yes
| Yes
| -
| -

|-
! Chief Medical Dwarf
| 1
| -
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Count
| -
| -
| Yes
| Yes
| Monarch
| Duke
| 20
| 200k / 20k
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Duke
| -
| -
| Yes
| Yes
| Monarch
| -
| 20
| 300k / 30k
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Expedition Leader
| 1
| -
| -
| -
| -
| Mayor
| -
| -
| -
| -
| -
| Yes
| -
| -

|-
! General
| 1
| 10:Soldier
| -
| -
| Monarch
| -
| -
| -
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Hammerer
| 1
| 10:Royal Guard
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| Yes
| Yes
| Yes
| -
| -

|-
! Manager
| 1
| -
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Mayor
| 1
| -
| -
| -
| -
| -
| 50
| -
| Yes
| -
| -
| Yes
| -
| -

|-
! Militia Captain
| 1+
| 10:Militia-dwarf
| -
| -
| Militia Commander
| -
| -
| -
| -
| -
| -
| -
| Yes
| -

|-
! Militia Commander
| 1
| 10:Militia-dwarf
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Monarch
| 1
| -
| Yes
| Yes
| Armok
| -
| 140
| [[Monarch|It's complicated]]
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Outpost Liaison
| 1
| -
| -
| -
| Monarch
| -
| -
| -
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Sheriff
| 1
| -
| -
| -
| Exp.Leader/Mayor
| Captain of the Guard
| -
| -
| -
| -
| -
| Yes
| -
| -

|}


==Appointed noble selection==
Appointed nobles are chosen by the player. There are certain social skills that are relevant for each appointed noble's job, and not all dwarves will gain experience in a given skill. In fact, some dwarves will never gain experience in certain skills. This is determined by each dwarf's personal traits, and it is therefore important to select the dwarf with the appropriate set of traits for each position:

==Bugs==
Nobles may have impossible [[demand]]s, like cardinal leather items or metal beds. {{Bug|944}}
(Feel free to arrange an [[unfortunate accident]] for the idiot in question) While no dwarves will get punished for not producing these items, it may enrage the noble.

In 42.04 and 42.05, it is impossible for the Baron, Count, Duke or Monarch to arrive, due to a problem with exported wealth.{{bug|9435}} The bug is fixed in 42.06.

===Selecting Squads which contain Nobles===

Here's a link to the DF forum, where some SCIENCE on Nobles in Squads has been conducted.
http://www.bay12forums.com/smf/index.php?topic=113639.msg3467517#msg3467517

{{D for Dwarf}}
Although <s>many</s> all players <s>often</s> constantly get <s>angry</s> murderously mad at nobles, wiser players simply thank their lucky stars that [[main:Armok|Armok]] never created congressdwarves.

{{Translation
| dwarven = rîthol
| elvish = ramu
| goblin = dösta
| human = hal
}}

{{Nobles}}
{{Category|Nobles}}

Noble

2016-04-24T14:42:41Z

Witty: /* Notes */

{{Quality|Superior|12:12, 1 February 2015 (UTC)}}
{{av}}

'''Nobles''' are <s>snotty, good-for-nothing parasites</s> dwarves appointed to office and rule over your fortress. They provide a critical happiness bonus to unhappy and stressed dwarves, who yell at or cry on the nobles. This provides a safety valve for your most stressed dwarves. They also are responsible for interacting with outpost liaisons.

However, some of them can make [[demand]]s and set [[mandate]]s which if not met will upset the noble and result in random punishments of your dwarves. They also are aware of their status and do not want a lesser dwarf to have a better room. If the noble is too much of a problem and cannot be fired, it is possible to <s>arrange</s> experience an [[unfortunate accident]].

It is possible for some of your dwarves to hold noble titles over other parts of the kingdom. These dwarves are still capable of issuing mandates in your fort, however, and demand the same sort of privileged treatment as any other noble.

== Needs ==
Below are the room demands made by each Position. For details on Room values see: [[Room]]. It also lists the number of chests, cabinets, weapon racks, and armor stands they demand. Finally it shows the max number of [[demand]]s and [[mandate]]s they can issue at any given point.



{| class="sortable" border="1" style="margin:1em 1em 1em 0;text-align:center;border-collapse:collapse;"
|- style="background:#F2F2F2;"
!Position!!Quarters!!Dining Room!!Office!!Tomb!!Chests!!Cabinets!!Racks!!Stands!!Demands!!Mandates

|-
![[Baron]]
|bgcolor="#FFFF80"|4Decent Quarters
|bgcolor="#FFFF80"|4Decent Dining Room
|bgcolor="#FFFF80"|4Decent Office
|bgcolor="#FFFF80"|4Tomb
|2
|1
|1
|1
|2
|1

|-
![[Bookkeeper]]
|0—
|0—
|bgcolor="#FFFFE0"|1Meager Office
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Broker]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Captain of the guard|Captain of the Guard]]
|bgcolor="#FFFFA0"|3Quarters
|bgcolor="#FFFFA0"|3Dining Room
|bgcolor="#FFFFA0"|3Office
|0—
|1
|1
|1
|1
|0—
|0—

|-
![[Champion]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|1
|0—

|-
![[Chief medical dwarf]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Count]]
|bgcolor="#FFFF40"|6Great Bedroom
|bgcolor="#FFFF40"|6Great Dining Room
|bgcolor="#FFFF40"|6Throne Room
|bgcolor="#FFFF40"|6Mausoleum
|3
|2
|2
|2
|3
|2

|-
![[Duke]]
|bgcolor="#FFFF20"|7Grand Bedroom
|bgcolor="#FFFF20"|7Grand Dining Room
|bgcolor="#FFFF20"|7Opulent Throne Room
|bgcolor="#FFFF20"|7Grand Mausoleum
|5
|3
|3
|3
|5
|3

|-
![[Expedition leader]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[General]]
|bgcolor="#FFFFA0"|3Quarters
|bgcolor="#FFFFA0"|3Dining Room
|bgcolor="#FFFF80"|4Decent Office
|bgcolor="#FFFFE0"|1Grave
|2
|1
|3
|3
|2
|0—

|-
![[Hammerer]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Manager]]
|0—
|0—
|bgcolor="#FFFFE0"|1Meager Office
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Mayor]]
|bgcolor="#FFFF80"|4Decent Quarters
|bgcolor="#FFFF80"|4Decent Dining Room
|bgcolor="#FFFF80"|4Decent Office
|0—
|2
|1
|1
|1
|2
|1

|-
![[Militia captain]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Militia commander]]
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—
|0—

|-
![[Monarch]]
|bgcolor="#FFFF00"|8Royal Bedroom
|bgcolor="#FFFF00"|8Royal Dining Room
|bgcolor="#FFFF00"|8Royal Throne Room
|bgcolor="#FFFF00"|8Royal Mausoleum
|910
|5
|5
|5
|910
|5

|-
![[Outpost liaison]]
|bgcolor="#FFFF40"|6Great Bedroom
|bgcolor="#FFFF40"|6Great Dining Room
|bgcolor="#FFFF40"|6Throne Room
|0—
|3
|2
|2
|2
|3
|0—

|-
![[Sheriff]]
|bgcolor="#FFFFC0"|2Modest Quarters
|bgcolor="#FFFFC0"|2Modest Dining Room
|bgcolor="#FFFFC0"|2Modest Office
|0—
|1
|1
|1
|1
|0—
|0—

|}

== Notes ==
This shows various notes for each position taken from the [[raws]].

*'''#''' - lists whether one or more dwarves can have this position. Duke/Count/Baron don't have a number listed, but each fortress can only have one.
*'''Squad''' - Lists the number and type of dwarf that this position leads
*'''Spouse''' - Is this noble's spouse also considered a noble? In 0.34.11, the titles of noble consorts are mere courtesy titles. No privileges are attached to them, except of course the fact that they share the rooms with their spouse.
*'''Heir''' - Is this individual replaced by an heir when they die? Inheritance doesn't take place in fortresses right now. If a landed noble or monarch dies, that position is permanently erased.
*'''Appointed By''' - Which position appoints this person initially? Note that the player actually controls all appointments via the noble screen; this is, in effect, only which dwarf is ''necessary'' before the player can make the appointment. Barons aren't directly appointed but elevated (presumably by the mountainhome) upon recommendation of the player. They cannot be replaced via the 'n'obles screen. Once a baron/countess/duke dies, no new noble can be created, either.
*'''Replaced By''' - What position replaces this one?
*'''Pop Req''' - Minimum population required for this position to become available.
*'''Wealth Req''' - Minimum created & exported wealth (respectively) for this position to become available.
*'''Elected''' - Is this dwarf elected?
*'''Lazy''' - If this dwarf is lazy they won't do any regular work aside from pulling levers, deconstructing walls, and some other things. In all 0.34.xx versions, this appears to be broken, i.e. "lazy" nobles can still be assigned to perform any labor. This is still the case for the latest versions.
*'''Immunity''' - Immune dwarves aren't punished for any crimes.
*'''Econ Exempt''' - These dwarves don't need money to pay for goods or rooms after the [[Economy]] arrives. The economy is currently disabled, so this privilege goes unused for now.
*'''Military Screen Only''' - This position is only listed on the military screen.
*'''Jealous''' - These dwarves will become [[thought|upset]] if their rooms are not better than those of "lesser" dwarves. They don't have to see the rooms to become upset, since they somehow just know such rooms exist.

{| class="sortable" border="1" style="margin:1em 1em 1em 0;text-align:center;border-collapse:collapse;"
|- style="background:#F2F2F2;"
| '''Position'''
| width=5% | '''#'''
| '''Squad'''
| width=5% | '''Spouse'''
| width=5% | '''Heir'''
| '''Appointed By'''
| '''Replaced By'''
| width=5% | '''Pop Req'''
| width=7% | '''Wealth Req'''
| width=5% | '''Elected'''
| '''Lazy'''
| width=5% | '''Immunity'''
| width=5% | '''Econ Exempt'''
| width=5% | '''Military Screen Only'''
| '''Jealous'''

|-
! Baron
| -
| -
| Yes
| Yes
| Monarch
| Count
| 20
| 100k / 10k
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Bookkeeper
| 1
| -
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Broker
| 1
| -
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Captain of the Guard
| 1
| 10:Fortress Guard
| -
| -
| Exp.Leader/Mayor
| -
| 50
| -
| -
| -
| -
| Yes
| -
| -

|-
! Champion
| 1
| -
| -
| -
| Duke/Count/Baron
| -
| -
| -
| -
| Yes
| Yes
| Yes
| -
| -

|-
! Chief Medical Dwarf
| 1
| -
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Count
| -
| -
| Yes
| Yes
| Monarch
| Duke
| 20
| 200k / 20k
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Duke
| -
| -
| Yes
| Yes
| Monarch
| -
| 20
| 300k / 30k
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Expedition Leader
| 1
| -
| -
| -
| -
| Mayor
| -
| -
| -
| -
| -
| Yes
| -
| -

|-
! General
| 1
| 10:Soldier
| -
| -
| Monarch
| -
| -
| -
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Hammerer
| 1
| 10:Royal Guard
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| Yes
| Yes
| Yes
| -
| -

|-
! Manager
| 1
| -
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Mayor
| 1
| -
| -
| -
| -
| -
| 50
| -
| Yes
| -
| -
| Yes
| -
| -

|-
! Militia Captain
| 1+
| 10:Militia-dwarf
| -
| -
| Militia Commander
| -
| -
| -
| -
| -
| -
| -
| Yes
| -

|-
! Militia Commander
| 1
| 10:Militia-dwarf
| -
| -
| Exp.Leader/Mayor
| -
| -
| -
| -
| -
| -
| -
| -
| -

|-
! Monarch
| 1
| -
| Yes
| Yes
| Armok
| -
| 140
| [[Monarch|It's complicated]]
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Outpost Liaison
| 1
| -
| -
| -
| Monarch
| -
| -
| -
| -
| Yes
| Yes
| Yes
| -
| Yes

|-
! Sheriff
| 1
| -
| -
| -
| Exp.Leader/Mayor
| Captain of the Guard
| -
| -
| -
| -
| -
| Yes
| -
| -

|}


==Appointed noble selection==
Appointed nobles are chosen by the player. There are certain social skills that are relevant for each appointed noble's job, and not all dwarves will gain experience in a given skill. In fact, some dwarves will never gain experience in certain skills. This is determined by each dwarf's personal traits, and it is therefore important to select the dwarf with the appropriate set of traits for each position:

==Bugs==
Nobles may have impossible [[demand]]s, like cardinal leather items or metal beds. {{Bug|944}}
(Feel free to arrange an [[unfortunate accident]] for the idiot in question) While no dwarves will get punished for not producing these items, it may enrage the noble.

In 42.04 and 42.05, it is impossible for the Baron, Count, Duke or Monarch to arrive, due to a problem with exported wealth.{{bug|9435}} The bug is fixed in 42.06.

===Selecting Squads which contain Nobles===

Here's a link to the DF forum, where some SCIENCE on Nobles in Squads has been conducted.
http://www.bay12forums.com/smf/index.php?topic=113639.msg3467517#msg3467517

{{D for Dwarf}}
Although <s>many</s> all players <s>often</s> constantly get <s>angry</s> murderously mad at nobles, wiser players simply thank their lucky stars that [[main:Armok|Armok]] never created congressdwarves.

{{Translation
| dwarven = rîthol
| elvish = ramu
| goblin = dösta
| human = hal
}}

{{Nobles}}
{{Category|Nobles}}

Refuse

2015-07-12T20:50:27Z

Witty: /* Refuse collection options */

{{Quality|Exceptional}}
{{av}}

[[Image:RefuseStockpile.png|right|thumb|240px|A refuse stockpile of a dwarven fortress after a goblin siege. The pond turtle shells ({{Raw Tile|²|2:0}}) suggest that the fisherdwarves may have been the first victims of it.]]

'''Refuse''' is anything which can be stored in a refuse [[stockpile]] ({{k|p}}-{{k|r}}). Such stockpile will accept:

* [[Corpse]]s, bodyparts and bodily remains of [[creatures]] (heads, teeth)
* By-products of the [[meat industry| meat]] and [[fishing industry]] ([[bones]], raw hide, [[shell]]s)
* Things which are rotten (rotten meat, rotten meals, rotten raw hide)
* Things the dwarves have no further use for (withered plants, damaged furniture, [[Wear|tattered]] clothes)
* [[Vermin]] remains

Note: Storing clothes or armor in a stockpile with the refuse category enabled will cause them to wear out very quickly.
 

== Uses for Refuse ==
Despite the name "refuse", some items can be valuable resources for dwarven industries:

===[[Bone]]s===
A single bone can be used to make a stack of bone [[bolt]]s [5], a bone [[crossbow]], 1-3 bone [[craft]]s, or a bone [[decoration]]. Multiple bones can be used to make bone [[armor]] (no breastplates, mailshirts or boots). A stack of bones may be required for some [[strange mood]] creations.

===Raw hides===
A raw hide from any size creature can be tanned at a [[Tanner's shop|tannery]] to produce a single unit of leather. Leather can be used to make leather clothes, leather armor, leather crafts, [[Equipment#Quivers|quivers]], [[Equipment#Backpacks|backpacks]], [[DF2012:Flask|waterskins]], [[Armor#Shield|shields]], and [[decoration]]s. Leather may be required for some [[strange mood]] creations.

===Wool===
Butchering or [[Shearer|shearing]] sheep, llamas or alpacas produces a stack of wool. Each unit of wool can be spun into yarn thread at a [[farmer's workshop]]. Yarn thread can then be woven into cloth and used to produce clothes, crafts, and decorations. Woolen cloth may be required for some [[strange mood]] creations.

===Hair===
The [[hair]] of butchered creatures (e.g. horses or cows) can be spun into [[thread]], too, although such thread can only be used in [[healthcare]] and [[trade]].

===Teeth, ivory, and horn===
These items can be processed by a [[bone carver]] to produce crafts and decorations.

===[[Shell]]s===
Shells can be used to produce a few types of [[armor]], crafts, and decorations. Shells may also be required for some [[strange mood]] creations.

===Skulls===
The skulls of kittens, poultry and other creatures don't need to lie uselessly in your refuse stockpile. Your bonecarver can use them to make [[totem]]s, a trade good.

===Sapient corpses===
Sapient corpses placed near a high-traffic route will horrify your dwarves from time to time, forcing them to slowly gain [[discipline]] points (and spam job cancellations). However, avoid locations that will horrify merchants, causing them to scuttle their wagons, drop their merchandise, and flee{{bug|7185}}.

== Refuse Stockpiles ==

A refuse stockpile works just like any other [[stockpile]] and is different from a [[Activity zone#Garbage dump|garbage dump]] zone (which accepts items explicitly marked to be dumped). The standard predefined refuse stockpile (designated by {{k|p}}-{{k|r}}) includes all types of refuse. Customized [[Stockpile#Stockpile_Settings|stockpiles]] can allow you to sort out the usable "refuse", the rotting refuse, the unusable but not rotting refuse, or even the [[Siege#Necromancer_sieges|reanimatable]] refuse. Disabling certain types of refuse in all refuse stockpiles will cause those items to accumulate wherever they are produced (eg. bones in the butcher shop) instead of tying up stockpile space.

== Avoiding Miasma ==

Some types of refuse rot, and rotting refuse produces [[miasma]] when in a subterranean tile. To avoid the miasma, you can [[garbage disposal|destroy refuse]] before it rots, or store rotting refuse in a {{DFtext|Light|6:1}} and {{DFtext|Above Ground|2:1}} tile (see [[tile attributes]]). A refuse pile on the surface works, as does exposing any part of your fortres's {{DFtext|Inside |6:0}}{{DFtext|Dark Subterranean|0:1}} tiles to sunlight and then covering them with constructed floors or walls. Such tiles will remain {{DFtext|Light |6:1}}{{DFtext|Above Ground|2:1}} and thus the refuse stored there will not generate any miasma.

== Refuse collection options ==

Refuse items lying outside your fortress will be ignored by default. You can toggle collection of "outside" refuse in the [[standing orders]] menu ({{k|o}}-{{k|r}}-{{k|o}}). Note that this setting also controls the collection of "[[dump]]ed" items outside your fortress.

Position token

2015-05-22T01:37:52Z

Witty: /* Position Tokens */

{{Quality|Fine|11:39, 18 May 2015 (UTC)}}
{{av}}
These tokens define positions in entity_*.txt files. See [[Entity token]].
==Position Tokens==
These tokens belong in an entity definition. These tokens apply to a position (such as monarch) and should follow the [POSITION:POSITION_NAME] token.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ACCOUNT_EXEMPT}}
|
| The position holder is not subjected to the economy. Less than relevant right now.

|-
| {{text anchor|ALLOWED_CLASS}}
| CREATURE_CLASS Token
| Only creatures with the specified class token can be appointed to this position.

|-
| {{text anchor|ALLOWED_CREATURE}}
| CREATURE:CASTE
| Restricts the position to only the defined caste. Only works with a caste of the entity's current race (If the entity had multiple CREATURE: tokens)

|-
| {{text anchor|APPOINTED_BY}}
| position
| This position can only be chosen to the task from the nobles screen, and is available only if there is an *argument* present. For example, the GENERAL is [APPOINTED_BY:MONARCH]. Contrast [ELECTED]. Being appointed by a MONARCH seems to handle a lot of worldgen stuff and interferes with fort mode titles.

|-
| {{text anchor|BRAG_ON_KILL}}
|
| A creature that kills this position will be sure to talk about it a lot.

|-
| {{text anchor|CHAT_WORTHY}}
|
| In adventure mode, when referencing locations an NPC may mention this position holder living there or having done some deed there. Means that the position exists in world-gen rather than being created only at the end of world-gen

|-
| {{text anchor|COLOR}}
| color
| Creatures of this position will have this color, instead of their profession color. e.g. [COLOR:5:0:1]

|-
| {{text anchor|COMMANDER}}
| position:ALL
| This position will act as a commander of the specified position{{verify}}. E.g. GENERAL is [COMMANDER:LIEUTENANT:ALL]. Unknown if values other than ALL work.

|-
| {{text anchor|CONQUERED_SITE}}
|
| This position is a puppet ruler left behind on a conquered site.

|-
| {{text anchor|DEMAND_MAX}}
| number (0-100)
| How many demands at one time the position can make of the population.

|-
| {{text anchor|DETERMINES_COIN_DESIGN}}
|
| Minted coins will have images that reflect the personality of this position holder.

|-
| {{text anchor|DO_NOT_CULL}}
|
| The position won't be culled from Legends as "unimportant" during world generation.

|-
| {{text anchor|DUTY_BOUND}}
|
| Members of this position will never agree to 'join' your character during adventure mode.

|-
| {{text anchor|ELECTED}}
|
| The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY].

|-
| {{text anchor|EXECUTION_SKILL}}
| weapon skill
| A mandatory subtag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for his work.

|-
| {{text anchor|EXPORTED_IN_LEGENDS}}
|
| The various members who have filled this role will be listed in the civilisation's history.

|-
| {{text anchor|FLASHES}}
|
| The creature holding this position will visibly flash, like legendary citizens. Represents a properly noble station by default.

|-
| {{text anchor|GENDER}}
| male/female
| The position can only be held by specified gender. Currently bugged {{bug|2714}}

|-
| {{text anchor|KILL_QUEST}}
|
| The position can assign quests to adventurers.

|-
| {{text anchor|LAND_HOLDER}}
| importance tier (1-3)
| This is an alternative to SITE. What it does is allow positions to be created at civ-level 'as needed' for all sites that meet the requirements to have them, which are the values set in LAND_HOLDER_TRIGGER. The character is tied permanantly to a particular site but also operates at the civ-level.

|-
| {{text anchor|LAND_NAME}}
| string
| The name the area takes on when under the control of a LAND_HOLDER. E.g. for the DUKE, [LAND_NAME:a duchy]

|-
| {{text anchor|MANDATE_MAX}}
| number (0-100)
| The maximum number of mandates the position can make at once.

|-
| {{text anchor|MENIAL_WORK_EXEMPTION}}
|
| Has no present function.

|-
| {{text anchor|MENIAL_WORK_EXEMPTION_SPOUSE}}
|
| The spouse of the position holder doesn't have to work, either. Also doesn't work either. {{bug|3721}}

|-
| {{text anchor|MILITARY_SCREEN_ONLY}}
|
| This position can not be appointed from the nobles screen. Intended for militia captains and other squad leaders to reduce clutter. Currently nonfunctional{{bug|8965}}

|-
| {{text anchor|NAME}}
| singular:plural
| The name of the position.

|-
| {{text anchor|NAME_MALE}}
| singular:plural
| If the creature holding the position is male, this is the position's name. E.g. for MONARCH, [NAME_MALE:king:kings]

|-
| {{text anchor|NAME_FEMALE}}
| singular:plural
| If the creature holding the position is female, this is the position's name. E.g. for MONARCH, [NAME_FEMALE:queen:queens]

|-
| {{text anchor|NUMBER}}
|
* number/AS_NEEDED
| How many of the position there should be. If the [SITE] token exists, this is per site, otherwise this is per civilisation.

|-
| {{text anchor|PRECEDENCE}}
| number (0-30000)
| How important the position is in society; a lower number is more important and displayed higher in the Nobles menu. For MONARCH it's 1, for MILITIA_CAPTAIN it's 200.

|-
| {{text anchor|PUNISHMENT_EXEMPTION}}
|
| Has no present function.

|-
| {{text anchor|QUEST_GIVER}}
|
| The position holder can give quests in Adventure mode. Functionality in 0.31.13 and later is uncertain.

|-
| {{text anchor|REJECTED_CLASS}}
| CREATURE_CLASS Token
| Creatures of the specified class cannot be appointed to this position.

|-
| {{text anchor|REJECTED_CREATURE}}
| CREATURE:CASTE
| Restricts position holders by CREATURE type.

|-
| {{text anchor|REPLACED_BY}}
| position
| This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR].

|-
| {{text anchor|REQUIRED_BEDROOM}}
| number (0-1000000)
| The position holder requires a bedroom with at least this value.

|-
| {{text anchor|REQUIRED_BOXES}}
| number (0-100)
| The position holder requires at least this many boxes.

|-
| {{text anchor|REQUIRED_CABINETS}}
| number (0-100)
| The position holder requires at least this many cabinets.

|-
| {{text anchor|REQUIRED_DINING}}
| number (0-1000000)
| The position holder requires a dining room with at least this value.

|-
| {{text anchor|REQUIRED_OFFICE}}
| number (0-1000000)
| The position holder requires an office with at least this value.

|-
| {{text anchor|REQUIRED_RACKS}}
| number (0-100)
| The position holder requires at least this many weapon racks.

|-
| {{text anchor|REQUIRED_STANDS}}
| number (0-100)
| The position holder requires at least this many armour stands.

|-
| {{text anchor|REQUIRED_TOMB}}
| number (0-1000000)
| The position holder requires a tomb with at least this value.

|-
| {{text anchor|REQUIRES_POPULATION}}
| number
| The position requires the population to be at least this number before it becomes available or before the position holder will move in.

|-
| {{text anchor|RESPONSIBILITY}}
| responsibility
| The position holder does a thing. See the table below for suitable arguments.

|-
| {{text anchor|RULES_FROM_LOCATION}}
|
| If there is a special location set aside for rulers, this is at present only the human castle/mead hall and the elf home tree the position holder will always be found at that particular location. Does nothing for dwarf nobles because at present dwarves have no such special location and may not conquer any foreign sites because of lack of defined siege criteria. Additionally, at present newly created position holders post-gen will not relocate to the proper location if the previously holder died violently, at least which the player was present (may be a bug or it may be a feature).

|-
| {{text anchor|REQUIRES_MARKET}}
|
| Position will only appear in towns and cities of sufficient size that can accommodate a market. More information needs to be collected.

|-
| {{text anchor|SITE}}
|
| Every site government will have the defined number of this position instead of the whole civilization; provided that other criteria (if any) are met. Unless LAND_HOLDER is present instead, the defined number of the position will be created only for the civilization as a whole.

|-
| {{text anchor|SLEEP_PRETENSION}}
|
| The position holder will get upset if someone with a higher PRECEDENCE holds quarters with a greater value than their own.

|-
| {{text anchor|SPECIAL_BURIAL}}
|
| The civilization will inter the corpse of the position holder in a special grave, either in catacombs or in monuments. If that grave is disturbed, the position holder can return as a mummy. {{verify}}

|-
| {{text anchor|SPOUSE}}
| singular:plural
| The name of the position holder's spouse.

|-
| {{text anchor|SPOUSE_FEMALE}}
| singular:plural
| If the spouse of the creature holding the position is female, this is the spouse's position name.

|-
| {{text anchor|SPOUSE_MALE}}
| singular:plural
| If the spouse of the creature holding the position is male, this is the spouse's position name.

|-
| {{text anchor|SQUAD}}
| number:singular:plural
| The position holder is authorized to form a military squad, led by themselves. The number denotes the maximum headcount. The noun used to describe the subordinates (e.g. royal guard) is used in adventure mode for the adventurer.

|-
| {{text anchor|SUCCESSION}}
|
* BY_HEIR / BY_POSITION:position
| How a new position holder is chosen. A single position can have multiple BY_POSITION tokens.

|}

== Responsibilities ==
{| {{prettytable}}
|- bgcolor="#dddddd"
! Argument
! Description
! Notes

|-
| {{text anchor|ACCOUNTING}}
| Found on bookkeeper. Position will use Record Keeper skill to keep track of stocks.

|-
| {{text anchor|ATTACK_ENEMIES}}
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}

|-
| {{text anchor|BUILD_MORALE}}
| Found on champion. Position will lead military training exercises.{{verify}}

|-
| {{text anchor|ESTABLISH_COLONY_TRADE_AGREEMENTS}}
| Found on outpost liaison. Position travels with the caravan to make trade agreements with any settlements that it visits, provided they are domestic, report the news and promote LAND_HOLDER positions. Also reports recent news. Presumably has no effect at site level. Crucially it does not visit foreign settlements but the civ-level TRADE position does the exact same thing in it's position.

|-
| {{text anchor|EXECUTIONS}}
| Found on hammerer. Position executes death penalties with a weapon of the appropriate skill.
|

|-
| {{text anchor|HEALTH_MANAGEMENT}}
| Found on chief medical dwarf. Position will use Diagnostician skill enable the {{key|z}}-menu health screen.
|

|-
| {{text anchor|LAW_ENFORCEMENT}}
| Found on sheriff/captain of the guard. Position and its subordinates are in charge of punishing criminals. A position holding this responsibility plus the SQUAD token (or allowing the entity to have a SITE_VARIABLE_POSITION with this responsibility) is required for an adventurer from a given civilization to start as a hearthperson, fortress guard, etc.

|-
| {{text anchor|LAW_MAKING}}
| Found on monarch/landholders. Will be referred to as the leader of the site in adventure mode and they may be informed as to the site being the capital city for civ-level positions.

|-
| {{text anchor|MAKE_INTRODUCTIONS}}
| Position will make a 'social call' to an established foreign settlement, complimenting or insulting them depending on relations and reporting the news.

|-
| {{text anchor|MAKE_PEACE_AGREEMENTS}}
| Found on diplomat. Position negotiates peace treaties in order to end wars.

|-
| {{text anchor|MAKE_TOPIC_AGREEMENTS}}
| Found on diplomat. Position negotiates special agreements such as tree cutting quotas.

|-
| {{text anchor|MANAGE_PRODUCTION}}
| Found on manager. Position enables the use of workshop profiles and uses the Organizer skill to process work orders entered in the job manager after the fortress population reaches 20.

|-
| {{text anchor|MEET_WORKERS}}
| Found on expedition leader/mayor. Position holds meetings with unhappy citizens and tries to pacify them with happy thoughts.

|-
| {{text anchor|MILITARY_GOALS}}
| Found on monarch/landholder/leaders. Character is in charge of going to war and making peace for the government they work for. Without a position with this responsibility at civ level the civilization will not be able to make peace and it's sites will wage war on each other constantly and as a result all viable civilizations must have one leader with this tag at civ level. This appears not to be a problem for kobolds, presumably due to either the SKULKING or the UTTERANCES tokens.

|-
| {{text anchor|MILITARY_STRATEGY}}
| Found on general/militia commander. During worldgen, position will go on expeditions to tame exotic creatures. Means that they will command the armies of their site or civilization.

|-
| {{text anchor|PATROL_TERRITORY}}
| Found on elven ranger captain. Effect unknown.{{verify}}

|-
| {{text anchor|RECEIVE_DIPLOMATS}}
| Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats and liaisons.

|-
| {{text anchor|RELIGION}}
| Found on elven druid. Position informs you about worship cults{{verify}}

|-
| {{text anchor|TRADE}}
| Found on broker. Position will use Appraisal skill to display value estimates and trade at the depot when set to broker only. When applied to other civilizations, this position will arrive with the caravan to make trade agreements and behaves otherwise like the civ's own ESTABLISH_COLONY_TRADE_AGREEMENTS position holder.

|}

== Related Tokens ==
The following two ENTITY tokens are not actually position tokens, but bear mentioning on this page because they can modify the way that a civilization's positions behave:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* landholder tier
* population
* wealth exported
* created wealth
| Defines the requirements for the noble ruler promotions. The tier numbers determine which position is used.

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

|}

== Why Won't My Positions Appear? ==
The way DF determines what positions will actually ''appear'' in your fortress is somewhat counter-intuitive and fairly limiting. This guide should help you understand what you can do to actually get your positions working properly.

There are five tokens governing which positions appear in your fortress - LAND_HOLDER, REQUIRES_POPULATION, APPOINTED_BY, ELECTED, and REPLACED_BY. The first two determine when your fortress is eligible for a new position, the next two determine how a new position for which your fortress is eligible can be added, and the fifth allows you to clear up obsolete positions. Unfortunately, they also interact in some strange ways that makes creating interesting position structures difficult.

When you start a new fortress, DF compiles a list of your initial positions. To do this, it looks at the requirements for each position - any position whose only requirement is less than seven dwarves (either because they have no requirement tokens, or because their only requirement tokens are [REQUIRES_POPULATION: =< 7] or [LAND_HOLDER:some trigger whose only requirement is some number of dwarves equal to or less than 7]). Most importantly, ''any'' position whose only requirement is a LAND_HOLDER requirement, regardless of what the trigger for that requirement is, will be added if another eligible starting position is REPLACED_BY it. '''A non-LAND_HOLDER position that is REPLACED_BY a LAND_HOLDER position will never appear.''' With this list compiled, the game culls all positions that are REPLACED_BY another eligible position, and then culls all positions that have the APPOINTED_BY token. '''You may not embark with any appointed positions.''' Any remaining positions are then filled by a dwarf chosen at random.

'''Positions do not automatically appear when you reach their requirements.''' For example, if you remove the ELECTED token from the Mayor, then the Mayor will never appear, even once you reach his required number of dwarves. '''For a position that does not appear at embark to appear in your fortress, it must be APPOINTED_BY another position or ELECTED.'''

Naturally, this is more complicated than it looks. '''APPOINTED_BY positions must be appointed by another position already in your fortress, or a civ-level position. Only LAND_HOLDER positions may be appointed by civ-level positions.''' LAND_HOLDER positions that are APPOINTED_BY civ-level positions are inherently tied to civ-level tokens with the ESTABLISH_COLONY_TRADE_AGREEMENTS responsibility. If a fortress meets the LAND_HOLDER_TRIGGER for a new LAND_HOLDER tier when a caravan leaves, then the next time the outpost liaison or equivalent arrives, he will offer to make you an official colony, which will allow you to select all positions for that LAND_HOLDER level. '''Each time he appears, the outpost liaison will only promote your fortress one tier up the LAND_HOLDER track.''' The biggest problem with this system is that you may set your LAND_HOLDER_TRIGGERS such that you are eligible for the first tier of LAND_HOLDER positions at embark. '''If you are eligible for the first tier of LAND_HOLDER positions at embark, then all first-tier positions will appear twice - once at embark, and again when the outpost liaison comes to appoint you to the first tier.'''

{{Category|Modding}}
{{Category|Tokens}}

Position token

2015-05-19T22:49:43Z

Witty: /* Position Tokens */

{{Quality|Fine|11:39, 18 May 2015 (UTC)}}
{{av}}
These tokens define positions in entity_*.txt files. See [[Entity token]].
==Position Tokens==
These tokens belong in an entity definition. These tokens apply to a position (such as monarch) and should follow the [POSITION:POSITION_NAME] token.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ACCOUNT_EXEMPT}}
|
| The position holder is not subjected to the economy. Less than relevant right now.

|-
| {{text anchor|ALLOWED_CLASS}}
| CREATURE_CLASS Token
| Only creatures with the specified class token can be appointed to this position.

|-
| {{text anchor|ALLOWED_CREATURE}}
| CREATURE:CASTE
| Restricts the position to only the defined caste. Only works with a caste of the entity's current race (If the entity had multiple CREATURE: tokens)

|-
| {{text anchor|APPOINTED_BY}}
| position
| This position can only be chosen to the task from the nobles screen, and is available only if there is an *argument* present. For example, the GENERAL is [APPOINTED_BY:MONARCH]. Contrast [ELECTED]. Being appointed by a MONARCH seems to handle a lot of worldgen stuff and interferes with fort mode titles.

|-
| {{text anchor|BRAG_ON_KILL}}
|
| A creature that kills this position will be sure to talk about it a lot.

|-
| {{text anchor|CHAT_WORTHY}}
|
| In adventure mode, when referencing locations an NPC may mention this position holder living there or having done some deed there. Means that the position exists in world-gen rather than being created only at the end of world-gen

|-
| {{text anchor|COLOR}}
| color
| Creatures of this position will have this color, instead of their profession color. e.g. [COLOR:5:0:1]

|-
| {{text anchor|COMMANDER}}
| position:ALL
| This position will act as a commander of the specified position{{verify}}. E.g. GENERAL is [COMMANDER:LIEUTENANT:ALL]. Unknown if values other than ALL work.

|-
| {{text anchor|CONQUERED_SITE}}
|
| This position is a puppet ruler left behind on a conquered site.

|-
| {{text anchor|DEMAND_MAX}}
| number (0-100)
| How many demands at one time the position can make of the population.

|-
| {{text anchor|DETERMINES_COIN_DESIGN}}
|
| Minted coins will have images that reflect the personality of this position holder.

|-
| {{text anchor|DO_NOT_CULL}}
|
| The position won't be culled from Legends as "unimportant" during world generation.

|-
| {{text anchor|DUTY_BOUND}}
|
| Members of this position will never agree to 'join' your character during adventure mode.

|-
| {{text anchor|ELECTED}}
|
| The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY].

|-
| {{text anchor|EXECUTION_SKILL}}
| weapon skill
| A mandatory subtag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for his work.

|-
| {{text anchor|EXPORTED_IN_LEGENDS}}
|
| The various members who have filled this role will be listed in the civilisation's history.

|-
| {{text anchor|FLASHES}}
|
| The creature holding this position will visibly flash, like legendary citizens. Represents a properly noble station by default.

|-
| {{text anchor|GENDER}}
| male/female
| The position can only be held by specified gender. Currently bugged {{bug|2714}}

|-
| {{text anchor|KILL_QUEST}}
|
| The position can assign quests to adventurers.

|-
| {{text anchor|LAND_HOLDER}}
| importance tier (1-3)
| This is an alternative to SITE. What it does is allow positions to be created at civ-level 'as needed' for all sites that meet the requirements to have them, which are the values set in LAND_HOLDER_TRIGGER. The character is tied permanantly to a particular site but also operates at the civ-level.

|-
| {{text anchor|LAND_NAME}}
| string
| The name the area takes on when under the control of a LAND_HOLDER. E.g. for the DUKE, [LAND_NAME:a duchy]

|-
| {{text anchor|MANDATE_MAX}}
| number (0-100)
| The maximum number of mandates the position can make at once.

|-
| {{text anchor|MENIAL_WORK_EXEMPTION}}
|
| Has no present function.

|-
| {{text anchor|MENIAL_WORK_EXEMPTION_SPOUSE}}
|
| The spouse of the position holder doesn't have to work, either. Also doesn't work either. {{bug|3721}}

|-
| {{text anchor|MILITARY_SCREEN_ONLY}}
|
| This position can not be appointed from the nobles screen. Intended for militia captains and other squad leaders to reduce clutter. Currently nonfunctional{{bug|8965}}

|-
| {{text anchor|NAME}}
| singular:plural
| The name of the position.

|-
| {{text anchor|NAME_MALE}}
| singular:plural
| If the creature holding the position is male, this is the position's name. E.g. for MONARCH, [NAME_MALE:king:kings]

|-
| {{text anchor|NAME_FEMALE}}
| singular:plural
| If the creature holding the position is female, this is the position's name. E.g. for MONARCH, [NAME_FEMALE:queen:queens]

|-
| {{text anchor|NUMBER}}
|
* number/AS_NEEDED
| How many of the position there should be. If the [SITE] token exists, this is per site, otherwise this is per civilisation.

|-
| {{text anchor|PRECEDENCE}}
| number (0-30000)
| How important the position is in society; a lower number is more important and displayed higher in the Nobles menu. For MONARCH it's 1, for MILITIA_CAPTAIN it's 200.

|-
| {{text anchor|PUNISHMENT_EXEMPTION}}
|
| Has no present function.

|-
| {{text anchor|QUEST_GIVER}}
|
| The position holder can give quests in Adventure mode. Functionality in 0.31.13 and later is uncertain.

|-
| {{text anchor|REJECTED_CLASS}}
| CREATURE_CLASS Token
| Creatures of the specified class cannot be appointed to this position.

|-
| {{text anchor|REJECTED_CREATURE}}
| CREATURE:CASTE
| Restricts position holders by CREATURE type.

|-
| {{text anchor|REPLACED_BY}}
| position
| This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR].

|-
| {{text anchor|REQUIRED_BEDROOM}}
| number (0-1000000)
| The position holder requires a bedroom with at least this value.

|-
| {{text anchor|REQUIRED_BOXES}}
| number (0-100)
| The position holder requires at least this many boxes.

|-
| {{text anchor|REQUIRED_CABINETS}}
| number (0-100)
| The position holder requires at least this many cabinets.

|-
| {{text anchor|REQUIRED_DINING}}
| number (0-1000000)
| The position holder requires a dining room with at least this value.

|-
| {{text anchor|REQUIRED_OFFICE}}
| number (0-1000000)
| The position holder requires an office with at least this value.

|-
| {{text anchor|REQUIRED_RACKS}}
| number (0-100)
| The position holder requires at least this many weapon racks.

|-
| {{text anchor|REQUIRED_STANDS}}
| number (0-100)
| The position holder requires at least this many armour stands.

|-
| {{text anchor|REQUIRED_TOMB}}
| number (0-1000000)
| The position holder requires a tomb with at least this value.

|-
| {{text anchor|REQUIRES_POPULATION}}
| number
| The position requires the population to be at least this number before it becomes available or before the position holder will move in.

|-
| {{text anchor|RESPONSIBILITY}}
| responsibility
| The position holder does a thing. See the table below for suitable arguments.

|-
| {{text anchor|RULES_FROM_LOCATION}}
|
| If there is a special location set aside for rulers, this is at present only the human castle/mead hall and the elf home tree the position holder will always be found at that particular location. Does nothing for dwarf nobles because at present dwarves have no such special location and may not conquer any foreign sites because of lack of defined siege criteria. Additionally, at present newly created position holders post-gen will not relocate to the proper location if the previously holder died violently, at least which the player was present (may be a bug or it may be a feature).

|-
| {{text anchor|SITE}}
|
| Every site government will have the defined number of this position instead of the whole civilization; provided that other criteria (if any) are met. Unless LAND_HOLDER is present instead, the defined number of the position will be created only for the civilization as a whole.

|-
| {{text anchor|SLEEP_PRETENSION}}
|
| The position holder will get upset if someone with a higher PRECEDENCE holds quarters with a greater value than their own.

|-
| {{text anchor|SPECIAL_BURIAL}}
|
| The civilization will inter the corpse of the position holder in a special grave, either in catacombs or in monuments. If that grave is disturbed, the position holder can return as a mummy. {{verify}}

|-
| {{text anchor|SPOUSE}}
| singular:plural
| The name of the position holder's spouse.

|-
| {{text anchor|SPOUSE_FEMALE}}
| singular:plural
| If the spouse of the creature holding the position is female, this is the spouse's position name.

|-
| {{text anchor|SPOUSE_MALE}}
| singular:plural
| If the spouse of the creature holding the position is male, this is the spouse's position name.

|-
| {{text anchor|SQUAD}}
| number:singular:plural
| The position holder is authorized to form a military squad, led by themselves. The number denotes the maximum headcount. The noun used to describe the subordinates (e.g. royal guard) is used in adventure mode for the adventurer.

|-
| {{text anchor|SUCCESSION}}
|
* BY_HEIR / BY_POSITION:position
| How a new position holder is chosen. A single position can have multiple BY_POSITION tokens.

|}

== Responsibilities ==
{| {{prettytable}}
|- bgcolor="#dddddd"
! Argument
! Description
! Notes

|-
| {{text anchor|ACCOUNTING}}
| Found on bookkeeper. Position will use Record Keeper skill to keep track of stocks.

|-
| {{text anchor|ATTACK_ENEMIES}}
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}

|-
| {{text anchor|BUILD_MORALE}}
| Found on champion. Position will lead military training exercises.{{verify}}

|-
| {{text anchor|ESTABLISH_COLONY_TRADE_AGREEMENTS}}
| Found on outpost liaison. Position travels with the caravan to make trade agreements with any settlements that it visits, provided they are domestic, report the news and promote LAND_HOLDER positions. Also reports recent news. Presumably has no effect at site level. Crucially it does not visit foreign settlements but the civ-level TRADE position does the exact same thing in it's position.

|-
| {{text anchor|EXECUTIONS}}
| Found on hammerer. Position executes death penalties with a weapon of the appropriate skill.
|

|-
| {{text anchor|HEALTH_MANAGEMENT}}
| Found on chief medical dwarf. Position will use Diagnostician skill enable the {{key|z}}-menu health screen.
|

|-
| {{text anchor|LAW_ENFORCEMENT}}
| Found on sheriff/captain of the guard. Position and its subordinates are in charge of punishing criminals. A position holding this responsibility plus the SQUAD token (or allowing the entity to have a SITE_VARIABLE_POSITION with this responsibility) is required for an adventurer from a given civilization to start as a hearthperson, fortress guard, etc.

|-
| {{text anchor|LAW_MAKING}}
| Found on monarch/landholders. Will be referred to as the leader of the site in adventure mode and they may be informed as to the site being the capital city for civ-level positions.

|-
| {{text anchor|MAKE_INTRODUCTIONS}}
| Position will make a 'social call' to an established foreign settlement, complimenting or insulting them depending on relations and reporting the news.

|-
| {{text anchor|MAKE_PEACE_AGREEMENTS}}
| Found on diplomat. Position negotiates peace treaties in order to end wars.

|-
| {{text anchor|MAKE_TOPIC_AGREEMENTS}}
| Found on diplomat. Position negotiates special agreements such as tree cutting quotas.

|-
| {{text anchor|MANAGE_PRODUCTION}}
| Found on manager. Position enables the use of workshop profiles and uses the Organizer skill to process work orders entered in the job manager after the fortress population reaches 20.

|-
| {{text anchor|MEET_WORKERS}}
| Found on expedition leader/mayor. Position holds meetings with unhappy citizens and tries to pacify them with happy thoughts.

|-
| {{text anchor|MILITARY_GOALS}}
| Found on monarch/landholder/leaders. Character is in charge of going to war and making peace for the government they work for. Without a position with this responsibility at civ level the civilization will not be able to make peace and it's sites will wage war on each other constantly and as a result all viable civilizations must have one leader with this tag at civ level. This appears not to be a problem for kobolds, presumably due to either the SKULKING or the UTTERANCES tokens.

|-
| {{text anchor|MILITARY_STRATEGY}}
| Found on general/militia commander. During worldgen, position will go on expeditions to tame exotic creatures. Means that they will command the armies of their site or civilization.

|-
| {{text anchor|PATROL_TERRITORY}}
| Found on elven ranger captain. Effect unknown.{{verify}}

|-
| {{text anchor|RECEIVE_DIPLOMATS}}
| Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats and liaisons.

|-
| {{text anchor|RELIGION}}
| Found on elven druid. Position informs you about worship cults{{verify}}

|-
| {{text anchor|TRADE}}
| Found on broker. Position will use Appraisal skill to display value estimates and trade at the depot when set to broker only. When applied to other civilizations, this position will arrive with the caravan to make trade agreements and behaves otherwise like the civ's own ESTABLISH_COLONY_TRADE_AGREEMENTS position holder.

|}

== Related Tokens ==
The following two ENTITY tokens are not actually position tokens, but bear mentioning on this page because they can modify the way that a civilization's positions behave:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* landholder tier
* population
* wealth exported
* created wealth
| Defines the requirements for the noble ruler promotions. The tier numbers determine which position is used.

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

|}

== Why Won't My Positions Appear? ==
The way DF determines what positions will actually ''appear'' in your fortress is somewhat counter-intuitive and fairly limiting. This guide should help you understand what you can do to actually get your positions working properly.

There are five tokens governing which positions appear in your fortress - LAND_HOLDER, REQUIRES_POPULATION, APPOINTED_BY, ELECTED, and REPLACED_BY. The first two determine when your fortress is eligible for a new position, the next two determine how a new position for which your fortress is eligible can be added, and the fifth allows you to clear up obsolete positions. Unfortunately, they also interact in some strange ways that makes creating interesting position structures difficult.

When you start a new fortress, DF compiles a list of your initial positions. To do this, it looks at the requirements for each position - any position whose only requirement is less than seven dwarves (either because they have no requirement tokens, or because their only requirement tokens are [REQUIRES_POPULATION: =< 7] or [LAND_HOLDER:some trigger whose only requirement is some number of dwarves equal to or less than 7]). Most importantly, ''any'' position whose only requirement is a LAND_HOLDER requirement, regardless of what the trigger for that requirement is, will be added if another eligible starting position is REPLACED_BY it. '''A non-LAND_HOLDER position that is REPLACED_BY a LAND_HOLDER position will never appear.''' With this list compiled, the game culls all positions that are REPLACED_BY another eligible position, and then culls all positions that have the APPOINTED_BY token. '''You may not embark with any appointed positions.''' Any remaining positions are then filled by a dwarf chosen at random.

'''Positions do not automatically appear when you reach their requirements.''' For example, if you remove the ELECTED token from the Mayor, then the Mayor will never appear, even once you reach his required number of dwarves. '''For a position that does not appear at embark to appear in your fortress, it must be APPOINTED_BY another position or ELECTED.'''

Naturally, this is more complicated than it looks. '''APPOINTED_BY positions must be appointed by another position already in your fortress, or a civ-level position. Only LAND_HOLDER positions may be appointed by civ-level positions.''' LAND_HOLDER positions that are APPOINTED_BY civ-level positions are inherently tied to civ-level tokens with the ESTABLISH_COLONY_TRADE_AGREEMENTS responsibility. If a fortress meets the LAND_HOLDER_TRIGGER for a new LAND_HOLDER tier when a caravan leaves, then the next time the outpost liaison or equivalent arrives, he will offer to make you an official colony, which will allow you to select all positions for that LAND_HOLDER level. '''Each time he appears, the outpost liaison will only promote your fortress one tier up the LAND_HOLDER track.''' The biggest problem with this system is that you may set your LAND_HOLDER_TRIGGERS such that you are eligible for the first tier of LAND_HOLDER positions at embark. '''If you are eligible for the first tier of LAND_HOLDER positions at embark, then all first-tier positions will appear twice - once at embark, and again when the outpost liaison comes to appoint you to the first tier.'''

{{Category|Modding}}
{{Category|Tokens}}