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|Fine|11:39, 18 May 2015 (UTC)}} |
{{av}} | {{av}} | ||
− | + | These tokens define positions in entity_*.txt files. See [[Entity token]]. | |
− | + | ==Position Tokens== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ==Position | ||
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 27: | Line 19: | ||
| {{text anchor|ALLOWED_CLASS}} | | {{text anchor|ALLOWED_CLASS}} | ||
| {{token|CREATURE_CLASS|creature}} 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. |
|- | |- | ||
| {{text anchor|ALLOWED_CREATURE}} | | {{text anchor|ALLOWED_CREATURE}} | ||
| CREATURE:CASTE | | CREATURE:CASTE | ||
− | | Restricts the position to only the defined [[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}} | | {{text anchor|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. | + | | 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. |
|- | |- | ||
Line 48: | Line 40: | ||
| | | | ||
| 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, it also means that the position exists in world-gen, rather than being created only at the end of world-gen. | ||
− | + | 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}} | | {{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]. |
|- | |- | ||
| {{text anchor|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. |
|- | |- | ||
Line 83: | Line 75: | ||
| {{text anchor|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. |
|- | |- | ||
| {{text anchor|ELECTED}} | | {{text anchor|ELECTED}} | ||
| | | | ||
− | | The population will periodically select the most skill-eligible creature to fill this position | + | | The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY]. |
|- | |- | ||
Line 117: | Line 109: | ||
|- | |- | ||
| {{text anchor|LAND_HOLDER}} | | {{text anchor|LAND_HOLDER}} | ||
− | | importance tier (1- | + | | 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. | + | | 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. |
− | |||
|- | |- | ||
| {{text anchor|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] |
|- | |- | ||
Line 159: | Line 150: | ||
| 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] | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 169: | Line 155: | ||
| | | | ||
* 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 | + | | 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}} | | {{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. |
|- | |- | ||
| {{text anchor|PUNISHMENT_EXEMPTION}} | | {{text anchor|PUNISHMENT_EXEMPTION}} | ||
| | | | ||
− | | The position holder will not be held accountable for his or her crimes. Currently nonfunctional.{{bug|4589 | + | | The position holder will not be held accountable for his or her crimes. Currently nonfunctional.{{bug|4589}} |
|- | |- | ||
Line 191: | Line 175: | ||
| {{text anchor|REJECTED_CLASS}} | | {{text anchor|REJECTED_CLASS}} | ||
| CREATURE_CLASS Token | | CREATURE_CLASS Token | ||
− | | Creatures of the specified class cannot be appointed to this position. | + | | Creatures of the specified class cannot be appointed to this position. |
|- | |- | ||
| {{text anchor|REJECTED_CREATURE}} | | {{text anchor|REJECTED_CREATURE}} | ||
| CREATURE:CASTE | | CREATURE:CASTE | ||
− | | Restricts position holders by CREATURE type | + | | Restricts position holders by CREATURE type. |
|- | |- | ||
| {{text anchor|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]. |
|- | |- | ||
Line 256: | Line 240: | ||
| {{text anchor|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. |
|- | |- | ||
Line 296: | Line 280: | ||
| {{text anchor|SQUAD}} | | {{text anchor|SQUAD}} | ||
| number:singular:plural | | number:singular:plural | ||
− | | The position holder is authorized to form a military squad, led by themselves | + | | 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. |
|- | |- | ||
Line 302: | Line 286: | ||
| | | | ||
* 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 | + | | How a new position holder is chosen. A single position can have multiple BY_POSITION tokens. |
− | |||
|} | |} | ||
Line 318: | Line 301: | ||
|- | |- | ||
− | | {{text anchor|ADVISE_LEADERS}} | + | | {{text anchor|ADVISE_LEADERS}}{{version|0.47.01}} |
| | | | ||
Line 330: | Line 313: | ||
|- | |- | ||
− | | {{text anchor|BUILDING_SAFETY}} | + | | {{text anchor|BUILDING_SAFETY}}{{version|0.47.01}} |
| | | | ||
Line 338: | Line 321: | ||
|- | |- | ||
− | | {{text anchor|CONSTRUCTION_PERMITS}} | + | | {{text anchor|CONSTRUCTION_PERMITS}}{{version|0.47.01}} |
− | |||
− | |||
− | |||
− | |||
− | |||
| | | | ||
− | |||
|- | |- | ||
Line 356: | Line 333: | ||
|- | |- | ||
− | | {{text anchor|ESPIONAGE}} | + | | {{text anchor|ESPIONAGE}}{{version|0.47.01}} |
− | | Found on [[dungeon master]] and [[General|princess]] | + | | Found on [[dungeon master]] and [[General|princess]]. |
|- | |- | ||
| {{text anchor|ESTABLISH_COLONY_TRADE_AGREEMENTS}} | | {{text anchor|ESTABLISH_COLONY_TRADE_AGREEMENTS}} | ||
− | | Found on [[outpost liaison]]. Position travels with the caravan | + | | 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 its position. |
|- | |- | ||
| {{text anchor|EXECUTIONS}} | | {{text anchor|EXECUTIONS}} | ||
− | | Found on [[hammerer]]. Position executes death penalty judgements with a weapon of the appropriate skill | + | | Found on [[hammerer]]. Position executes death penalty judgements with a weapon of the appropriate skill. |
|- | |- | ||
− | | {{text anchor|FIRE_SAFETY}} | + | | {{text anchor|FIRE_SAFETY}}{{version|0.47.01}} |
| | | | ||
|- | |- | ||
− | | {{text anchor|FOOD_SUPPLY}} | + | | {{text anchor|FOOD_SUPPLY}}{{version|0.47.01}} |
| | | | ||
Line 380: | Line 357: | ||
|- | |- | ||
− | | {{text anchor|JUDGE}} | + | | {{text anchor|JUDGE}}{{version|0.47.01}} |
| | | | ||
|- | |- | ||
| {{text anchor|LAW_ENFORCEMENT}} | | {{text anchor|LAW_ENFORCEMENT}} | ||
− | | Found on [[sheriff]]/[[captain of the guard]]. Position and its subordinates are in charge of punishing criminals. A | + | | 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. |
|- | |- | ||
Line 392: | Line 369: | ||
|- | |- | ||
− | | {{text anchor|MAINTAIN_BRIDGES}} | + | | {{text anchor|MAINTAIN_BRIDGES}}{{version|0.47.01}} |
| | | | ||
|- | |- | ||
− | | {{text anchor|MAINTAIN_ROADS}} | + | | {{text anchor|MAINTAIN_ROADS}}{{version|0.47.01}} |
| | | | ||
|- | |- | ||
− | | {{text anchor|MAINTAIN_SEWERS}} | + | | {{text anchor|MAINTAIN_SEWERS}}{{version|0.47.01}} |
| | | | ||
|- | |- | ||
− | | {{text anchor|MAINTAIN_TUNNELS}} | + | | {{text anchor|MAINTAIN_TUNNELS}}{{version|0.47.01}} |
| | | | ||
Line 417: | Line 394: | ||
|- | |- | ||
| {{text anchor|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. |
|- | |- | ||
− | | {{text anchor|MANAGE_ANIMALS}} | + | | {{text anchor|MANAGE_ANIMALS}}{{version|0.47.01}} |
| Found on [[dungeon master]]. | | Found on [[dungeon master]]. | ||
|- | |- | ||
− | | {{text anchor|MANAGE_LEADER_HOUSEHOLD_CLEANLINESS}} | + | | {{text anchor|MANAGE_LEADER_HOUSEHOLD_CLEANLINESS}}{{version|0.47.01}} |
| | | | ||
|- | |- | ||
− | | {{text anchor|MANAGE_LEADER_HOUSEHOLD_DRINKS}} | + | | {{text anchor|MANAGE_LEADER_HOUSEHOLD_DRINKS}}{{version|0.47.01}} |
| | | | ||
|- | |- | ||
− | | {{text anchor|MANAGE_LEADER_HOUSEHOLD_FOOD}} | + | | {{text anchor|MANAGE_LEADER_HOUSEHOLD_FOOD}}{{version|0.47.01}} |
| | | | ||
Line 441: | Line 418: | ||
|- | |- | ||
| {{text anchor|MEET_WORKERS}} | | {{text anchor|MEET_WORKERS}} | ||
− | | 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 | + | | 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. |
|- | |- | ||
| {{text anchor|MILITARY_GOALS}} | | {{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 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 | + | | 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. |
|- | |- | ||
| {{text anchor|MILITARY_STRATEGY}} | | {{text anchor|MILITARY_STRATEGY}} | ||
− | | 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. | + | | 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. Issues the orders for the teams conducting raids or other operations away from the fortress.{{version|0.44.01}} |
|- | |- | ||
− | | {{text anchor|OVERSEE_LEADER_HOUSEHOLD}} | + | | {{text anchor|OVERSEE_LEADER_HOUSEHOLD}}{{version|0.47.01}} |
| | | | ||
Line 460: | Line 437: | ||
|- | |- | ||
− | | {{text anchor|PREPARE_LEADER_MEALS}} | + | | {{text anchor|PREPARE_LEADER_MEALS}}{{version|0.47.01}} |
| | | | ||
Line 469: | Line 446: | ||
|- | |- | ||
| {{text anchor|RELIGION}} | | {{text anchor|RELIGION}} | ||
− | | Found on elven [[druid]] | + | | Found on elven [[druid]]. Position informs you about worship cults{{verify}} |
|- | |- | ||
Line 477: | Line 454: | ||
|- | |- | ||
| {{text anchor|TAME_EXOTICS}} | | {{text anchor|TAME_EXOTICS}} | ||
− | | Position will tame animals with the {{token|PET_EXOTIC}} token. Currently unused - was originally assigned to the dungeon master. | + | | Position will tame animals with the {{token|PET_EXOTIC}} token. Currently unused - was originally assigned to the dungeon master. |
|- | |- | ||
| {{text anchor|TRADE}} | | {{text anchor|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. | + | | 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. |
|- | |- | ||
Line 489: | Line 466: | ||
|} | |} | ||
− | == Related | + | == 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 514: | Line 491: | ||
|} | |} | ||
− | == Why | + | == 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 counter-intuitive and fairly limiting. This guide should help you understand what you can do to actually get your positions working properly. | ||
Line 521: | Line 498: | ||
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 | + | '''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.''' | 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.''' | ||
− | |||
− | |||
− | |||
− | |||
{{Category|Modding}} | {{Category|Modding}} | ||
{{Category|Tokens}} | {{Category|Tokens}} | ||
[[ru:Position token]] | [[ru:Position token]] |