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 "v0.34:Position token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
m (up to 10)
Line 11: Line 11:
  
 
|-
 
|-
−
| ACCOUNT_EXEMPT
+
| {{text anchor|ACCOUNT_EXEMPT}}
 
|
 
|
 
| The position holder is not subjected to the economy. Less than relevant right now.
 
| The position holder is not subjected to the economy. Less than relevant right now.
  
 
|-
 
|-
−
| ALLOWED_CLASS
+
| {{text anchor|ALLOWED_CLASS}}
−
| CREATURE_CLASS Token
+
| {{token|CREATURE_CLASS|creature}} Token
 
| Only creatures with the specified class token can be appointed to this position.
 
| Only creatures with the specified class token can be appointed to this position.
  
 
|-
 
|-
−
| ALLOWED_CREATURE
+
| {{text anchor|ALLOWED_CREATURE}}
 
| CREATURE:CASTE
 
| 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)
 
| 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)
  
 
|-
 
|-
−
| APPOINTED_BY
+
| {{text anchor|APPOINTED_BY}}
 
| position
 
| 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.
 
| 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.
  
 
|-
 
|-
−
| BRAG_ON_KILL
+
| {{text anchor|BRAG_ON_KILL}}
 
|  
 
|  
 
| A creature that kills this position will be sure to talk about it a lot.
 
| A creature that kills this position will be sure to talk about it a lot.
  
 
|-
 
|-
−
| CHAT_WORTHY
+
| {{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.
 
| In adventure mode, when referencing locations an NPC may mention this position holder living there or having done some deed there.
  
 
|-
 
|-
−
| COLOR
+
| {{text anchor|COLOR}}
 
| color
 
| color
 
| Creatures of this position will have this color, instead of their profession color. e.g. [COLOR:5:0:1]
 
| Creatures of this position will have this color, instead of their profession color. e.g. [COLOR:5:0:1]
  
 
|-
 
|-
−
| COMMANDER
+
| {{text anchor|COMMANDER}}
 
| position:ALL
 
| 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.
 
| 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.
  
 
|-
 
|-
−
| CONQUERED_SITE
+
| {{text anchor|CONQUERED_SITE}}
 
|  
 
|  
−
| This position is the puppet ruler left behind on a conquered site.
+
| This position is the puppet ruler left behind at a conquered site.
  
 
|-
 
|-
−
| DEMAND_MAX
+
| {{text anchor|DEMAND_MAX}}
 
| number (0-100)
 
| number (0-100)
−
| How many demands at one time the position can make of the population.
+
| How many [[demand]]s at one time the position can make of the population.
  
 
|-
 
|-
−
| DETERMINES_COIN_DESIGN
+
| {{text anchor|DETERMINES_COIN_DESIGN}}
 
|  
 
|  
−
| Minted coins will have images that reflect the personality of this position holder.
+
| Minted [[coin]]s will have images that reflect the personality of this position holder.
  
 
|-
 
|-
−
| DO_NOT_CULL
+
| {{text anchor|DO_NOT_CULL}}
 
|  
 
|  
 
| The position won't be culled from Legends as "unimportant" during world generation.
 
| The position won't be culled from Legends as "unimportant" during world generation.
  
 
|-
 
|-
−
| DUTY_BOUND
+
| {{text anchor|DUTY_BOUND}}
 
|  
 
|  
 
| Members of this position will never agree to 'join' your character during adventure mode.
 
| Members of this position will never agree to 'join' your character during adventure mode.
  
 
|-
 
|-
−
| ELECTED
+
| {{text anchor|ELECTED}}
 
|  
 
|  
 
| The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY].
 
| The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY].
  
 
|-
 
|-
−
| EXECUTION_SKILL
+
| {{text anchor|EXECUTION_SKILL}}
 
| weapon skill
 
| weapon skill
 
| A mandatory subtag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for his work.
 
| A mandatory subtag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for his work.
  
 
|-
 
|-
−
| EXPORTED_IN_LEGENDS
+
| {{text anchor|EXPORTED_IN_LEGENDS}}
 
