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.

Editing Position token

Jump to navigation Jump to search

Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.

If you are creating a redirect to the current version's page, do not use any namespace. For example: use #REDIRECT [[Cat]], not #REDIRECT [[Main:Cat]] or #REDIRECT [[cv:Cat]]. See DF:Versions for more information.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
{{Quality|Fine}}
+
{{quality|unrated}}{{av}}
{{av}}
+
These tokens define positions in entity_*.txt files. See [[Entity token]].
{{Modding}}
+
==Position Tokens==
Position tokens define [[noble]] positions for [[dwarf fortress mode|Dwarf Fortress mode]]. They are defined inside [[Entity token]]s. In the vanilla game, position token definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_entities\objects\entity_default.txt</code>.
 
 
 
__TOC__
 
{{clear}}
 
 
 
==Code==
 
A position is defined with a position 'code', as argument in de [POSITION]-tag. The same code may be used multiple times, they don't have to be unique. This code is used as reference by APPOINTED_BY, SUCCESSION:BY_POSITION, REPLACE_BY and COMMANDER. 'MONARCH' is an example of this code.
 
 
 
==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.
 
These tokens belong in an entity definition. These tokens apply to a position (such as monarch) and should follow the [POSITION:POSITION_NAME] token.
  
Line 20: Line 11:
  
 
|-
 
|-
| {{text anchor|ACCOUNT_EXEMPT}}
+
| ACCOUNT_EXEMPT
 
|
 
|
| The position holder is not subjected to the [[Dwarven economy|economy]]. Less than relevant right now.
+
| The position holder is not subjected to the economy. Less than relevant right now.
  
 
|-
 
|-
| {{text anchor|ALLOWED_CLASS}}
+
| ALLOWED_CLASS
| {{token|CREATURE_CLASS|creature}} token
+
| CREATURE_CLASS Token
| Only creatures with the specified class token can be appointed to this position. Multiple entries are allowed
+
| Only creatures with the specified class token can be appointed to this position.
  
 
|-
 
|-
| {{text anchor|ALLOWED_CREATURE}}
+
| ALLOWED_CREATURE
 
| CREATURE:CASTE
 
| CREATURE:CASTE
| Restricts the position to only the defined [[caste]]. Multiple entries are allowed. Only works with a caste of the entity's current race. It does not prevent other creature-types to gain that position, at least not in world-gen.
+
| 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}}
+
| APPOINTED_BY
 
| position
 
| position
| This position can only be chosen for 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. Multiple entries are allowed. If you have neither an ELECTED-token nor a APPOINTED_BY-token, the holder may always be changed (like the expedition leader). Read more: [[Advanced_Entity_Position_Mechanics#Appointment]]
+
| 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}}
+
| BRAG_ON_KILL
 
|  
 
|  
| A creature that kills a member of 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.
  
 
|-
 
|-
| {{text anchor|CHAT_WORTHY}}
+
| CHAT_WORTHY
 
|  
 
|  
| In adventure mode, when referencing locations, an NPC may mention this position holder living there or having done some deed there, it also means that the position exists in world-gen, rather than being created only at the end of world-gen.
+
| 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
Before 47.05, Dark Fortress civs cannot have this tag on anybody but their Law Maker, or the game will crash without leaving an errorlog.
 
  
 
|-
 
|-
| {{text anchor|COLOR}}
+
| COLOR
 
| color
 
| color
| Creatures of this position will have this color, instead of their profession color, e.g. [COLOR:5:0:1]. It is also applied to the name of the citizen in the units-screen.
+
| Creatures of this position will have this color, instead of their profession color. e.g. [COLOR:5:0:1]
  
 
|-
 
|-
| {{text anchor|COMMANDER}}
+
| 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. Multiple entries are allowed
+
| 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}}
+
| CONQUERED_SITE
 
|  
 
|  
| This position is a puppet ruler left behind in a conquered site.
+
| This position is the puppet ruler left behind on a conquered site.
  
 
|-
 
|-
| {{text anchor|DEMAND_MAX}}
+
| DEMAND_MAX
 
| number (0-100)
 
| number (0-100)
| How many demands the position can make of the population at one time.
+
| How many demands at one time the position can make of the population.
  
 
|-
 
|-
| {{text anchor|DETERMINES_COIN_DESIGN}}
+
| DETERMINES_COIN_DESIGN
 
