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.
v0.31:Position token
Jump to navigation
Jump to search
| This article is about an older version of DF. |
These tokens define positions in entity_*.txt files.
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.
| Token | Arguments | Description |
|---|---|---|
| APPOINTED_BY | position | The position used as an argument selects creatures to fill the role in question. For example, the GENERAL is [APPOINTED_BY:MONARCH]. |
| BRAG_ON_KILL | A creature that kills this position will be sure to talk about it a lot. | |
| CHAT_WORTHY | Unknown.[Verify] | |
| COLOR | color | Creatures of this position will have this colour, instead of their profession colour. 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 will be available to creatures when the site has been taken over by another civilisation. | |
| DEMAND_MAX | number | How many demands at one time the position can make of the population. |
| DETERMINES_COIN_DESIGN | ||
| DO_NOT_CULL | The position won't be culled during world generation.[Verify] | |
| DUTY_BOUND | Unknown, but every position in the raws has it.[Verify] | |
| ELECTED | The population will periodically select the creature to fill this position. | |
| EXPORTED_IN_LEGENDS | The various members who have filled this role will be listed in the civilisation's history. | |
| FEMALE | Only a female creature can hold the position. | |
| FLASHES | The creature holding this position will flash on the display. | |
| KILL_QUEST | The position can assign quests to adventurers. | |
| LAND_HOLDER | number | The position will arrive when 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] |
| MALE | Only a male creature can hold the position. | |
| MANDATE_MAX | number | 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. | |
| MENIAL_WORK_EXEMPTION_SPOUSE | The lover of the position holder doesn't have to work, either. | |
| NAME | singular:plural | The name of the position. |
| 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] |
| 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] |
| NUMBER |
|
How many of the position there should be. If the [SITE] token exists, this is per site, otherwise this is per civilisation. |
| PRECEDENCE | 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. Unknown if it accepts values greater than 200.[Verify] |
| PUNISHMENT_EXEMPTION | The position holder will not be held accountable for his or her crimes. | |
| REPLACED_BY | position | For when one position is a lesser form of another. For example, expedition leader is [REPLACED_BY:MAYOR]. |
| REQUIRED_BEDROOM | number | The position holder requires a bedroom with at least this value. |
| REQUIRED_BOXES | number | The position holder requires at least this many boxes. |
| REQUIRED_CABINETS | number | The position holder requires at least this many cabinets. |
| REQUIRED_DINING | number | The position holder requires a dining room with at least this value. |
| REQUIRED_OFFICE | number | The position holder requires an office with at least this value. |
| REQUIRED_RACKS | number | The position holder requires at least this many weapon racks. |
| REQUIRED_STANDS | number | The position holder requires at least this many armour stands. |
| REQUIRED_TOMB | number | 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 | See the table below for the avaiable responsibility tokens. E.g. [RESPONSIBILITY:TAME_EXOTICS] |
| RULES_FROM_LOCATION | Unknown[Verify] | |
| 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.[Verify] | |
| SPOUSE_FEMALE | singular:plural | The name of the position holder's spouse if they're female. |
| SPOUSE_MALE | singular:plural | The name of the position holder's spouse if they're male. |
| SQUAD | number:singular:plural | The position holder will be accompanied by this many whatevers; e.g. for HAMMERER, [SQUAD:10:royal guard:royal guards] |
| SUCCESSION |
|
How a new position holder is chosen. |
Responsibilities
| Argument | Description |
|---|---|
| ACCOUNTING | Found on bookkeeper. Position will keep track of stocks. |
| ATTACK_ENEMIES | Found on elven ranger captain and human warrior. Effect[Verify] |
| BUILD_MORALE | Found on champion. Effect[Verify] |
| COLLECT_TAXES | Found on tax collector. Effect[Verify] |
| EQUIPMENT_MANIFESTS | Found on arsenal dwarf. Effect[Verify] |
| ESCORT_TAX_COLLECTOR | Found on hammerer. Position will accompiany the COLLECT_TAXES position[Verify] |
| ESTABLISH_COLONY_TRADE_AGREEMENTS | Found on outpost liaison. Position will make trade agreements with the civilisation's colonies. |
| EXECUTIONS | Found on hammerer. Position will deliver beatings for great justice. |
| HEALTH_MANAGEMENT | Found on chief medical dwarf. Enables the z menu health screen. Other effect[Verify] |
| LAW_ENFORCEMENT | Found on sheriff/captain of the guard. Position is in charge of imprisoning criminals. |
| LAW_MAKING | Found on monarch/landholders. Effect[Verify] |
| MAKE_INTRODUCTIONS | Found on diplomat. Effect[Verify] |
| MAKE_PEACE_AGREEMENTS | Found on diplomat. Required for a civilisation to end a war[Verify] |
| MAKE_TOPIC_AGREEMENTS | Found on diplomat. Effect[Verify] |
| MANAGE_PRODUCTION | Found on manager. Position will verify work orders. |
| MEET_WORKERS | Found on expedition leader/mayor. Dwarves want one of these around to complain to[Verify] |
| MILITARY_GOALS | Found on monarch/landholder/leaders. Effect[Verify] |
| MILITARY STRATEGY | Found on general/militia commander. Effect[Verify] |
| PATROL_TERRITORY | Found on elven ranger captain and human warrior. Effect[Verify] |
| RECEIVE_DIPLOMATS | Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats/liaisons. |
| RELIGION | Found on elven druid. Effect[Verify] |
| SORT_AMMUNITION | Found on arsenal dwarf. Effect[Verify] |
| TAME_EXOTICS | Found on dungeon master. Position will tame creatures with the [PET_EXOTIC] token. |
| TRADE | Found on broker. Position will trade at the depot when set to broker only. |
| UPGRADE_SQUAD_EQUIPMENT | Found on arsenal dwarf. Effect[Verify] |