|  
 
|  
 
| The various members who have filled this role will be listed in the civilisation's history.
 
| The various members who have filled this role will be listed in the civilisation's history.
  
 
|-
 
|-
−
| FLASHES
+
| {{text anchor|FLASHES}}
 
|  
 
|  
 
| The creature holding this position will visibly flash, like legendary citizens. Represents a properly noble station by default.
 
| The creature holding this position will visibly flash, like legendary citizens. Represents a properly noble station by default.
  
 
|-
 
|-
−
| GENDER
+
| {{text anchor|GENDER}}
 
| male/female
 
| male/female
 
| The position can only be held by specified gender.
 
| The position can only be held by specified gender.
  
 
|-
 
|-
−
| KILL_QUEST
+
| {{text anchor|KILL_QUEST}}
 
|  
 
|  
 
| The position can assign quests to adventurers.
 
| The position can assign quests to adventurers.
  
 
|-
 
|-
−
| LAND_HOLDER
+
| {{text anchor|LAND_HOLDER}}
 
| importance tier (1-10)
 
| importance tier (1-10)
 
| The position is a title bestowed by the King. The outpost liaison may offer to appoint a citizen to this position once the wealth requirements given in the LAND_HOLDER_TRIGGER in the entity definition has been met.
 
| The position is a title bestowed by the King. The outpost liaison may offer to appoint a citizen to this position once the wealth requirements given in the LAND_HOLDER_TRIGGER in the entity definition has been met.
  
 
|-
 
|-
−
| LAND_NAME
+
| {{text anchor|LAND_NAME}}
 
| string
 
| string
 
| The name the area takes on when under the control of a LAND_HOLDER. E.g. for the DUKE, [LAND_NAME:a duchy]
 
| The name the area takes on when under the control of a LAND_HOLDER. E.g. for the DUKE, [LAND_NAME:a duchy]
  
 
|-
 
|-
−
| MANDATE_MAX
+
| {{text anchor|MANDATE_MAX}}
 
| number (0-100)
 
| number (0-100)
−
| The maximum number of mandates the position can make at once.
+
| The maximum number of [[mandate]]s the position can make at once.
  
 
|-
 
|-
−
| MENIAL_WORK_EXEMPTION
+
| {{text anchor|MENIAL_WORK_EXEMPTION}}
 
|  
 
|  
 
| The position cannot be assigned labours, and will generally just lounge around like nobles do. Currently does not actually work. {{bug|3721}}
 
| The position cannot be assigned labours, and will generally just lounge around like nobles do. Currently does not actually work. {{bug|3721}}
  
 
|-
 
|-
−
| MENIAL_WORK_EXEMPTION_SPOUSE
+
| {{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}}
 
| The spouse of the position holder doesn't have to work, either. Also doesn't work either. {{bug|3721}}
  
 
|-
 