|  
 
|  
| The site's (or civ's) minted [[coin]]s, if any, will have images that reflect the personality of this position holder.
+
| Minted coins will have images that reflect the personality of this position holder.
  
 
|-
 
|-
| {{text anchor|DO_NOT_CULL}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|DUTY_BOUND}}
+
| DUTY_BOUND
 
|  
 
|  
| Members of this position will never agree to 'join' your character during adventure mode. They also don't settle anywhere else but in the capital. If they are not DUTY_BOUND, they will live anywhere as they like.
+
| Members of this position will never agree to 'join' your character during adventure mode.
  
 
|-
 
|-
| {{text anchor|ELECTED}}
+
| ELECTED
 
|  
 
|  
| The population will periodically select the most skill-eligible creature to fill this position for site-level positions at the player's fort. For responsibilities or positions that use more than one skill, no skill takes priority in electing a creature: an accomplished comedian is more qualified for the TRADE responsibility than a skilled appraiser. A creature may be elected to multiple positions at the same time. Contrast [APPOINTED_BY]. More info: [[Elections]]. Read more: [[Advanced_Entity_Position_Mechanics#Elections]]
+
| The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY].
  
 
|-
 
|-
| {{text anchor|EXECUTION_SKILL}}
+
| EXECUTION_SKILL
 
| weapon skill
 
| weapon skill
| A mandatory sub-tag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for their work.
+
| A mandatory subtag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for his work.
  
 
|-
 
|-
| {{text anchor|EXPORTED_IN_LEGENDS}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|FLASHES}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|GENDER}}
+
| GENDER
 
| male/female
 
| male/female
| The position can only be held by the specified gender. Currently bugged {{bug|2714}}
+
| The position can only be held by specified gender.
  
 
|-
 
|-
| {{text anchor|KILL_QUEST}}
+
| KILL_QUEST
 
|  
 
|  
 
| The position can assign quests to adventurers.
 
| The position can assign quests to adventurers.
  
 
|-
 
|-
| {{text anchor|LAND_HOLDER}}
+
| LAND_HOLDER
| importance tier (1-10)
+
| 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 permanently to a particular site but also operates at the civ-level. Since 50* modded levels of higher than 3 are possbile.
+
| 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 wealth requirements to have them, which is set by the number.  The character is tied permanantly to a particular site but also operates at the civ-level.
Read more: [[Advanced_Entity_Position_Mechanics#land holder]]
 
  
 
|-
 
|-
| {{text anchor|LAND_NAME}}
+
| 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]. If the position is not a [[LAND_HOLDER]], the land_name is still displayed left of the position in the nobles menu.
+
| 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}}
+
| MANDATE_MAX
 
| number (0-100)
 
| number (0-100)
 
| The maximum number of mandates the position can make at once.
 
| The maximum number of mandates the position can make at once.
  
 
|-
 
|-
| {{text anchor|MENIAL_WORK_EXEMPTION}}
+
| MENIAL_WORK_EXEMPTION
 
|  
 
|  
| The position holder cannot be assigned labors. Currently nonfunctional.{{bug|3721}}
+
| The position cannot be assigned labours, and will generally just lounge around like nobles do. Currently does not actually work. {{bug|3721}}
  
 
|-
 
|-
| {{text anchor|MENIAL_WORK_EXEMPTION_SPOUSE}}
+
| MENIAL_WORK_EXEMPTION_SPOUSE
 
|  
 
|  
| The spouse of the position holder doesn't have to work, either - see above.
+
| The spouse of the position holder doesn't have to work, either. Also doesn't work either. {{bug|3721}}
 +
 
 
|-
 
|-
| {{text anchor|MILITARY_SCREEN_ONLY}}
+
| MILITARY_SCREEN_ONLY
 
|
 
|
| This position cannot be appointed from the nobles screen. Intended for militia captains and other squad leaders to reduce clutter. Currently nonfunctional{{bug|8965}}
+
| This position can not be appointed from the nobles screen. Intended for militia captains and other squad leaders to reduce clutter.
  
 
|-
 
|-
| {{text anchor|NAME}}
+
| NAME
 
| singular:plural
 
| singular:plural
 
| The name of the position.
 
| The name of the position.
  
 
|-
 
