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 v0.31: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.
You are editing a page for an older version of Dwarf Fortress ("Main" is the current version, not "v0.31"). Please make sure you intend to do this. If you are here by mistake, see the current page instead.
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: | ||
− | + | {{av}} | |
− | These tokens define positions in entity_*.txt files. See | + | These tokens define positions in entity_*.txt files. See {{l|Entity token}}. |
==Position Tokens== | ==Position Tokens== | ||
These tokens belong in an entity definition. These tokens apply to a position (such as monarch, dungeon master, etc) and should follow the [POSITION:POSITION_NAME] token. | These tokens belong in an entity definition. These tokens apply to a position (such as monarch, dungeon master, etc) and should follow the [POSITION:POSITION_NAME] token. | ||
{| {{prettytable}} | {| {{prettytable}} | ||
− | |- bgcolor="# | + | |- bgcolor="#ddd" |
! Token | ! Token | ||
! Arguments | ! Arguments | ||
! Description | ! Description | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 57: | Line 42: | ||
|- | |- | ||
| DEMAND_MAX | | DEMAND_MAX | ||
− | | number | + | | number |
| How many demands at one time the position can make of the population. | | How many demands at one time the position can make of the population. | ||
Line 93: | Line 78: | ||
| GENDER | | GENDER | ||
| | | | ||
− | *MALE | + | *MALE |
+ | *FEMALE | ||
| The position can only be held by specified gender. | | The position can only be held by specified gender. | ||
Line 113: | Line 99: | ||
|- | |- | ||
| MANDATE_MAX | | MANDATE_MAX | ||
− | | number | + | | number |
| The maximum number of mandates the position can make at once. | | The maximum number of mandates the position can make at once. | ||
Line 119: | Line 105: | ||
| MENIAL_WORK_EXEMPTION | | MENIAL_WORK_EXEMPTION | ||
| | | | ||
− | | The position cannot be assigned labours, and will generally just lounge around like nobles do. | + | | The position cannot be assigned labours, and will generally just lounge around like nobles do. |
|- | |- | ||
| MENIAL_WORK_EXEMPTION_SPOUSE | | MENIAL_WORK_EXEMPTION_SPOUSE | ||
| | | | ||
− | | The | + | | The lover of the position holder doesn't have to work, either. |
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 140: | Line 121: | ||
| 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] | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| NUMBER | | NUMBER | ||
| | | | ||
− | * 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. | | How many of the position there should be. If the [SITE] token exists, this is per site, otherwise this is per civilisation. | ||
|- | |- | ||
| PRECEDENCE | | PRECEDENCE | ||
− | | number | + | | number |
− | | How important the position is in society; a lower number is more important. For MONARCH it's 1, for MILITIA_CAPTAIN it's 200. | + | | How important the position is in society; a lower number is more important. For MONARCH it's 1, for MILITIA_CAPTAIN it's 200. Unknown if it accepts values greater than 200.{{verify}} |
|- | |- | ||
| PUNISHMENT_EXEMPTION | | PUNISHMENT_EXEMPTION | ||
| | | | ||
− | | The position holder will not be held accountable for his or her crimes | + | | The position holder will not be held accountable for his or her crimes. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 184: | Line 146: | ||
|- | |- | ||
| REQUIRED_BEDROOM | | REQUIRED_BEDROOM | ||
− | | number | + | | number |
| The position holder requires a bedroom with at least this value. | | The position holder requires a bedroom with at least this value. | ||
|- | |- | ||
| REQUIRED_BOXES | | REQUIRED_BOXES | ||
− | | number | + | | number |
| The position holder requires at least this many boxes. | | The position holder requires at least this many boxes. | ||
|- | |- | ||
| REQUIRED_CABINETS | | REQUIRED_CABINETS | ||
− | | number | + | | number |
| The position holder requires at least this many cabinets. | | The position holder requires at least this many cabinets. | ||
|- | |- | ||
| REQUIRED_DINING | | REQUIRED_DINING | ||
− | | number | + | | number |
| 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 | | REQUIRED_OFFICE | ||
− | | number | + | | number |
| The position holder requires an office with at least this value. | | The position holder requires an office with at least this value. | ||
|- | |- | ||
| REQUIRED_RACKS | | REQUIRED_RACKS | ||
− | | number | + | | number |
| The position holder requires at least this many weapon racks. | | The position holder requires at least this many weapon racks. | ||
|- | |- | ||
| REQUIRED_STANDS | | REQUIRED_STANDS | ||
− | | number | + | | number |
| The position holder requires at least this many armour stands. | | The position holder requires at least this many armour stands. | ||
|- | |- | ||
| REQUIRED_TOMB | | REQUIRED_TOMB | ||
− | | number | + | | number |
| The position holder requires a tomb with at least this value. | | The position holder requires a tomb with at least this value. | ||
Line 230: | Line 192: | ||
| RESPONSIBILITY | | RESPONSIBILITY | ||
| responsibility | | responsibility | ||
− | | See the table below for the | + | | See the table below for the avaiable responsibility tokens. E.g. [RESPONSIBILITY:TAME_EXOTICS] |
|- | |- | ||
Line 245: | Line 207: | ||
| 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.{{verify}} |
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| SPOUSE_FEMALE | | SPOUSE_FEMALE | ||
| singular:plural | | singular:plural | ||
− | | | + | | The name of the position holder's spouse if they're female. |
|- | |- | ||
| SPOUSE_MALE | | SPOUSE_MALE | ||
| singular:plural | | singular:plural | ||
− | | | + | | The name of the position holder's spouse if they're male. |
|- | |- | ||
Line 270: | Line 227: | ||
| SUCCESSION | | SUCCESSION | ||
| | | | ||
− | * BY_HEIR | + | * BY_HEIR |
+ | * BY_POSITION:position | ||
| How a new position holder is chosen. | | How a new position holder is chosen. | ||
Line 277: | Line 235: | ||
== Responsibilities == | == Responsibilities == | ||
{| {{prettytable}} | {| {{prettytable}} | ||
− | |- bgcolor="# | + | |- bgcolor="#ddd" |
! Argument | ! Argument | ||
! Description | ! Description | ||
Line 295: | Line 253: | ||
|- | |- | ||
| COLLECT_TAXES | | COLLECT_TAXES | ||
− | | Found on tax collector. | + | | Found on tax collector. Effect{{verify}} |
|- | |- | ||
Line 303: | Line 261: | ||
|- | |- | ||
| ESCORT_TAX_COLLECTOR | | ESCORT_TAX_COLLECTOR | ||
− | | Found on hammerer. Position will | + | | Found on hammerer. Position will accompiany the COLLECT_TAXES position{{verify}} |
|- | |- | ||
Line 331: | Line 289: | ||
|- | |- | ||
| MAKE_PEACE_AGREEMENTS | | MAKE_PEACE_AGREEMENTS | ||
− | | Found on diplomat. | + | | Found on diplomat. Required for a civilisation to end a war{{verify}} |
|- | |- | ||
| MAKE_TOPIC_AGREEMENTS | | MAKE_TOPIC_AGREEMENTS | ||
− | | Found on diplomat. | + | | Found on diplomat. Effect{{verify}} |
|- | |- | ||
Line 343: | Line 301: | ||
|- | |- | ||
| MEET_WORKERS | | MEET_WORKERS | ||
− | | Found on expedition leader/mayor. Dwarves want one of these around to complain to | + | | Found on expedition leader/mayor. Dwarves want one of these around to complain to{{verify}} |
|- | |- | ||
Line 351: | Line 309: | ||
|- | |- | ||
| MILITARY_STRATEGY | | MILITARY_STRATEGY | ||
− | | Found on general/militia commander. | + | | Found on general/militia commander. They tame the creatures of the depths for military use.{{verify}} |
|- | |- | ||
Line 363: | Line 321: | ||
|- | |- | ||
| RELIGION | | RELIGION | ||
− | | Found on elven druid. | + | | Found on elven druid. Effect{{verify}} |
|- | |- | ||
Line 371: | Line 329: | ||
|- | |- | ||
| TAME_EXOTICS | | TAME_EXOTICS | ||
− | | Found on dungeon master. Position will tame creatures with the [PET_EXOTIC] token | + | | Found on dungeon master. Position will tame creatures with the [PET_EXOTIC] token. |
|- | |- | ||
| TRADE | | TRADE | ||
− | | Found on broker. Position will trade at the depot when set to broker only | + | | Found on broker. Position will trade at the depot when set to broker only. |
|- | |- | ||
| UPGRADE_SQUAD_EQUIPMENT | | UPGRADE_SQUAD_EQUIPMENT | ||
| Found on arsenal dwarf. Effect{{verify}} | | Found on arsenal dwarf. Effect{{verify}} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
Line 415: | Line 348: | ||
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 his required number of dwarves. | + | '''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.''' | 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.''' |