|-
−
| MILITARY_SCREEN_ONLY
+
| {{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.
 
| This position can not be appointed from the nobles screen. Intended for militia captains and other squad leaders to reduce clutter.
  
 
|-
 
|-
−
| NAME
+
| {{text anchor|NAME}}
 
| singular:plural
 
| singular:plural
 
| The name of the position.
 
| The name of the position.
  
 
|-
 
|-
−
| NAME_MALE
+
| {{text anchor|NAME_MALE}}
 
| singular:plural
 
| singular:plural
 
| If the creature holding the position is male, this is the position's name. E.g. for MONARCH, [NAME_MALE:king:kings]
 
| If the creature holding the position is male, this is the position's name. E.g. for MONARCH, [NAME_MALE:king:kings]
  
 
|-
 
|-
−
| NAME_FEMALE
+
| {{text anchor|NAME_FEMALE}}
 
| singular:plural
 
| singular:plural
 
| If the creature holding the position is female, this is the position's name. E.g. for MONARCH, [NAME_FEMALE:queen:queens]
 
| If the creature holding the position is female, this is the position's name. E.g. for MONARCH, [NAME_FEMALE:queen:queens]
  
 
|-
 
|-
−
| NUMBER
+
| {{text anchor|NUMBER}}
 
|  
 
|  
 
* number/AS_NEEDED
 
* number/AS_NEEDED
Line 157: Line 157:
  
 
|-
 
|-
−
| PRECEDENCE
+
| {{text anchor|PRECEDENCE}}
 
| number (0-30000)
 
| 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.
 
| 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.
  
 
|-
 
|-
−
| PUNISHMENT_EXEMPTION
+
| {{text anchor|PUNISHMENT_EXEMPTION}}
 
|  
 
|  
 
| The position holder will not be held accountable for his or her crimes. Does not appear to work. {{bug|4589}}
 
| The position holder will not be held accountable for his or her crimes. Does not appear to work. {{bug|4589}}
  
 
|-
 
|-
−
| QUEST_GIVER
+
| {{text anchor|QUEST_GIVER}}
 
|
 
|
 
| The position holder can give quests in Adventurer mode. Functionality in 0.31.13 and later is uncertain.
 
| The position holder can give quests in Adventurer mode. Functionality in 0.31.13 and later is uncertain.
  
 
|-
 
|-
−
| REJECTED_CLASS
+
| {{text anchor|REJECTED_CLASS}}
−
| CREATURE_CLASS Token
+
| {{token|CREATURE_CLASS|creature}} Token
 
| Creatures of the specified class cannot be appointed to this position.
 
| Creatures of the specified class cannot be appointed to this position.
  
 
|-
 
|-
−
| REJECTED_CREATURE
+
| {{text anchor|REJECTED_CREATURE}}
 
| CREATURE:CASTE
 
| CREATURE:CASTE
 
| Restricts position holders by CREATURE type.
 
| Restricts position holders by CREATURE type.
  
 
|-
 
|-
−
| REPLACED_BY
+
| {{text anchor|REPLACED_BY}}
 
| position
 
| position
 
| This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR].
 
| This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR].
  
 
|-
 
|-
−
| REQUIRED_BEDROOM
+
| {{text anchor|REQUIRED_BEDROOM}}
 
| number (0-1000000)
 
| number (0-1000000)
 
| The position holder requires a bedroom with at least this value.
 
| The position holder requires a bedroom with at least this value.
  
 
|-
 
|-
−
| REQUIRED_BOXES
+
| {{text anchor|REQUIRED_BOXES}}
 
| number (0-100)
 
| number (0-100)
−
| The position holder requires at least this many boxes.
+
| The position holder requires at least this many [[box]]es (i.e. chests or coffers).
  
 
|-
 
|-
−
| REQUIRED_CABINETS
+
| {{text anchor|REQUIRED_CABINETS}}
 
| number (0-100)
 
| number (0-100)
−
| The position holder requires at least this many cabinets.
+
| The position holder requires at least this many [[cabinet]]s.
  
 
|-
 
|-
−
| REQUIRED_DINING
+
| {{text anchor|REQUIRED_DINING}}
 
| number (0-1000000)
 
| number (0-1000000)
 
| The position holder requires a dining room with at least this value.
 
| The position holder requires a dining room with at least this value.
  
 
|-
 
|-
−
| REQUIRED_OFFICE
+
| {{text anchor|REQUIRED_OFFICE}}
 
| number (0-1000000)
 
| number (0-1000000)
 
| The position holder requires an office with at least this value.
 
| The position holder requires an office with at least this value.
  
 
|-
 
|-
−
| REQUIRED_RACKS
+
| {{text anchor|REQUIRED_RACKS}}
 
| number (0-100)
 
| number (0-100)
−
| The position holder requires at least this many weapon racks.
+
| The position holder requires at least this many [[weapon rack]]s.
  
 
|-
 
|-
−
| REQUIRED_STANDS
+
| {{text anchor|REQUIRED_STANDS}}
 
| number (0-100)
 