|-
| {{text anchor|NAME_MALE}}
+
| 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]
  
 
|-
 
|-
| {{text anchor|NAME_FEMALE}}
+
| 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]
  
 
|-
 
|-
| {{text anchor|DESCRIPTION}}
+
| NUMBER
|
 
| description of this position in the nobles screen.
 
 
 
|-
 
| {{text anchor|NUMBER}}
 
 
|  
 
|  
 
* number/AS_NEEDED
 
* 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. AS_NEEDED applies mainly to positions involved with the military command chain; this is used to allow armies to expand to whatever size they need to be. Other non-military positions like the land_holders or the [[messenger]] with NUMBER:AS_NEEDED will also be appointed.
+
| How many of the position there should be. If the [SITE] token exists, this is per site, otherwise this is per civilisation.
The problem with [[Lieutenant]]s and [[Captain]]s not been created, is their AS_NEEDED number. They are only then created when the're needed, and that has some pretty unusual conditions. When a fixed number is used, they are appointed with the creation of the civ.
 
If the NUMBER is set at a fixed value higher than 1, the position is always filled up full. If the position is available on embark, it is completely filled up with only the first dwarf.  
 
  
 
|-
 
|-
| {{text anchor|PRECEDENCE}}
+
| PRECEDENCE
| number (0-30000)/NONE
+
| 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. The game just assumes that anything with [PRECEDENCE:1] is the ruler, for both embark screen and mountainhome purposes. A civ-position will also be created without precedence. Positions may have the same precedence and will be appointed, although the effect is unknown.  
+
| 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}}
+
| PUNISHMENT_EXEMPTION
 
|  
 
|  
| The position holder will not be held accountable for his or her crimes. Currently nonfunctional.{{bug|4589}}{{verify|seems to prevent punishment when they are convicted of actual crime}}
+
| The position holder will not be held accountable for his or her crimes. Does not appear to work. {{bug|4589}}
  
 
|-
 
|-
| {{text anchor|QUEST_GIVER}}
+
| QUEST_GIVER
 
|
 
|
| The position holder can give quests in Adventure 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.
  
 
|-
 
|-
| {{text anchor|REJECTED_CLASS}}
+
| REJECTED_CLASS
 
| CREATURE_CLASS Token
 
| CREATURE_CLASS Token
| Creatures of the specified class cannot be appointed to this position. Multiple entries are allowed
+
| Creatures of the specified class cannot be appointed to this position.
  
 
|-
 
|-
| {{text anchor|REJECTED_CREATURE}}
+
| REJECTED_CREATURE
 
| CREATURE:CASTE
 
| CREATURE:CASTE
| Restricts position holders by CREATURE type. Multiple entries are allowed. It doesn't seem to work in world-gen. When checking Legends mode, units are seen assigned this position regardless of their creature-type or caste. It does work in Fortress mode.
+
| Restricts position holders by CREATURE type.
  
 
|-
 
|-
| {{text anchor|REPLACED_BY}}
+
| REPLACED_BY
 
| position
 
| position
| This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR]. Only a single entry is allowed.
+
| This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR].
  
 
|-
 
|-
| {{text anchor|REQUIRED_BEDROOM}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|REQUIRED_BOXES}}
+
| 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 boxes.
  
 
|-
 
|-
| {{text anchor|REQUIRED_CABINETS}}
+
| 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 cabinets.
  
 
|-
 
|-
| {{text anchor|REQUIRED_DINING}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|REQUIRED_OFFICE}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|REQUIRED_RACKS}}
+
| 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 racks.
  
 
|-
 
|-
| {{text anchor|REQUIRED_STANDS}}
+
| 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 armour stands.
  
 
|-
 
|-
| {{text anchor|REQUIRED_TOMB}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|REQUIRES_MARKET}}
+
| REQUIRES_POPULATION
|
 
| Does not have anything directly to do with markets.  It means that in minor sites (such as hillocks) the position will not appear, while in major sites (such as dwarf fortresses) it will.
 
 
 
|-
 
