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

From Dwarf Fortress Wiki
Revision as of 11:40, 30 April 2010 by Vattic (talk | contribs) (MALE token error)
Jump to navigation Jump to search
This article is about an older version of DF.

These tokens define positions in entity_*.txt files. See Template:L.

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. During world gen you get <ENTITY>:Unrecognized Entity Token: MALE in errorlog.txt
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
  • 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 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
  • BY_HEIR
  • BY_POSITION:position
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]