| number (0-100)
−
| The position holder requires at least this many armour stands.
+
| The position holder requires at least this many [[armor stand]]s.
  
 
|-
 
|-
−
| REQUIRED_TOMB
+
| {{text anchor|REQUIRED_TOMB}}
 
| number (0-1000000)
 
| number (0-1000000)
 
| The position holder requires a tomb with at least this value.
 
| The position holder requires a tomb with at least this value.
  
 
|-
 
|-
−
| REQUIRES_POPULATION
+
| {{text anchor|REQUIRES_POPULATION}}
 
| number
 
| number
 
| The position requires the population to be at least this number before it becomes available or before the position holder will move in.
 
| The position requires the population to be at least this number before it becomes available or before the position holder will move in.
  
 
|-
 
|-
−
| RESPONSIBILITY
+
| {{text anchor|RESPONSIBILITY}}
 
| responsibility
 
| responsibility
 
| The position holder does a thing. See the table below for suitable arguments.
 
| The position holder does a thing. See the table below for suitable arguments.
  
 
|-
 
|-
−
| RULES_FROM_LOCATION
+
| {{text anchor|RULES_FROM_LOCATION}}
 
|  
 
|  
 
| The position holder is the main ruler of his site and tends to stay there. {{verify}} This token is also required for custom position to appear in fortresses and town keeps in adventure mode, like randomly generated lords/ladies.
 
| The position holder is the main ruler of his site and tends to stay there. {{verify}} This token is also required for custom position to appear in fortresses and town keeps in adventure mode, like randomly generated lords/ladies.
  
 
|-
 
|-
−
| SITE
+
| {{text anchor|SITE}}
 
|  
 
|  
 
| The civilisation will attempt to have this position separate for each site.
 
| The civilisation will attempt to have this position separate for each site.
  
 
|-
 
|-
−
| SLEEP_PRETENSION
+
| {{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.
 
| The position holder will get upset if someone with a higher PRECEDENCE holds quarters with a greater value than their own.
  
 
|-
 
|-
−
| SPECIAL_BURIAL
+
| {{text anchor|SPECIAL_BURIAL}}
 
|  
 
|  
 
| The civilisation 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}}
 
| The civilisation 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}}
  
 
|-
 
|-
−
| SPOUSE
+
| {{text anchor|SPOUSE}}
 
| singular:plural
 
| singular:plural
 
| The name of the position holder's spouse.
 
| The name of the position holder's spouse.
  
 
|-
 
|-
−
| SPOUSE_FEMALE
+
| {{text anchor|SPOUSE_FEMALE}}
 
| singular:plural
 
| singular:plural
 
| If the spouse of the creature holding the position is female, this is the spouse's position name.
 
| If the spouse of the creature holding the position is female, this is the spouse's position name.
  
 
|-
 
|-
−
| SPOUSE_MALE
+
| {{text anchor|SPOUSE_MALE}}
 
| singular:plural
 
| singular:plural
 
| If the spouse of the creature holding the position is male, this is the spouse's position name.
 
| If the spouse of the creature holding the position is male, this is the spouse's position name.
  
 
|-
 
|-
−
| SQUAD
+
| {{text anchor|SQUAD}}
 
| number:singular:plural
 
| 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) may be a relic from the 40d era.{{verify}}
 
| 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) may be a relic from the 40d era.{{verify}}
  
 
|-
 
|-
−
| SUCCESSION
+
| {{text anchor|SUCCESSION}}
 
|  
 
|  
 
* BY_HEIR / BY_POSITION:position
 
* BY_HEIR / BY_POSITION:position
Line 292: Line 292:
  
 
|-
 
|-
−
| ACCOUNTING
+
| {{text anchor|ACCOUNTING}}
 
| Found on bookkeeper. Position will use Record Keeper skill to keep track of stocks.
 
| Found on bookkeeper. Position will use Record Keeper skill to keep track of stocks.
  
 
|-
 
|-
−
| ATTACK_ENEMIES
+
| {{text anchor|ATTACK_ENEMIES}}
 
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}
 
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}
  
 
|-
 