| {{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.
  
 
|-
 
|-
| {{text anchor|RESPONSIBILITY}}
+
| RESPONSIBILITY
 
| responsibility
 
| responsibility
| The position holder does a thing. See the table below for suitable arguments. A position does not need to have a responsibility.
+
| The position holder does a thing. See the table below for suitable arguments.
  
 
|-
 
|-
| {{text anchor|RULES_FROM_LOCATION}}
+
| RULES_FROM_LOCATION
 
|  
 
|  
| If there is a special location set aside for rulers, such as a human castle/mead hall, the position holder will always be found at that particular location. Does nothing for dwarven nobles, because at present, dwarves have no such special locations.  
+
| 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.
  
 
|-
 
|-
| {{text anchor|SITE}}
+
| 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.  
+
| The civilisation will attempt to have this position separate for each site.
  
 
|-
 
|-
| {{text anchor|SLEEP_PRETENSION}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|SPECIAL_BURIAL}}
+
| 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}}
+
| 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}}
  
 
|-
 
|-
| {{text anchor|SPOUSE}}
+
| SPOUSE
 
| singular:plural
 
| singular:plural
 
| The name of the position holder's spouse.
 
| The name of the position holder's spouse.
  
 
|-
 
|-
| {{text anchor|SPOUSE_FEMALE}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|SPOUSE_MALE}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|SQUAD}}
+
| SQUAD
 
| number:singular:plural
 
| number:singular:plural
| The position holder is authorized to form a military squad, led by themselves using the [[leader]] and [[military tactics]] skills. 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.
+
| 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}}
  
 
|-
 
|-
| {{text anchor|SUCCESSION}}
+
| SUCCESSION
 
|  
 
|  
 
* BY_HEIR / BY_POSITION:position
 
* BY_HEIR / BY_POSITION:position
| How a new position holder is chosen. A single position can have multiple BY_POSITION tokens.  See [[Noble]] for more information on how succession is handled in the game.
+
| How a new position holder is chosen. A single position can have multiple BY_POSITION tokens.
The SUCCESSION-Tag is also considered when a new positions opens up, for example when a required populationnumber is reached. If a valid successor is available, he will be the one taking that position initially, without appointment or election.
 
  
 
|}
 
|}
Line 312: Line 289:
 
! Argument
 
! Argument
 
! Description
 
! Description
 +
! Notes
  
 
|-
 
|-
| {{text anchor|ACCOUNTING}}
+
| 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.
 
 
|-
 
| {{text anchor|ADVISE_LEADERS}}
 
|
 
 
 
|-
 
| {{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|BUILDING_SAFETY}}
 
|
 
 
 
|-
 
| {{text anchor|COLLECT_TAXES}}
 
| Currently unused - was originally assigned to the tax collector.
 
 
 
|-
 
| {{text anchor|CONSTRUCTION_PERMITS}}
 
|
 
 
 
|-
 
| {{text anchor|DELIVER_MESSAGES}}
 
| Found on [[messenger]]. Position travels to other sites and uses [[social skill]]s.
 
|
 
 
 
  
 
|-
 
|-
| {{text anchor|EQUIPMENT_MANIFESTS}}
+
| ATTACK_ENEMIES
| Currently unused - was originally assigned to the arsenal dwarf.
+
| Found on elven ranger captain and human warrior. Effect unknown.{{verify}}
  
 
|-
 
|-
| {{text anchor|ESCORT_TAX_COLLECTOR}}
+
| BUILD_MORALE
| Currently unused - was originally assigned to the Royal Guards (squad members beneath the Hammerer).
+
| Found on champion. Position will lead military training exercises.{{verify}}
  
 
|-
 
|-
| {{text anchor|ESPIONAGE}}
+
| COLLECT_TAXES
| Found on [[dungeon master]] and [[General|princess]] and uses the [[schemer]] skill.
+
| Found on tax collector. Position goes around and collects the tax money from the populace, under armed escort.
 +
| Removed in version 0.31 along with the dwarven [[economy]]. Has no current effect.
  
 
|-
 