|-
−
| BUILD_MORALE
+
| {{text anchor|BUILD_MORALE}}
−
| Found on champion. Citizens get a special thought for "talking to a pillar of society" when speaking to this noble.
+
| Found on [[champion]]. Citizens get a special thought for "talking to a pillar of society" when speaking to this noble.
  
 
|-
 
|-
−
| COLLECT_TAXES
+
| {{text anchor|COLLECT_TAXES}}
 
| Found on tax collector. Position goes around and collects the tax money from the populace, under armed escort.  
 
| Found on tax collector. Position goes around and collects the tax money from the populace, under armed escort.  
 
| Only functions if the dwarven [[economy]] is active, which never happens.
 
| Only functions if the dwarven [[economy]] is active, which never happens.
  
 
|-
 
|-
−
| EQUIPMENT_MANIFESTS
+
| {{text anchor|EQUIPMENT_MANIFESTS}}
−
| Found on arsenal dwarf. Position will keep track of assigned weapons and equipment.
+
| Originally found on arsenal dwarf. Position will keep track of assigned weapons and equipment.
−
| Removed in version 0.31.10. Has no effect.
+
| Has no effect.
  
 
|-
 
|-
−
| ESCORT_TAX_COLLECTOR
+
| {{text anchor|ESCORT_TAX_COLLECTOR}}
 
| Found on hammerer. Position serves as one of the tax collector's bodyguards during his rounds.
 
| Found on hammerer. Position serves as one of the tax collector's bodyguards during his rounds.
 
| Only functions if the dwarven [[economy]] is active, which never happens.
 
| Only functions if the dwarven [[economy]] is active, which never happens.
  
 
|-
 
|-
−
| ESTABLISH_COLONY_TRADE_AGREEMENTS
+
| {{text anchor|ESTABLISH_COLONY_TRADE_AGREEMENTS}}
 
| Found on outpost liaison. Position will live in the civilization capital and travels to make trade agreements with its colonies.
 
| Found on outpost liaison. Position will live in the civilization capital and travels to make trade agreements with its colonies.
  
 
|-
 
|-
−
| EXECUTIONS
+
| {{text anchor|EXECUTIONS}}
 
| Found on hammerer. Position executes death penalties with a weapon of the appropriate skill.
 
| Found on hammerer. Position executes death penalties with a weapon of the appropriate skill.
 
|
 
|
  
 
|-
 
|-
−
| HEALTH_MANAGEMENT
+
| {{text anchor|HEALTH_MANAGEMENT}}
 
| Found on chief medical dwarf. Position will use Diagnostician skill enable the {{key|z}}-menu health screen.
 
| Found on chief medical dwarf. Position will use Diagnostician skill enable the {{key|z}}-menu health screen.
 
|
 
|
  
 
|-
 
|-
−
| LAW_ENFORCEMENT
+
| {{text anchor|LAW_ENFORCEMENT}}
 
| Found on sheriff/captain of the guard. Position and its subordinates are in charge of punishing criminals.
 
| Found on sheriff/captain of the guard. Position and its subordinates are in charge of punishing criminals.
  
 
|-
 
|-
−
| LAW_MAKING
+
| {{text anchor|LAW_MAKING}}
 
| Found on monarch/landholders. Seems to allow position to receive elf and human diplomats.{{verify}}
 
| Found on monarch/landholders. Seems to allow position to receive elf and human diplomats.{{verify}}
  
 
|-
 
|-
−
| MAKE_INTRODUCTIONS
+
| {{text anchor|MAKE_INTRODUCTIONS}}
 
| Found on diplomat. Allows Elves to make "first contact".
 
| Found on diplomat. Allows Elves to make "first contact".
  
 
|-
 
|-
−
| MAKE_PEACE_AGREEMENTS
+
| {{text anchor|MAKE_PEACE_AGREEMENTS}}
 
| Found on diplomat. Position negotiates peace treaties in order to end wars.
 
| Found on diplomat. Position negotiates peace treaties in order to end wars.
  
 
|-
 
|-
−
| MAKE_TOPIC_AGREEMENTS
+
| {{text anchor|MAKE_TOPIC_AGREEMENTS}}
 
| Found on diplomat. Position negotiates special agreements such as tree cutting quotas.
 
| Found on diplomat. Position negotiates special agreements such as tree cutting quotas.
  
 
|-
 
|-
−
| MANAGE_PRODUCTION
+
| {{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.
 
| 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.
  
 
|-
 
|-
−
| MEET_WORKERS
+
| {{text anchor|MEET_WORKERS}}
 
| Found on expedition leader/mayor. Position holds meetings with unhappy citizens and tries to pacify them with happy thoughts.
 
| Found on expedition leader/mayor. Position holds meetings with unhappy citizens and tries to pacify them with happy thoughts.
  
 
|-
 
|-
−
| MILITARY_GOALS
+
| {{text anchor|MILITARY_GOALS}}
 
| Found on monarch/landholder/leaders. Effect unknown.{{verify}}
 
| Found on monarch/landholder/leaders. Effect unknown.{{verify}}
  
 
|-
 
|-
−
| MILITARY_STRATEGY
+
| {{text anchor|MILITARY_STRATEGY}}
 
| Found on general/militia commander. During worldgen, position will go on expeditions to tame exotic creatures.{{verify}}
 
| Found on general/militia commander. During worldgen, position will go on expeditions to tame exotic creatures.{{verify}}
  
 
|-
 
|-
−
| PATROL_TERRITORY
+
| {{text anchor|PATROL_TERRITORY}}
 
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}
 
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}
  
 
|-
 
|-
−
| RECEIVE_DIPLOMATS
+
| {{text anchor|RECEIVE_DIPLOMATS}}
 
| Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats and liaisons.
 
| Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats and liaisons.
  
 
|-
 
|-
−
| RELIGION
+
| {{text anchor|RELIGION}}
 
| Found on elven druid. Position informs you about worship cults{{verify}}
 
| Found on elven druid. Position informs you about worship cults{{verify}}
  
 
|-
 
|-
−
| SORT_AMMUNITION
+
| {{text anchor|SORT_AMMUNITION}}
−
| Found on arsenal dwarf. Position approves changes to ammunition settings in the military screen.
+
| Originally found on arsenal dwarf. Position approves changes to ammunition settings in the military screen.
−
| Removed in version 0.31.10. Has no current effect.
+
| Has current effect.
  
 
|-
 
|-
−
| TAME_EXOTICS
+
| {{text anchor|TAME_EXOTICS}}
−
| Found on dungeon master. Position enables taming exotic creatures and does forge work.
+
| Originally found on dungeon master. Position enables taming exotic creatures and does forge work.
−
| Broken since version 0.31.01, removed with the animal training overhaul in 0.34.06. Has no current effect.
+
| Removed with the animal training overhaul in 0.34.06. Has no current effect.
  
 
|-
 
|-
−
| TRADE
+
| {{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, the position will arrive with the caravan to make trade agreements.
 
| 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, the position will arrive with the caravan to make trade agreements.
  
 
|-
 
|-
−
| UPGRADE_SQUAD_EQUIPMENT
+
| {{text anchor|UPGRADE_SQUAD_EQUIPMENT}}
−
| Found on arsenal dwarf. Position approves changes to assigned squad equipment in the military screen.
+
| Originally found on arsenal dwarf. Position approves changes to assigned squad equipment in the military screen.
−
| Removed in version 0.31.10. Has no current effect.
+
| Has current effect.
  
 
|}
 
|}
Line 411: Line 411:
  
 
|-
 
|-
−
| LAND_HOLDER_TRIGGER
+
| {{text anchor|LAND_HOLDER_TRIGGER}}
 
|
 
|
 
* landholder tier
 
* landholder tier
Line 420: Line 420:
  
 
|-
 
|-
−
| VARIABLE_POSITIONS
+
| {{text anchor|VARIABLE_POSITIONS}}
 
| Position responsibility or ALL
 
| Position responsibility or ALL
 
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).
 
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

Revision as of 14:44, 3 April 2026

xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼
v53.12 · v0.47 · v0.34.11 · v0.31 · v0.28 · v0.23
This article is about an older version of DF.

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.

Token Arguments Description
 ACCOUNT_EXEMPT The position holder is not subjected to the economy. Less than relevant right now.
 ALLOWED_CLASS [CREATURE_CLASS] Token Only creatures with the specified class token can be appointed to this position.
 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)
 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.
 BRAG_ON_KILL A creature that kills this position will be sure to talk about it a lot.
 CHAT_WORTHY In adventure mode, when referencing locations an NPC may mention this position holder living there or having done some deed there.
 COLOR color Creatures of this position will have this color, instead of their profession color. e.g. [COLOR:5:0:1]
 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.
 CONQUERED_SITE This position is the puppet ruler left behind at a conquered site.
 DEMAND_MAX number (0-100) How many demands at one time the position can make of the population.
 DETERMINES_COIN_DESIGN Minted coins will have images that reflect the personality of this position holder.
 DO_NOT_CULL The position won't be culled from Legends as "unimportant" during world generation.
 DUTY_BOUND Members of this position will never agree to 'join' your character during adventure mode.
 ELECTED The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY].
 EXECUTION_SKILL weapon skill A mandatory subtag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for his work.
 EXPORTED_IN_LEGENDS The various members who have filled this role will be listed in the civilisation's history.
 FLASHES The creature holding this position will visibly flash, like legendary citizens. Represents a properly noble station by default.
 GENDER male/female The position can only be held by specified gender.
 KILL_QUEST The position can assign quests to adventurers.
 LAND_HOLDER importance tier (1-10) The position is a title bestowed by the King. The outpost liaison may offer to appoint a citizen to this position once the wealth requirements given in the LAND_HOLDER_TRIGGER in the entity definition has been met.
 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]
 MANDATE_MAX number (0-100) The maximum number of mandates the position can make at once.
 MENIAL_WORK_EXEMPTION The position cannot be assigned labours, and will generally just lounge around like nobles do. Currently does not actually work. Bug:3721
 MENIAL_WORK_EXEMPTION_SPOUSE The spouse of the position holder doesn't have to work, either. Also doesn't work either. Bug:3721
 MILITARY_SCREEN_ONLY This position can not be appointed from the nobles screen. Intended for militia captains and other squad leaders to reduce clutter.
 NAME singular:plural The name of the position.
 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]
 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]
 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.
 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.
 PUNISHMENT_EXEMPTION The position holder will not be held accountable for his or her crimes. Does not appear to work. Bug:4589
 QUEST_GIVER The position holder can give quests in Adventurer mode. Functionality in 0.31.13 and later is uncertain.
 REJECTED_CLASS [CREATURE_CLASS] Token Creatures of the specified class cannot be appointed to this position.
 REJECTED_CREATURE CREATURE:CASTE Restricts position holders by CREATURE type.
 REPLACED_BY position This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR].
 REQUIRED_BEDROOM number (0-1000000) The position holder requires a bedroom with at least this value.
 REQUIRED_BOXES number (0-100) The position holder requires at least this many boxes (i.e. chests or coffers).
 REQUIRED_CABINETS number (0-100) The position holder requires at least this many cabinets.
 REQUIRED_DINING number (0-1000000) The position holder requires a dining room with at least this value.
 REQUIRED_OFFICE number (0-1000000) The position holder requires an office with at least this value.
 REQUIRED_RACKS number (0-100) The position holder requires at least this many weapon racks.
 REQUIRED_STANDS number (0-100) The position holder requires at least this many armor stands.
 REQUIRED_TOMB number (0-1000000) The position holder requires a tomb with at least this value.
 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.
 RESPONSIBILITY responsibility The position holder does a thing. See the table below for suitable arguments.
 RULES_FROM_LOCATION The position holder is the main ruler of his site and tends to stay there. [Verify] This token is also required for custom position to appear in fortresses and town keeps in adventure mode, like randomly generated lords/ladies.
 SITE The civilisation will attempt to have this position separate for each site.
 SLEEP_PRETENSION The position holder will get upset if someone with a higher PRECEDENCE holds quarters with a greater value than their own.
 SPECIAL_BURIAL The civilisation 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]
 SPOUSE singular:plural The name of the position holder's spouse.
 SPOUSE_FEMALE singular:plural If the spouse of the creature holding the position is female, this is the spouse's position name.
 SPOUSE_MALE singular:plural If the spouse of the creature holding the position is male, this is the spouse's position name.
 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) may be a relic from the 40d era.[Verify]
 SUCCESSION
  • BY_HEIR / BY_POSITION:position
 How a new position holder is chosen. A single position can have multiple BY_POSITION tokens.

Responsibilities

Argument Description Notes
 ACCOUNTING Found on bookkeeper. Position will use Record Keeper skill to keep track of stocks.
 ATTACK_ENEMIES Found on elven ranger captain and human warrior. Effect unknown.[Verify]
 BUILD_MORALE Found on champion. Citizens get a special thought for "talking to a pillar of society" when speaking to this noble.
 COLLECT_TAXES Found on tax collector. Position goes around and collects the tax money from the populace, under armed escort. Only functions if the dwarven economy is active, which never happens.
 EQUIPMENT_MANIFESTS Originally found on arsenal dwarf. Position will keep track of assigned weapons and equipment. Has no effect.
 ESCORT_TAX_COLLECTOR Found on hammerer. Position serves as one of the tax collector's bodyguards during his rounds. Only functions if the dwarven economy is active, which never happens.
 ESTABLISH_COLONY_TRADE_AGREEMENTS Found on outpost liaison. Position will live in the civilization capital and travels to make trade agreements with its colonies.
 EXECUTIONS Found on hammerer. Position executes death penalties with a weapon of the appropriate skill.
 HEALTH_MANAGEMENT Found on chief medical dwarf. Position will use Diagnostician skill enable the z-menu health screen.
 LAW_ENFORCEMENT Found on sheriff/captain of the guard. Position and its subordinates are in charge of punishing criminals.
 LAW_MAKING Found on monarch/landholders. Seems to allow position to receive elf and human diplomats.[Verify]
 MAKE_INTRODUCTIONS Found on diplomat. Allows Elves to make "first contact".
 MAKE_PEACE_AGREEMENTS Found on diplomat. Position negotiates peace treaties in order to end wars.
 MAKE_TOPIC_AGREEMENTS Found on diplomat. Position negotiates special agreements such as tree cutting quotas.
 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.
 MEET_WORKERS Found on expedition leader/mayor. Position holds meetings with unhappy citizens and tries to pacify them with happy thoughts.
 MILITARY_GOALS Found on monarch/landholder/leaders. Effect unknown.[Verify]
 MILITARY_STRATEGY Found on general/militia commander. During worldgen, position will go on expeditions to tame exotic creatures.[Verify]
 PATROL_TERRITORY Found on elven ranger captain and human warrior. Effect unknown.[Verify]
 RECEIVE_DIPLOMATS Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats and liaisons.
 RELIGION Found on elven druid. Position informs you about worship cults[Verify]
 SORT_AMMUNITION Originally found on arsenal dwarf. Position approves changes to ammunition settings in the military screen. Has current effect.
 TAME_EXOTICS Originally found on dungeon master. Position enables taming exotic creatures and does forge work. Removed with the animal training overhaul in 0.34.06. Has no current effect.
 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, the position will arrive with the caravan to make trade agreements.
 UPGRADE_SQUAD_EQUIPMENT Originally found on arsenal dwarf. Position approves changes to assigned squad equipment in the military screen. Has current effect.

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:

Token Arguments Description
 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.
 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 counterintuitive 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.

Retrieved from "https://dwarffortresswiki.org/index.php?title=v0.34:Position_token&oldid=315714"