|-
| {{text anchor|ESTABLISH_COLONY_TRADE_AGREEMENTS}}
+
| EQUIPMENT_MANIFESTS
| Found on [[outpost liaison]]. Position travels with the caravan and uses [[social skill]]s 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 its position. They arrive the same time as the caravan arrive and this can thus be modded by setting [[Entity_token#ACTIVE_SEASON]]
+
| Found on arsenal dwarf. Position will keep track of assigned weapons and equipment.
 +
| Removed in version 31.10. Has no effect.
  
 
|-
 
|-
| {{text anchor|EXECUTIONS}}
+
| ESCORT_TAX_COLLECTOR
| Found on [[hammerer]]. Position executes death penalty judgements with a weapon of the appropriate skill. Cannot be combined with LAW_ENFORCEMENT, resulting in the "Invalid Officer"-error.
+
| Found on hammerer. Position serves as one of the tax collector's bodyguards during his rounds.
 +
| Removed in version 0.31 along with the tax collector. Has no current effect.
  
 
|-
 
|-
| {{text anchor|FIRE_SAFETY}}
+
| ESTABLISH_COLONY_TRADE_AGREEMENTS
|
+
| Found on outpost liaison. Position will live in the civilization capital and travels with the caravan to make trade agreements with any settlements that it visits, whether they are domestic or foreign.  Presumably has no effect at site level.
  
 
|-
 
|-
| {{text anchor|FOOD_SUPPLY}}
+
| EXECUTIONS
 +
| Found on hammerer. Position executes death penalties with a weapon of the appropriate skill.
 
|
 
|
  
 
|-
 
|-
| {{text anchor|HEALTH_MANAGEMENT}}
+
| HEALTH_MANAGEMENT
| Found on [[chief medical dwarf]]. Position will use [[diagnostician]] skill to enable the {{key|z}}-menu health screen.
+
| Found on chief medical dwarf. Position will use Diagnostician skill enable the {{key|z}}-menu health screen.
 
 
|-
 
| {{text anchor|JUDGE}}
 
 
|
 
|
  
 
|-
 
|-
| {{text anchor|LAW_ENFORCEMENT}}
+
| LAW_ENFORCEMENT
| Found on [[sheriff]]/[[captain of the guard]]. Position and its subordinates are in charge of punishing criminals. A [SITE] 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. Cannot be combined with EXECUTIONS, resulting in the "Invalid Officer"-error.
+
| 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}}
+
| 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.
 
| 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|MAINTAIN_BRIDGES}}
+
| MAKE_INTRODUCTIONS
|
+
| Informs settlements it visits as to the situation in the wider world as relating their civilizationPresumably has no effect at site level.
 
 
|-
 
| {{text anchor|MAINTAIN_ROADS}}
 
|
 
 
 
|-
 
| {{text anchor|MAINTAIN_SEWERS}}
 
|
 
 
 
|-
 
| {{text anchor|MAINTAIN_TUNNELS}}
 
|
 
 
 
|-
 
| {{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}}
+
| 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.
  
 
|-
 
|-
| {{text anchor|MAKE_TOPIC_AGREEMENTS}}
+
| MAKE_TOPIC_AGREEMENTS
| Found on diplomat. Position negotiates special agreements, such as tree cutting quotas. Used when elevating a settlement in the LAND_HOLDER chain up from level 1.
+
| Found on diplomat. Position negotiates special agreements such as tree cutting quotas.
 
 
|-
 
| {{text anchor|MANAGE_ANIMALS}}
 
| Found on [[dungeon master]].
 
 
 
|-
 
| {{text anchor|MANAGE_LEADER_HOUSEHOLD_CLEANLINESS}}
 
|
 
 
 
|-
 
| {{text anchor|MANAGE_LEADER_HOUSEHOLD_DRINKS}}
 
|
 
 
 
|-
 
| {{text anchor|MANAGE_LEADER_HOUSEHOLD_FOOD}}
 
|
 
 
 
|-
 
| {{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}}
+
| MANAGE_PRODUCTION
| Found on expedition leader/mayor. Position uses the various [[social skill]]s to hold meetings with unhappy citizens and try to pacify them with happy thoughts. In adventure mode, [SITE] positions with this responsibility handle petitions to make the player a performer for the local government.
+
| 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|MILITARY_GOALS}}
+
| MEET_WORKERS
| 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 its 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 [[kobold]]s, presumably due to either the SKULKING or the UTTERANCES tokens. If no position has this responsibility in fortress mode, players are unable to start [[missions]].
+
| Found on expedition leader/mayor. Position holds meetings with unhappy citizens and tries to pacify them with happy thoughts.
  
 
|-
 
|-
| {{text anchor|MILITARY_STRATEGY}}
+
| MILITARY_GOALS
| Found on [[general]]/[[militia commander]]. Means that they will command the armies of their site or civilization. Issues the orders for the teams conducting raids or other operations away from the fortress. During worldgen, position will go on expeditions to tame exotic creatures. Counterintuitively not by the TAME_EXOTICS-position. The destinations of these expeditions are determined by the entities USE_(...)_ANIMALS-tokens.  
+
| 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 site's will wage war on eachother constantly, as a result all civilization with diplomatic relations 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|OVERSEE_LEADER_HOUSEHOLD}}
+
| 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}}
+
| PATROL_TERRITORY
 
| Found on elven ranger captain. Effect unknown.{{verify}}
 
| Found on elven ranger captain. Effect unknown.{{verify}}
  
 
|-
 
|-
| {{text anchor|PREPARE_LEADER_MEALS}}
+
| RECEIVE_DIPLOMATS
|
+
| Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats and liaisons.
 
 
|-
 
| {{text anchor|RECEIVE_DIPLOMATS}}
 
| Found on monarch/landholder/leaders. Position uses the various social skills to hold meetings with incoming diplomats and liaisons.
 
  
 
|-
 
|-
| {{text anchor|RELIGION}}
+
| RELIGION
| Found on elven [[druid]] and uses [[social skill]]s. Position informs you about worship cults{{verify}}
+
| Found on elven druid. Position informs you about worship cults{{verify}}
  
 
|-
 
|-
| {{text anchor|SORT_AMMUNITION}}
+
| SORT_AMMUNITION
| Currently unused - was originally assigned to the arsenal dwarf.
+
| Found on arsenal dwarf. Position approves changes to ammunition settings in the military screen.
 +
| Removed in version 31.10. Has no current effect.
  
 
|-
 
|-
| {{text anchor|TAME_EXOTICS}}
+
| TAME_EXOTICS
| Position will tame animals with the {{token|PET_EXOTIC}} token. Currently unused - was originally assigned to the dungeon master. Expeditions to tame exotic creatures will be done by the MILITARY_STRATEGY-position
+
| Found on dungeon master. Position enables taming exotic creatures and does forge work.
 +
| Defunct since version 0.31, removed with the animal training overhaul in 34.06. Has no current effect.
  
 
|-
 
|-
| {{text anchor|TRADE}}
+
| TRADE
| Found on [[broker]]. Position will use Appraisal skill to display value estimates and the various Social skills to trade at the depot. When applied to other civilizations, this position will arrive with the caravan to make trade agreements (like the Human Guild Representative from older versions) and behaves otherwise like the civ's own ESTABLISH_COLONY_TRADE_AGREEMENTS position holder. They arrive the same time as the caravan arrive and this can thus be modded by setting [[Entity_token#ACTIVE_SEASON]]
+
| 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.
  
 
|-
 
|-
| {{text anchor|UPGRADE_SQUAD_EQUIPMENT}}
+
| UPGRADE_SQUAD_EQUIPMENT
| Currently unused - was originally assigned to the arsenal dwarf.
+
| Found on arsenal dwarf. Position approves changes to assigned squad equipment in the military screen.
 +
| Removed in version 31.10. Has no current effect.
  
 
|}
 
|}
  
== Related tokens ==
+
== 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:
 
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:
  
Line 499: Line 411:
  
 
|-
 
|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
+
| LAND_HOLDER_TRIGGER
 
|
 
|
 
* landholder tier
 
* landholder tier
Line 508: Line 420:
  
 
|-
 
|-
| {{text anchor|VARIABLE_POSITIONS}}
+
| 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).
Line 514: Line 426:
 
|}
 
|}
  
== Why won't my positions appear? ==
+
== 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.
+
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.
 
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.
Line 521: Line 433:
 
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.
 
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 their 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.'''
+
'''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, they will offer to make you an official colony, which will allow you to select all positions for that LAND_HOLDER level. '''Each time they appear, 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.'''
 
 
 
If civ-positions are neither APPOINTED_BY nor ELECTED, they still will be filled.
 
  
Read more: [[Advanced_Entity_Position_Mechanics]]
+
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|Modding}}
 
{{Category|Tokens}}
 
{{Category|Tokens}}
[[ru:Position token]]
 

Please note that all contributions to Dwarf Fortress Wiki are considered to be released under the GFDL & MIT (see Dwarf Fortress Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following CAPTCHA:

Cancel Editing help (opens in new window)

Templates used on this page:

This page is a member of 2 hidden categories: