Dwarf Fortress Wiki - User contributions [en]

Counting house

2020-07-04T09:18:09Z

FortressBuilder:

{{Quality|Superior}}
{{av}}
{{new in|v0.47.01}}

A '''counting house''' is a structure built by a merchant company at a [[site]]. A single company might build multiple counting houses, some of which might be in the same site.

A counting house consists of several floors, with bins filled with goods on one, and a room with chairs and tables on another. Sometimes [[artifact]]s might be hidden at counting houses.

[[File:Df counting house.png|800px|thumb|center|The two levels of a counting house. The left is the lower storage floor, filled with bins. The right is the upper socialization area, filled with chairs.]]

== Merchant Company ==
A merchant company is a group of [[merchant]]s. In world generation, members of a merchant company will trade items between sites, as an expression of the underlying economy simulation. Currently, the primary purpose of merchant companies is to facilitate the interconnection between sites of different civilizations, and to ensure there are plenty of rich [[historical figure]]s that might buy properties in sites, build [[Tower_(structure)|fancy towers]], and fund all sorts of [[intrigue|schemes]]. In short, it is mostly invisible.

Merchant companies will have a leader position (named master or head), and may have an administrator (also named governor or factor) position with trade and record keeping responsibilities.

{{world}}
{{category|Economy}}
{{category|Locations}}

Entity token

2020-02-07T11:44:30Z

FortressBuilder: /* Behavior */ MINING_UNDERWORLD_DISASTERS

{{Quality|Exceptional|19:21, 13 October 2015 (UTC)}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ALL_MAIN_POPS_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, elves, and humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom entity can have a tier of 3000 and still work even if it's the only custom entity.

[ADVENTURE_TIER:4]

Removed in [[:Category:Version 0.42.01|Version 0.42.01]], effectively replaced by ALL_MAIN_POPS_CONTROLLABLE.

|-
| {{text anchor|INDIV_CONTROLLABLE}} / {{text anchor|OUTSIDER_CONTROLLABLE}}{{version|0.42.01}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

Removed in [[:Category:Version 0.42.01|Version 0.42.01]], in favor of the [[creature token]] OUTSIDER_CONTROLLABLE.

|-
| {{text anchor|SITE_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, then at embark the specific civs can be chosen by + or - on the civ list screen (by pressing TAB), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token. (Replaced in [[:Category:Version 0.42.01|0.42.01]] by SITE_CONTROLLABLE.)

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures. In entities with multiple possible creatures, you can manipulate the chance of one creature being chosen by adding multiple identical creature tags. For instance adding [CREATURE:DWARF][CREATURE:DWARF][CREATURE:DWARF][CREATURE:ELF] to the same entity will make the civs created about 75% dwarven, 25% elven.

|-
| {{text anchor|SOURCE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| The birth of the civilization can occur in this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| The birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, castles are currently controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing up on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]].
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max historical population '''per entity'''. Multiply this by max starting civ to get the total maximum historical population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token '''must''' be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the [[cv:coin|coin]].
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in these ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations are drawn randomly from all translation files. Multiple translation tags will only result in the last one being used.
* If GEN_DIVINE is entered, the entity will use a generated divine language, that is, the same language that is used for the names of [[angel]]s.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, BATTLE, BRIDGE, CIV, LIBRARY{{version|0.42.01}}, MILITARY_UNIT, RELIGION, ROAD, SIEGE, SITE, TEMPLE, TUNNEL, VESSEL, WALL, WAR
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be preferred as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens, also used when announcing arrival of their caravan. Defaults to 7:0:1.

[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can be any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere. Note that the DEATH sphere favours the appearance of necromancers (and therefore, towers) in the race.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

== Leadership ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress. As of version 0.44.11, however, this is obsolete due to the changes in how sites are elevated in status.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

== Behavior ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE; for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's [[personality trait|cultural values]]. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|VARIABLE_VALUE}}{{version|0.42.01}}
|
*value or ALL
*min
*max
| Makes values randomized rather than specified.
This tag overrides the VALUE tag. Using [VARIABLE_VALUE:ALL:x:y] and then overwriting single values with further [VARIABLE_VALUE:value:x:y] tags works.

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the defenders.

If the civ sends out mercenaries, they may come to the player's fort to enlist in the military.{{version|0.42.01}}

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| The season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading, sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest, and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in fortress mode has this tag (e.g. you add BABYSNATCHER to the dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you. However, animals traded away to one's own caravan will count as snatched, reported upon the animal leaving the map, and the animal will not count as having been exported.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s, and (unlike older versions) only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

Note: If the playable civ in Fortress Mode has this tag (e.g. you add ITEM_THIEF to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and kobolds will be friendly to you. However, ALL items traded away to one's own caravan will count as stolen, reported when the items leave the map, and the stolen items will not count as exported.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a land holder.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as [[bat man]] civilizations. May spawn in any of the three caverns, in groups of 5-10 soldiers who will hunt down nearby cavern creatures. If you embark as this civ, you have access to pets and trees from all three layers, not only the first.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|-
| {{text anchor|GENERATE_KEYBOARD_INSTRUMENTS}}, {{text anchor|GENERATE_PERCUSSION_INSTRUMENTS}}, {{text anchor|GENERATE_STRINGED_INSTRUMENTS}}, {{text anchor|GENERATE_WIND_INSTRUMENTS}}, {{text anchor|GENERATE_DANCE_FORMS}}, {{text anchor|GENERATE_MUSICAL_FORMS}}, {{text anchor|GENERATE_POETIC_FORMS}}{{version|0.42.01}}
|
| Makes civilizations generate the given instruments/forms.

|-
| {{text anchor|SCHOLAR}}{{version|0.42.01}}
| scholar type
| ALL, ASTRONOMER, CHEMIST, DOCTOR, ENGINEER, GEOGRAPHER, HISTORIAN, MATHEMATICIAN, NATURALIST, PHILOSOPHER

|-
| {{text anchor|SET_SCHOLARS_ON_VALUES_AND_JOBS}}{{version|0.42.01}}
|
| Generates scholars based on the values generated with the VARIABLE_VALUE tag.

|-
| {{text anchor|NO_ARTIFACT_CLAIMS}}{{version|0.44.01}}
|
| Used for kobolds.

|-
| {{text anchor|MINING_UNDERWORLD_DISASTERS}}{{version|0.47.02}}
|
| The civilization can breach the [[Underworld]] during world generation.

|}

== Available resources ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal. For those cases, listing the pick under the [WEAPON] token works just as well. Note that this tag is neither necessary nor sufficient to allow use of that item as a mining tool -- for that, the item itself needs to be a weapon with [SKILL:MINING].
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
| No longer used as of [[:Category:Version 0.42.01|Version 0.42.01]] due to the ability to generate instruments in world generation. It is still usable if pre-defined instruments are modded in, and generated musical forms are capable of selecting pre-defined instruments to use. However, reactions for making instruments, instrument parts, and/or assembling such instruments need to be added as well, as this token no longer adds such instruments to the craftdwarf's workshop menu.
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or [[:Category:DF2014:Exotic pet|PET_EXOTIC]] will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with [[:Category:DF2014:Mount|MOUNT]] or [[:Category:DF2014:Exotic mount|MOUNT_EXOTIC]]), or siege minion (with [[:Category:DF2014:War animals|TRAINABLE_WAR]] and ''without'' [[:Category:DF2014:Learns|CAN_LEARN]]). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with [[:Category:DF2014:Mount|MOUNT]] or [[:Category:DF2014:Exotic mount|MOUNT_EXOTIC]]), and siege minions (with [[:Category:DF2014:War animals|TRAINABLE_WAR]] and ''without'' [[:Category:DF2014:Learns|CAN_LEARN]]).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' [[:Category:DF2014:Learns|CAN_LEARN]] will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with [[:Category:DF2014:Mount|MOUNT]] or [[:Category:DF2014:Exotic mount|MOUNT_EXOTIC]]), and siege minions (with [[:Category:DF2014:War animals|TRAINABLE_WAR]] or SLOW_LEARNER), even the normally untameable species.

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' [[:Category:DF2014:Learns|CAN_LEARN]] will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with [[:Category:DF2014:Mount|MOUNT]] or [[:Category:DF2014:Exotic mount|MOUNT_EXOTIC]]), and siege minions (with [[:Category:DF2014:War animals|TRAINABLE_WAR]]), even the normally untameable species.

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|USE_NON_EXOTIC_PET_RACE}}{{version|0.47.01}}
|
| Makes the civilization use all locally available non-exotic pets.

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and [[:Category:DF2014:Mount|MOUNT]]. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with [[:Category:DF2014:Mount|MOUNT]] and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade. Lack of suitable vegetation in the caverns will cause [[World generation#Rejections|worldgen rejection]]s.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade. Lack of suitable vegetation in the civ's starting area will cause [[World generation#Rejections|worldgen rejection]]s.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves, in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows civ to use indoor tree growths in the goods it has available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTHING}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_CRAFTS}}
|
| Allows civ to use materials with [DIVINE] for crafts.{{verify}} Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Animal definitions ==

{{version|0.44.01}}

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ANIMAL}}
|
| Start an animal definition.

|-
| {{text anchor|ANIMAL_TOKEN}}
| [[creature token]]
| Select specific creature.

|-
| {{text anchor|ANIMAL_CASTE_TOKEN}}
| [[Caste|creature caste token]]
| Select specific creature caste (requires ANIMAL_TOKEN). Sites with animal populations will still include all castes, but only the selected ones will be used for specific roles.

|-
| {{text anchor|ANIMAL_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Select creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_FORBIDDEN_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Forbid creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_ALWAYS_PRESENT}}
|
| Animal will be present even if it does not naturally occur in the entity's terrain. All creatures, including [[demon]]s, night trolls and other generated ones will be used if no specific creature or class is selected.

|-
|
* {{text anchor|ANIMAL_NEVER_MOUNT}}, {{text anchor|ANIMAL_ALWAYS_MOUNT}}
* {{text anchor|ANIMAL_NEVER_WAGON_PULLER}}, {{text anchor|ANIMAL_ALWAYS_WAGON_PULLER}}
* {{text anchor|ANIMAL_NEVER_SIEGE}}, {{text anchor|ANIMAL_ALWAYS_SIEGE}}
* {{text anchor|ANIMAL_NEVER_PET}}, {{text anchor|ANIMAL_ALWAYS_PET}}
* {{text anchor|ANIMAL_NEVER_PACK_ANIMAL}}, {{text anchor|ANIMAL_ALWAYS_PACK_ANIMAL}}
|
| Override creature usage tokens. Respectively:
* [[Creature token#MOUNT|MOUNT]] and [[Creature token#MOUNT_EXOTIC|MOUNT_EXOTIC]]
* [[Creature token#WAGON_PULLER|WAGON_PULLER]]
* [[Creature token#TRAINABLE_WAR|TRAINABLE_WAR]] and not [[Creature token#CAN_LEARN|CAN_LEARN]]
* [[Creature token#PET|PET]] and [[Creature token#PET_EXOTIC|PET_EXOTIC]]
* [[Creature token#PACK_ANIMAL|PACK_ANIMAL]]
ALWAYS overrides NEVER if a caste is matched by more than one animal definition.

|}

== Tissue styling-related tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select a tissue layer which has the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for the selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Entity token]]

Unit type token

2020-01-30T10:05:08Z

FortressBuilder: Worldgen positions

{{quality|Fine}}
{{av}}
'''Unit type tokens''' define [[profession]] roles. They are used with various [[entity token]]s, as well as in graphical tilesets.

{| {{prettytable}} class="sortable"
|- style='background-color:#ddd'
! # !! Token !! Unit type !!
|-
| 0 || {{text anchor|MINER}} || [[Miner]] ||style="background:#000" data-sort-value="7"| {{Dwarf|7:0}}
|-
| 1 || {{text anchor|WOODWORKER}} || [[Woodworker]] ||style="background:#000" data-sort-value="14"| {{Dwarf|6:1}}
|-
| 2 || {{text anchor|CARPENTER}} || [[Carpenter]] ||style="background:#000" data-sort-value="14"| {{Dwarf|6:1}}
|-
| 3 || {{text anchor|BOWYER}} || [[Bowyer]] ||style="background:#000" data-sort-value="14"| {{Dwarf|6:1}}
|-
| 4 || {{text anchor|WOODCUTTER}} || [[Woodcutter]] ||style="background:#000" data-sort-value="14"| {{Dwarf|6:1}}
|-
| 5 || {{text anchor|STONEWORKER}} || [[Stoneworker]] ||style="background:#000" data-sort-value="15"| {{Dwarf|7:1}}
|-
| 6 || {{text anchor|ENGRAVER}} || [[Engraver]] ||style="background:#000" data-sort-value="15"| {{Dwarf|7:1}}
|-
| 7 || {{text anchor|MASON}} || [[Mason]] ||style="background:#000" data-sort-value="15"| {{Dwarf|7:1}}
|-
| 8 || {{text anchor|RANGER}} || [[Ranger]] ||style="background:#000" data-sort-value="2"| {{Dwarf|2:0}}
|-
| 9 || {{text anchor|ANIMAL_CARETAKER}} || [[Animal caretaker]] ||style="background:#000" data-sort-value="2"| {{Dwarf|2:0}}
|-
| 10 || {{text anchor|ANIMAL_TRAINER}} || [[Animal trainer]] ||style="background:#000" data-sort-value="2"| {{Dwarf|2:0}}
|-
| 11 || {{text anchor|HUNTER}} || [[Hunter]] ||style="background:#000" data-sort-value="2"| {{Dwarf|2:0}}
|-
| 12 || {{text anchor|TRAPPER}} || [[Trapper]] ||style="background:#000" data-sort-value="2"| {{Dwarf|2:0}}
|-
| 13 || {{text anchor|ANIMAL_DISSECTOR}} || [[Animal dissector]] ||style="background:#000" data-sort-value="2"| {{Dwarf|2:0}}
|-
| 14 || {{text anchor|METALSMITH}} || [[Metalsmith]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 15 || {{text anchor|FURNACE_OPERATOR}} || [[Furnace operator]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 16 || {{text anchor|WEAPONSMITH}} || [[Weaponsmith]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 17 || {{text anchor|ARMORER}} || [[Armorsmith|Armorer]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 18 || {{text anchor|BLACKSMITH}} || [[Blacksmith]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 19 || {{text anchor|METALCRAFTER}} || [[Metalcrafter]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 20 || {{text anchor|JEWELER}} || [[Jeweler]] ||style="background:#000" data-sort-value="10"| {{Dwarf|2:1}}
|-
| 21 || {{text anchor|GEM_CUTTER}} || [[Gem cutter]] ||style="background:#000" data-sort-value="10"| {{Dwarf|2:1}}
|-
| 22 || {{text anchor|GEM_SETTER}} || [[Gem setter]] ||style="background:#000" data-sort-value="10"| {{Dwarf|2:1}}
|-
| 23 || {{text anchor|CRAFTSMAN}} || [[Craftsdwarf|Craftsman]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 24 || {{text anchor|WOODCRAFTER}} || [[Woodcrafter]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 25 || {{text anchor|STONECRAFTER}} || [[Stonecrafter]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 26 || {{text anchor|LEATHERWORKER}} || [[Leatherworker]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 27 || {{text anchor|BONE_CARVER}} || [[Bone carver]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 28 || {{text anchor|WEAVER}} || [[Weaver]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 29 || {{text anchor|CLOTHIER}} || [[Clothier]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 30 || {{text anchor|GLASSMAKER}} || [[Glassmaker]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 31 || {{text anchor|POTTER}} || [[Potter]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 32 || {{text anchor|GLAZER}} || [[Glazer]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 33 || {{text anchor|WAX_WORKER}} || [[Wax worker]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 34 || {{text anchor|STRAND_EXTRACTOR}} || [[Strand extractor]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 35 || {{text anchor|FISHERY_WORKER}} || [[Fishery worker]] ||style="background:#000" data-sort-value="1"| {{Dwarf|1:0}}
|-
| 36 || {{text anchor|FISHERMAN}} || [[Fisherdwarf|Fisherman]] ||style="background:#000" data-sort-value="1"| {{Dwarf|1:0}}
|-
| 37 || {{text anchor|FISH_DISSECTOR}} || [[Fish dissector]] ||style="background:#000" data-sort-value="1"| {{Dwarf|1:0}}
|-
| 38 || {{text anchor|FISH_CLEANER}} || [[Fish cleaner]] ||style="background:#000" data-sort-value="1"| {{Dwarf|1:0}}
|-
| 39 || {{text anchor|FARMER}} || [[Farmer]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 40 || {{text anchor|CHEESE_MAKER}} || [[Cheese maker]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 41 || {{text anchor|MILKER}} || [[Milker]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 42 || {{text anchor|COOK}} || [[Cook]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 43 || {{text anchor|THRESHER}} || [[Thresher]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 44 || {{text anchor|MILLER}} || [[Miller]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 45 || {{text anchor|BUTCHER}} || [[Butcher]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 46 || {{text anchor|TANNER}} || [[Tanner]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 47 || {{text anchor|DYER}} || [[Dyer]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 48 || {{text anchor|PLANTER}} || [[Grower|Planter]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 49 || {{text anchor|HERBALIST}} || [[Herbalist]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 50 || {{text anchor|BREWER}} || [[Brewer]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 51 || {{text anchor|SOAP_MAKER}} || [[Soaper|Soap maker]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 52 || {{text anchor|POTASH_MAKER}} || [[Potash maker]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 53 || {{text anchor|LYE_MAKER}} || [[Lye maker]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 54 || {{text anchor|WOOD_BURNER}} || [[Wood burner]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 55 || {{text anchor|SHEARER}} || [[Shearer]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 56 || {{text anchor|SPINNER}} || [[Spinner]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 57 || {{text anchor|PRESSER}} || [[Presser]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 58 || {{text anchor|BEEKEEPER}} || [[Beekeeper]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 59 || {{text anchor|ENGINEER}} || [[Engineer]] ||style="background:#000" data-sort-value="12"| {{Dwarf|4:1}}
|-
| 60 || {{text anchor|MECHANIC}} || [[Mechanic]] ||style="background:#000" data-sort-value="12"| {{Dwarf|4:1}}
|-
| 61 || {{text anchor|SIEGE_ENGINEER}} || [[Siege engineer]] ||style="background:#000" data-sort-value="12"| {{Dwarf|4:1}}
|-
| 62 || {{text anchor|SIEGE_OPERATOR}} || [[Siege operator]] ||style="background:#000" data-sort-value="12"| {{Dwarf|4:1}}
|-
| 63 || {{text anchor|PUMP_OPERATOR}} || [[Pump operator]] ||style="background:#000" data-sort-value="12"| {{Dwarf|4:1}}
|-
| 64 || {{text anchor|CLERK}} || [[Clerk]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 65 || {{text anchor|ADMINISTRATOR}} || [[Administrator]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 66 || {{text anchor|TRADER}} || [[Trader]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 67 || {{text anchor|ARCHITECT}} || [[Architect]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 68 || {{text anchor|ALCHEMIST}} || [[Alchemist]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 69 || {{text anchor|DOCTOR}} || [[Doctor]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 70 || {{text anchor|DIAGNOSER}} || [[Diagnostician|Diagnoser]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 71 || {{text anchor|BONE_SETTER}} || [[Bone doctor]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 72 || {{text anchor|SUTURER}} || [[Suturer]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 73 || {{text anchor|SURGEON}} || [[Surgeon]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 74 || {{text anchor|MERCHANT}} || [[Merchant]] ||style="background:#000" data-sort-value="7"| {{Dwarf|7:0}}
|-
| 75 || {{text anchor|HAMMERMAN}} || [[Hammerman]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0|type=m}}
|-
| 76 || {{text anchor|MASTER_HAMMERMAN}} || [[Hammer lord]] ||style="background:#000" data-sort-value="13"| {{Dwarf|5:1|type=m}}
|-
| 77 || {{text anchor|SPEARMAN}} || [[Spearman]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0|type=m}}
|-
| 78 || {{text anchor|MASTER_SPEARMAN}} || [[Spearmaster]] ||style="background:#000" data-sort-value="14"| {{Dwarf|6:1|type=m}}
|-
| 79 || {{text anchor|CROSSBOWMAN}} || [[Crossbowman]] ||style="background:#000" data-sort-value="2"| {{Dwarf|2:0|type=m}}
|-
| 80 || {{text anchor|MASTER_CROSSBOWMAN}} || [[Elite crossbowman]] ||style="background:#000" data-sort-value="10"| {{Dwarf|2:1|type=m}}
|-
| 81 || {{text anchor|WRESTLER}} || [[Wrestler]] ||style="background:#000" data-sort-value="7"| {{Dwarf|7:0|type=m}}
|-
| 82 || {{text anchor|MASTER_WRESTLER}} || [[Elite wrestler]] ||style="background:#000" data-sort-value="15"| {{Dwarf|7:1|type=m}}
|-
| 83 || {{text anchor|AXEMAN}} || [[Axeman]] ||style="background:#000" data-sort-value="1"| {{Dwarf|1:0|type=m}}
|-
| 84 || {{text anchor|MASTER_AXEMAN}} || [[Axe lord]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1|type=m}}
|-
| 85 || {{text anchor|SWORDSMAN}} || [[Swordsman]] ||style="background:#000" data-sort-value="3"| {{Dwarf|3:0|type=m}}
|-
| 86 || {{text anchor|MASTER_SWORDSMAN}} || [[Swordmaster]] ||style="background:#000" data-sort-value="11"| {{Dwarf|3:1|type=m}}
|-
| 87 || {{text anchor|MACEMAN}} || [[Maceman]] ||style="background:#000" data-sort-value="4"| {{Dwarf|4:0|type=m}}
|-
| 88 || {{text anchor|MASTER_MACEMAN}} || [[Mace lord]] ||style="background:#000" data-sort-value="12"| {{Dwarf|4:1|type=m}}
|-
| 89 || {{text anchor|PIKEMAN}} || [[Pikeman]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0|type=m}}
|-
| 90 || {{text anchor|MASTER_PIKEMAN}} || [[Pikemaster]] ||style="background:#000" data-sort-value="14"| {{Dwarf|6:1|type=m}}
|-
| 91 || {{text anchor|BOWMAN}} || [[Bowman]] ||style="background:#000" data-sort-value="2"| {{Dwarf|2:0|type=m}}
|-
| 92 || {{text anchor|MASTER_BOWMAN}} || [[Elite bowman]] ||style="background:#000" data-sort-value="10"| {{Dwarf|2:1|type=m}}
|-
| 93 || {{text anchor|BLOWGUNMAN}} || [[Blowgunner]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1|type=m}}
|-
| 94 || {{text anchor|MASTER_BLOWGUNMAN}} || [[Master blowgunner]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1|type=m}}
|-
| 95 || {{text anchor|LASHER}} || [[Lasher]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1|type=m}}
|-
| 96 || {{text anchor|MASTER_LASHER}} || [[Master lasher]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1|type=m}}
|-
| 97 || {{text anchor|RECRUIT}} || [[Recruit]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1|type=m}}
|-
| 98 || {{text anchor|TRAINED_HUNTER}} || [[Hunting animal]] ||style="background:#000" data-sort-value="15"| {{Dwarf|7:1}}
|-
| 99 || {{text anchor|TRAINED_WAR}} || [[War animal]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 100 || {{text anchor|MASTER_THIEF}} || [[Master thief]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 101 || {{text anchor|THIEF}} || [[Thief]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 102 || {{text anchor|STANDARD}} || [[Peasant]] ||style="background:#000" data-sort-value="-1"| {{Dwarf|3:0}}
|-
| 103 || {{text anchor|CHILD}} || [[Child]] ||style="background:#000" data-sort-value="4"| {{Dwarf|4:0}}
|-
| 104 || {{text anchor|BABY}} || [[Baby]] ||style="background:#000" data-sort-value="4"| {{Dwarf|4:0}}
|-
| 105 || {{text anchor|DRUNK}} || [[Drunk]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 106 || {{text anchor|MONSTER_SLAYER}} || [[Monster slayer]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 107 || {{text anchor|SCOUT}} || [[Scout]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 108 || {{text anchor|BEAST_HUNTER}} || [[Beast hunter]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 109 || {{text anchor|SNATCHER}} || [[Snatcher]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 110 || {{text anchor|MERCENARY}} || [[Mercenary]] || style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 111 || {{text anchor|GELDER}} || [[Gelder]] ||style="background:#000" data-sort-value="6"| {{Dwarf|6:0}}
|-
| 112 || {{text anchor|PERFORMER}}{{version|0.42.01}} || [[Performer]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 113 || {{text anchor|POET}}{{version|0.42.01}} || [[Poet]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 114 || {{text anchor|BARD}}{{version|0.42.01}} || [[Bard]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 115 || {{text anchor|DANCER}}{{version|0.42.01}} || [[Dancer]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 116 || {{text anchor|SAGE}}{{version|0.42.01}} || [[Sage]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 117 || {{text anchor|SCHOLAR}}{{version|0.42.01}} || [[Scholar]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 118 || {{text anchor|PHILOSOPHER}}{{version|0.42.01}} || [[Philosopher]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 119 || {{text anchor|MATHEMATICIAN}}{{version|0.42.01}} || [[Mathematician]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 120 || {{text anchor|HISTORIAN}}{{version|0.42.01}} || [[Historian]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 121 || {{text anchor|ASTRONOMER}}{{version|0.42.01}} || [[Astronomer]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 122 || {{text anchor|NATURALIST}}{{version|0.42.01}} || [[Naturalist]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 123 || {{text anchor|CHEMIST}}{{version|0.42.01}} || [[Chemist]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 124 || {{text anchor|GEOGRAPHER}}{{version|0.42.01}} || [[Geographer]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 125 || {{text anchor|SCRIBE}}{{version|0.42.01}} || [[Scribe]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 126 || {{text anchor|PAPERMAKER}}{{version|0.42.01}} || [[Papermaker]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 127 || {{text anchor|BOOKBINDER}}{{version|0.42.01}} || [[Bookbinder]] ||style="background:#000" data-sort-value="9"| {{Dwarf|1:1}}
|-
| 128 || {{text anchor|TAVERN_KEEPER}}{{version|0.42.01}} || [[Tavern keeper]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|-
| 129 || {{text anchor|CRIMINAL}}{{version|0.44.01}} || [[Criminal]] ||style="background:#000" data-sort-value="8"| {{Dwarf|0:1}}
|-
| 130 || {{text anchor|PEDDLER}}{{version|0.44.01}} || [[Peddler]] ||style="background:#000" data-sort-value="7"| {{Dwarf|7:0}}
|-
| 131 || {{text anchor|PROPHET}}{{version|0.44.01}} || [[Prophet]] ||style="background:#000" data-sort-value="15"| {{Dwarf|7:1}}
|-
| 132 || {{text anchor|PILGRIM}}{{version|0.44.01}} || [[Pilgrim]] ||style="background:#000" data-sort-value="15"| {{Dwarf|7:1}}
|-
| 133 || {{text anchor|MONK}}{{version|0.44.01}} || [[Monk]] ||style="background:#000" data-sort-value="15"| {{Dwarf|7:1}}
|-
| 134 || {{text anchor|MESSENGER}}{{version|0.44.11}} || [[Messenger]] ||style="background:#000" data-sort-value="5"| {{Dwarf|5:0}}
|}

The following tokens are also permitted in tilesets:

Entity link:
*MEMBER (not useful)
*FORMER_MEMBER (not useful)
*FORMER_MERCENARY (not useful)
*SLAVE {{Dwarf|7:0}}
*FORMER_SLAVE (not useful)
*PRISONER {{Dwarf|7:0}}
*FORMER_PRISONER (not useful)
*ENEMY (not useful)
Worldgen positions:{{version|0.47.01}} ({{forum link|175434.msg8082510#msg8082510|source}})
*CUSTOM_OFFICIAL_0 (chancellor)
*CUSTOM_OFFICIAL_1 (justiciar)
*CUSTOM_OFFICIAL_2 (treasurer)
*CUSTOM_OFFICIAL_3 (counselor)
*CUSTOM_OFFICIAL_4 (chamberlain)
*CUSTOM_OFFICIAL_5 (master of beasts)
*CUSTOM_OFFICIAL_6 (butler)
*CUSTOM_OFFICIAL_7 (doctor)
*CUSTOM_OFFICIAL_8 (executioner)
*CUSTOM_OFFICIAL_9 (chef)
*CUSTOM_OFFICIAL_10 (housekeeper)
*CUSTOM_MARKET_OFFICIAL_0 (sewer official)
*CUSTOM_MARKET_OFFICIAL_1 (grain official)
*CUSTOM_MARKET_OFFICIAL_2 (fire official)
*CUSTOM_MARKET_OFFICIAL_3 (judge)
*CUSTOM_MARKET_OFFICIAL_4 (building official)
*CUSTOM_MARKET_OFFICIAL_5 (road official)

{{Category|Modding}}
{{Category|Tokens}}

[[ru:Unit type token]]

Tool token

2020-01-29T17:26:58Z

FortressBuilder: New tokens

{{Quality|Superior|12:23, 18 May 2015 (UTC)}}
{{av}}

{| {{prettytable}}
|- bgcolor="#999999"
! Token
! Arguments
! Description

|-
| {{text anchor|NAME}}
|
*singular
*plural
| Name of the tool. <font color="red">Required.</font>

|-
| {{text anchor|BONE_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any bone.

|-
| {{text anchor|CERAMIC_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any ceramic material.

|-
| {{text anchor|DESCRIPTION}}{{version|0.42.01}}
|
| Allows a string to describe the tool when {{key|v}}iewed. The text box can accommodate up to 325 characters until it cuts off, but the spacing of actual sentences puts the realistic limit closer to 300.

|-
| {{text anchor|GLASS_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any glass.

|-
| {{text anchor|HARD_MAT}}
|
| Permits the tool to be made from anything with the [ITEMS_HARD] token, such as wood, stone or metal.

|-
| {{text anchor|LEATHER_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any leather.

|-
| {{text anchor|METAL_MAT}}
|
| Permits the tool to be made from anything with the [IS_METAL] token.

|-
| {{text anchor|METAL_WEAPON_MAT}}
|
| Permits the tool to be made from any metal with the [ITEMS_WEAPON] token.

|-
| {{text anchor|SHEET_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any "sheet" material, such as papyrus, paper, and parchment. Connected to the PAPER_SLURRY/PAPER_PLANT reaction classes?{{verify}}

|-
| {{text anchor|SHELL_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any shell.

|-
| {{text anchor|SILK_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any silk.

|-
| {{text anchor|SOFT_MAT}}
|
| Permits the tool to be made from any material with the [ITEMS_SOFT] token, such as leather or textiles.

|-
| {{text anchor|STONE_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any stone. Presumably connected to the [IS_STONE] token.

|-
| {{text anchor|THREAD_PLANT_MAT}}{{version|0.42.01}}
|
| Permits the tool to be made from any plant fiber, such as pig tails.

|-
| {{text anchor|WOOD_MAT}}
|
| Permits the tool to be made from any wood.

|-
| {{text anchor|INCOMPLETE_ITEM}}{{version|0.42.01}}
|
| According to Toady, "Won't be used in world gen libraries (to differentiate scrolls from quires). Also put it on bindings, rollers, instr. pieces for completeness/future use". Used on scroll rollers, book bindings, and quires.

|-
| {{text anchor|DEFAULT_IMPROVEMENT}}{{version|0.42.01}}
|
*improvement type and subtype (latter only really applicable to SPECIFIC)
*tool material flag like HARD_MAT or SILK_MAT
| Items that appear in the wild come standard with this kind of improvement. Used on scrolls: [DEFAULT_IMPROVEMENT:SPECIFIC:ROLLERS:HARD_MAT]
Currently bugged, the effect is also applied to everything made in-game. This causes scrolls to have two sets of rollers, for example.

|-
| {{text anchor|UNIMPROVABLE}}
|
| Prevents the tool from being improved. Used on honeycombs, (scroll rollers, book bindings, and quires.){{version|0.42.01}}

|-
| {{text anchor|VALUE}}
|
*num
| Defines the item value of the tool. <font color="red">Required.</font>

|-
| {{text anchor|TILE}}
|
*num
| Defines the tile used to represent the tool. <font color="red">Required.</font>

|-
| {{text anchor|INVERTED_TILE}}
|
| The background of the tile will be colored, instead of the foreground.

|-
| {{text anchor|NO_DEFAULT_JOB}}{{version|0.42.01}}
|
| According to Toady, "only custom reactions are used to make this item". Found on [[scroll]]s and [[quire]]s.

|-
| {{text anchor|TOOL_USE}}
|
*tool use, see below
| Defines the task performed using the tool.

|-
| {{text anchor|FURNITURE}}
|
| Allows item to be stored in a furniture stockpile.

|-
| {{text anchor|SHAPE_CATEGORY}}{{version|0.47.01}}
|
*shape category
|

|-
| {{text anchor|USES_FACE_IMAGE_SET}}{{version|0.47.01}}
|
|

|-
| {{text anchor|ADJECTIVE}}
|
*adjective
| Adjective preceding the material name (e.g. "large copper dagger")

|-
| {{text anchor|SIZE}} / {{text anchor|WEIGHT}}
|
*size
| Volume of tool in mL or cubic centimeters. <font color="red">Required.</font>

|-
| {{text anchor|CONTAINER_CAPACITY}}
|
*amount
| How much the item can contain. Defaults to 0.

|-
| {{text anchor|SHOOT_FORCE}}
|
*value
| <font color="red">Required for weapons.</font>

|-
| {{text anchor|SHOOT_MAXVEL}}
|
*value
| <font color="red">Required for weapons.</font>

|-
| {{text anchor|SKILL}}
|
*Skill token
| The skill to determine effectiveness in melee with this tool. <font color="red">Required for weapons.</font>

|-
| {{text anchor|RANGED}}
|
*Skill token
*Ammo item token
| Makes this tool a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.

|-
| {{text anchor|TWO_HANDED}}
|
*size
| Creatures under this size (in cm^3) must use the tool two-handed. <font color="red">Required for weapons.</font>

|-
| {{text anchor|MINIMUM_SIZE}}
|
*size
| Minimum body size (in cm^3) to use the tool at all (multigrasp required until TWO_HANDED value) <font color="red">Required for weapons.</font>

|-
| {{text anchor|MATERIAL_SIZE}}
|
*value
| Number of bar units needed for forging, as well as the amount gained from melting. <font color="red">Required for weapons.</font>

|-
| {{text anchor|ATTACK}}
|
*attacktype:BLUNT or EDGE
*contact_area:value
*penetration_size:value
*verb2nd:string
*verb3rd:string
*noun:string
*velocity_multiplier:value
| You can have many ATTACK tags and one will be randomly selected for each attack, with EDGE attacks 100 times more common than BLUNT attacks. <font color="red">Required for weapons.</font>
|}

Valid tool uses (and the default tools used for these tasks) are as follows:
{| class="wikitable sortable"
|- bgcolor="#999999"
! ID
! Token
! Usage
|-
| 0 || LIQUID_COOKING || cauldron
|-
| 1 || LIQUID_SCOOP || ladle
|-
| 2 || GRIND_POWDER_RECEPTACLE || mortar
|-
| 3 || GRIND_POWDER_GRINDER || pestle
|-
| 4 || MEAT_CARVING || carving knife
|-
| 5 || MEAT_BONING || boning knife
|-
| 6 || MEAT_SLICING || slicing knife
|-
| 7 || MEAT_CLEAVING || meat cleaver
|-
| 8 || HOLD_MEAT_FOR_CARVING || carving fork
|-
| 9 || MEAL_CONTAINER || bowl
|-
| 10 || NEST_BOX || nest box
|-
| 11 || LIQUID_CONTAINER || jug
|-
| 12 || FOOD_STORAGE || large pot
|-
| 13 || HIVE || hive
|-
| 14 || SMALL_OBJECT_STORAGE || pouch
|-
| 15 || TRACK_CART || minecart
|-
| 16 || HEAVY_OBJECT_HAULING || wheelbarrow
|-
| 17 || STAND_AND_WORK_ABOVE || stepladder
|-
| 18 || ROLL_UP_SHEET{{version|0.42.01}} || scroll rollers{{version|0.42.01}}
|-
| 19 || PROTECT_FOLDED_SHEETS{{version|0.42.01}} || book binding{{version|0.42.01}}
|-
| 20 || CONTAIN_WRITING{{version|0.42.01}} || scroll & quire{{version|0.42.01}}
|-
| 21 || BOOKCASE{{version|0.42.01}} || bookcase{{version|0.42.01}}
|-
| 22 || DISPLAY_OBJECT{{version|0.44.01}} || pedestal & display case{{version|0.44.01}}
|-
| ? || PLACE_OFFERING{{version|0.47.01}} || altar{{version|0.47.01}}
|-
| ? || DIVINATION{{version|0.47.01}} || dice{{version|0.47.01}}
|-
| ? || GAMES_OF_CHANCE{{version|0.47.01}} || dice{{version|0.47.01}}

|}

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Tool token]]

Entity token

2020-01-29T17:13:39Z

FortressBuilder: /* Available resources */ USE_NON_EXOTIC_PET_RACE

{{Quality|Exceptional|19:21, 13 October 2015 (UTC)}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ALL_MAIN_POPS_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, elves, and humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom entity can have a tier of 3000 and still work even if it's the only custom entity.

[ADVENTURE_TIER:4]

Removed in [[:Category:Version 0.42.01|Version 0.42.01]], effectively replaced by ALL_MAIN_POPS_CONTROLLABLE.

|-
| {{text anchor|INDIV_CONTROLLABLE}} / {{text anchor|OUTSIDER_CONTROLLABLE}}{{version|0.42.01}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

Removed in [[:Category:Version 0.42.01|Version 0.42.01]], in favor of the [[creature token]] OUTSIDER_CONTROLLABLE.

|-
| {{text anchor|SITE_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, then at embark the specific civs can be chosen by + or - on the civ list screen (by pressing TAB), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token. (Replaced in [[:Category:Version 0.42.01|0.42.01]] by SITE_CONTROLLABLE.)

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures. In entities with multiple possible creatures, you can manipulate the chance of one creature being chosen by adding multiple identical creature tags. For instance adding [CREATURE:DWARF][CREATURE:DWARF][CREATURE:DWARF][CREATURE:ELF] to the same entity will make the civs created about 75% dwarven, 25% elven.

|-
| {{text anchor|SOURCE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| The birth of the civilization can occur in this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| The birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, castles are currently controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing up on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]].
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max historical population '''per entity'''. Multiply this by max starting civ to get the total maximum historical population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token '''must''' be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in these ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations are drawn randomly from all translation files. Multiple translation tags will only result in the last one being used.
* If GEN_DIVINE is entered, the entity will use a generated divine language, that is, the same language that is used for the names of [[angel]]s.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, BATTLE, BRIDGE, CIV, LIBRARY{{version|0.42.01}}, MILITARY_UNIT, RELIGION, ROAD, SIEGE, SITE, TEMPLE, TUNNEL, VESSEL, WALL, WAR
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be preferred as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens, also used when announcing arrival of their caravan. Defaults to 7:0:1.

[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can be any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere. Note that the DEATH sphere favours the appearance of necromancers (and therefore, towers) in the race.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

== Leadership ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress. As of version 0.44.11, however, this is obsolete due to the changes in how sites are elevated in status.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

== Behavior ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE; for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's [[personality trait|cultural values]]. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|VARIABLE_VALUE}}{{version|0.42.01}}
|
*value or ALL
*min
*max
| Makes values randomized rather than specified.
This tag overrides the VALUE tag. Using [VARIABLE_VALUE:ALL:x:y] and then overwriting single values with further [VARIABLE_VALUE:value:x:y] tags works.

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the defenders.

If the civ sends out mercenaries, they may come to the player's fort to enlist in the military.{{version|0.42.01}}

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| The season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading, sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest, and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in fortress mode has this tag (e.g. you add BABYSNATCHER to the dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you. However, animals traded away to one's own caravan will count as snatched, reported upon the animal leaving the map, and the animal will not count as having been exported.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s, and (unlike older versions) only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

Note: If the playable civ in Fortress Mode has this tag (e.g. you add ITEM_THIEF to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and kobolds will be friendly to you. However, ALL items traded away to one's own caravan will count as stolen, reported when the items leave the map, and the stolen items will not count as exported.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a land holder.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as [[bat man]] civilizations. May spawn in any of the three caverns, in groups of 5-10 soldiers who will hunt down nearby cavern creatures. If you embark as this civ, you have access to pets and trees from all three layers, not only the first.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|-
| {{text anchor|GENERATE_KEYBOARD_INSTRUMENTS}}, {{text anchor|GENERATE_PERCUSSION_INSTRUMENTS}}, {{text anchor|GENERATE_STRINGED_INSTRUMENTS}}, {{text anchor|GENERATE_WIND_INSTRUMENTS}}, {{text anchor|GENERATE_DANCE_FORMS}}, {{text anchor|GENERATE_MUSICAL_FORMS}}, {{text anchor|GENERATE_POETIC_FORMS}}{{version|0.42.01}}
|
| Makes civilizations generate the given instruments/forms.

|-
| {{text anchor|SCHOLAR}}{{version|0.42.01}}
| scholar type
| ALL, ASTRONOMER, CHEMIST, DOCTOR, ENGINEER, GEOGRAPHER, HISTORIAN, MATHEMATICIAN, NATURALIST, PHILOSOPHER

|-
| {{text anchor|SET_SCHOLARS_ON_VALUES_AND_JOBS}}{{version|0.42.01}}
|
| Generates scholars based on the values generated with the VARIABLE_VALUE tag.

|-
| {{text anchor|NO_ARTIFACT_CLAIMS}}{{version|0.44.01}}
|
| Used for kobolds.

|}

== Available resources ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal. For those cases, listing the pick under the [WEAPON] token works just as well. Note that this tag is neither necessary nor sufficient to allow use of that item as a mining tool -- for that, the item itself needs to be a weapon with [SKILL:MINING].
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
| No longer used as of [[:Category:Version 0.42.01|Version 0.42.01]] due to the ability to generate instruments in world generation. It is still usable if pre-defined instruments are modded in, and generated musical forms are capable of selecting pre-defined instruments to use. However, reactions for making instruments, instrument parts, and/or assembling such instruments need to be added as well, as this token no longer adds such instruments to the craftdwarf's workshop menu.
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or [[:Category:DF2014:Exotic pet|PET_EXOTIC]] will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with [[:Category:DF2014:Mount|MOUNT]] or [[:Category:DF2014:Exotic mount|MOUNT_EXOTIC]]), or siege minion (with [[:Category:DF2014:War animals|TRAINABLE_WAR]] and ''without'' [[:Category:DF2014:Learns|CAN_LEARN]]). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with [[:Category:DF2014:Mount|MOUNT]] or [[:Category:DF2014:Exotic mount|MOUNT_EXOTIC]]), and siege minions (with [[:Category:DF2014:War animals|TRAINABLE_WAR]] and ''without'' [[:Category:DF2014:Learns|CAN_LEARN]]).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' [[:Category:DF2014:Learns|CAN_LEARN]] will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with [[:Category:DF2014:Mount|MOUNT]] or [[:Category:DF2014:Exotic mount|MOUNT_EXOTIC]]), and siege minions (with [[:Category:DF2014:War animals|TRAINABLE_WAR]] or SLOW_LEARNER), even the normally untameable species.

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' [[:Category:DF2014:Learns|CAN_LEARN]] will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with [[:Category:DF2014:Mount|MOUNT]] or [[:Category:DF2014:Exotic mount|MOUNT_EXOTIC]]), and siege minions (with [[:Category:DF2014:War animals|TRAINABLE_WAR]]), even the normally untameable species.

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|USE_NON_EXOTIC_PET_RACE}}{{version|0.47.01}}
|
| Makes the civilization use all locally available non-exotic pets.

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and [[:Category:DF2014:Mount|MOUNT]]. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with [[:Category:DF2014:Mount|MOUNT]] and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade. Lack of suitable vegetation in the caverns will cause [[World generation#Rejections|worldgen rejection]]s.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade. Lack of suitable vegetation in the civ's starting area will cause [[World generation#Rejections|worldgen rejection]]s.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves, in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows civ to use indoor tree growths in the goods it has available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTHING}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_CRAFTS}}
|
| Allows civ to use materials with [DIVINE] for crafts.{{verify}} Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Animal definitions ==

{{version|0.44.01}}

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ANIMAL}}
|
| Start an animal definition.

|-
| {{text anchor|ANIMAL_TOKEN}}
| [[creature token]]
| Select specific creature.

|-
| {{text anchor|ANIMAL_CASTE_TOKEN}}
| [[Caste|creature caste token]]
| Select specific creature caste (requires ANIMAL_TOKEN). Sites with animal populations will still include all castes, but only the selected ones will be used for specific roles.

|-
| {{text anchor|ANIMAL_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Select creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_FORBIDDEN_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Forbid creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_ALWAYS_PRESENT}}
|
| Animal will be present even if it does not naturally occur in the entity's terrain. All creatures, including [[demon]]s, night trolls and other generated ones will be used if no specific creature or class is selected.

|-
|
* {{text anchor|ANIMAL_NEVER_MOUNT}}, {{text anchor|ANIMAL_ALWAYS_MOUNT}}
* {{text anchor|ANIMAL_NEVER_WAGON_PULLER}}, {{text anchor|ANIMAL_ALWAYS_WAGON_PULLER}}
* {{text anchor|ANIMAL_NEVER_SIEGE}}, {{text anchor|ANIMAL_ALWAYS_SIEGE}}
* {{text anchor|ANIMAL_NEVER_PET}}, {{text anchor|ANIMAL_ALWAYS_PET}}
* {{text anchor|ANIMAL_NEVER_PACK_ANIMAL}}, {{text anchor|ANIMAL_ALWAYS_PACK_ANIMAL}}
|
| Override creature usage tokens. Respectively:
* [[Creature token#MOUNT|MOUNT]] and [[Creature token#MOUNT_EXOTIC|MOUNT_EXOTIC]]
* [[Creature token#WAGON_PULLER|WAGON_PULLER]]
* [[Creature token#TRAINABLE_WAR|TRAINABLE_WAR]] and not [[Creature token#CAN_LEARN|CAN_LEARN]]
* [[Creature token#PET|PET]] and [[Creature token#PET_EXOTIC|PET_EXOTIC]]
* [[Creature token#PACK_ANIMAL|PACK_ANIMAL]]
ALWAYS overrides NEVER if a caste is matched by more than one animal definition.

|}

== Tissue styling-related tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select a tissue layer which has the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for the selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Entity token]]

Position token

2020-01-29T17:10:05Z

FortressBuilder: Add new position responsibilities

{{Quality|Fine|11:39, 18 May 2015 (UTC)}}
{{av}}
These tokens define positions in entity_*.txt files. See [[Entity token]].
==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.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ACCOUNT_EXEMPT}}
|
| The position holder is not subjected to the [[Dwarven economy|economy]]. Less than relevant right now.

|-
| {{text anchor|ALLOWED_CLASS}}
| {{token|CREATURE_CLASS|creature}} token
| Only creatures with the specified class token can be appointed to this position.

|-
| {{text anchor|ALLOWED_CREATURE}}
| CREATURE: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}}
| position
| 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}}
|
| A creature that kills this position will be sure to talk about it a lot.

|-
| {{text anchor|CHAT_WORTHY}}
|
| In adventure mode, when referencing locations an NPC may mention this position holder living there or having done some deed there. 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}}
| color
| Creatures of this position will have this color, instead of their profession color, e.g. [COLOR:5:0:1].

|-
| {{text anchor|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.

|-
| {{text anchor|CONQUERED_SITE}}
|
| This position is a puppet ruler left behind on a conquered site.

|-
| {{text anchor|DEMAND_MAX}}
| number (0-100)
| How many demands at one time the position can make of the population.

|-
| {{text anchor|DETERMINES_COIN_DESIGN}}
|
| Minted coins will have images that reflect the personality of this position holder.

|-
| {{text anchor|DO_NOT_CULL}}
|
| The position won't be culled from Legends as "unimportant" during world generation.

|-
| {{text anchor|DUTY_BOUND}}
|
| Members of this position will never agree to 'join' your character during adventure mode.

|-
| {{text anchor|ELECTED}}
|
| The population will periodically select the most skill-eligible creature to fill this position. Contrast [APPOINTED_BY].

|-
| {{text anchor|EXECUTION_SKILL}}
| weapon skill
| A mandatory subtag of [RESPONSIBILITY:EXECUTIONS]. Determines the weapon chosen by the executioner for his work.

|-
| {{text anchor|EXPORTED_IN_LEGENDS}}
|
| The various members who have filled this role will be listed in the civilisation's history.

|-
| {{text anchor|FLASHES}}
|
| The creature holding this position will visibly flash, like legendary citizens. Represents a properly noble station by default.

|-
| {{text anchor|GENDER}}
| male/female
| The position can only be held by the specified gender. Currently bugged {{bug|2714}}

|-
| {{text anchor|KILL_QUEST}}
|
| The position can assign quests to adventurers.

|-
| {{text anchor|LAND_HOLDER}}
| 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.

|-
| {{text anchor|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]

|-
| {{text anchor|MANDATE_MAX}}
| number (0-100)
| The maximum number of mandates the position can make at once.

|-
| {{text anchor|MENIAL_WORK_EXEMPTION}}
|
| The position holder cannot be assigned labors. Currently nonfunctional.{{bug|3721}}

|-
| {{text anchor|MENIAL_WORK_EXEMPTION_SPOUSE}}
|
| The spouse of the position holder doesn't have to work, either. Also doesn't work either. {{bug|3721}}

|-
| {{text anchor|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}}

|-
| {{text anchor|NAME}}
| singular:plural
| The name of the position.

|-
| {{text anchor|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]

|-
| {{text anchor|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]

|-
| {{text anchor|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.

|-
| {{text anchor|PRECEDENCE}}
| 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.

|-
| {{text anchor|PUNISHMENT_EXEMPTION}}
|
| The position holder will not be held accountable for his or her crimes. Currently nonfunctional.{{bug|4589}}

|-
| {{text anchor|QUEST_GIVER}}
|
| The position holder can give quests in Adventure mode. Functionality in 0.31.13 and later is uncertain.

|-
| {{text anchor|REJECTED_CLASS}}
| CREATURE_CLASS Token
| Creatures of the specified class cannot be appointed to this position.

|-
| {{text anchor|REJECTED_CREATURE}}
| CREATURE:CASTE
| Restricts position holders by CREATURE type.

|-
| {{text anchor|REPLACED_BY}}
| position
| This position is absorbed by another down the line. For example, expedition leader is [REPLACED_BY:MAYOR].

|-
| {{text anchor|REQUIRED_BEDROOM}}
| number (0-1000000)
| The position holder requires a bedroom with at least this value.

|-
| {{text anchor|REQUIRED_BOXES}}
| number (0-100)
| The position holder requires at least this many boxes.

|-
| {{text anchor|REQUIRED_CABINETS}}
| number (0-100)
| The position holder requires at least this many cabinets.

|-
| {{text anchor|REQUIRED_DINING}}
| number (0-1000000)
| The position holder requires a dining room with at least this value.

|-
| {{text anchor|REQUIRED_OFFICE}}
| number (0-1000000)
| The position holder requires an office with at least this value.

|-
| {{text anchor|REQUIRED_RACKS}}
| number (0-100)
| The position holder requires at least this many weapon racks.

|-
| {{text anchor|REQUIRED_STANDS}}
| number (0-100)
| The position holder requires at least this many armour stands.

|-
| {{text anchor|REQUIRED_TOMB}}
| number (0-1000000)
| The position holder requires a tomb with at least this value.

|-
| {{text anchor|REQUIRES_MARKET}}
|
| 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
| 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
| The position holder does a thing. See the table below for suitable arguments.

|-
| {{text anchor|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 dwarf nobles because at present dwarves have no such special locations.

|-
| {{text anchor|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.

|-
| {{text anchor|SLEEP_PRETENSION}}
|
| 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}}
|
| 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}}

|-
| {{text anchor|SPOUSE}}
| singular:plural
| The name of the position holder's spouse.

|-
| {{text anchor|SPOUSE_FEMALE}}
| singular:plural
| If the spouse of the creature holding the position is female, this is the spouse's position name.

|-
| {{text anchor|SPOUSE_MALE}}
| singular:plural
| If the spouse of the creature holding the position is male, this is the spouse's position name.

|-
| {{text anchor|SQUAD}}
| number:singular:plural
| 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.

|-
| {{text anchor|SUCCESSION}}
|
* BY_HEIR / BY_POSITION:position
| How a new position holder is chosen. A single position can have multiple BY_POSITION tokens.

|}

== Responsibilities ==
{| {{prettytable}}
|- bgcolor="#dddddd"
! Argument
! Description

|-
| {{text anchor|ACCOUNTING}}
| Found on [[bookkeeper]]. Position will use Record Keeper skill to keep track of stocks.

|-
| {{text anchor|ADVISE_LEADERS}}{{version|0.47.01}}
|

|-
| {{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}}{{version|0.47.01}}
|

|-
| {{text anchor|COLLECT_TAXES}}
| Currently unused - was originally assigned to the Tax Collector

|-
| {{text anchor|CONSTRUCTION_PERMITS}}{{version|0.47.01}}
|

|-
| {{text anchor|EQUIPMENT_MANIFESTS}}
| Currently unused - was originally assigned to the Arsenal Dwarf

|-
| {{text anchor|ESCORT_TAX_COLLECTOR}}
| Currently unused - was originally assigned to the Royal Guards (squad members beneath the Hammerer)

|-
| {{text anchor|ESPIONAGE}}{{version|0.47.01}}
| Found on [[dungeon master]] and [[General|princess].

|-
| {{text anchor|ESTABLISH_COLONY_TRADE_AGREEMENTS}}
| 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}}
| Found on [[hammerer]]. Position executes death penalties with a weapon of the appropriate skill.

|-
| {{text anchor|FIRE_SAFETY}}{{version|0.47.01}}
|

|-
| {{text anchor|FOOD_SUPPLY}}{{version|0.47.01}}
|

|-
| {{text anchor|HEALTH_MANAGEMENT}}
| Found on [[chief medical dwarf]]. Position will use Diagnostician skill to enable the {{key|z}}-menu health screen.

|-
| {{text anchor|JUDGE}}{{version|0.47.01}}
|

|-
| {{text anchor|LAW_ENFORCEMENT}}
| 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}}
| 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}}{{version|0.47.01}}
|

|-
| {{text anchor|MAINTAIN_ROADS}}{{version|0.47.01}}
|

|-
| {{text anchor|MAINTAIN_SEWERS}}{{version|0.47.01}}
|

|-
| {{text anchor|MAINTAIN_TUNNELS}}{{version|0.47.01}}
|

|-
| {{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}}
| Found on diplomat. Position negotiates peace treaties in order to end wars.

|-
| {{text anchor|MAKE_TOPIC_AGREEMENTS}}
| Found on diplomat. Position negotiates special agreements, such as tree cutting quotas.

|-
| {{text anchor|MANAGE_ANIMALS}}{{version|0.47.01}}
| Found on [[dungeon master]].

|-
| {{text anchor|MANAGE_LEADER_HOUSEHOLD_CLEANLINESS}}{{version|0.47.01}}
|

|-
| {{text anchor|MANAGE_LEADER_HOUSEHOLD_DRINKS}}{{version|0.47.01}}
|

|-
| {{text anchor|MANAGE_LEADER_HOUSEHOLD_FOOD}}{{version|0.47.01}}
|

|-
| {{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}}
| Found on expedition leader/mayor. Position uses the various Social skills to hold meetings with unhappy citizens and try to pacify them with happy thoughts.

|-
| {{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 it's 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 kobolds, presumably due to either the SKULKING or the UTTERANCES tokens.

|-
| {{text anchor|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. Issues the orders for the teams conducting raids or other operations away from the fortress.{{version|0.44.01}}

|-
| {{text anchor|OVERSEE_LEADER_HOUSEHOLD}}{{version|0.47.01}}
|

|-
| {{text anchor|PATROL_TERRITORY}}
| Found on elven ranger captain. Effect unknown.{{verify}}

|-
| {{text anchor|PREPARE_LEADER_MEALS}}{{version|0.47.01}}
|

|-
| {{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}}
| Found on elven druid. Position informs you about worship cults{{verify}}

|-
| {{text anchor|SORT_AMMUNITION}}
| Currently unused - was originally assigned to the Arsenal Dwarf

|-
| {{text anchor|TAME_EXOTICS}}
| Currently unused - was originally assigned to the Dungeon Master

|-
| {{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.

|-
| {{text anchor|UPGRADE_SQUAD_EQUIPMENT}}
| Currently unused - was originally assigned to the Arsenal Dwarf

|}

== 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:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* landholder tier
* population
* wealth exported
* created wealth
| Defines the requirements for the noble ruler promotions. The tier numbers determine which position is used.

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

|}

== 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.

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.

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. '''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.'''

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Position token]]

Template:DF2014 materials

2020-01-27T16:43:57Z

FortressBuilder: Alphabetize

<center>
{| {{listboxformat}}
! colspan="2" style="border: 1px solid #7eacac; font-weight:bold; background-color: #97c9d9; padding-left: 1em; padding-right: 1em;" | [[Material]]s
|-
| style="font-weight:bold; background-color: #6fa4b5; padding-left: 1em; padding-right: 1em;" | Creature
| [[Blood]] • [[Bone]] • [[Cartilage]] • [[Cheese]] • [[Chitin]] • [[Egg]] • [[Extract]] • [[Fat]] • [[Feather]] • [[Hair]] • [[Honey]] • [[Horn]] • [[Ivory]] • [[Leather]] • [[Meat]] • [[Milk]] • [[Nail]] • [[Nervous tissue]] • [[Parchment]] • [[Royal jelly]] • [[Scale]] • [[Shell]] • [[Silk]] • [[Skin]] • [[Soap]] • [[Tallow]] • [[Wax]] • [[Wool]]
|-
| style="font-weight:bold; background-color: #6fa4b5; padding-left: 1em; padding-right: 1em;" | Plant
| [[Booze]] • [[Dye]] • [[Extract]] • [[Flour]] • [[Flower]] • [[Fruit]] • [[Leaf]] • [[Oil]] • [[Paper]] • [[Plant fiber]] • [[Press cake]] • [[Seed]] • [[Slurry]] • [[Wood]]
|-
| style="font-weight:bold; background-color: #6fa4b5; padding-left: 1em; padding-right: 1em;" | Inorganic
| [[Ceramic]] • [[Clay]] • [[Gem]] • [[Gypsum plaster]] • [[Metal]] • [[Milk of lime]] • [[Ore]] • [[Quicklime]] • [[Sand]] • [[Soil]] • [[Stone]]
|-
| style="font-weight:bold; background-color: #6fa4b5; padding-left: 1em; padding-right: 1em;" | [[Hardcoded material|Hardcoded]]
| [[Amber]] • [[Ash]] • [[Coral]] • [[Filth]] • [[Glass]] • [[Grime]] • [[Ice]] • [[Lye]] • [[Magma]] • [[Mud]] • [[Pearlash]] • [[Potash]] • [[Refined coal]] • [[Salt]] • [[Unknown substance]] • [[Vomit]] • [[Water]]

|}</center><includeonly>{{#ifeq:{{{cat|}}}|nocat||{{Category|Materials}}}}</includeonly><noinclude>[[Category:Templates]][[Category:Navigation templates]]</noinclude>

Instrument token

2018-07-29T07:25:28Z

FortressBuilder:

{{Quality|Exceptional|14:41, 22 July 2018 (UTC)}}
{{av}}

Since v0.42.01, [[instruments]] are procedurally generated for each world, but if so desired, it is still possible to define custom instruments in the raws by using an [ITEM_INSTRUMENT] token. Most [[tool token]]s can be used as before, but there are a few instrument-specific tokens, as listed in the table below.

The information on this page is sourced from the file <code>raw/objects/examples and notes/item_instrument_example.txt</code>, which also includes useful example instrument definitions.

{| {{prettytable}}
|- bgcolor="#999999"
! Token
! Arguments
! Description

|-
| {{text anchor|PLACED_AS_BUILDING}}
|
| Makes the instrument stationary.

|-
| {{text anchor|DOMINANT_MATERIAL_PIECE}}
|
* instrument piece
| Sets a piece as the central part of the instrument.

|-
| {{text anchor|INSTRUMENT_PIECE}}
|
* token
* tool token
* singular
* plural
* STANDARD/ALWAYS_PLURAL/ALWAYS_SINGULAR
| Defines an instrument piece. ''token'' is the identifier that can be used in other raw tags to refer to this instrument piece. ''tool token'' is the tool which is required (and consumed) during the construction process to create this instrument piece.

If an instrument does not have any pieces, SELF can be used for any argument which needs to be an instrument piece.

|-
| {{text anchor|VOLUME_mB}}
|
* min
* max
| The instrument's volume range, in millibels (100 mB = 1 dB).

|-
| {{text anchor|SOUND_PRODUCTION}}
|
* various tokens
| Defines how a musician can produce sound when using this instrument. Can be used multiple times. Valid tokens and their required additional arguments are:
* PLUCKED_BY_BP, PLUCKED (requires two tokens, actor then target)
* BOWED (two tokens)
* STRUCK_BY_BP, STRUCK (two tokens)
* VIBRATE_BP_AGAINST_OPENING
* BLOW_AGAINST_FIPPLE, BLOW_OVER_OPENING_SIDE, BLOW_OVER_OPENING_END, BLOW_OVER_SINGLE_REED, BLOW_OVER_DOUBLE_REED, BLOW_OVER_FREE_REED
* STRUCK_TOGETHER, SHAKEN
* SCRAPED (two tokens), FRICTION (two tokens)
* RESONATOR
* BAG_OVER_REED (two tokens), AIR_OVER_REED (two tokens), AIR_OVER_FREE_REED (two tokens), AIR_AGAINST_FIPPLE (two tokens)

|-
| {{text anchor|PITCH_CHOICE}}
|
* method
| Defines how the pitch can be varied by the musician. Can be used multiple times. Valid methods are:
* MEMBRANE_POSITION
* SUBPART_CHOICE
* KEYBOARD
* STOPPING_FRET (requires two tokens, first for "string" second for "neck" -- or whatever is being pressed against what), STOPPING_AGAINST_BODY (two tokens), STOPPING_HOLE, STOPPING_HOLE_KEY
* SLIDE
* HARMONIC_SERIES
* VALVE_ROUTES_AIR
* BP_IN_BELL
* FOOT_PEDALS (two token, first is what is being changed e.g. "strings", second is "body" which has pedalboard -- or whatever piece is being stepped on)

|-
| {{text anchor|TUNING}}
|
* method
* instrument piece
| Can be used multiple times. Valid methods are: PEGS, ADJUSTABLE_BRIDGES, CROOKS, TIGHTENING, LEVERS.

|-
| {{text anchor|PITCH_RANGE}}
|
* min pitch
* max pitch
| From the example file:
<blockquote>Pitch is <min>:<max> in cents with middle C at zero. There are 1200 cents in an octave. The game verbally differentiates values from -4200 to 4200, but you can go outside that if you like. The in-game generated instruments will range from roughly C0 to C8 (-4800 to 4800), sometimes beyond for really unusual ones.

You can also use INDEFINITE_PITCH.
</blockquote>

|-
| {{text anchor|TIMBRE}}
|
* any number of timbre words
| Valid timbre words are: CLEAR, NOISY, FULL, THIN, ROUND, SHARP, SMOOTH, CHOPPY, STEADY, EVOLVING, STRONG, DELICATE, BRIGHT, GRACEFUL, SPARSE, BREATHY, STRAINED, BROAD, LIGHT, MELLOW, WOBBLING, FOCUSED, EVEN, FLUID, VIBRATING, QUAVERING, EERIE, FRAGILE, BRITTLE, PURE, PIERCING, STRIDENT, WAVERING, HARSH, REEDY, NASAL, BUZZY, ROUGH, WARM, RUGGED, HEAVY, FLAT, DARK, CRISP, SONOROUS, WATERY, GENTLE, SLICING, LIQUID, RAUCOUS, BREEZY, RASPY, WISPY, SHRILL, MUDDY, RICH, DULL, FLOATING, RINGING, RESONANT, SWEET, RIPPLING, SPARKLING.

|-
| {{text anchor|REGISTER}}
|
* min pitch
* max pitch
* any number of timbre words
| See [[#PITCH_RANGE|PITCH_RANGE]] and [[#TIMBRE|TIMBRE]] for possible values. The pitch range overrides the global pitch for a register, but the register timbres are added to the global ones.

|-
| {{text anchor|MUSIC_SKILL}}
|
* skill token
| The skill should be one of the music-related [[skill token]]s.

|}

{{category|Tokens}}

Instrument token

2018-07-22T07:02:10Z

FortressBuilder:

Since v0.42.01, [[instruments]] are being procedurally generated for each world, but if so desired, it is still possible to define custom instruments in the raws, using an [ITEM_INSTRUMENT] token. Most [[tool token]]s can be used as before, but there are a few instrument-specific tokens, as described in the table below.

The information on this page is sourced from the file <code>raw/objects/examples and notes/item_instrument_example.txt</code>, which also includes useful example instrument definitions.

{| {{prettytable}}
|- bgcolor="#999999"
! Token
! Arguments
! Description

|-
| {{text anchor|PLACED_AS_BUILDING}}
|
| Makes the instrument stationary.

|-
| {{text anchor|DOMINANT_MATERIAL_PIECE}}
|
* instrument piece
| Sets a piece as the central part of the instrument.

|-
| {{text anchor|INSTRUMENT_PIECE}}
|
* token
* tool token
* singular
* plural
* STANDARD/ALWAYS_PLURAL/ALWAYS_SINGULAR
| Defines an instrument piece. ''token'' is the identifier that can be used in other raw tags to refer to this instrument piece. ''tool token'' is the tool which is required (and consumed) during the construction process to create this instrument piece.

If an instrument does not have any pieces, SELF can be used for any argument which needs to be an instrument piece.

|-
| {{text anchor|VOLUME_mB}}
|
* min
* max
| The instrument's volume range, in Millibell (100 mB = 1 dB).

|-
| {{text anchor|SOUND_PRODUCTION}}
|
* various tokens
| Defines how a musician can produce sound when using this instrument. Can be used multiple times. Valid tokens and their required additional arguments are:
* PLUCKED_BY_BP, PLUCKED (requires two tokens, actor then target)
* BOWED (two tokens)
* STRUCK_BY_BP, STRUCK (two tokens)
* VIBRATE_BP_AGAINST_OPENING
* BLOW_AGAINST_FIPPLE, BLOW_OVER_OPENING_SIDE, BLOW_OVER_OPENING_END, BLOW_OVER_SINGLE_REED, BLOW_OVER_DOUBLE_REED, BLOW_OVER_FREE_REED
* STRUCK_TOGETHER, SHAKEN
* SCRAPED (two tokens), FRICTION (two tokens)
* RESONATOR
* BAG_OVER_REED (two tokens), AIR_OVER_REED (two tokens), AIR_OVER_FREE_REED (two tokens), AIR_AGAINST_FIPPLE (two tokens)

|-
| {{text anchor|PITCH_CHOICE}}
|
* method
| Defines how the pitch can be varied by the musician. Can be used multiple times. Valid methods are:
* MEMBRANE_POSITION
* SUBPART_CHOICE
* KEYBOARD
* STOPPING_FRET (requires two tokens, first for "string" second for "neck" -- or whatever is being pressed against what), STOPPING_AGAINST_BODY (two tokens), STOPPING_HOLE, STOPPING_HOLE_KEY
* SLIDE
* HARMONIC_SERIES
* VALVE_ROUTES_AIR
* BP_IN_BELL
* FOOT_PEDALS (two token, first is what is being changed e.g. "strings", second is "body" which has pedalboard -- or whatever piece is being stepped on)

|-
| {{text anchor|TUNING}}
|
* method
* instrument piece
| Can be used multiple times. Valid methods are: PEGS, ADJUSTABLE_BRIDGES, CROOKS, TIGHTENING, LEVERS.

|-
| {{text anchor|PITCH_RANGE}}
|
* min pitch
* max pitch
| From the example file:
<blockquote>Pitch is <min>:<max> in cents with middle C at zero. There are 1200 cents in an octave. The game verbally differentiates values from -4200 to 4200, but you can go outside that if you like. The in-game generated instruments will range from roughly C0 to C8 (-4800 to 4800), sometimes beyond for really unusual ones.

You can also use INDEFINITE_PITCH.
</blockquote>

|-
| {{text anchor|TIMBRE}}
|
* any number of timbre words
| Valid timbre words are: CLEAR, NOISY, FULL, THIN, ROUND, SHARP, SMOOTH, CHOPPY, STEADY, EVOLVING, STRONG, DELICATE, BRIGHT, GRACEFUL, SPARSE, BREATHY, STRAINED, BROAD, LIGHT, MELLOW, WOBBLING, FOCUSED, EVEN, FLUID, VIBRATING, QUAVERING, EERIE, FRAGILE, BRITTLE, PURE, PIERCING, STRIDENT, WAVERING, HARSH, REEDY, NASAL, BUZZY, ROUGH, WARM, RUGGED, HEAVY, FLAT, DARK, CRISP, SONOROUS, WATERY, GENTLE, SLICING, LIQUID, RAUCOUS, BREEZY, RASPY, WISPY, SHRILL, MUDDY, RICH, DULL, FLOATING, RINGING, RESONANT, SWEET, RIPPLING, SPARKLING.

|-
| {{text anchor|REGISTER}}
|
* min pitch
* max pitch
* any number of timbre words
| See [[#PITCH_RANGE|PITCH_RANGE]] and [[#TIMBRE|TIMBRE]] for possible values. The pitch range overrides the global pitch for a register, but the register timbres are added to the global ones.

|-
| {{text anchor|MUSIC_SKILL}}
|
* skill token
| The skill should be one of the music-related [[skill token]]s.

|}

Instrument token

2018-07-22T07:01:43Z

FortressBuilder:

Since v0.42.01, [[instruments]] are being procedurally generated for each world, but if so desired, it is still possible to define custom instruments in the raws, using an [ITEM_INSTRUMENT] token. Most [[tool token]]s can be used as before, but there are a few instrument-specific tokens, as described in the table below.

The information on this page is sourced from the file <code>raw/objects/examples and notes/item_instrument_example.txt</code>, which also includes useful example instrument definitions.

{| {{prettytable}}
|- bgcolor="#999999"
! Token
! Arguments
! Description

|-
| {{text anchor|PLACED_AS_BUILDING}}
|
| Makes the instrument stationary.

|-
| {{text anchor|DOMINANT_MATERIAL_PIECE}}
|
* instrument piece
| Sets a piece as the central part of the instrument.

|-
| {{text anchor|INSTRUMENT_PIECE}}
|
* token
* tool token
* singular
* plural
* STANDARD/ALWAYS_PLURAL/ALWAYS_SINGULAR
| Defines an instrument piece. ''token'' is the identifier that can be used in other raw tags to refer to this instrument piece. ''tool token'' is the tool which is required (and consumed) during the construction process to create this instrument piece.

If an instrument does not have any pieces, SELF can be used for any argument which needs to be an instrument piece.

|-
| {{text anchor|VOLUME_mB}}
|
* min
* max
| The instrument's volume range, in Millibell (100 mB = 1 dB).

|-
| {{text anchor|SOUND_PRODUCTION}}
| * various tokens
| Defines how a musician can produce sound when using this instrument. Can be used multiple times. Valid tokens and their required additional arguments are:
* PLUCKED_BY_BP, PLUCKED (requires two tokens, actor then target)
* BOWED (two tokens)
* STRUCK_BY_BP, STRUCK (two tokens)
* VIBRATE_BP_AGAINST_OPENING
* BLOW_AGAINST_FIPPLE, BLOW_OVER_OPENING_SIDE, BLOW_OVER_OPENING_END, BLOW_OVER_SINGLE_REED, BLOW_OVER_DOUBLE_REED, BLOW_OVER_FREE_REED
* STRUCK_TOGETHER, SHAKEN
* SCRAPED (two tokens), FRICTION (two tokens)
* RESONATOR
* BAG_OVER_REED (two tokens), AIR_OVER_REED (two tokens), AIR_OVER_FREE_REED (two tokens), AIR_AGAINST_FIPPLE (two tokens)

|-
| {{text anchor|PITCH_CHOICE}}
|
* method
| Defines how the pitch can be varied by the musician. Can be used multiple times. Valid methods are:
* MEMBRANE_POSITION
* SUBPART_CHOICE
* KEYBOARD
* STOPPING_FRET (requires two tokens, first for "string" second for "neck" -- or whatever is being pressed against what), STOPPING_AGAINST_BODY (two tokens), STOPPING_HOLE, STOPPING_HOLE_KEY
* SLIDE
* HARMONIC_SERIES
* VALVE_ROUTES_AIR
* BP_IN_BELL
* FOOT_PEDALS (two token, first is what is being changed e.g. "strings", second is "body" which has pedalboard -- or whatever piece is being stepped on)

|-
| {{text anchor|TUNING}}
|
* method
* instrument piece
| Can be used multiple times. Valid methods are: PEGS, ADJUSTABLE_BRIDGES, CROOKS, TIGHTENING, LEVERS.

|-
| {{text anchor|PITCH_RANGE}}
|
* min pitch
* max pitch
| From the example file:
<blockquote>Pitch is <min>:<max> in cents with middle C at zero. There are 1200 cents in an octave. The game verbally differentiates values from -4200 to 4200, but you can go outside that if you like. The in-game generated instruments will range from roughly C0 to C8 (-4800 to 4800), sometimes beyond for really unusual ones.

You can also use INDEFINITE_PITCH.
</blockquote>

|-
| {{text anchor|TIMBRE}}
|
* any number of timbre words
| Valid timbre words are: CLEAR, NOISY, FULL, THIN, ROUND, SHARP, SMOOTH, CHOPPY, STEADY, EVOLVING, STRONG, DELICATE, BRIGHT, GRACEFUL, SPARSE, BREATHY, STRAINED, BROAD, LIGHT, MELLOW, WOBBLING, FOCUSED, EVEN, FLUID, VIBRATING, QUAVERING, EERIE, FRAGILE, BRITTLE, PURE, PIERCING, STRIDENT, WAVERING, HARSH, REEDY, NASAL, BUZZY, ROUGH, WARM, RUGGED, HEAVY, FLAT, DARK, CRISP, SONOROUS, WATERY, GENTLE, SLICING, LIQUID, RAUCOUS, BREEZY, RASPY, WISPY, SHRILL, MUDDY, RICH, DULL, FLOATING, RINGING, RESONANT, SWEET, RIPPLING, SPARKLING.

|-
| {{text anchor|REGISTER}}
|
* min pitch
* max pitch
* any number of timbre words
| See [[#PITCH_RANGE|PITCH_RANGE]] and [[#TIMBRE|TIMBRE]] for possible values. The pitch range overrides the global pitch for a register, but the register timbres are added to the global ones.

|-
| {{text anchor|MUSIC_SKILL}}
|
* skill token
| The skill should be one of the music-related [[skill token]]s.

|}

Item definition token

2018-07-22T07:01:08Z

FortressBuilder:

{{Quality|Fine|07:17, 17 May 2015 (UTC)}}
{{av}}
'''Item definition tokens''' are used in item definitions in the raws.

Item types:
* ITEM_WEAPON - [[weapon token]]
* ITEM_TOY - see below
* ITEM_TOOL - [[tool token]]
* ITEM_INSTRUMENT - [[instrument token]]
* ITEM_TRAPCOMP - [[trap component token]]
* ITEM_ARMOR - [[Armor token|armor-type armor token]]
* ITEM_AMMO - [[ammo token]]
* ITEM_SIEGEAMMO - see below
* ITEM_GLOVES - [[Armor token|gloves-type armor token]]
* ITEM_SHOES - [[Armor token|shoes-type armor token]]
* ITEM_SHIELD - [[Armor token|shield-type armor token]]
* ITEM_HELM - [[Armor token|helm-type armor token]]
* ITEM_PANTS - [[Armor token|pants-type armor token]]
* ITEM_FOOD - see below

==Toy Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|NAME}}
| singular:plural
| What this item will be called ingame.

|-
| {{text anchor|HARD_MAT}}
|
| Presumably prevents the item from being made from cloth, silk, or leather, present on everything but puzzleboxes and drums. Appears to work backwards for [[strange mood]]s.

|}

==Siege Ammo Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|NAME}}
| singular:plural
| What this item will be called ingame.

|-
| {{text anchor|CLASS}}
|
| Specifies what type of siege engine uses this ammunition. Currently, only BALLISTA is permitted.

|}

==Food Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|NAME}}
| singular:plural
| What this item will be called ingame.

|-
| {{text anchor|LEVEL}}
|
| Specifies the number of ingredients are used in this type of prepared meal - 2 for Easy, 3 for Fine, 4 for Lavish. Defaults to 2.

|}

{{Category|Modding}}
{{Category|Tokens}}

Instrument token

2018-07-22T07:00:09Z

FortressBuilder: Created page with "Since v0.42.01, instruments are being procedurally generated for each world, but if so desired, it is still possible to define custom instruments in the raws, using an [IT..."

Since v0.42.01, [[instruments]] are being procedurally generated for each world, but if so desired, it is still possible to define custom instruments in the raws, using an [ITEM_INSTRUMENT] token. Most [[tool token]]s can be used as before, but there are a few instrument-specific tokens, as described in the table below.

The information on this page is sourced from the file <code>raw/objects/examples and notes/item_instrument_example.txt</code>, which also includes useful example instrument definitions.

{| {{prettytable}}
|- bgcolor="#999999"
! Token
! Arguments
! Description

|-
| {{text anchor|PLACED_AS_BUILDING}}
|
| Makes the instrument stationary.

|-
| {{text anchor|DOMINANT_MATERIAL_PIECE}}
|
* instrument piece
| Sets a piece as the central part of the instrument.

|-
| {{text anchor|INSTRUMENT_PIECE}}
|
* token
* tool token
* singular
* plural
* STANDARD/ALWAYS_PLURAL/ALWAYS_SINGULAR
| Defines an instrument piece. ''token'' is the identifier that can be used in other raw tags to refer to this instrument piece. ''tool token'' is the tool which is required (and consumed) during the construction process to create this instrument piece.

If an instrument does not have any pieces, SELF can be used for any argument which needs to be an instrument piece.

|-
| {{text anchor|VOLUME_mB}}
|
* min
* max
| The instrument's volume range, in Millibell (100 mB = 1 dB).

|-
| {{text anchor|SOUND_PRODUCTION}}
| * various tokens
| Defines how a musician can produce sound when using this instrument. Can be used multiple times. Valid tokens and their required additional arguments are:
* PLUCKED_BY_BP, PLUCKED (requires two tokens, actor then target)
* BOWED (two tokens)
* STRUCK_BY_BP, STRUCK (two tokens)
* VIBRATE_BP_AGAINST_OPENING
* BLOW_AGAINST_FIPPLE, BLOW_OVER_OPENING_SIDE, BLOW_OVER_OPENING_END, BLOW_OVER_SINGLE_REED, BLOW_OVER_DOUBLE_REED, BLOW_OVER_FREE_REED
* STRUCK_TOGETHER, SHAKEN
* SCRAPED (two tokens), FRICTION (two tokens)
* RESONATOR
* BAG_OVER_REED (two tokens), AIR_OVER_REED (two tokens), AIR_OVER_FREE_REED (two tokens), AIR_AGAINST_FIPPLE (two tokens)

|-
| {{text anchor|PITCH_CHOICE}}
|
* method
| Defines how the pitch can be varied by the musician. Can be used multiple times. Valid methods are:
* MEMBRANE_POSITION
* SUBPART_CHOICE
* KEYBOARD
* STOPPING_FRET (requires two tokens, first for "string" second for "neck" -- or whatever is being pressed against what), STOPPING_AGAINST_BODY (two tokens), STOPPING_HOLE, STOPPING_HOLE_KEY
* SLIDE
* HARMONIC_SERIES
* VALVE_ROUTES_AIR
* BP_IN_BELL
* FOOT_PEDALS (two token, first is what is being changed e.g. "strings", second is "body" which has pedalboard -- or whatever piece is being stepped on)

|-
| {{text anchor|TUNING}}
|
* method
* instrument piece
| Can be used multiple times. Valid methods are: PEGS, ADJUSTABLE_BRIDGES, CROOKS, TIGHTENING, LEVERS.

|-
| {{text anchor|PITCH_RANGE}
|
* min pitch
* max pitch
| From the example file:
<blockquote>Pitch is <min>:<max> in cents with middle C at zero. There are 1200 cents in an octave. The game verbally differentiates values from -4200 to 4200, but you can go outside that if you like. The in-game generated instruments will range from roughly C0 to C8 (-4800 to 4800), sometimes beyond for really unusual ones.

You can also use INDEFINITE_PITCH.
</blockquote>

|-
| {{text anchor|TIMBRE}}
|
* any number of timbre words
| Valid timbre words are: CLEAR, NOISY, FULL, THIN, ROUND, SHARP, SMOOTH, CHOPPY, STEADY, EVOLVING, STRONG, DELICATE, BRIGHT, GRACEFUL, SPARSE, BREATHY, STRAINED, BROAD, LIGHT, MELLOW, WOBBLING, FOCUSED, EVEN, FLUID, VIBRATING, QUAVERING, EERIE, FRAGILE, BRITTLE, PURE, PIERCING, STRIDENT, WAVERING, HARSH, REEDY, NASAL, BUZZY, ROUGH, WARM, RUGGED, HEAVY, FLAT, DARK, CRISP, SONOROUS, WATERY, GENTLE, SLICING, LIQUID, RAUCOUS, BREEZY, RASPY, WISPY, SHRILL, MUDDY, RICH, DULL, FLOATING, RINGING, RESONANT, SWEET, RIPPLING, SPARKLING.

|-
| {{text anchor|REGISTER}}
|
* min pitch
* max pitch
* any number of timbre words
| See [[#PITCH_RANGE|PITCH_RANGE]] and [[#TIMBRE|TIMBRE]] for possible values. The pitch range overrides the global pitch for a register, but the register timbres are added to the global ones.

|-
| {{text anchor|MUSIC_SKILL}}
|
* skill token
| The skill should be one of the music-related [[skill token]]s.

|}

Material definition token

2018-05-11T20:20:14Z

FortressBuilder: /* Material Properties */ Add PAPER_PLANT and PAPER_SLURRY as possible values for REACTION_CLASS

{{Quality|Fine|11:11, 18 May 2015 (UTC)}}
{{av}}

The following tokens can be used in material definitions (whether for inorganics or those within plants and creatures) as well as in material templates.

==Material Properties==
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| {{text_anchor|PREFIX}}
|
* string or NONE
| Applies a prefix to all items made from the material. For PLANT and CREATURE materials, this defaults to the plant/creature name. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|STONE_NAME}}
|
* string
| Overrides the name of mined out stones (used for native copper/silver/gold/platinum to make them be called "nuggets").

|-
| {{text_anchor|IS_GEM}}
|
* name
* plural
* state
| Used to indicate that said material is a gemstone - when tiles are mined out, rough gems will be yielded instead of boulders. Plural can be "STP" to automatically append an "s" to the singular form, and OVERWRITE_SOLID will override the relevant STATE_NAME and STATE_ADJ values.

|-
| {{text_anchor|TEMP_DIET_INFO}}
|
* type
| Specifies what the material should be treated as when drinking water contaminated by it, for generating unhappy [[thought]]s. Valid values are BLOOD, SLIME, VOMIT, ICHOR, PUS, GOO, GRIME, and FILTH.

|-
| {{text_anchor|POWDER_DYE}}
| [[color|color name]]
| Allows the material to be used as [[dye]], and defines color of dyed items.

|-
| {{text_anchor|TILE}}
| [[Main:Character table|tile]]
| Specifies the tile that will be used to represent unmined tiles made of this material. Generally only used with stones. Defaults to 219 ('█').

|-
| {{text_anchor|ITEM_SYMBOL}}
| tile
| Specifies the tile that will be used to represent BOULDER objects made of this material. Generally only used with stones. Defaults to 7 ('•').

|-
| {{text_anchor|DISPLAY_COLOR}}
|
*foreground color
*background color
*foreground brightness
| The on-screen color of the material. Uses a standard 3-digit [[Color|color token]]. Equivalent to [TILE_COLOR:a:b:c], [BUILD_COLOR:b:a:X] (X = 1 if 'a' equals 'b', 0 otherwise), and [BASIC_COLOR:a:c]

|-
| {{text_anchor|BUILD_COLOR}}
|
*foreground color
*background color
*foreground brightness
| The color of objects made of this material which use both the foreground and background color: [[door]]s, [[floodgate]]s, [[hatch cover]]s, [[bin]]s, [[barrel]]s, and [[cage]]s. Defaults to 7:7:1 (white).

|-
| {{text_anchor|TILE_COLOR}}
|
*foreground color
*background color
*foreground brightness
| The color of unmined tiles containing this material (for stone and soil), as well as [[engraving]]s in this material. Defaults to 7:7:1 (white).

|-
| {{text_anchor|BASIC_COLOR}}
|
*color
*brightness
| The color of objects made of this material which use only the foreground color, including workshops, floors and boulders, and smoothed walls. Defaults to 7:1 (white).

|-
| {{text_anchor|STATE_COLOR}}
|
*state
*[[color]] token
| The state may be SOLID, LIQUID, GAS, POWDER/SOLID_POWDER, PASTE/SOLID_PASTE, PRESSED/SOLID_PRESSED, ALL_SOLID, or ALL.
Color comes from descriptor_color_standard.txt and is used to indicate the color of the material. The nearest color value is used to display contaminants and body parts made of this material.
[STATE_COLOR:ALL_SOLID:GRAY]

|-
| {{text_anchor|STATE_NAME}}
|
*state
*name
| The name of the material as displayed in-game.
[STATE_NAME:ALL_SOLID:stone]

|-
| {{text_anchor|STATE_NAME_ADJ}}
|
*state
*name/adjective
| Sets both STATE_NAME and STATE_ADJ at the same time.

|-
| {{text_anchor|STATE_ADJ}}
|
*state
*adjective
| Like STATE_NAME, but used in different situations. Equipment made from the material uses the state adjective and not the state name.

|-
| {{text_anchor|ABSORPTION}}
|
*value
| The material's tendency to absorb liquids. Containers made of materials with nonzero absorption cannot hold liquids unless they have been [[glaze]]d. Defaults to 0.

|-
| {{text_anchor|IMPACT_YIELD}}
|
*value
| Specifies how hard of an impact (in kilopascals) the material can withstand before it will start deforming permanently. Used for blunt-force combat. Defaults to 10000.

|-
| {{text_anchor|IMPACT_FRACTURE}}
|
*value
| Specifies how hard of an impact the material can withstand before it will fail entirely. Used for blunt-force combat. Defaults to 10000.

|-
| {{text_anchor|IMPACT_STRAIN_AT_YIELD}} or {{text_anchor|IMPACT_ELASTICITY}}
|
*value
| Specifies how much the material will have given (in parts-per-100000) when the yield point is reached. Used for blunt-force combat. Defaults to 0. Apparently affects in combat whether the corresponding tissue is bruised (value >= 50000), torn (value between 25000 and 49999), or fractured (value <= 24999)

|-
| {{text_anchor|COMPRESSIVE_YIELD}}
|
*value
| Specifies how hard the material can be compressed before it will start deforming permanently. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 10000.

|-
| {{text_anchor|COMPRESSIVE_FRACTURE}}
|
*value
| Specifies how hard the material can be compressed before it will fail entirely. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 10000.

|-
| {{text_anchor|COMPRESSIVE_STRAIN_AT_YIELD}} or {{text_anchor|COMPRESSIVE_ELASTICITY}}
|
*value
| Specifies how much the material will have given when it has been compressed to its yield point. Determines a tissue's resistance to pinching and response to strangulation. Defaults to 0.

|-
| {{text_anchor|TENSILE_YIELD}}
|
*value
| Specifies how hard the material can be stretched before it will start deforming permanently. Determines a tissue's resistance to a latching and tearing bite. Defaults to 10000.

|-
| {{text_anchor|TENSILE_FRACTURE}}
|
*value
| Specifies how hard the material can be stretched before it will fail entirely. Determines a tissue's resistance to a latching and tearing bite. Defaults to 10000.

|-
| {{text_anchor|TENSILE_STRAIN_AT_YIELD}} or {{text_anchor|TENSILE_ELASTICITY}}
|
*value
| Specifies how much the material will have given when it is stretched to its yield point. Determines a tissue's resistance to a latching and tearing bite. Defaults to 0.

|-
| {{text_anchor|TORSION_YIELD}}
|
*value
| Specifies how hard the material can be twisted before it will start deforming permanently. Used for latching and shaking with a blunt attack (no default creature has such an attack, but they can be modded in). Defaults to 10000.

|-
| {{text_anchor|TORSION_FRACTURE}}
|
*value
| Specifies how hard the material can be twisted before it will fail entirely. Used for latching and shaking with a blunt attack (no default creature has such an attack, but they can be modded in). Defaults to 10000.

|-
| {{text_anchor|TORSION_STRAIN_AT_YIELD}} or {{text_anchor|TORSION_ELASTICITY}}
|
*value
| Specifies how much the material will have given when it is twisted to its yield point. Used for latching and shaking with a blunt attack (no default creature has such an attack, but they can be modded in). Defaults to 0.

|-
| {{text_anchor|SHEAR_YIELD}}
|
*value
| Specifies how hard the material can be sheared before it will start deforming permanently. Used for cutting calculations. Defaults to 10000.

|-
| {{text_anchor|SHEAR_FRACTURE}}
|
*value
| Specifies how hard the material can be sheared before it will fail entirely. Used for cutting calculations. Defaults to 10000.

|-
| {{text_anchor|SHEAR_STRAIN_AT_YIELD}} or {{text_anchor|SHEAR_ELASTICITY}}
|
*value
| Specifies how much the material will have given when sheared to its yield point. Used for cutting calculations. Defaults to 0.

|-
| {{text_anchor|BENDING_YIELD}}
|
*value
| Specifies how hard the material can be bent before it will start deforming permanently. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 10000.

|-
| {{text_anchor|BENDING_FRACTURE}}
|
*value
| Specifies how hard the material can be bent before it will fail entirely. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 10000.

|-
| {{text_anchor|BENDING_STRAIN_AT_YIELD}} or {{text_anchor|BENDING_ELASTICITY}}
|
*value
| Specifies how much the material will have given when bent to its yield point. Determines a tissue's resistance to being mangled with a joint lock. Defaults to 0.

|-
| {{text_anchor|MAX_EDGE}}
|
*value
| How sharp the material is. Used in cutting calculations. Does not allow an inferior metal to penetrate superior armor. Applying a value of at least 10000 to a stone will allow weapons to be made from that stone. Defaults to 10000.

|-
| {{text_anchor|MATERIAL_VALUE}}
|
*value
| Value modifier for the material. Defaults to 1. This number can be made negative by placing a "-" in front, resulting in things that you are paid to buy and must pay to sell.

|-
| {{text_anchor|MULTIPLY_VALUE}}
|
*value
| Multiplies the value of the material. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|SPEC_HEAT}}
|
*specific heat capacity
| Rate at which the material heats up or cools down (in joules/kilokelvin). See [[Temperature]] for more information. Defaults to NONE.

|-
| {{text_anchor|HEATDAM_POINT}}
|
*temperature
| Temperature above which the material takes damage from heat. May be set to NONE. If the material has an ignite point but no heatdam point, it will burn for a very long time (9 months and 16.8 days). Defaults to NONE.

|-
| {{text_anchor|COLDDAM_POINT}}
|
*temperature
| Temperature below which the material takes damage from cold. Defaults to NONE.

|-
| {{text_anchor|IGNITE_POINT}}
|
*temperature
| Temperature at which the material will catch fire. Defaults to NONE.

|-
| {{text_anchor|MELTING_POINT}}
|
*temperature
| Temperature at which the material melts. Defaults to NONE.

|-
| {{text_anchor|BOILING_POINT}}
|
*temperature
| Temperature at which the material boils. Defaults to NONE.

|-
| {{text_anchor|MAT_FIXED_TEMP}}
|
*temperature
| Constant temperature emitted by the material. Defaults to NONE.

|-
| {{text_anchor|IF_EXISTS_SET_HEATDAM_POINT}}
|
*temperature
| Changes a material's HEATDAM_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_COLDDAM_POINT}}
|
*temperature
| Changes a material's COLDDAM_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_IGNITE_POINT}}
|
*temperature
| Changes a material's IGNITE_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_MELTING_POINT}}
|
*temperature
| Changes a material's MELTING_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_BOILING_POINT}}
|
*temperature
| Changes a material's BOILING_POINT, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|IF_EXISTS_SET_MAT_FIXED_TEMP}}
|
*temperature
| Changes a material's MAT_FIXED_TEMP, but only if it was not set to NONE. '''Not permitted in material template definitions.'''

|-
| {{text_anchor|SOLID_DENSITY}}
|
*density
| Specifies the density (in kilograms per cubic meter) of the material when in solid form. Also affects combat calculations; affects blunt-force damage and ability of edged weapons to pierce tissue layers{{verify}}. Defaults to NONE.

|-
| {{text_anchor|LIQUID_DENSITY}}
|
*density
| Specifies the density of the material when in liquid form. Defaults to NONE.

|-
| {{text_anchor|MOLAR_MASS}}
|
*value
| Supposedly not used{{verify}}. Theoretically, should determine density (at given pressure) in gas state, on which in turn would depend (together with weight of vaporized material) on the volume covered by spreading vapors. Defaults to NONE.

|-
| {{text_anchor|EXTRACT_STORAGE}}
| BARREL or FLASK
| Specifies the type of container used to store the material. Used in conjunction with the [EXTRACT_BARREL], [EXTRACT_VIAL], or [EXTRACT_STILL_VIAL] [[plant token]]s. Defaults to BARREL.

|-
| {{text_anchor|BUTCHER_SPECIAL}}
|
*[[item token]]
| Specifies the item type used for butchering results made of this material. Stock raws use GLOB:NONE for fat and MEAT:NONE for other meat materials.

|-
| {{text_anchor|MEAT_NAME}}
|
*prefix
*name
*adjective
| When a creature is butchered, meat yielded from organs made from this material will be named via this token.

|-
| {{text_anchor|BLOCK_NAME}}
|
*singular
*plural
| Specifies the name of [[block]]s made from this material.

|-
| {{text_anchor|WAFERS}}
|
| The material forms "wafers" instead of "[[bar]]s".

|-
| {{text_anchor|MATERIAL_REACTION_PRODUCT}}
|
*reaction reference
*[[material token]]
| Used with reaction raws to associate a reagent material with a product material. The first argument is used by HAS_MATERIAL_REACTION_PRODUCT and GET_MATERIAL_FROM_REAGENT in reaction raws. The remainder is a material reference, generally LOCAL_CREATURE_MAT:SUBTYPE or LOCAL_PLANT_MAT:SUBTYPE or INORGANIC:STONETYPE.
[MATERIAL_REACTION_PRODUCT:TAN_MAT:LOCAL_CREATURE_MAT:LEATHER]

|-
| {{text_anchor|ITEM_REACTION_PRODUCT}}
|
*item reference
*[[item token]]
*[[material token]]
| Used with reaction raws to associate a reagent material with a complete item. The first argument is used by HAS_ITEM_REACTION_PRODUCT and GET_ITEM_DATA_FROM_REAGENT in reaction raws. The rest refers to the type of item, then its material.
[ITEM_REACTION_PRODUCT:BAG_ITEM:PLANT_GROWTH:LEAVES:LOCAL_PLANT_MAT:LEAF]

|-
| {{text_anchor|REACTION_CLASS}}
|
*reaction reference
| Used to classify all items made of the material, so that reactions can use them as generic reagents.
In default raws, the following are used:
* FAT, TALLOW, SOAP, PARCHMENT, PAPER_PLANT, PAPER_SLURRY, MILK, CHEESE, WAX
* CAN_GLAZE - items made from this material can be glazed.
* FLUX - can be used as [[flux]] in pig iron and steel making.
* GYPSUM - can be processed into [[gypsum plaster]].
* CALCIUM_CARBONATE - can be used in production of [[quicklime]].{{version|0.42.01}}

|-
| {{text_anchor|METAL_ORE}}
|
* MATERIAL_NAME
* value
| Makes BOULDER acceptable as a [[Reactions#Reagents|reagent]] in reactions that require [[Item_token#Related_Tokens|"METAL_ORE:MATERIAL_NAME"]], as well as [[Smelter|smelting]] directly into metal [[bar]]s.<br /> Places the material under "Metal Ores" in Stone stockpiles.<br /> Value determines the probability for this product (see [[Tetrahedrite]] or [[Galena]] for details).

|-
| {{text_anchor|THREAD_METAL}}
|
* MATERIAL_NAME
* value
| Makes BOULDER acceptable for [[Strand extractor|strand extraction]] into threads; see also STOCKPILE_THREAD_METAL. Value presumably determines the probability of this product extracted.{{verify}}

|-
| {{text_anchor|HARDENS_WITH_WATER}}
|
* [[material token]]
| Allows the material to be used to make [[healthcare|casts]].

|-
| {{text_anchor|SOAP_LEVEL}}
|
*value
| [[Soap]] has [SOAP_LEVEL:2]. Effects unknown. Defaults to 0.

|-
| {{text_anchor|SYNDROME}}
|
| Begins defining a [[syndrome]] applied by the material. Multiple syndromes can be specified. See [[Syndrome token]].
|}

==Material Usage Tokens==
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| {{text_anchor|IMPLIES_ANIMAL_KILL}}
|
| Lets the game know that an animal was likely killed in the production of this item. Entities opposed to killing animals (which currently does '''not''' include Elves) will refuse to accept these items in trade.

|-
| {{text_anchor|ALCOHOL_PLANT}}
|
| Classifies the material as plant-based alcohol, allowing its storage in food stockpiles under "Drink (Plant)".

|-
| {{text_anchor|ALCOHOL_CREATURE}}
|
| Classifies the material as animal-based alcohol, allowing its storage in food stockpiles under "Drink (Animal)".

|-
| {{text_anchor|ALCOHOL}}
|
| Classifies the material as generic alcohol. Implied by both ALCOHOL_PLANT and ALCOHOL_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|CHEESE_PLANT}}
|
| Classifies the material as plant-based cheese, allowing its storage in food stockpiles under "Cheese (Plant)".

|-
| {{text_anchor|CHEESE_CREATURE}}
|
| Classifies the material as animal-based cheese, allowing its storage in food stockpiles under "Cheese (Animal)".

|-
| {{text_anchor|CHEESE}}
|
| Classifies the material as generic cheese. Implied by both CHEESE_PLANT and CHEESE_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|POWDER_MISC_PLANT}}
|
| Classifies the material as plant powder, allowing its storage in in food stockpiles under "Milled Plant".

|-
| {{text_anchor|POWDER_MISC_CREATURE}}
|
| Classifies the material as creature powder, allowing its storage in food stockpiles under "Bone Meal".

|-
| {{text_anchor|POWDER_MISC}}
|
| Classifies the material as generic powder. Implied by both POWDER_MISC_PLANT and POWDER_MISC_CREATURE. Exact behavior unknown, possibly vestigial.

|-
| {{text_anchor|STOCKPILE_GLOB}} or {{text_anchor|STOCKPILE_GLOB_SOLID}}
|
| Permits globs of the material in solid form to be stored in food stockpiles under "Fat" - without it, dwarves will come by and "clean" the items, destroying them (unless [DO_NOT_CLEAN_GLOB] is also included).

|-
| {{text_anchor|STOCKPILE_GLOB_PASTE}}
|
| Classifies the material as milled paste, allowing its storage in food stockpiles under "Paste".

|-
| {{text_anchor|STOCKPILE_GLOB_PRESSED}}
|
| Classifies the material as pressed goods, allowing its storage in food stockpiles under "Pressed Material".

|-
| {{text_anchor|STOCKPILE_PLANT_GROWTH}}
|
| Classifies the material as a plant growth (e.g. fruits, leaves), allowing its storage in food stockpiles under Plant Growth/Fruit.

|-
| {{text_anchor|LIQUID_MISC_PLANT}}
|
| Classifies the material as a plant extract, allowing its storage in food stockpiles under "Extract (Plant)".

|-
| {{text_anchor|LIQUID_MISC_CREATURE}}
|
| Classifies the material as a creature extract, allowing its storage in food stockpiles under "Extract (Animal)".

|-
| {{text_anchor|LIQUID_MISC_OTHER}}
|
| Classifies the material as a miscellaneous liquid, allowing its storage in food stockpiles under "Misc. Liquid" along with lye.

|-
| {{text_anchor|LIQUID_MISC}}
|
| Classifies the material as a generic liquid. Implied by LIQUID_MISC_PLANT, LIQUID_MISC_CREATURE, and LIQUID_MISC_OTHER. Exact behavior unknown. Possibly vestigial.

|-
| {{text_anchor|STRUCTURAL_PLANT_MAT}}
|
| Classifies the material as plant, allowing its storage in food stockpiles under "Plants".

|-
| {{text_anchor|SEED_MAT}}
|
| Classifies the material as plant seed, allowing its storage in food stockpiles under "Seeds".

|-
| {{text_anchor|BONE}}
|
| Classifies the material as bone, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|WOOD}}
|
| Classifies the material as wood, allowing its use for carpenters and storage in wood stockpiles. Entities opposed to killing plants (i.e. [[Elf|Elves]]) will refuse to accept these items in trade.

|-
| {{text_anchor|THREAD_PLANT}}
|
| Classifies the material as plant fiber, allowing its use for clothiers and storage in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".

|-
| {{text_anchor|TOOTH}}
|
| Classifies the material as tooth, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|HORN}}
|
| Classifies the material as horn, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|PEARL}}
|
| Classifies the material as pearl, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|SHELL}}
|
| Classifies the material as shell, allowing its use for bone carvers and restriction from stockpiles by material.

|-
| {{text_anchor|LEATHER}}
|
| Classifies the material as leather, allowing its use for leatherworkers and storage in leather stockpiles.

|-
| {{text_anchor|SILK}}
|
| Classifies the material as silk, allowing its use for clothiers and storage in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".

|-
| {{text_anchor|SOAP}}
|
| Classifies the material as soap, allowing it to be used as a bath detergent and stored in bar/block stockpiles under "Bars: Other Materials".{{verify}}

|-
| {{text_anchor|GENERATES_MIASMA}}
|
| Material generates miasma when it rots

|-
| {{text_anchor|MEAT}}
|
| Classifies the material as edible meat.{{verify}}

|-
| {{text_anchor|ROTS}}
|
| Material will rot if not stockpiled appropriately

|-
| {{text_anchor|BLOOD_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "blood" in Adventurer mode tile descriptions ("Here we have a Dwarf in a slurry of blood.").

|-
| {{text_anchor|ICHOR_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "ichor".

|-
| {{text_anchor|GOO_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "goo".

|-
| {{text_anchor|SLIME_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "slime".

|-
| {{text_anchor|PUS_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "pus".

|-
| {{text_anchor|SWEAT_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "sweat".

|-
| {{text_anchor|TEARS_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "tears".

|-
| {{text_anchor|SPIT_MAP_DESCRIPTOR}}
|
| Tells the game to classify contaminants of this material as being "spit".

|-
| {{text_anchor|EVAPORATES}}
|
| Contaminants composed of this material evaporate over time, slowly disappearing from the map. Used internally by water.

|-
| {{text_anchor|ENTERS_BLOOD}}
|
| Used for materials which cause [[syndrome]]s, causes it to enter the creature's blood instead of simply spattering on the surface.

|-
| {{text_anchor|EDIBLE_VERMIN}}
|
| Can be eaten by vermin.

|-
| {{text_anchor|EDIBLE_RAW}}
|
| Can be eaten raw.

|-
| {{text_anchor|EDIBLE_COOKED}}
|
| Can be cooked and then eaten.

|-
| {{text_anchor|DO_NOT_CLEAN_GLOB}}
|
| Prevents globs made of this material from being cleaned up and destroyed.

|-
| {{text_anchor|NO_STONE_STOCKPILE}}
|
| Prevents the material from showing up in Stone stockpile settings.

|-
| {{text_anchor|ITEMS_METAL}}
|
| Allows the creation of metal furniture at the metalsmith's forge.

|-
| {{text_anchor|ITEMS_BARRED}}
|
| Equivalent to ITEMS_HARD. Given to [[bone]].

|-
| {{text_anchor|ITEMS_SCALED}}
|
| Equivalent to ITEMS_HARD. Given to [[shell]].

|-
| {{text_anchor|ITEMS_LEATHER}}
|
| Equivalent to ITEMS_SOFT. Given to [[leather]].

|-
| {{text_anchor|ITEMS_SOFT}}
|
| Random [[finished goods|crafts]] made from this material can not be made into rings, crowns, scepters or figurines. Given to [[plant fiber]], [[silk]] and [[wool]].

|-
| {{text_anchor|ITEMS_HARD}}
|
| Random [[finished goods|crafts]] made from this material include all seven items. Given to [[stone]], [[wood]], [[bone]], [[shell]], [[chitin]], [[nail|claws]], [[tooth|teeth]], [[horn|horns]], [[horn|hooves]] and [[wax|beeswax]]. [[Hair]], [[pearl|pearls]] and eggshells also have the tag.

|-
| {{text_anchor|IS_STONE}}
|
| Used to define that said material is stone. Allows its storage in stone stockpiles, among other effects.

|-
| {{text_anchor|UNDIGGABLE}}
|
| Used for a stone that cannot be dug into.

|-
| {{text_anchor|DISPLAY_UNGLAZED}}
|
| Causes containers made of this material to be prefixed with "unglazed" if they have not yet been [[glaze]]d.

|-
| {{text_anchor|YARN}}
|
| Classifies the material as yarn, allowing its use for clothiers and its storage in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".

|-
| {{text_anchor|STOCKPILE_THREAD_METAL}}
|
| Classifies the material as metal thread, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Metal)" and "Cloth (Metal)".

|-
| {{text_anchor|IS_METAL}}
|
| Defines the material as being metal, allowing it to be used at forges.

|-
| {{text_anchor|IS_GLASS}}
|
| Used internally by green glass, clear glass, and crystal glass.

|-
| {{text_anchor|CRYSTAL_GLASSABLE}}
|
| Can be used in the production of crystal glass.

|-
| {{text_anchor|ITEMS_WEAPON}}
|
| Melee [[Weapon#Manufactured weapons|weapons]] can be made out of this material.

|-
| {{text_anchor|ITEMS_WEAPON_RANGED}}
|
| Ranged weapons can be made out of this material.

|-
| {{text_anchor|ITEMS_ANVIL}}
|
| [[Anvil]]s can be made out of this material.

|-
| {{text_anchor|ITEMS_AMMO}}
|
| [[Weapon#Ammunition|Ammunition]] can be made out of this material.

|-
| {{text_anchor|ITEMS_DIGGER}}
|
| [[Weapon#Dwarf-manufactured weapons|Picks]] can be made out of this material.

|-
| {{text_anchor|ITEMS_ARMOR}}
|
| [[Armor]] can be made out of this material.

|-
| {{text_anchor|ITEMS_DELICATE}}
|
| Used internally by amber and coral. Functionally equivalent to ITEMS_HARD.

|-
| {{text_anchor|ITEMS_SIEGE_ENGINE}}
|
| Siege engine parts can be made out of this material. Does not appear to work.

|-
| {{text_anchor|ITEMS_QUERN}}
|
| Querns and millstones can be made out of this material.{{verify}}
|}

==Syndrome tokens==

For more details, see the [[Syndrome token]] page.

{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| {{text_anchor|SYN_NAME
|
* text
| Defines the name of the syndrome

|-
| {{text_anchor|SYN_INJECTED}}
|
| Syndrome can be contracted by injection (by a creature)

|-
| {{text_anchor|SYN_CONTACT}}
|
| Syndrome can be contracted on contact (e.g. poison dust or liquid)

|-
| {{text_anchor|SYN_INHALED}}
|
| Syndrome can be contracted by inhalation (e.g. poison vapor or gas)

|-
| {{text_anchor|SYN_INGESTED}}
|
| Syndrome can be contracted by ingestion (when the material is eaten in solid or liquid form)

|-
| {{text_anchor|SYN_AFFECTED_CLASS}}
|
* creature class name
| Adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| {{text_anchor|SYN_IMMUNE_CLASS}}
|
* creature class name
| Makes the class of creatures immune to the syndrome

|-
| {{text_anchor|SYN_AFFECTED_CREATURE}}
|
* creature name
* caste name or ALL
| Adds a specific creature to those affected.

|-
| {{text_anchor|SYN_IMMUNE_CREATURE}}
|
* creature name
* caste name or ALL
| Makes the creature immune to the syndrome

|-
| CE_PAIN<br />CE_SWELLING<br />CE_OOZING<br />CE_BRUISING<br />CE_BLISTERS<br />CE_NUMBNESS<br />CE_PARALYSIS<br />CE_FEVER<br />CE_BLEEDING<br />CE_COUGH_BLOOD<br />CE_VOMIT_BLOOD<br />CE_NAUSEA<br />CE_UNCONSCIOUSNESS<br />CE_NECROSIS<br />CE_IMPAIR_FUNCTION<br />CE_DROWSINESS<br />CE_DIZZINESS
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place affected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:BY_CATEGORY:category:tissue (optional)
*BP:BY_TYPE:type:tissue (optional)
*BP:BY_TOKEN:token:tissue (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the [[Syndrome#Creature effect tokens|Syndromes page]]

|}

==See Also==
* [[Inorganic material definition token]]
* [[Syndrome]]

{{Category|Modding}}
{{Category|Tokens}}

Speech file

2018-03-19T12:34:35Z

FortressBuilder: Scout speech files were removed recently

'''Speech files''' are text files that define sentences which can be spoken by people in [[adventure mode]]. They are found in the <code>data/speech</code> folder.

== List of files ==

{| class="wikitable"
! File !! Uses !! Example
|-
| {{text anchor|ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|animal_slayer}}
|
| I have taken down [CONTEXT:NUMBER] [CONTEXT:RACE:NUMBERED_NAME] while stalking [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|arch_info_justification}}
|
| It is said that the [CONTEXT:ARCH_ELEMENT] of [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] [CONTEXT:JUSTIFICATION] [CONTEXT:DEF_SPHERE] for the glory of [CONTEXT:HIST_FIG:TRANS_NAME].

|-
| {{text anchor|child_age_proclamation}}
|
| I'm [CONTEXT:NUMBER]!

|-
| {{text anchor|current_profession_no_year}}
|
| I am a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|current_profession_year}}
|
| This is my [CONTEXT:ORDINAL] year as a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|curse}}
|
| Who dares to enter my house? I curse you!

|-
| {{text anchor|dwarf}}
| Used when boasting about killing a [[dwarf]]. See also [[Creature token#SPEECH]].
| whose hammer shattered on the anvil of my power

|-
| {{text anchor|elf}}
| Used when boasting about killing an [[elf]]. See also [[Creature token#SPEECH]].
| whose fragile bones shattered before the power of my contempt

|-
| {{text anchor|family_relationship_additional}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] is also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_additional_dead}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] was also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_no_spec}}
|
| I have [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_no_spec_dead}}
|
| I had [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] is named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec_dead}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] was named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|general}}
|
| who lies dead, now only an embarrassing memory

|-
| {{text anchor|goodbye_worship_1}}
|
| upon arising in the mornings,

|-
| {{text anchor|goodbye_worship_2}}
|
| always remember to

|-
| {{text anchor|goodbye_worship_3}}
|
| speak the praises of [SPEAKER:HF_LINK:DEITY:RANDOM_DEF_SPHERE]

|-
| {{text anchor|greet}}
| Used when greeting another person.
| Greetings. My name is [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_baby}}
| Used when greeting a [[baby]].
| A baby! How adorable!

|-
| {{text anchor|greet_reply}}
| Used when replying to another person's greeting.
| Ah, hello. I'm [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_after_hero}}
| Used by NPCs when replying to the player character's greeting after becoming a [[hero]].
| I am [SPEAKER:TRANS_NAME]. How can I be of service?

|-
| {{text anchor|greet_reply_diff_language}}
| Used when replying to the greeting of a person which is of another [[race]].
| Hello, [AUDIENCE:RACE]. I am [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_unusual_first}}
| Used when replying to the greeting of a person whose first name is unusual.{{verify|June 2015}}
| You know, you don't meet many people with the name [AUDIENCE:FIRST_NAME]

|-
| {{text anchor|greet_worship}}
| Used for greetings by [[priest]]s and faithful people.{{verify|June 2015}}
| This servant of [SPEAKER:HF_LINK:DEITY:TRANS_NAME] greets you.

|-
| {{text anchor|guard_profession}}
| Used by [[guard]]s when you ask them about their profession. See also [[#soldier_profession|soldier_profession]].
| I am a guard.

|-
| {{text anchor|guard_warning}}
|
| Don't start any trouble.

|-
| {{text anchor|hist_fig_slayer}}
|
| It is I that felled [CONTEXT:HIST_FIG:TRANS_NAME] the [CONTEXT:HIST_FIG:RACE].

|-
| {{text anchor|hunting_profession}}
|
| I hunt great beasts in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|hunting_profession_year}}
|
| I have hunted great beasts in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|justification_antithetical}}
|
| can be thought of as the antithesis of

|-
| {{text anchor|justification_experience}}
|
| can allow one to experience

|-
| {{text anchor|justification_proximity}}
|
| can bring one near to

|-
| {{text anchor|justification_reminder}}
|
| can remind one of

|-
| {{text anchor|justification_representation}}
|
| can be thought of as a representation of

|-
| {{text anchor|lair_hunter_minotaur}}
| Used by [[minotaur]]s while hunting adventures in their lairs. See also [[Creature token#LAIR_HUNTER_SPEECH]].
| I'll eat you whole!

|-
| {{text anchor|mercenary_profession}}
|
| I seek fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|mercenary_profession_year}}
|
| I have sought fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|no_family}}
| Used by NPCs when you ask them about their [[family]], but they don't have any.
| I have no family to speak of.

|-
| {{text anchor|past_hunting_profession}}
|
| In the past, I hunted great beasts.

|-
| {{text anchor|past_mercenary_profession}}
|
| In the past, I sought fortune and glory by offering my skill at arms.

|-
| {{text anchor|past_profession_no_year}}
|
| I was once a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|past_profession_year}}
|
| I was a [CONTEXT:UNIT_NAME] for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|past_scouting_profession}}
|
| At one time, I was a scout.

|-
| {{text anchor|past_snatcher_profession}}
|
| Once it was my calling to rescue lost children.

|-
| {{text anchor|past_thief_profession}}
|
| I once sought great treasures.

|-
| {{text anchor|past_wandering_profession}}
|
| I once wandered the wilds.

|-
| {{text anchor|positive}}
| Used to express positive [[feeling]]s.
| wonderful!<br/>fantastic!<br/>very good

|-
| {{text anchor|same_site_ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME]

|-
| {{text anchor|same_site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|scouting_profession}} (removed in 0.44.01)
|
| It is my duty to scout the area around [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|scouting_profession_year}} (removed in 0.44.01)
|
| I have been scouting the area around [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|slayer}}
|
| bane<br/>death<br/>nemesis<br/>vanquisher

|-
| {{text anchor|snatcher_profession}}
|
| I rescue lost children and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|snatcher_profession_year}}
|
| For [CONTEXT:NUMBER] of my years, I have been rescuing lost children and bringing them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|soldier_profession}}
| Used by [[soldier]]s when you ask them about their profession. See also [[#guard_profession|guard_profession]].
| I am a soldier.

|-
| {{text anchor|task_recommendation}}
|
| [CONTEXT:ANY:TRANS_NAME] might have a task for you

|-
| {{text anchor|temple_already_member}}
|
| your task is simple;<br/>all you need is to

|-
| {{text anchor|temple_become_member}}
|
| Welcome to [CONTEXT:ENTITY:TRANS_NAME]. Praise be to [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME]!<br/>As a member of [CONTEXT:ENTITY:TRANS_NAME], you can now seek the higher mysteries of [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME].

|-
| {{text anchor|thief_profession}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|thief_profession_year}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME] and have done so for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|threat}}
| Used by NPC [[bandit]]s{{verify|June 2015}} before attacking you.
| Prepare to die!

|-
| {{text anchor|unknown_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME], wherever [CONTEXT:HIST_FIG:PRO_SUB] might be

|-
| {{text anchor|wandering_profession}}
|
| I wander [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|wandering_profession_year}}
|
| I have wandered [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.
|}

== Adding custom files ==

While any of the hardcoded speech files can be edited to customize the used phrases, it is also possible to add new files and associate them with custom creatures.

{| class="wikitable"
|+ [[Creature token]]s
! Token !! Example uses

|-
| [[Creature token#CASTE_SPEECH|CASTE_SPEECH]]
|

|-
| [[Creature token#LAIR_HUNTER_SPEECH|LAIR_HUNTER_SPEECH]]
| [[minotaur]] ([[#lair_hunter_minotaur|lair_hunter_minotaur.txt]])

|-
| [[Creature token#SPEECH|SPEECH]]
| [[dwarf]] ([[#dwarf|dwarf.txt]]), [[elf]] ([[#elf|elf.txt]])

|-
| [[Creature token#SPEECH_FEMALE|SPEECH_FEMALE]]
|

|-
| [[Creature token#SPEECH_MALE|SPEECH_MALE]]
|
|}

== Special tokens ==

Speech files can contain tokens in square brackets (<code>[]</code>), which are replaced with context-specific strings before the speech is displayed.

=== Context tokens ===

These give special information about the background of the conversation.

{| class="wikitable"
! Token !! Type !! Meaning

|-
| [CONTEXT:ABSTRACT_BUILDING]
| building
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the building in which the historical figure the speaker wants you to seek is

|-
| [CONTEXT:HIST_FIG]
| creature
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the historical figure the speaker wants you to seek

|-
| [CONTEXT:NUMBER]
| number
|
* [[#animal_slayer|animal_slayer]]: number of animals slain
* [[#child_age_proclamation|child_age_proclamation]]: age in years of the child

|-
| [CONTEXT:ORDINAL]
| number
|
* [[#current_profession_year|current_profession_year]]: the number of years the speaker has had their profession

|-
| [CONTEXT:PLACE]
| site
|
* [[#animal_slayer|animal_slayer]]: the place where the speaker slayed the animals

|-
| [CONTEXT:RACE]
| race
|
* [[#animal_slayer|animal_slayer]]: the race of the animals the speaker has slain

|-
| [CONTEXT:SITE]
| site
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the site where the historical figure the speaker wants you to seek is

|-
| [CONTEXT:UNIT_NAME]
| text
|
* [[#current_profession_no_year|current_profession_no_year]]: the name of the speaker's profession
|}

[[Category:DF2014:Files]]
[[Category:DF2014:Modding]]

Entity token

2018-03-19T12:27:06Z

FortressBuilder: /* Behavior */ NO_ARTIFACT_CLAIMS

{{Quality|Exceptional|19:21, 13 October 2015 (UTC)}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ALL_MAIN_POPS_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom entity can have a tier of 3000 and still work even if it's the only custom entity.

[ADVENTURE_TIER:4]

Adventure tiers were removed in [[:Category:Version 0.42.01|Version 0.42.01]], effectively replaced by ALL_MAIN_POPS_CONTROLLABLE.

|-
| {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

Removed in [[:Category:Version 0.42.01|Version 0.42.01]], in favor of the [[Creature token]] OUTSIDER_CONTROLLABLE.

|-
| {{text anchor|SITE_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, then in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|SOURCE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing of on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]].
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max historical population '''per entity'''. Multiply this by max starting civ to get the total maximum historical population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations are drawn randomly from all translation files. Multiple translation tags will only result in the last one being used.
* If GEN_DIVINE is entered, the entity will use a generated divine language, that is, the same language that is used for the names of [[angel]]s.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, BATTLE, BRIDGE, CIV, LIBRARY{{version|0.42.01}}, MILITARY_UNIT, RELIGION, ROAD, SIEGE, SITE, TEMPLE, TUNNEL, VESSEL, WALL, WAR
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be preferred as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens, also used when announcing arrival of their caravan. Defaults to 7:0:1.

[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can be any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere. Note that the DEATH sphere favours the appearance of necromancers (and therefore, towers) in the race.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

== Leadership ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

== Behavior ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's [[personality trait|cultural values]]. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|VARIABLE_VALUE}}{{version|0.42.01}}
|
*value or ALL
*min
*max
| Makes values randomized rather than specified.

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the defenders.

If the civ sends out mercenaries, they may come to the player's fort to enlist in the military.{{version|0.42.01}}

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| The season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest, and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (e.g. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you. However, animals traded away to one's own caravan will count as snatched, reported upon the animal leaving the map, and the animal will not count as having been exported.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s, and (unlike older versions) only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

Note: If the playable civ in Fortress Mode has this tag (e.g. you add ITEM_THIEF to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and kobolds will be friendly to you. However, ALL items traded away to one's own caravan will count as stolen, reported when the items leave the map, and the stolen items will not count as exported.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a land holder.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as [[bat man]] civilizations. May spawn in any of three caverns, in groups of 5-10 soldiers who will hunt down nearby cavern creatures.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|-
| {{text anchor|GENERATE_KEYBOARD_INSTRUMENTS}}, {{text anchor|GENERATE_PERCUSSION_INSTRUMENTS}}, {{text anchor|GENERATE_STRINGED_INSTRUMENTS}}, {{text anchor|GENERATE_WIND_INSTRUMENTS}}, {{text anchor|GENERATE_DANCE_FORMS}}, {{text anchor|GENERATE_MUSICAL_FORMS}}, {{text anchor|GENERATE_POETIC_FORMS}}{{version|0.42.01}}
|
| Makes civilizations generate the given instruments/forms.

|-
| {{text anchor|SCHOLAR}}{{version|0.42.01}}
| scholar type
| ALL, ASTRONOMER, CHEMIST, DOCTOR, ENGINEER, GEOGRAPHER, HISTORIAN, MATHEMATICIAN, NATURALIST, PHILOSOPHER

|-
| {{text anchor|SET_SCHOLARS_ON_VALUES_AND_JOBS}}{{version|0.42.01}}
|
| Generates scholars based on the values generated with the VARIABLE_VALUE tag.

|-
| {{text anchor|NO_ARTIFACT_CLAIMS}}{{version|0.44.01}}
|
| Used for kobolds.

|}

== Available Resources ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal. For those cases, listing the pick under the [WEAPON] token works just as well. Note that this tag is neither necessary nor sufficient to allow use of that item as a mining tool -- for that, the item itself needs to be a weapon with [SKILL:MINING].
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
| No longer used as of [[:Category:Version 0.42.01|Version 0.42.01]] due to the ability to generate instruments in world generation. It is still usable if pre-defined instruments are modded in, and generated musical forms are capable of selecting pre-defined instruments to use. However, reactions for making instruments, instrument parts, and/or assembling such instruments need to be added as well, as this token no longer adds such instruments to the craftdwarf's workshop menu.
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER), even the normally untameable species.

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR), even the normally untameable species.

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade. Lack of suitable vegetation in caverns will cause [[World generation#Rejections|worldgen rejection]]s.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade. Lack of suitable vegetation in the civ's starting area will cause [[World generation#Rejections|worldgen rejection]]s.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows civ to use indoor tree growths in the goods it has available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTHING}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_CRAFTS}}
|
| Allows civ to use materials with [DIVINE] for crafts.{{verify}} Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Animal definitions ==

{{version|0.44.01}}

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ANIMAL}}
|
| Start an animal definition.

|-
| {{text anchor|ANIMAL_TOKEN}}
| [[creature token]]
| Select specific creature.

|-
| {{text anchor|ANIMAL_CASTE_TOKEN}}
| [[Caste|creature caste token]]
| Select specific creature caste (requires ANIMAL_TOKEN). Sites with animal populations will still include all castes, but only the selected ones will be used for specific roles.

|-
| {{text anchor|ANIMAL_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Select creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_FORBIDDEN_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Forbid creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_ALWAYS_PRESENT}}
|
| Animal will be present even if it does not naturally occur in the entity's terrain.

|-
|
* {{text anchor|ANIMAL_NEVER_MOUNT}}, {{text anchor|ANIMAL_ALWAYS_MOUNT}}
* {{text anchor|ANIMAL_NEVER_WAGON_PULLER}}, {{text anchor|ANIMAL_ALWAYS_WAGON_PULLER}}
* {{text anchor|ANIMAL_NEVER_SIEGE}}, {{text anchor|ANIMAL_ALWAYS_SIEGE}}
* {{text anchor|ANIMAL_NEVER_PET}}, {{text anchor|ANIMAL_ALWAYS_PET}}
* {{text anchor|ANIMAL_NEVER_PACK_ANIMAL}}, {{text anchor|ANIMAL_ALWAYS_PACK_ANIMAL}}
|
| Override creature usage tokens. Respectively:
* [[Creature token#MOUNT|MOUNT]] and [[Creature token#MOUNT_EXOTIC|MOUNT_EXOTIC]]
* [[Creature token#WAGON_PULLER|WAGON_PULLER]]
* [[Creature token#TRAINABLE_WAR|TRAINABLE_WAR]] and not [[Creature token#CAN_LEARN|CAN_LEARN]]
* [[Creature token#PET|PET]] and [[Creature token#PET_EXOTIC|PET_EXOTIC]]
* [[Creature token#PACK_ANIMAL|PACK_ANIMAL]]
ALWAYS overrides NEVER if a caste is matched by more than one animal definition.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}

Entity token

2018-03-19T12:22:58Z

FortressBuilder: Animal definitions

{{Quality|Exceptional|19:21, 13 October 2015 (UTC)}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ALL_MAIN_POPS_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom entity can have a tier of 3000 and still work even if it's the only custom entity.

[ADVENTURE_TIER:4]

Adventure tiers were removed in [[:Category:Version 0.42.01|Version 0.42.01]], effectively replaced by ALL_MAIN_POPS_CONTROLLABLE.

|-
| {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

Removed in [[:Category:Version 0.42.01|Version 0.42.01]], in favor of the [[Creature token]] OUTSIDER_CONTROLLABLE.

|-
| {{text anchor|SITE_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, then in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|SOURCE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing of on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]].
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max historical population '''per entity'''. Multiply this by max starting civ to get the total maximum historical population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations are drawn randomly from all translation files. Multiple translation tags will only result in the last one being used.
* If GEN_DIVINE is entered, the entity will use a generated divine language, that is, the same language that is used for the names of [[angel]]s.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, BATTLE, BRIDGE, CIV, LIBRARY{{version|0.42.01}}, MILITARY_UNIT, RELIGION, ROAD, SIEGE, SITE, TEMPLE, TUNNEL, VESSEL, WALL, WAR
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be preferred as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens, also used when announcing arrival of their caravan. Defaults to 7:0:1.

[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can be any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere. Note that the DEATH sphere favours the appearance of necromancers (and therefore, towers) in the race.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

== Leadership ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

== Behavior ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's [[personality trait|cultural values]]. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|VARIABLE_VALUE}}{{version|0.42.01}}
|
*value or ALL
*min
*max
| Makes values randomized rather than specified.

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the defenders.

If the civ sends out mercenaries, they may come to the player's fort to enlist in the military.{{version|0.42.01}}

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| The season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest, and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (e.g. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you. However, animals traded away to one's own caravan will count as snatched, reported upon the animal leaving the map, and the animal will not count as having been exported.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s, and (unlike older versions) only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

Note: If the playable civ in Fortress Mode has this tag (e.g. you add ITEM_THIEF to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and kobolds will be friendly to you. However, ALL items traded away to one's own caravan will count as stolen, reported when the items leave the map, and the stolen items will not count as exported.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a land holder.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as [[bat man]] civilizations. May spawn in any of three caverns, in groups of 5-10 soldiers who will hunt down nearby cavern creatures.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|-
| {{text anchor|GENERATE_KEYBOARD_INSTRUMENTS}}, {{text anchor|GENERATE_PERCUSSION_INSTRUMENTS}}, {{text anchor|GENERATE_STRINGED_INSTRUMENTS}}, {{text anchor|GENERATE_WIND_INSTRUMENTS}}, {{text anchor|GENERATE_DANCE_FORMS}}, {{text anchor|GENERATE_MUSICAL_FORMS}}, {{text anchor|GENERATE_POETIC_FORMS}}{{version|0.42.01}}
|
| Makes civilizations generate the given instruments/forms.

|-
| {{text anchor|SCHOLAR}}{{version|0.42.01}}
| scholar type
| ALL, ASTRONOMER, CHEMIST, DOCTOR, ENGINEER, GEOGRAPHER, HISTORIAN, MATHEMATICIAN, NATURALIST, PHILOSOPHER

|-
| {{text anchor|SET_SCHOLARS_ON_VALUES_AND_JOBS}}{{version|0.42.01}}
|
| Generates scholars based on the values generated with the VARIABLE_VALUE tag.

|}

== Available Resources ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal. For those cases, listing the pick under the [WEAPON] token works just as well. Note that this tag is neither necessary nor sufficient to allow use of that item as a mining tool -- for that, the item itself needs to be a weapon with [SKILL:MINING].
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
| No longer used as of [[:Category:Version 0.42.01|Version 0.42.01]] due to the ability to generate instruments in world generation. It is still usable if pre-defined instruments are modded in, and generated musical forms are capable of selecting pre-defined instruments to use. However, reactions for making instruments, instrument parts, and/or assembling such instruments need to be added as well, as this token no longer adds such instruments to the craftdwarf's workshop menu.
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER), even the normally untameable species.

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR), even the normally untameable species.

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade. Lack of suitable vegetation in caverns will cause [[World generation#Rejections|worldgen rejection]]s.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade. Lack of suitable vegetation in the civ's starting area will cause [[World generation#Rejections|worldgen rejection]]s.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows civ to use indoor tree growths in the goods it has available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTHING}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_CRAFTS}}
|
| Allows civ to use materials with [DIVINE] for crafts.{{verify}} Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Animal definitions ==

{{version|0.44.01}}

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ANIMAL}}
|
| Start an animal definition.

|-
| {{text anchor|ANIMAL_TOKEN}}
| [[creature token]]
| Select specific creature.

|-
| {{text anchor|ANIMAL_CASTE_TOKEN}}
| [[Caste|creature caste token]]
| Select specific creature caste (requires ANIMAL_TOKEN). Sites with animal populations will still include all castes, but only the selected ones will be used for specific roles.

|-
| {{text anchor|ANIMAL_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Select creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_FORBIDDEN_CLASS}}
| [[Creature token#CREATURE_CLASS|creature class]]
| Forbid creature castes with this creature class (multiple uses allowed).

|-
| {{text anchor|ANIMAL_ALWAYS_PRESENT}}
|
| Animal will be present even if it does not naturally occur in the entity's terrain.

|-
|
* {{text anchor|ANIMAL_NEVER_MOUNT}}, {{text anchor|ANIMAL_ALWAYS_MOUNT}}
* {{text anchor|ANIMAL_NEVER_WAGON_PULLER}}, {{text anchor|ANIMAL_ALWAYS_WAGON_PULLER}}
* {{text anchor|ANIMAL_NEVER_SIEGE}}, {{text anchor|ANIMAL_ALWAYS_SIEGE}}
* {{text anchor|ANIMAL_NEVER_PET}}, {{text anchor|ANIMAL_ALWAYS_PET}}
* {{text anchor|ANIMAL_NEVER_PACK_ANIMAL}}, {{text anchor|ANIMAL_ALWAYS_PACK_ANIMAL}}
|
| Override creature usage tokens. Respectively:
* [[Creature token#MOUNT|MOUNT]] and [[Creature token#MOUNT_EXOTIC|MOUNT_EXOTIC]]
* [[Creature token#WAGON_PULLER|WAGON_PULLER]]
* [[Creature token#TRAINABLE_WAR|TRAINABLE_WAR]] and not [[Creature token#CAN_LEARN|CAN_LEARN]]
* [[Creature token#PET|PET]] and [[Creature token#PET_EXOTIC|PET_EXOTIC]]
* [[Creature token#PACK_ANIMAL|PACK_ANIMAL]]
ALWAYS overrides NEVER if a caste is matched by more than one animal definition.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}

Adventurer mode

2017-08-22T09:59:51Z

FortressBuilder: /* What creatures of night can I become? */ Fix slashes

{{old}}
{{Quality|Exceptional|Jan 2016}}
{{av}}

:''This is a detailed reference guide for Adventurer Mode. For a tutorial see the [[Adventure mode quick start]].
:''See [[Adventure mode quick reference]] to quickly look up key commands.

In '''Adventurer mode''' (also called "adventure mode") you create a single adventurer ([[dwarf]], [[human]], [[elf]], [[goblin]], or one of the varieties of [[animal people]]) who starts out somewhere in one of your generated worlds. You can learn about what ails the world and go on [[quest]]s to end those troubles (or get brutally murdered trying), and you can venture into the wilderness to find [[cave]]s, shrines, lairs, abandoned towers, and other [[Site|towns and settlements]]. You can even visit your previously abandoned and retired [[fortress]]es and take all the precious items you yourself once created.

Unlike [[Fortress mode]], Adventurer Mode is a sort of advanced [http://en.wikipedia.org/wiki/Sandbox_game open world] RPG version of [http://en.wikipedia.org/wiki/Rogue_%28computer_game%29 rogue] or [http://en.wikipedia.org/wiki/Nethack nethack] taking place in the same procedurally generated worlds used for Fortress Mode. Whereas in fortress mode you are in charge of a large group of people in real-time restricted to a small parcel, in adventurer mode you control a single character in a turn-based manner, roaming the entire world freely.

==World selection==

You can play Adventurer mode in any world that has a civilization with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token (which are elf, dwarf, humans, goblins, as well as animal people{{version|0.42.01}}). Humans inhabit cities, towns, and the occasional above-ground fortress. Elves inhabit [[forest retreat|forest retreats]]. Dwarves are spread between "deep sites" which sometimes do not contain a direct connection to the surface, [[Fortress|Fortresses]] which are built into the surface and almost always connect to the underground and "hill dwarves" which inhabit a loose collection of mounds built into hillsides. Goblins typically live in [[dark fortress|Dark Fortresses]]. Lastly, Animal People can live with any civilization, in virtually any location. Human cities and towns and Dwarven Fortresses are currently the only sites with shops and other places to officially buy goods. Not including taverns (Which can also exist in Elven sites but only sell rooms and drinks).

If you have previously built a fort in the world that you select, your adventurer will be able to go visit it. If you have selected to "retire" the fortress rather than abandon it, you will likely be able to encounter all the inhabitants from fortress mode. However, they will likely not have the same level of activity as they would in a bustling fortress-mode fort.

==Character creation==

===Race and civilization===
Any race with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token is playable in adventure mode. In an unmodded game, this means dwarves, elves, and humans. All three races can complete the same quests.

*'''Humans''' always originate from one of the villages in the world, begin with bronze, copper, or iron weapons, and can use any of the items sold by shopkeepers (who, for the time being, are only found in human towns and only sell human-sized clothing/armor). They also start with the widest variety of weapon skills.

*'''Human Outsiders''' are humans that aren't from that world or any of its villages. They simply appear in the wilderness, a stranger to all. You may always play as an outsider, even if the world is otherwise completely uninhabited. Outsiders can only start with Spear User and Knife User as weapon skills, and they cannot start with Armor User or Shield User. They also start out literally naked with no clothing, but can wear any human-sized armor that they trade for, steal, or loot. "Outsiders" of other races can be played if you add the [[Entity_token#Gameplay|INDIV_CONTROLLABLE]] token to the race's entity definition.

*'''Dwarves''' have the advantage of being able to go into a [[martial trance]] when fighting multiple foes at once. This gives them many combat bonuses, which aids their survival greatly. They are the only race which can start with steel weapons, but they wear "small" sized clothing (like goblins and elves) which means that they're unable to wear human clothing and armor found in human shops. Goblin armor fits them, making Dark Fortresses (if your computer can handle them) and bandits a viable source of armor; if you're up for it, you could also just rob some dwarves or a dwarven fortress. They can start with almost the same weapon skills as civilized humans. Many larger weapons must be wielded two-handed by dwarves, due to their size.

*'''Elves''' start with very weak wooden weapons and have a more limited list of weapon skills during character creation. They have the advantage that they have higher natural speed. Elves have the {{token|AT_PEACE_WITH_NATURE}} tag, which makes all wildlife passive towards them. They also have a notably better sense of smell compared to the other races with a SMELL_TRIGGER of 10, instead of 90, which means they can sense smells over much larger distances. Like dwarves they wear small sized clothing and will have the same problem finding suitable armor and weapons.

*'''Intelligent Wilderness Creatures'''{{version|0.42.01}} can be played not only in varying conditions as above, but also as part of another parent civilization such as elves, humans, and dwarves. They come in various sizes, shapes and abilities, and as such a short description cannot be given; however, they will not start with armor or be able to wear armor sized for the more common races, making Dodger and Shield User more important as defensive skills.

*'''Goblins''' can be played only if goblin populations have been absorbed into dwarven, human or elven civilizatons during world generation. They possess the same body proportions of dwarves and elves, and can wear whatever weapons and armor the civilization which adopted/conquered them allows.

*'''Kobolds''' can be played only if there are no other civilizations and there are kobolds. They are very small and weak in combat and a huge challenge compared to the other races. They wear even smaller armor than the other races and armor will be impossible to find for them, unless you are absurdly lucky and run into armored kobolds.

If no civilization for a given race exists in a world you can only play as an outsider.

=== Status ===

Determines the number of starting skill and attribute points, which does not change based on race:
*'''Peasant:''' 15 attribute, 35 skill
*'''Hero:''' 35 attribute, 95 skill
*'''Demigod:''' 105 attribute, 161 skill
The number of skill points is less significant than the number of attribute points because the time it takes to go from Peasant to Demigod in skill terms is much less than what it would take to go from Peasant to Demigod in attribute terms.

=== Starting attributes ===

[[Attribute|Attributes]] are divided into Body and Soul attributes. This section provides some guidance for allocating attributes as it relates to adventurer mode.

==== Body ====

*'''Strength''': Contributes to melee attack momentum, adding velocity and force, and leg strength to movement velocity. Strength determines encumbrance limits, and higher capacity reduces the speed penalty of carrying burdens. Increases to muscle layer mass proportionately improves damage resistance but also reduces speed; proportionately larger characters benefit more from the extra layer thickness and suffer more from the speed penalty.
*'''Agility''': This attribute is directly related to a character's Speed. All combat skills rely on it, especially defensive. Increases attack velocity and potential attack rate.
*'''Toughness''': Reduces physical damage inflicted on you. Also relates to defensive combat skills.
*'''Endurance''': Reduces the rate at which the adventurer becomes exhausted. Exhaustion progressively penalizes physical skills and rate of movement to the point of immobility and [[unconscious]]ness.
*'''Recuperation''': Increases the rate of wound healing.
*'''Disease Resistance''': Reduces risk of contracting syndromes (including infection) and the negative effects when active (including alcohol-induced.)

==== Soul ====

Some of these are demonstrated useful for adventure-mode-applicable skills, but the effects of the attributes aren't clearly understood. For ideas on how they may be applied, see [[Attribute#Skills_By_Soul_Attribute|a list of skills organized by attributes.]].

*'''Analytical Ability''': Useful for Tracker, Knapping and Student. Analytical Ability seems to have an influence on the quality of written creations, such as Poems, as well as ability to speak about ideals.{{version|0.42.01}}

*'''Focus''': Affects Archer, Ambusher, Observer.

*'''Willpower''': Affects Fighter, Crutch Walker and Swimmer. Willpower helps resist the negative effects of status ailments such as Pain, Stunned, Unconscious, and all states of exhaustion and food/drink/sleep deprivation.

*'''Creativity''': This influences quality of poems, songs, and dances and crafts. It may also influence "make believe", now able to be performed by children.{{version|0.42.01}}

*'''Intuition''': Helps with Observer, which aids in spotting concealed enemies, ambushes, and identifying attacks from opponents.

*'''Patience''': May have some effect on dealings with others as a result of the new conversation system.{{Verify}}

*'''Memory''': Memory is applied to the Student and Reading skills. Higher Student improves the ability to learn from demonstrations in fortress mode, but it isn't certain whether it has any application in adventurer mode. It's also unknown what benefits come from of higher Reading capability.

*'''Linguistic Ability''': Affects any speaking and writing ability, improves the ability to communicate thoughts and feelings to listeners/readers. Verbal ability can form a positive impression depending on how the listener values eloquence, and responses to stories and poetry relies on delivery.

*'''Spatial Sense''': Important. Affects combat skills, Ambusher, Crutch Walker, Swimmer, Observer, Knapping. Also, prevents/reduces the chance of stumbling during a dance.{{version|0.42.01}}

*'''Musicality''': Influences the Adventurers ability to perform music and song well. This, so far works for all instruments, one can play a flute, guitar, any other instrument equally well, given that the adventurer has equal skills in all instrument fields.{{version|0.42.01}}

*'''Kinesthetic Sense''': Affects most combat skills, walking with crutches, swimming and dancing

*'''Empathy''': Affects social skills such as Persuader, Flatterer, Judge of Intent, and other Social skills that may not be applied in adventurer mode.

*'''Social Awareness''': Increases the number of followers you can have at a given "fame" level. Normally you start with a limit of two. Increasing this stat by one level raises that to three. Your fame still plays a big part in whenever you can recruit followers or not. This attribute also helps with Persuader and Judge of Intent.

==== Attribute advancement cap ====

Adventure mode attributes are capped at double the starting value or the starting value plus the racial average, whichever is greater. Humans, for example, have a racial average strength of 1,000. If a human adventurer starts with an ''above average'' strength of 1,100, then his strength will ultimately be capped at 2,200. Had this human started with a ''below average'' strength of 900, then his strength would be capped at 1,800 instead. For the purpose of maximizing final attributes, this makes it important to start with as many attributes in the ''superior'' range as possible (more attributes per point allocated), while avoiding taking any penalties to even remotely important attributes (big attribute deductions per point recovered). As a consequence of the attribute cap, demigod adventurers will always have a much higher potential for advancement than mere peasants and heroes.

=== Starting skills ===

Not all races have the same sets of skills available at character creation time, but keep in mind that all starting [[skill]]s, as well as ones not available at character creation, can be improved through use in game.

This section will specifically address starting skills as they relate to adventure mode. For a full description of combat skills see [[Combat skill]]. Other skills that you can't start with, but which can be increased in game (such as Butchery) are described elsewhere.

==== Weapon ====

The weapon you start out with will be based on which of these, plus the unarmed combat skills, is the highest. In other words, even if Swordsman is your highest weapon skill, you won't start with a sword if your Wrestler or Striker skills are better. Usually the best choice anyway is to specialize in just one melee weapon skill. Regardless of weapon skills, a '''large copper dagger''' will always be included in the starting equipment, which is handy for throwing at enemies that are just a step away or finishing off a foe pinned down by a stuck weapon. If you don't select any offensive skills, you will also start with a spear, just as an outsider would.

Not all races/civilizations can start with all of these skills. Dwarves can't start with Bowman, Pikeman, or Lasher. Elves can only use Swordsman, Bowman, and Spearman. Of the playable races, only humans have access to Pikeman and Lasher. Strangely, only outsiders can start with Knife User.

Note that different races have different names for their weapon skills. Axegoblin, Axedwarf etc.

Crossbowman is an exception. Dwarves call this skill Marksdwarf, although bow skill is referred to as Bow Dwarf as you'd expect. Elite Axe and Hammer dwarves are referred to as Lords.

*'''[[Axeman]]''': allows characters to use axes, great axes, and halberds more effectively. Useful for cleaving off limbs.
*'''[[Bowman]]''': skill allows characters to use bows more effectively. Useful for taking down enemies at a distance.
*'''[[Crossbowman]]''': allows characters to use crossbows more effectively. Useful for taking down enemies at a distance.
*'''[[Hammerman]]''': allows characters to use crossbows in melee, mauls, and war hammers more effectively. Useful for breaking limbs.
*'''[[Knife user]]''': allows characters to use large daggers and knives more effectively. Useful for stabbing things.
*'''[[Lasher]]''': allows characters to use whips and scourges more effectively. Very deadly weapons.
*'''[[Maceman]]''': allows characters to use flails, maces, and morningstars more effectively. Similar to hammers.
*'''[[Pikeman]]''': allows characters to use pikes more effectively. Like spears, but much bigger.
*'''[[Spearman]]''': allows characters to use spears more effectively. Useful for stabbing things.
*'''[[Swordsman]]''': allows characters to use blowguns and bows in melee, long swords, scimitars, short swords, and two-handed swords more effectively. Useful for cutting, stabbing, and whacking, but less effective than more dedicated weapons.

==== General combat ====

These skills form the basis for combat effectiveness. There is no maximum value to their utility, so if you begin with a rank equal or higher to your chosen weapon you'll become better able to benefit from other weapons when necessity or strategic advantage requires. Starting versatility can pay off early; you may choose your starting weapon, but the ''best'' available weapon is beyond your control or prediction.

*'''[[Fighter]]''': This increases with, and contributes to, melee combat whether armed or unarmed. It appears that the purpose of it is to allow melee experience to contribute to melee combat in general regardless of weapon. Repeatedly wrestling (grabbing and releasing) even a small creature will raise this skill.
*'''[[Archer]]''': This increases with, and contributes to, ranged combat including throwing. It works similarly to Fighter except for ranged attacks. It can be easily raised by repeatedly throwing rocks, making it advisable for archers to practice their marksmanship with rock throwing before using up the more finite and expensive forms of ammunition. Shooting at a wall with adjacent upward ramp one level below and picking back projectiles is also a good idea (such places often happen to be in keeps and fortresses). See the FAQ section on [[#How do I increase my skills and attributes?|increasing your skills and attributes]] for information on raising bowman/marksman skills.

==== Defensive ====

These skills are critical for survival. Starting out with good ability in one (especially Shield User or Armor User) if not all is strongly advised.

*'''[[Shield user]]''': Ability to block attacks with shields. Starting with even novice skill in this means that the adventurer will start with a shield. This is a no-brainer unless you're creating a two handed weapon user, and lack a broadness or height modifier on your character - necessary for one-handing any two-handed weapon, without penalty.
*'''[[Armor user]]''': A higher level of this skill reduces the encumbrance penalties of armor, allowing you to move faster when wearing it. It also affects how well armor protects you and this makes a huge difference. Unskilled armor users gain little protection. This is noticeable as you'll begin seeing far more combat reports about hits either striking you though armor, (you managed to use your armor to lessen the force of the blow) or being deflected by your armor (you used your armor to avoid the hit entirety) as your skill rises and you learn to actually use your armor to deflect hits. It is highly advised to train your armor skill before entering battle with it as the speed penalties of lower levels can be a serious handicap.
*'''[[Dodger]]''': Ability to dodge out of the way of attacks. Dodger is incredibly important and will allow you to avoid many, many hits that would have otherwise injured you. Especially important when you are fighting unarmored and can't afford a battle axe in the chest. Boost this to talented or at least close to it.

==== Unarmed combat and improvised weapons ====

While some of them come in handy at times, they can generally be raised fairly easily in game, especially Wrestler and Thrower.

*'''[[Wrestler]]''': Ability to grapple, restrain, take-down, throw opponents, etc. Higher skill means all of these moves succeed more often. See [[#Wrestling and Unarmed Attacks]] for details. Can be raised very easily in game.
*'''[[Striker]]''': Punching ability. Turns handy when weapons get stuck and there is no time to wrest them back.
*'''[[Kicker]]''': Kicking ability. Same as Striker. Kicks are slower but more deadly than punches; heavy kicks are particularly good at crushing and exploding heads.
*'''[[Biter]]''': Biting ability. Biting is surprisingly effective even with non animal races as after biting you can shake opponents around by your teeth, causing great damage and possibly ripping off body parts, although with sapient races this tends to lean more towards fingers or toes, perhaps the occasional hand or foot.
*'''[[Thrower]]''': Throwing any miscellaneous object including rocks, knives, axes, swords, heads, etc. Skill affects accuracy and damage caused.
*'''[[Miscellaneous object user]]''': Ability to beat things to death with anything that comes at hand, from bags to coins to their own severed body parts. Also somewhat more commonly used for shield bashing. This skill affects combat with any object, from a rock to a beehive. There are no separate skills for different items. Items actually intended to be weapons, like swords or axes, are unaffected by this skill.

A well written article on martial arts "Kisat Dur" can be found on the forums [http://www.bay12forums.com/smf/index.php?topic==148015.0 here].

==== Movement and awareness ====

*'''[[Observer]]''': Helps one to notice things like ambushes, enemies who are "sneaking" (stealth movement), and traps. Detection range increases with skill, but up to a maximum of 3 tiles away. Higher levels give more information regarding opponents. Hard to train. Adding some points here is advisable.
*'''[[Swimmer]]''': Allows movement through water without drowning. A Novice swimmer can swim but will revert to being unable to swim if stunned, which happens when falling even 1 z-level into the water, or possibly after an unfriendly encounter with a creature in the water. An Adequate swimmer can swim normally (not drown) while stunned. For this reason, ''starting out as an Adequate swimmer is advisable.'' If you don't, at least start as Novice and go get some swimming practice right away.
*'''[[Ambusher]]''': The skill of {{K|S}}neaking around unobserved. This can be raised fairly easily by sneaking around while traveling from place to place when speed is not important. Enemies will have "sight ranges" from where they can detect a sneaking adventurer. The red zone of sight is where they will see you immediately and begin chasing you; the yellow is where they might see you. Staying out of sight will allow you to silently assassinate your foes, as they rarely seem to notice a knife in their back in time.
*'''[[Climber]]''': The skill of climbing up walls, into trees, and around the edges of gorges. Higher levels reduce the chance of falling and increase the speed of a climbing character.
*'''[[Tracker]]''': The skill of tracking your quarry, whether it be animals or goblins. Higher levels will let you spot more tracks and help you distinguish different tracks.
*'''[[Crutch-walker]]''': The skill of standing and walking with a crutch for support. This skill only becomes available when attempting to move with a crutch in inventory, and can be developed with or without legs. At Legendary levels, a crutch walker walks with no speed reduction, and simply keeping it in hand will continue to increase attributes.

==== Crafting ====

These allow your character to create things.

*'''[[Knapper]]''': The fine art of sharpening rocks by banging them together in a clever manner. The resulting rocks become sharp rocks which do more damage when thrown and can be used for things requiring a sharp edge like butchering. Easy to raise in game and doing so helps with Kinesthetic and Spatial Sense.

*'''[[Bone carver]]''': The art of making knick knacks and other items by carving bones. A skilled bone carver adventurer can make items of the same qualities of dwarves in fortress mode, including "*Masterpiece*". Bone carving adventurers can also make bone figurines, and customize the appearance of them.

*'''[[Writer]]''': Your adventurers ability to craft/write upon books and scrolls, you can choose the topic as well. It is hard to acquire the materials however. Checking in libraries and old dwarven fortresses has proven profitable.

*'''[[Carpenter]]''': Your adventurers ability to craft wooden objects and create wooden buildings and displays.

==== Social ====

Almost all of these are only used in arguments.

*'''[[Persuader]]''': Increases your ability to convince people of your view.
*'''[[Judge of intent]]''': Allows you to tell how the opponent is arguing, unknown if higher levels change anything.
*'''[[Flatterer]]''': Increases your ability to flatter your way out of the argument.

==== General performance skills ====
These are your general performance skills, similar to fighter in that they enhance rolls for many different skills and can be leveled easily.

*'''[[Musician]]''': Increases quality of all instrument based performances this is your all around instrument skill, very similar to speaker and fighter, except with instruments.
*'''[[Speaker]]''': Your all-around speaking skill increases quality of all performances that involve speaking out loud, includes reading poetry, singing etc. Very similar to "Fighter" skill except its with performance rolls not fighting rolls. May also effect arguments {{verify}}.

==== Performance skills ====
Skills that affect your characters ability to pull off performances. These skills can be used to play as a bard.

*'''[[Poet]]''': Increases the quality of poems you create and read out loud.
*'''[[Singer]]''': Increases quality of all songs your character sings.
*'''[[Dancer]]''': Increases quality of dances you choreograph and perform.
*'''[[Stringed instrumentalist|Stringed Instrumentalist]]''': Increases quality of all performances using stringed instruments.
*'''[[Wind Instrumentalist]]''': Increases quality of all performances using wind-based instruments
*'''[[Percussionist]]''': Increases quality of all performances using percussion instruments
*'''[[Keyboardist]]''': Increases quality of all performances using keyboard instruments (Note, shows up far less often in character generation then any of the others)

'''Note, if your civilization does not have access to a type of instrument you will not be able to choose that skill at character generation time.'''

There are also procedural skills for every different kind of instrument, dance and poetic form, these will vary from world to world and by civilization and cannot be chosen at character generation, but can be leveled in play.

==== Other ====

*'''[[Reader]]''': Allows you to read books, signs, and writing in Adventurer mode. Novice level is required in order to become a [[Necromancer]]. Can be trained slowly by reading books (if you can read). Adding more points is a waste, as novice allows you to read anything.
*'''[[Butcher]]''': The art of turning corpses into piles of delicious prepared brains and meat for food. Butchering also makes corpses and body parts less useful to enemy necromancers. You can allocate points here during character creation, but doing so is a waste because the skill doesn't really affect anything anyway. Except the taste, of course.
*'''[[Wordsmith]]''': It is unknown exactly what this skill affects, but likely it affects the quality of books and poems and other written materials.

=== Character appearance and preferences ===

As of 42.01 you are able to customise your adventurer's appearance, [[need]]s and preferences. Just like with any citizen in fortress mode, the needs will have to be fulfilled or else the character suffers from distraction.

As needs are fulfilled, your character's total level of focus goes up, gaining you bonuses to accuracy and other skill rolls. Your current level of focus will be displayed whilst playing, as one of the following: {{DFtext|Focused|2:0}} {{DFtext|Focused!|2:1}}

In the current version, some of these are unable to be fulfilled in adventurer mode.

== Gameplay ==

=== Common UI concepts ===
{{KeyConventions|3}}

=== Moving around ===

==== Local movement ====
[[File:Advmode_normaltravel_DF2014.png|thumb|400px|An image of normal travel mode. A list of the closest (but not necessarily close) sites is in the top-left corner. On the right side are minimaps of the next two levels down, relative to the player. Along the bottom is information about the player.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Move
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Move
|-
| {{k|Alt}} and a direction key
| Move carefully / Deliberately enter dangerous terrain
|-
| {{k|Shift}}+{{k|<}} or {{k|Shift}}+{{key|5}} (num lock off)
| Ascend
|-
| {{k|Shift}}+{{k|>}} or {{k|Ctrl}}+{{key|5}} (num lock off)
| Descend
|-
| {{k|.}}
| Wait for 10 instants
|-
| {{k|,}}
| Wait for 1 instant
|-
| {{k|s}}
| Stand or lie down
|-
| {{k|S}}
| Open Movement Speed/Sneak Menu
|}

Unless your character is an outsider, you will start out in a race-appropriate town or hamlet; in the standard tileset the @ sign is your character.

The directional keys allow movement. Diagonal movement is particularly important especially when chasing or running away from things.

Use {{k|Alt}}+direction to enter water, jump off of cliffs, or otherwise attempt to enter anything that you can't enter using normal movement commands. Note that when entering water it's best to enter the actual water and not the open space over the water as, in the later case, you will fall in causing you to become stunned which may lead to drowning.

If you hit {{k|j}}, you can jump. This is mostly useful for crossing gorges and crevices, where you have to get to the other side. Occasionally, you can manage to jump onto an opponent and tackle them, which typically causes them to go flying a short distance.

Hitting {{k|.}} allows you to stay in one place and wait for other things to move. {{k|,}} does the same but with a tenth of the time it takes for {{k|.}}.

Use {{k|s}} to sit/lie down. Moving while laying down (crawling) will let you move past NPCs which are standing in your way. Also note that you will frequently get knocked to the ground in combat, and if you don't hit {{k|s}} to stand back up then you will crawl slowly along the ground, giving your opponent a lot of opportunity to attack you.

{{k|S}}neak will allow you to move around invisibly, limited by your Ambusher skill and the Observer skill of nearby creatures. Enemies will have sight cones indicating where they can detect a sneaking adventurer. The central zone of sight (red, violet, or cyan) is where they will see you immediately and begin chasing you; their peripheral vision (yellow) is where they might see you. Violet and cyan central zones indicate the enemy is on a different level than yours, while red means they are on the same level. Staying out of sight will allow you to silently assassinate your foes, as they rarely seem to notice a knife in their back in time. Note that sneak is also affected by a variety of other factors detailed on the {{k|S}}neak screen, such as light level and weather.

If you {{k|h}}old onto a wall or tree, you can climb the wall or tree by using the movement keys. In towns and tamer parts of the countryside, this isn't particularly useful. However, in a combat situation, climbing a tree or wall can give you a height advantage, possibly allowing you to dive-tackle your opponents. Sometimes, mountains will be too steep to walk up the edge, or you will find a deep drop into a ravine. In these cases, you will have to climb up to reach the top, or perhaps jump or climb down one face, then climb up the other.

==== Fast travel ====
[[File:Advmode_fasttravel_DF2014.png|thumb|400px|Fast Travel screen. The player is in a hamlet, between the houses to the right and the mead hall in the top-left area of the map. The asterisk represents a group of creatures (in this case unfriendly goblins). The world map (in sepia) is on the far right.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|T}}
| Fast Travel
|-
| {{k|d}}
| Exit fast travel mode
|-
| {{k|K}}
| Display detected tracks and odors
|-
| {{k|c}}
| Toggle display of clouds on region map
|-
| {{k|s}}
| Walk around in sneak mode. Exiting fast travel starts you in sneak mode.
|-
| {{k|m}}
| Cycle through maps and significant structures
|-
| {{k|Q}}
| View Quest Log
|-
| {{k|Z}}
| Bring up sleep menu
|-
| {{k|h}}
| Hide parts of the bottom bar
|-
| {{k|>}} and {{k|<}}
| Enter/exit tunnel
|-
|}

Entering Fast Travel mode will allow you to move large distances in a single keypress. Of course, the same amount of time will go by and you can also be interrupted (ambushed) while moving in fast travel mode.

Along the top of the map is a line showing the sky, and the position of the sun and/or moon from west to east. This primarily helps you determine how long you have before it gets dark, at which point you won't be able to see very far, will risk getting attacked by bogeymen, and will be more vulnerable to attack in general.

If you are not near any sites, the {{k|m}} key will toggle a world map, colored in sepia tone (matching the map you see in the quest log). If you are near a site, then {{k|m}} cycles between a list of significant structures where your player is, a regional map (matching what you travel on when away from any site), and the aforementioned world map.

The {{k|c}} key will only show clouds on the region map (the one you travel on outside of sites). Some clouds will be visible regardless of the state of this option.

The {{k|h}} key will cycle through various amounts of the bottom bar of content hidden. The effects of each press are:

* 1 press: hide key reference. Allows you to see status effects on your character if obscured by the key list.
* 2 presses: hide most local name, reducing the bar to one line of text.
* 3 presses: hide less local name, eliminating the bar entirely.
* 4 presses: shows all information

=== Status and information ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|l}}
| Look around
|-
| {{k|Space}}
| Advance/Clear Messages
|-
| {{k|a}}
| View Announcements
|-
| {{k|z}}
| Status
|}

==== Looking around ====

If you're not sure what a tile is, the {{k|l}}ook command will tell you. In addition to being useful for identifying tiles and creatures, you can also view creatures' equipment and what items are sitting on the ground in a given tile. If in doubt, try the look command.

Move the cursor to the tile you want to look at using direction keys and {{k|Shift}}+direction. It's possible to look up and down z-levels (assuming you have line of sight) using the {{k|<}} and {{k|>}} keys. This, for example, allows you to find out if any flying creatures are above you. Hit {{k|Esc}} to exit look mode and go back to movement mode.

==== Messages ====

The game makes frequent use of messages on the screen to tell you what is going on. If there are a lot of these you may need to use {{k|Space}} to display the rest of the messages that won't fit on the screen. You can always go back and view old messages by pressing {{k|a}}.

==== Status Screen ====

This screen shows your skills, attributes, wounded body parts, health (along with more detailed descriptions of your wounds), lets you view your description, and change your nickname if you want.

==== Saving the game ====

Hit the {{k|Esc}} key at any time and select {{DFtext|Save Game}} to save your game. You can then come back to it later by using the {{DFtext|Continue Playing}} option in the main menu.

=== Searching and manipulating ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|u}}
| Interact with building, furniture, or mechanism
|-
| {{k|L}}
| Search the nearby area very carefully
|}

The {{k|u}} key can be used to do stuff like pull levers in your abandoned forts. It is also used to lower and raise the bucket when standing right next to a well so you can get water to refill your waterskin with.

{{k|L}} will perform a thorough search of the area that you're standing in, possibly revealing some small creatures.

=== Managing equipment ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|i}}
| Show Inventory
|-
| {{k|d}}
| Drop an item
|-
| {{k|g}}
| Get (pickup) an item off the ground
|-
| {{k|p}}
| Put an item into a container
|-
| {{k|r}}
| Remove an item you are wearing or from a container
|-
| {{k|w}}
| Wear an item
|-
| {{k|I}}
| Interact with an object in an advanced way. (unstick a weapon, refill waterskin etc.)
|-
| {{k|q}}
| Sheath your weapons and shield. (Frees your hands for tasks such as climbing or grabbing)
|}

==== Inventory ====

Press {{k|i}} to display a list of what you are currently carrying. Press {{k|-}} {{k|+}} {{k|*}} {{k|/}} to scroll the list. This list will show you if items are being worn, held in hands, stuck on your body, or are inside a container. Detailed information about an object can be viewed by pressing the key associated with the item.

==== Getting/dropping things ====

You can {{k|d}}rop items out of your inventory, as well as {{k|g}}et items on the ground on the same tile that you are standing on. If there is more than one item a menu will be listed. Press {{k|-}} {{k|+}} {{k|*}} {{k|/}} to scroll the list if the list is too long to fit on the screen. Note that getting something makes your adventurer pick something up with his or her hands. This often means that you have to use {{k|q}} to sheathe whatever you have in your hands before you pick something up. If you do not have a backpack or some other way of storing the object, your adventurer will not pick the item up.

{{k|g}} will also allow you to ignite foliage/any flammable objects adjacent to you. Fires aren't as devastating as one might imagine, but they will cause (most) enemies to path around them, making your crowd control slightly more effective when taking on multiple enemies. As an added bonus, it will also surely piss off the elves.

==== Containers ====

Items can be placed into containers with {{k|p}} and removed with {{k|r}}.

==== Wearing ====

Items can be worn using {{k|w}} and removed using {{k|r}} (the same command used for removing from containers). If an item you want to wear does not show up as an option, then it means you are already wearing too many items in the location used by that item. Try {{K|r}}emoving items in that location and then wear them again in order of priority. You also must put on equipment in an order that makes sense,. for example a shirt first ''then'' the armor, not the other way around. Armor must also be put on in a sensible manner with flexible layers such as chainmail first then rigid plate armor second. After all, who, in real life, would wear chainmail over a hard plate?

''Note that "large" or "small" clothing items are too big / small for your race'' (e.g. a '''large''' giant cave spider silk sock). If you have that problem, try getting clothing from a different source.

After acquiring [[armor]] from one source or another, you'll most likely want to equip it. To do this, first make sure it is in your possession--not on the ground. You can then {{key|w}}ear it, granted you don't already have too much on that equipment slot already. You can {{key|r}}emove or {{key|d}}rop inferior equipment as necessary.

See [[Armor]] for more information on wearing things. One thing to note in particular, DF allows you to wear more than one item in the same location in many situations, for example a copper mail shirt and a copper breastplate. The thin, flexible chain can be worn under the breastplate, but not the other way around.

==== Wielding ====

There is no command for wielding items such as [[weapon]]s in specific hands. Instead, they are automatically equipped when you either {{k|g}}et them from the ground or {{k|r}}emove them from your [[backpack]] - provided the hand that would wield them is free. So in order to change [[weapon]]s or [[shield]]s you should drop items or place them into containers (such as your backpack) until your hands are free, then get items from the floor or remove them from containers which will place them in your hands. For example, put all items into backpack, remove sword from backpack, remove shield from backpack. The items will end up in the right and left hand. Simply remember the {{k|r}}emove command and the {{k|p}}ut into container command.

While normally one would only be able to equip one item in each hand, removing items from your inventory results in them being wielded regardless of whether one's hands are full.{{bug|9817}} This is especially useful with shields, as every shield will contribute a block chance to each incoming attack.

Once equipped, weapons and shields can be quickly drawn and sheathed with {{k|q}}, instantly preparing for attack or freeing your hands. Any number of weapons can be strapped, but only one for each hand will be drawn. Others can be manually {{k|r}}emoved for use, and stowed again without occupying other inventory containers.

It should be noted that Dwarf Fortress does not enforce one particular hand as dominant for everyone, so do not be surprised if your character holds the weapon and [[Armor#Shields and Bucklers|shield]] in hands you yourself would not hold them in.

During advanced combat interactions it's worth noting that the first item you picked up with empty hands shows up at the top of the interaction menu. This means picking up a shield first will mean pressing {{k|a}} will bash with the shield. Being consistent in the order you equip weapons will allow you to easily memorize attacks.

==== Advanced interaction ====

The {{k|I}} key allows "complex interaction" with objects in your inventory.

This is used for removing arrows and weapons stuck in wounds which will appear in your inventory when they become stuck in you. Removing stuck arrows can cause bleeding so it is not always a good idea mid combat, but stuck objects will slow you down as you are encumbered by their weight. It's best to remove them as soon as possible when it is safe and you are not in danger of bleeding to death.

Advanced interaction can also be used to steal enemy equipment. Use [[wrestling]] to grab hold of a piece of enemy equipment, such as their weapon, or a helmet protecting their squishy brain and it will appear in the advanced interaction menu. Simply grab the item with a free hand and pull away. If successful, you will now be holding that item in your hands.

This command is particularly useful for getting water. When standing next to a well you press the {{k|u}} key to lower, then raise the bucket, yielding 10 units of water in the bucket. Then you can press the {{k|I}} key to fill your waterskin from the full bucket (alternatively you can press the {{k|e}} key to drink directly from the bucket).

Advanced interactions can be used next to a campfire to heat things, such as any frozen liquids you have in your inventory (or snow lying on the ground) and need to drink. You can refill waterskins from a nearby liquid source as well

====Sheathing====
The {{k|q}} key lets you strap your weapons to your back.

This is useful because you can't climb or wrestle with your hands unless your hands are free.

People will also be less likely to be scared of you on first sight if you don't appear to be ready to attack.

Keep in mind that while strapping will put away ''everything'' you have in your hands, pressing it again will only cause you to put items into hands that are currently empty, meaning if you had multiple items in one hand you'll have to {{k|r}}emove them manually to use them again.

=== Time and weather ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|D}}
| Date
|-
| {{k|P}}
| Temperature
|-
| {{k|W}}
| Weather/Time
|}

The game has a day/night cycle with time passing as various actions take place.

When using quick travel mode, the top line of the screen will indicate the position of the sun in the sky with a yellow "☼"; further to the right of the screen is earlier in the day and further to the left is later in the day.

In local travel mode you'll have to use the {{k|W}} command to learn the position of the sun, when you're in a place where the sun is visible.

At night you won't be able to see nearly as well and you will be more vulnerable to ambush.

The game also has weather and temperature. The most common weather you'll experience is rain. Rain is shown as blue moving dots on the local travel screen and will unsurprisingly cause everything outside to become wet. Temperature is important because if it happens to drop below freezing while you're swimming through water, you'll instantly die from being encased in the ice.

Therefore, you might want to keep an eye on the temperature while swimming, especially if it's getting cold.

Also, unlike fortress mode, rivers/other bodies of water can be liquid during the day, and freeze at night. The cycles of freezing can also be erratic from day to day.

Freezing weather can also freeze liquids in your inventory solid, making them undrinkable. If your water freezes and you are thirsty, make a campfire and {{k|I}}nteract with your waterskin to heat it over the fire and melt the ice.

=== Sleep ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Z}}
| Sleep
|}

Eventually your character will become {{DFtext|Drowsy|1:0}} and this will get worse until you get sufficient sleep.

Sleep does not necessarily have to coincide with night, but if you're traveling alone when night comes you'll be in danger of being attacked by [[Bogeyman|Bogeymen]]. To avoid this while traveling solo you need to make it to shelter before nightfall and sleep the night away inside a building or abandoned lair. Enter a building, use {{K|k}} to talk to a human, and ask for permission to stay the night. Next press {{K|Z}} to sleep, {{K|d}} to sleep until dawn, then {{K|Enter}} to confirm. ('''NOTE''': If you stay the night in a castle, you have to sleep in the keep which houses the lord/lady of the castle. Sleeping inside the castle but outside the keep still leaves you vulnerable to attack.) Sleeping on an ocean beach also prevents bogeymen from attacking. (If you'd rather not deal with bogeymen, you can disable them by generating a world using [[advanced world generation]] and setting "Number of Bogeymen" to 0)

Though sleeping inside can be safe, it's also limiting: any quest site you want to go to has to be within a daytime's round-trip time of a safe habitation, and you have to make your way to there by hopping from one habitation to the next, sleeping at each along the way. A way to avoid this is to travel with companions. If you have any companions with you then Bogeymen won't attack you. You'll still have to sleep at night, though, both to avoid sleep deprivation and because there's no visibility at night. You can still be ambushed at night by wildlife, but that's much less likely than being ambushed by Bogeymen when traveling alone. If you find yourself alone at night with nowhere safe to sleep, the safest bet is to keep traveling until dawn, even if that means running around in circles. You will eventually feel unwell from sleep deprivation, but this can take a considerable amount of time. You can make up for lost sleep once you've found your way to safety.

Note that sleeping in lairs, shrines, and labyrinths makes you safe from ambush, assuming that you or someone else has killed whatever was living there. If you have sufficient shrines/lairs/etc between you and your goal and they are either uninhabited or inhabited by things you are capable of killing then you can travel from lair to lair using each lair as a safe lodging. This is much safer than sleeping out in the open, day or night, even with companions.

If no other options are available, completely surrounding yourself with campfires will keep night marauders at bay as they cannot pass through the fires; the fires will go out after several hours and enable you to move on (you may also be able to jump over the fires). The bogeymen or other enemies may be outside your line of sight, which will prevent you from firing arrows or throwing things at them. In this case, you will have to stand up and lie down {{K|s}} repeatedly until the enemies wander into your range, the fires go out and the enemies can path to you, or dawn breaks.

It should be noted that, as of DF2014, climbing trees and sleeping on them will sometimes prevent Bogeyman attacks, as well. This is especially useful if you prefer to play solo, and do not wish to have an army of followers in your employ. This is also useful if you prefer to engage enemies at your own pace (such as via stealth), rather than having your entire follower party immediately charge at anything that is hostile to you. Be wary though, as bogeymen may still be able to reach you by climbing or flying.

=== Food and drink ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|e}}
| Eat or drink something
|}

To find water, you must find a river, stream, or well in a town and fill your waterskin (or any container) from it, or drink from it directly. Water that may be covering you or your items will not be able to satisfy your thirst.

Note that drinking vampire blood will turn you into a vampire instantly.

You can only eat and drink up to stomach capacity; after that you become increasingly nauseous and unable to retain your stomach contents (though if you needed a source for vomit, that's one way to acquire it.) You can reset stomach capacity by offloading the map (travel, rest, wait, etc,) which can only be done in safe locations and circumstances. Over time food contents are converted to stored fat, even if you remain active, and this will increase your fat layer mass and potentially reduce your speed. Fast traveling also resets food contents (as of v 43.03,) though the hunger and thirst timers are still satisfied by consumption.

If you find yourself in need of both food and hydration, make sure to take care of the most urgent problem first, as if you are moderately hungry but severely dehydrated and eat three times, you may die before you have another chance to drink.

If the temperature is low enough you might have trouble finding liquid water. Snow and ice can be heated into water by first making a campfire with {{k|g}} and then performing an advanced interaction with {{k|I}} on the ice or snow in your inventory to heat it. Advanced interactions with your waterskin (or any container) can also be used to gather water from water sources, or snow from the ground.

====Announcements when eating====
When eating or drinking, the following announcements will be displayed:
*(nothing): You can eat or drink more, no problem.
*You are starting to feel full: You can eat or drink ''one'' more time, but any more than that will cause problems.
*You feel really full: Exactly what it says on the tin. This is as much as you can eat or drink at the moment.
*It's too much! You might not be able to keep it down: You've eaten/drunk too much, and will likely [[vomit]].

=== Combat ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Attack adjacent hostile creature
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Attack adjacent hostile creature
|-
| {{k|A}}
| Attack an adjacent creature.
|-
| {{k|f}}
| Fire a projectile
|-
| {{k|t}}
| Throw an item
|-
| {{k|C}}
| Open combat preferences interface
|}

[[Combat]] is the fine art of using physical force to cause injury and death, and it is particularly fun in Dwarf Fortress.

==== Melee attacks ====

Hostile creatures can be attacked using a non-aimed attack by simply advancing towards your enemy using the arrow keys. Doing a non-aimed attack will also have a chance of freeing up any stuck weapon, though you are more likely to accomplish this by moving away from the enemy, or complexly interacting with the weapon.

Any creature can be attacked by standing next to it and pressing {{k|A}}. Attacking a friendly or unconscious creature (which includes wild animals for elves) will further require a confirmation, given using {{k|alt}}+{{k|y}}.

After selecting (and maybe confirming) which creature you want to attack, {{k|A}} will allow you to make an '''aimed attack'''. You must first select the body part that you want to attack. Look at the difficulty rating for various possible attacks. Impossible attacks will be nearly impossible to land and Easier attacks will be very easy to land. The difficulty rating for an attack does not change depending on your weapon skill. Based on player experiences, a Grand Master weapon user can almost always land a "Tricky" strike, while a Novice generally cannot. Attacks on various locations will also have limits on how "squarely" they can land (due to being out of reach, for example). Square and very square attacks will deal more damage.{{Verify}} Attacks which "can't land squarely" are generally still effective.

Attacks aimed at the head are the most effective; a single attack to the cranium with a weapon will usually put an end to the fight. Aimed attacks are especially useful for dismembering opponents. Opponents who are missing a foot will fall over, thereby greatly lowering their speed, and giving you an immediate edge in the fight. Cutting off both hands also highly recommended for obvious reasons. After all, a field full of armless, one-legged enemies can be a big experience booster for your character and your companions.

Aimed attacks are also especially helpful when fighting giant beasts. Some enemies like giant desert scorpions have lots of redundant body parts, and random attacks waste valuable time on low priority areas while the scorpion is busy injecting venom into the whole party. Lastly, aimed attacks allow you to grab trophies that are not available via butchering. For example, a minotaur's horns can be cut off during a fight, but since its a humanoid, most adventurers will refuse to butcher its corpse after the fight. However, in Dwarf Fortress 2014, all butcherable corpses are able to be butchered, as long as the corpse isn't too mangled.

There are several options below the hitting menu. Quick attacks are faster than regular attacks but weaker. Heavy attacks are slower but attack harder. Wild attacks are faster and hit harder but are inaccurate. Precise attacks are very slow but are much more likely to hit. Multi-attacks allow you to attack several times in a row at a great cost to the effectiveness of any one of the chosen attacks.

In addition to aimed attacks pressing {{k|A}} also allows for the three defensive maneuvers blocking, dodging and parrying. They do not have fixed keys because their order changes if one or more is impossible (e.g. no blocking without a shield). When dodging you will be able to pick a direction, and your character will move on step in this direction, possibly avoiding any number of attacks. Note that you can dodge even if you are not being attacked. When blocking or parrying you can pick one attack and attempt to stop it. If several attacks are incoming the remaining attacks will not be affected.

==== Ranged attacks ====

To attack with a ranged weapon press the {{k|f}} key with a ranged weapon (bow, crossbow, etc.) equipped on one hand and select the square where you want to attack. Note that you need to have some sort of ammo, corresponding to the type of ranged weapon you are using (for example, bows use arrows, crossbows use bolts). Otherwise, a message stating "You have nothing left to fire." is displayed in brown. Similarly use the {{k|t}} key to throw any random object in the same manner. Random objects appear to make a random attack if they happen to have more than one possible type.{{Verify}} For example, if you throw a sword it may hit with a blunt impact, a stabbing impact, or a slicing impact. Throwing crossbow bolts with sufficient throwing skill and strength seems to have an effect similar to firing them, although less powerful. On the plus side, you will never lose ammo if you throw it.

It is not possible to aim for specific body parts with ranged or thrown attacks.

Throwing is generally a good skill to have for any adventurer, as it allows you to slow down fleeing foes, both on the ground and in the air without the need of equipping a (cross)bow. Just like {{k|l}}ooking, you can use throwing to view and hit enemies multiple Z levels away from you. If you're lucky, you can simply land a hit that causes the flying enemy to give in to pain, and then let gravity do the rest of the work. Even if the fall doesn't kill them, they will most likely be stunned long enough for you to run up and slaughter them.

==== Wrestling and unarmed attacks ====

:''Main article: [[Wrestling]]''

'''[[Wrestling]]''' (grappling) can be performed by selecting an enemy via {{k|A}} followed by {{k|b}} to wrestle. You can wrestle any enemy. Wrestling works somewhat like a targeted attack. Once you grab a creature by some body part, you may be able to make another wrestling attempt that will allow you to perform a throw or takedown.

For a detailed list of moves such as takedowns, throws, choke holds, etc., see [[Wrestling]].

It's also possible to punch, kick, and bite. These are not in the wrestling menu but are performed like normal targeted attacks with {{k|A}}.

==== Weapons ====

[[Weapon]]s are basically divided into axe, sword, spear, pike, mace, whip, bow and hammer, with various versions of these taking up the gray area.

==== Wounds ====

If you get wounded during combat, there's not much that you can do except perhaps run before you get more wounded. Be aware that movement speed while stunned, nauseous or winded is reduced and might leave you open to fatal blows. Your wounds will heal over time, so just travel around or sleep in a safe place. Some wounds however may never heal, leaving you permanently crippled. Obtaining a crutch may help with this. Or if you are not already a vampire, then you can get bitten by a werebeast during full moon, which will heal all injuries once per month.

If you have some bolts or arrows stuck in your body, they can be removed by using the complex interaction menu {{k|I}}. Select the stuck bolt or arrow from the list and then pull it out with {{k|a}} You'll probably start bleeding after you pull it out, but the bleeding is rarely anything to worry about.

==== Combat preferences ====

At any time during gameplay (Except fast travel mode), you can press {{k|C}} to open the Combat Preferences menu. There are three different preferences you can set: Attack, Dodge and Charge Defense. These have a few different preferences each:

*'''{{k|a}}ttack'''
**'''According to Opponent''' - The default setting. When set to this, charging happens more or less frequently, depending on the difference in size between you and the opponent. Bigger opponents get charged less, smaller more often. Can be very risky, since a random charge against a huge opponent is likely to get you knocked down and stunned. In the same vein, charging when close to obstacles or other environmental hazards is very dangerous, potentially fatal, if the enemy dodges you.
**'''Strike''' - This setting ensures that you never charge an opponent, but rather just swing your weapon at them. This carries less risk than the above, but you're never going to knock anyone down without hitting their legs or spine. Very preferable against large opponents.
**'''Charge''' - When set to this, you ALWAYS charge. When faced with numerous small enemies (Bogeymen in particular), this can be extremely useful, but remember to switch back when facing something bigger. Charging a large dragon is almost a certain death sentence.
**'''Close Combat''' - With this setting, all your auto-attacks are grapples. Generally not very useful, since the random nature of it tends to prevent you from actually doing any damage with it, but if you continually auto-attack a harmless creature with it your wrestling-skill will be legendary in no time.

*'''{{k|d}}odge'''
**'''Move Around''' - This means you can jump away from attacks, physically moving in a random direction. While this lets you dodge attacks more often, it can also result in you jumping into a wall or down a lake. If you're fighting in really tight spaces, or areas with large pits, you might want to switch to the other option.
**'''Stand Ground''' - As can be expected, you stand your ground. No jumping around, which is useful in the above situation, but risky in the open. If you have room for jumping around, go with Move Around, but otherwise this could be a good idea.

*'''{{k|c}}harge Defense'''
**'''According to Opponent''' - Again, the default setting. You're more likely to stand still against small enemies charging, but will probably prefer moving away from larger ones. Somewhat risky, in that even a somewhat small enemy can stun you by charging.
**'''Dodge Away''' - With this, you'll dodge away from charging enemies, if you can. It's not a sure bet, but it's very much worth it against enemies who like to charge. This is probably the most preferable mode, since you're not losing a whole lot by dodging a small foe charging, but dodging an angry night beast can save you from a world of pain.
**'''Stand Ground''' - If you're certain of your physical superiority to the opponent, you can safely choose this. Standing your ground like a real man/woman might feel hardcore, but getting knocked down in a fight can be extremely dangerous. It probably has some use against bogeymen though, since they're quite small. If you really are much bigger than the enemy, you'll end up knocking THEM down. Most of the time though, charges heavily favor the attacker, so dodging away is probably preferable.

Using Combat Preferences properly can actually save your hide, so it's worth fiddling with. Just don't forget that you've fiddled with them, since a misplaced charge or dodge could end up killing you.

=== Talking ===
[[File:Advmode_conversation_DF2014.png|thumb|400px|Talking to someone in Adventurer mode.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|k}}
| Talk to somebody
|}

Now that you know how to kill people, you may also want to know how to talk to and otherwise interact with them in a less violent manner. While this is less entertaining, it can sometimes be useful.

To begin a conversation or performance, press {{k|k}}. Unless someone else has already started a conversation with you (see below if someone has), you will get a cyan X that can be positioned over people you want to talk to with the normal directional keys. Use {{k|-}} and {{k|+}} to select who you want to talk to. Aside from individuals, you can also {{DFtext|Shout out to everybody}}, which will have you talking with everyone in earshot, or you can talk to your deity or you can even {{DFtext|Begin Performance}} which includes such things as reciting poetry, telling stories or dancing and is very important if you want to be a bard.

Whenever you want to advance the conversation, you have to press {{k|k}} again and choose the ongoing conversation you wish to continue. You will also see ongoing conversations from people who have started a conversation with you. If you want to talk to someone else during this time, simply {{DFtext|Start a new conversation}}.

* {{DFtext|Greet listener}} — Has you offering a greeting to someone, when you're initiating the conversation.
* {{DFtext|Bypass greeting (new menu)}} — Skips the greeting, taking you straight to the normal conversation menus.
* {{DFtext|Reply to greeting}} — If you aren't the one who started the conversation, this option will let you reply to someone's greeting. They will then talk about some trouble.
* {{DFtext|Refuse conversation}} — Causes you to explicitly refuse to talk to someone who started a conversation with you. Unknown if this has a different effect from simply not doing anything.{{Verify}}
* {{DFtext|Reply to greeting (impersonation)}} — Like {{DFtext|Reply to greeting}}, except you're impersonating a deity.
* {{DFtext|Nevermind}} — This has you back out of having a conversation.

When you start talking to someone, you are presented with a wide array of things to talk about. (If the person you are talking to started the conversation and told you about some trouble, you'll first get a menu related to that trouble. Just press {{k|-}}-{{k|Enter}} to {{DFtext|Change the subject (new menu)}} and get to this first menu.) Your choices are as follows:

{| class="wikitable" style="border:1px solid #ccc;"
| style="text-align:right;width:30%;" | {{DFtext|Return to current topic (new menu)}}
| You'll see this option only if you chose to change the subject in another menu. This will, predictably, take you back to that subject.
|-
| style="text-align:right;" | {{DFtext|Bring up specific incident or rumor (new menu)}}
| Allows you to spread rumors or summarize conflicts you've been a part of. The next step of the conversation will bring up a menu of choices that allow you to ask for directions to places or state your opinion on the incident/rumor.
|-
| style="text-align:right;" | {{DFtext|Create a performance troupe together (group naming menu)}}
| If the listener is in your party as a performer, you can choose this option to create an official troupe.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Ask to become a hearthperson}}
| Only appears when talking to a lord/lady who you aren't under the command of. Allows to become one the leader's guards.
|-
| style="text-align:right;" | {{DFtext|Invite listener to become a hearthperson}}
| Only appears when you are a leader. Allows to become one the leader's guards.
|-
| style="text-align:right;" | {{DFtext|Ask to become a lieutenant}}
| Only appears when talking to a bandit leader who you aren't under the command of. Allows to become one the leader's lieutenants.
|-
| style="text-align:right;" | {{DFtext|Invite listener to become a lieutenant}}
| Only appears when you are a bandit leader. Allows to become one the leader's lieutenants.
|-
| style="text-align:right;" | {{DFtext|Ask to be made a performer for group}}
| Only appears when you are talking to a leader. Allows you to become a performer for the group. Usually, you need to prove your performing capabilities to be accepted.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Ask for your performance troupe to become performers for group}}
| Only appears when you are talking to a leader. Allows your performance troupe to become performers for the group.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Request duty or advice pertaining to service as a hearthperson}}
| Only appears when talking to a leader who are under the command of. You will receive some task to accomplish for the group, if there is anything that needs doing. In 42.xx, these will include killing monsters and bandits, or causing trouble for other groups. Completing these tasks will allow you to gain fame as a loyal soldier in addition to the fame from slaying the beast or killing the bandits.{{version|0.42.01}}
|-
|-
| style="text-align:right;" | {{DFtext|Request duty or advice pertaining to service as a lieutenant}}
| Only appears when talking to a bandit leader who you are under the command of. You will receive some task to accomplish for the group, if there is anything that needs doing. In 42.xx, these will include killing monsters but not bandits, or causing trouble for other groups. Completing these tasks will allow you to gain fame as a loyal soldier in addition to the fame from slaying the beast.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Bring up the journey together}}
| Only appears when talking to a companion. The next step of the conversation will allow you to cancel the agreement you made with that person, if you so choose.
|-
| style="text-align:right;" | {{DFtext|Inquire about any troubles}}
| Asks the listener what things in the world are bothering them and their people.
|-
| style="text-align:right;" | {{DFtext|Ask for directions (new menu)}}
| Allows you to ask for the location of a specific creature or site. People aren't guaranteed to know, and may instead direct you to someone who does.
|-
| style="text-align:right;" | {{DFtext|Ask about the local ruler}}
| As you might imagine, this gets you some information on who controls this particular area.
|-
| style="text-align:right;" | {{DFtext|Trade or settle debts}}
| Allows you to trade with a merchant or pay for your drink from a tavern keeper. Note that you have to be right next to them for this to work.
|-
| style="text-align:right;" | {{DFtext|Ask about available services, drinks, rooms, etc.}}
| Appears when in a structure, but only works with tavern keepers. Allows you to purchase drinks and rent rooms in a tavern.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Exchange, give, or take personal items}}
| Like {{DFtext|Trade}}, only that it works with non-merchants.
|-
| style="text-align:right;" | {{DFtext|Ask favor, place request, make demand or issue order (new menu)}}
| Takes to a menu of various request you can make, including asking the listener to yield, stay put, or pay homage to your group. The options available depends on who you're talking to.
|-
| style="text-align:right;" | {{DFtext|Ask listener to join you (new menu)}}
| This is how you get companions. You can either ask them to join you on an adventure, to lead you to some location, or to join your performance troupe if they are convinced of your skills.
|-
| style="text-align:right;" | {{DFtext|Claim this site for yourself (group naming menu)}}
| This option allows you to stake a claim on the site you are in. You need to retire or be Hearthperson or Lieutenant to be able to claim as Outsider.
|-
| style="text-align:right;" | {{DFtext|Ask for permission to stay a day}}
| Allows you to sleep in the listener's building for the night.
|-
| style="text-align:right;" | {{DFtext|Ask about the structure you are in}}
| Tells you about whatever structure you are standing in, if you are standing in one.
|-
| style="text-align:right;" | {{DFtext|Ask about this site's neighbors and trade partners}}
| Lets you learn what sites this site is neighboring and/or trading with.
|-
| style="text-align:right;" | {{DFtext|Ask about the surrounding area}}
| Choosing this will tell you about some location nearby, and why it's significant.
|-
| style="text-align:right;" | {{DFtext|Express your emotions (new menu)}}
| Brings you to a menu where you can state your feelings about an event (such as improving a skill), or say something general about your emotions or thoughts.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|State your values (new menu)}}
| Lets you state one of your [[Personality_trait|value]]s. Doing so will start an argument with the listener if they have differing values, and can train your Persuader, Judge of Intent, Flatterer, Intimidator, and Pacifier [[social skill]]s depending on how you argue. If you win the argument your opposition's [[Personality_trait|values]] will change to match yours if you give in, yours will change.This can result in your needs changing. {{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Comment on weather}}
| Small talk about the weather. Really.
|-
| style="text-align:right;" | {{DFtext|Comment on natural surroundings}}
| Same as the weather, only about the nature around you.
|-
| style="text-align:right;" | {{DFtext|Accuse listener of being a night creature}}
| If chosen against a night creature, such as a vampire, it will expose them. Normal individuals will just think you're losing it.
|-
| style="text-align:right;" | {{DFtext|Inquire about listener's profession}}
| Learn what it is the listener does. Useful for lords and ladies and anyone else whose profession isn't listed next to them. This can also potentially oust bandits if they aren't hostile, if you aren't sure you have the right <strike>victim</strike> suspect.
|-
| style="text-align:right;" | {{DFtext|Ask about listener's family}}
| Discover what family the listener has, as expected.
|-
| style="text-align:right;" | {{DFtext|Brag about your past violent acts}}
| Causes you to brag about whatever last violent act you did. Doesn't seem to have an effect, or at least severely less impactful than summarizing the conflict.{{Verify}}
|-
| style="text-align:right;" | {{DFtext|Say goodbye}}
| Ends the conversation.
|}

Note that you can press {{k|Esc}} to not choose anything. The conversation is still ongoing, you have to explicitly say goodbye to end it. Pressing {{k|Esc}} is useful if you need to double-check something before talking.

=== Companions ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|c}}
| View companion interface
|}

Companions are the guys who follow you around after you've asked them to join you and they've accepted. Your character will have a limit on the maximum number of companions that is based on fame/reputation level and the ''Social Awareness'' attribute. With average social awareness and the maximum level of fame, the limit is 19 companions. Note that people with no military skills are unlikely to agree to join you, and people with military skills higher than yours will also be unlikely to join you.

You can use the {{k|c}} key to open up a list showing your companions and their relative position to you. This can be useful if one of them runs off somewhere and you want to find them. You can select specific companions who are in visual range in order to view them. This is the same as viewing them with {{k|l}}ook.

You can give or take equipment with a companion by choosing to talk to them and selecting {{DFtext|Exchange, give or take personal items}}. An evil and arguably inefficient way to get equipment is to intentionally get your companions killed and then take their stuff. If you are trying to help your companions, it is important to note that they prefer to store exchanged items in a personal container rather than to equip said items. You must convince your companions to trade away any containers (pouches, quivers, backpacks, etc.) as well as the equipment that you are attempting to replace. Once you have given your companions almost no choice in the matter, they will equip the new items and a message like {{DFtext|The Swordsman reorganizes his possessions.|6:1}} will be displayed.

If they survive long enough/are trained well enough then companions are capable of leveling stats and skills. Thus they are susceptible to gaining a title or having a job title change as well.

Your companions will continue to follow you and fight hostile creatures around you until they die (if you asked them to join you on an adventure) or get you to the proper location (if you asked them to guide you some place). If you want to get rid of your companions at any time, the safe way is to talk to each one of them, ask them about their journey with you, and then cancel the agreement.

If your companions are too far away from you when you enter fast travel, they will become an asterisk on the map where you started fast travel from. This asterisk may try to join up with you during travel. If you keep losing your companions while traveling through rivers, try going to a spot where the river becomes a "minor river" (shown by a single dark blue line). Brooks are obviously also safe to cross.

{{new in v0.42}}
In v0.42, you can have companions join you as performers after you convince them of your skills. This can be used to recruit people you normally couldn't recruit, such as civilians and stronger soldiers. The maximum on this is also much easier to obtain, allowing players to bring a mob of dancing civilians along with you.

=== Personal finance ===

==== Trading (barter) ====

In human towns (not hamlets or castles), you can find shops,in Elven Trading trees you can find markets and at depots in dwarven fortresses you can encounter brokers. Once you're inside of a [[shop]] and right next to any of the NPCs, you can use {{K|k}} to {{DFtext|Trade}} with them. Use {{K|Enter}} to select which items to trade, left/right arrow keys to switch between the list of shop items and your items, and up/down arrow keys to scroll through the lists. You can also either {{k|a}}sk for or {{k|o}}ffer currency as part of the process. Once done, press {{K|t}} to trade. The shopkeeper won't get angry if you're not offering enough in trade, so you can start offering just a few items, keep trying again with a little more until the trade is accepted. Once the trade is accepted all of the items you offered will be on the floor underneath you.

After trading, you will find the stuff you gave on the floor at your feet, and the stuff you got in your inventory.

==== Theft ====

You may also pick up the item before buying it, but you should never walk out of a shop carrying an unbought item, as that is theft. It is punishable by death if you are caught, and excommunication if you are not. On any occasion when you have stolen goods from a store (indicated by dollar signs on either side of the item in your inventory), the game requires you to exit the site ''and'' move a considerable distance before allowing you to quick travel. This may make a getaway more difficult if your adventurer is not already faster than anyone else. This only applies to goods in stores; killing townsfolk and taking their personal things, including those of the shopkeep still only requires exiting the site. The moment you are out of sight, you will be able to warp out as usual. Theft and murder remain within entities; even depopulating one country and stealing all its things will not generate ill response in another country.

In some cases, the shop will be abandoned. This will be made clear by the presence of unbought items and the lack of any merchants in the area. You will not be considered a thief by the relevant entity for taking stuff from an abandoned shop, but you will still be withheld the privilege of fast-travel until you leave the site.

If the item name is not surrounded by dollar signs, it is never considered stealing, even in situations where it would be in real life.

==== Managing coins ====

You will find that coins from one civilization are nearly worthless in other civilizations. This will typically result in adventurers carrying around lots of now useless coins. Coins can and will encumber your adventurer, eventually reducing your speed. To reduce that effect you can try to exchange your copper and silver coins for gold ones as well as sell all of your loot directly for gold coins. Remember, merchants will always try to pay you in higher denomination currency first but will resort to lower value coins if they run out of anything higher. First, check the merchant's chest to see how much of each type of coins they have.

Coin values are as follows:
* Copper Coin == 1☼
* Silver Coin == 5☼
* Gold Coin == 15☼

To receive the maximum amount of gold coins from that merchant, make sure the amount "they owe you" during the trade is equal to (total amount of gold coins the shop has)*15☼ . If you are selling loot, simply make sure you only trade this worth of goods, and move on to other merchants for the rest. If you wish to exchange copper and silver coins for gold, buy random goods from the merchant until their price is around this value and then sell back all of the goods for their original value but in gold.

Alternatively, you can take your excess coinage and use it to purchase [[Gem|large gems]] at a trinket shop. Large gems make good investments because they are 1) light, 2) variably priced, and 3) equally valuable between different civilizations.

A few goods are strictly superior to all forms of coinage as a store of value, most notably giant cave spider silk items. A suitably sneaky (or powerful) adventurer can murder a few dwarves or goblins for such items for trade and sale for human goods. Giant cave spider silk is a non-renewable resource in a given world - please harvest responsibly.

==== Where to get items to sell ====

The best place to get items to sell is at bandit camps, after you've slaughtered all the bandits. You can loot the clothes and equipment off of the corpses of the bandits (and off your fallen companions, too), plus at the very center of camp there'll be a few scattered weapons and a few bags/chests containing various goods.

The next best way to get items to sell is to kill a creature, butcher their corpse (see below for how), and pick up the edible bits. Butchered bits from the corpses of people (dwarves, elves, humans, etc.) can sometimes be found in monster lairs and these seem to be just as desired by shopkeepers as the products you gain from your own butchering. Remember that you can also carve the bones of animals to make them desirable trading items.

Another good early source of income can be bags left in houses and shops, which usually contain plants and food. No one will complain, and the plants inside can be sold at about 2☼ each plus the value of the bag.

At the bottom of the list comes {{k|L}}ooking carefully and selling any small creatures you might find. However, shops will not accept live creatures unless they are in cages. Some rocks, piles of sand, and other things found on the ground nearly everywhere can also be sold for 1☼ each.

You can also try filling your backpack from river - it can hold up to 100 units of water which is worth 100☼ total. After your sell it, water will drop to the floor as a pool, and backpack can be refilled instantly and for free from there. In fact, you can infinitely fill any container from any pool/pile of any liquid/powder, so if you happen to find some precious substance like [[sunshine]] or [[dwarven sugar]], money won't be a problem for you anymore. This is of course an [[exploit]], liable to be fixed at any time. It may be useful in a pinch, but don't rely on it.

Another devious method is to go outside the shop, {{k|g}}rab handfuls of mud and throw it into your backpack, then sell them for 1☼ each. The merchants will gladly buy your rare and valuable mud despite the unlimited free mud just outside their shop.

=== Quest log ===

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Q}}
| Open quest log
|-
| {{k|Esc}}
| Exit quest log
|-
| {{k|e}} {{k|p}} {{k|a}} {{k|s}} {{k|r}} {{k|b}}
| Access various lists
|-
| {{k|m}}
| Switch between the world map and additional info
|-
| {{k|z}}
| Center cursor on location of selected list item, if known
|-
| {{k|c}}
| Center cursor on your location
|-
| {{k|l}}
| Toggle the visibility of the line between you and some other point on the map.
|-
| {{k|f}}
| Filter the list
|-
| {{k|+}} {{k|-}} {{k|*}} {{k|/}}
| Navigate the list
|}

The quest log contains everything you know about the world, such as various events going on, people you know, and various sites. The {{k|m}} key will alternate between a world map that you can navigate, and information on whatever item is highlighted in the list to the right.

There are various kinds of lists you can check on the quest log:

* '''Events''' — A list of events that are happening or have happened. Formatting of the list is {{DFtext|(type)/(description)}}. You can center on the location of the event if you know this. This list is the closest you'll get to some formal quest system.
* '''People''' — A list of people you know. At the start of the game, this list will contain people in your site.
* '''Sites''' — A list of various sites around the world.
* '''Groups''' — A list of groups you know of and your relation to them. Note that you have to press {{k|e}} when you're on the events list in order to reach this list, requiring you to press {{k|e}} at most twice.
* '''Agreements''' Your various agreements this includes tasks given to you by your lord and why people are traveling with you and the history of your agreements.
* '''Regions''' — A list of regions. The additional information will list the biomes a region possesses.
* '''Bestiary''' — A list of creatures, their characteristics, and where you could find them.

=== Create ===
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|x}}
| Perform action (butcher, create item...)
|}

Adventurers can perform limited crafting, (also known as "reactions"). To access the crafting menu, press {{k|x}}. In addition to crafting, other actions can be performed.

==== Crafting ====

* '''[[Knapper|Knapping]]''' allows an adventurer to sharpen a rock. Knapping only works on stones on the ground or in your hands. Choose the {{k|c}}reate option and then select "Make sharp stone". You will be prompted to choose a rock to sharpen ("tool stone"), and then the rock that is to be the hammerstone. The tool stone will be replaced in your hand by a sharp version.

* '''Helves''' (hafts){{version|0.43.01}} are carved from branches, which can be pulled from trees. Doing so requires a sharp item, which can be anything from a weapon or arrow all the way to a sharpened rock. Helves are currently only used to make...

* '''Stone Axes'''{{version|0.43.01}} - Assembling a stone axe requires a helve plus a sharp rock as components. Stone axes are inferior to battle axes, but are just as usable for cutting down trees.

* '''[[Bone carver|Carve Bone]]''' acts similarly to Fortress Mode's [[Bone carver]] by allowing the adventurer to, well, carve bones into various objects and figurines. The bone carving options are contained in a subsection of the crafting menu, due to the number of options.

* '''Carpentry'''{{version|0.43.01}} is another crafting menu, but using it requires one to stand on a carpenter's workshop. This can be one found in fortress, or it can be constructed by yourself. The menu includes various furniture (not all of which can be placed in the build menu) along with various containers, buckets, shields, and training weapons. All of these require a log and a sharp object.

==== Butchery ====

'''[[Butcher|Butcher]]''' acts similarly to Fortress Mode's [[Butchery]] by converting a corpse into edible products, bones, and skin. A corpse must be on the ground or in your hand. With a sharp object (such as a dagger or knapped stone or even a bolt/arrow) in your hand or on the same tile of the corpse, select the {{k|b}}utcher option, and then you can select the corpse and the sharp tool to butcher with. The corpse will be replaced by its butchering returns.

==== Natural abilities and acquired powers ====

* '''Spitting''' gives you spit(if you are a creature that can), which can be aimed at someone in much the same way as any projectile. To get this, choose natural ability and then spit in the reactions menu. Other natural abilities exist (such as breathing fire), but only some are usable, since some belong to creatures that are not playable.

You may also gain acquired abilities when you become a creature of the night, such as a necromancer.

==== Composing ====

Composing allows you to select '''musical compositions''' or '''choreography''' to create new songs and dances. Upon selecting one of the two, you will then be able to select from one of the art forms already known to the adventurer, which the specific song or dance will be an example of.

==== Writing ====

'''[[Writer|Writing]]''' allows the adventurer to write books and scrolls, allowing one to create various types of literature. Writing requires reading or writing skill as a prerequisite, along with a blank scroll or quire available. Each option produces different results.

* '''Guide''' - General writing about a specific site, generally described as "concerning" that town, dark pit, etc. without going into detail.

* '''Essay''' - Writing about individual historical events, generally of personal relevance to the adventurer. The acension of that adventurer to lordship, companions joining the party, and other such events.

* '''Manual''' - This will write down a randomly-selected form of knowledge the adventurer is aware of, to be learned by future readers. Most commonly this will be musical, poetic, and dance forms the adventurer knows or composed. This can also include scientific research the adventurer has learned, and necromancer adventurers can spread the secrets of life and death by writing manuals about them.

* '''Chronicle''' - In-depth writing about a particular site, group, or civilization. This will be presented as multiple characters, each chapter relating to a historical event related to the writing's subject.

* '''Letters''', '''short stories''', '''novels''', and '''plays''' will write generic prose, typically described as having no particular subject. In addition, letters will normally generate untitled.

* '''Composition''' - Writes new songs. This functions similarly to composing new songs, with the added benefit of writing it down for others to learn. However, unlike normal composition you do not get to select which musical form to base the song in.

* '''Choreography''' - As with compositions above, this writes down a new dance based on a randomly-selected dance form the adventurer knows.

* You can also unlock even more types of writing by going to a library and reading books of different genres. Such as '''biographies'''.

Additionally, at the bottom of the writing menu you have the option of writing down specific songs and dances known to the adventurer.

== Woodcutting, building and site management ==
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|b}}
| Found a site and build
|}

As of version 43.01, adventurers can chop down trees for resources, and build their own personal sites to claim as their own. Neither of these can be performed on existing sites like towns.

First one needs wooden logs, acquired by chopping down trees. With an axe in hand, hitting {{k|g}} while next to a tree allows you to chop it down.
As of version 43.03, wooden axes will not work to chop down trees.

Any object that is being used in the construction process, must be on the ground within the borders of your site to be used in the construction. Logs and furniture in your inventory will need to be dropped before they show up in the build menu. Every item used in construction takes 1 hour to be built. Standing under a constructed floor or wall will prevent bogeymen from attacking when building at night. Constructions will be built starting from the top-left square and building from top to bottom, much like how a printer moves. It's advisable to start with a small construction to get a roof over your head before nightfall. Note that if there are any items located where you are building a construction, it will be permanently removed once you complete the construction.

Having companions with you will greatly speed up the build time as they can be recruited to help you. You can even make them do all the work if you don't want to get your hands dirty. If you assign them to build but don't build yourself you can leave the site whilst they work (they will follow you until you leave the site though if they are your companions but once off site they will stay) After building your structure, you can designate zones for {{DFtext|Mead Hall}}, {{DFtext|tavern}}, {{DFtext|library}}, or {{DFtext|temple}} locations and non-location {{DFtext|zones}} and you can assign people to these locations.

Building a carpenter's workshop will give you access to wooden furniture. To build furniture, drop logs in the workshop and press {{k|x}} and use carpentry in the {{k|c}}reate menu. Furniture will be in your hands after you create it, so you'll need to drop the items before you can use them in your construction(the game will happily let you stand around for 6 hours and "build" the 6 cabinets you are holding in your hands, even though they don't show up and aren't used in the construction).

==== Faction management ====

After you create a mead hall zone you can claim it like you can claim any mead hall, you will get a text popup telling you you are in control now and your title will change to lord, you may then start hiring guards and assigning them to your sites zones. The guards will automatically patrol your site if they are not your companions, or will hang out in the zones you assign them.

Note If they are not your companions they will not build for you.

As with owning a town, you can force the leaders of nearby villages to pay you tribute via the
{{DFtext|submit and pay tribute}} demand if you create a site and claim its mead hall. However they are unlikely to submit under non-strenuous circumstances.

== Sites ==

More information on each type of site can be found in the site's specific article.

=== Civilization ===

[[Civilization]]s are organized groups of creatures (generally of the same race) which build sites such as towns.

==== Human sites ====

===== Towns {{Raw Tile|+|7:0:0}} {{Raw Tile|*|7:0:0}} {{Raw Tile|#|7:0:0}} {{Raw Tile|☼|7:0:1}} =====
Humans live in towns comprised of buildings and often a paved road. Human towns are highly modular, and are usually near some source of water, either the coast or a river.

Towns appear on the fast travel map (when outside a site) as {{Tile|■|7:0:1}} or {{Tile|■|6:0:1}} symbols which are small collections of buildings. When you are near a human site, large yellow blocks indicate where various houses and shops are found (though not all houses and shops can be found in these blocks; sometimes you'll find a house or two out in a site's fields). You usually have to follow the roads in a yellow block on the fast travel map.

Towns usually have lots of interesting structures which are described fully in the [[town]] article.

===== Hamlets {{Raw Tile|æ|2:0:0}} {{Raw Tile|Æ|2:0:0}} {{Raw Tile|{{=}}|2:0:0}} {{Raw Tile|≡|2:0:0}} =====
Most of the time, the majority of a human civilization's population will live in small [[hamlet]]s, which tend to be sprawled out along coastlines and through river valleys. Like other sites, they can be invaded, and you'll sometimes find them captured by other civilizations, [[necromancer]]s, or criminal syndicates. Human adventurers usually spawn in hamlets.

Note that hamlets are similar in structure to towns, only they have mead halls instead of keeps, and don't have any defensive walls.

==== Dwarven sites ====

===== Dwarf fortresses {{Raw Tile|Ω|7:0:1}} =====
These are the randomly generated equivalent of the sites you build in [[dwarf fortress mode]]. [[Fortress]]es are described in detail in the own article. Their main function for adventurers is that they have a central, spiraling ramp that connects the underground and above-ground worlds, particularly in that they connect the subterranean tunnel networks to the rest of the dwarf civilization. They are located at the edges of mountain ranges.

Player-made fortresses are considered dwarf fortresses by the game, in addition to the randomly-generated ones.

===== Mountain halls {{Raw Tile|Ω|0:0:1}} =====
[[Mountain halls]] are the sites of the "deep dwarves," located far beneath the mountains. They can be accessed via down-stairs found in underground tunnels, and are comprised of a couple of levels that contain bedrooms and large halls filled with smelters or forges.

===== Hillocks {{Raw Tile|Ω|7:0:0}} =====
[[Hillocks]] are the dwarf equivalent to human hamlets. They consist of a few circular mounds filled with dwarf citizens. There doesn't seem to be any settlement pattern for them; they are equally likely to be found in any land [[biome]].

==== Elven sites ====

===== Forest retreats {{Raw Tile|î|6:0:1}} {{Raw Tile|¶|6:0:1}} =====
Elves live in [[forest retreat]]s located, unsurprisingly, in [[forest]] biomes. They are essentially clusters of huge [[tree]]s with elves standing in and around them.

==== Goblin sites ====

===== Dark fortresses {{Raw Tile|π|0:0:1}} {{Raw Tile|π|5:0:1}} =====
These are the main goblin sites. [[Dark fortress]]es contain a [[underworld spire|certain spoiler]].

===== Dark pits {{Raw Tile|º|5:0:0}}=====
These are the goblin equivalent of hamlets and hillocks. [[Dark pits]] are essentially canyons lined with wooden guard towers. They tend to be built in huge clusters around the dark fortresses, such that large chunks of the map may be covered with them.

==== Kobold sites ====
===== Caves {{Raw Tile|•|0:0:1}}=====
[[Cave]]s are sometimes home to [[kobold]] groups. They are mounds filled with narrow tunnels leading to the [[caverns]] and usually contain piles of random loot resulting from kobold [[Thief|thieving]] incursions. Some caves are inhabited by [[bandit]]s or [[megabeast]]s instead.

==== Beast and night creature sites ====

===== Necromancer's towers {{Raw Tile|I|5:0:0}} =====
[[Necromancer]]'s Towers are built by necromancers who have at least 50 followers; younger necromancers may take over towns or camps instead. Usually you can find [[book]]s written by the necromancer, some of which contain [[Necromancer#Adventurer_Mode|the secret to life and death]]. Towers require abundant human populations (low savagery, large tracts of neutral land) and a high number of secrets to be generated in world generation, as necromancers cannot be elf or goblin.

===== Lairs {{Raw Tile|•|0:0:1}}=====
[[Lair]]s are the homes of [[animal|predatory animals]], [[megabeast]]s, or [[night troll]]s. Lairs are mounds or holes in the ground. Night troll lairs have [[door]]s or [[hatch cover]]s. Most lairs are inhabited by a single creature, but sometimes you'll encounter entire families of them.

===== Minotaur's labyrinths {{Raw Tile|#|0:7:0}}=====
A [[Labyrinth]] is an intricate network of tunnels often filled with the bodies of previous adventurers slain in [[World generation|worldgen]] by its resident [[minotaur]]. Each labyrinth contains a hidden chamber filled with treasures. As you explore the labyrinth, you will hear the minotaur taunting you.

===== Shrines {{Raw Tile|Å|7:0:0}} =====
Shrines are huge stone structures surrounded by pillars that are the homes of [[Bronze colossus|bronze colossi]] and [[titan]]s. Several of them can be found on a single site, making its exploration particularly hazardous. [[Clowns|Clowns]] have also been reported to inhabit them.

== FAQ ==

=== How do I cut down a tree? ===
To cut down a tree in adventure mode you must be outside of a previously existent site (adventure mode sites not included).
Then walk up to the tree and press "g" select the fell tree option. {{version|0.43.01}}

=== How do I find an entrance to the underworld? ===
Method 1: Most [[Cave|caves]] lead directly into the first [[cavern]] layer. Although it may be possible to learn of some trouble which originates from a cave{{verify}}, your best bet is to ask people about the surroundings, and hope that they mention a cave at some point. If they don't, travel to another site a fair bit away from where you are and ask someone else.

Method 2: Dwarf [[Fortress|fortresses]] are connected to the [[tunnel]] system, which usually connects to the caverns.

Method 3: You can start a [[dwarf fortress mode]] game, dig to the first cavern layer, retire or abandon the fortress, and then return with your adventurer.

The three cavern layers are connected to each other in [[Deep pit|various]] [[Passage|places]], although they are rather spread out and extremely difficult to find with an adventurer.

Additionally, [[Underworld spire|a certain spoiler]] can be found which leads to [[Hell|another spoiler]], deep underground.

=== I keep getting maimed! How can I fight without getting seriously hurt? ===
The best defense is a good offense. If you let your enemies attack you, you're (unsurprisingly) likely to get hurt eventually.
* Try to '''avoid fighting difficult enemies until you get some armor'''. Don't fight enemies at all unless you're sure you can beat them. If you're unsure, you're probably going to get hurt.
* Increase your speed! The most immediate way to do this is to raise your walking pace to Jog. Until your endurance is high enough this may be exhausting, but active dodging and blocking will recover energy.
* If you have good speed, try to '''fight enemies one-by-one''' — keep dodging away and only attack when you're within range of just one enemy. Maneuvering around charging opponents can cause them to collide with each other and become prone and/or stunned. Above all, don't let yourself get flanked by an enemy, much less surrounded.
* If you have a slashing weapon, try to '''chop body parts off of your enemy''' — it makes them stop fighting for a turn, allowing you to keep attacking them without being attacked in exchange. Chopping off limbs will also weaken your enemies - taking their arms can prevent them from using weapons, taking their legs can make them slow and knock them down. Chopping off their heads will instantly kill them, but it may take a few (or, with larger enemies such as [[troll]]s, it may take more than fifteen) slashes before the head is severed.
* Remember that '''it's better to let your enemy come to you, than to go to your enemy'''. You have to either move or attack. If you move, you can't attack, so if you move within range to attack your enemy, you allow them to have the first strike (unless you're much faster than them). On the other hand, if you let them move within range of you, then you get to have the first strike. If your enemy is one space away from you, use that as an opportunity to throw a knife or a rock at them; worst case, they will get a bruise or a cut; best case, they will start the melee severely crippled. If you're fast enough, then you can simply step back after getting in that first hit, and they'll have to spend their turn approaching you again. Lather, rinse, repeat.
* Follow the advice under [[#Combat Preferences|Combat Preferences]].

=== How can I obtain armor as quickly as possible? ===
* The best way would be to rummage through mead halls, keeps, and fortresses, or whatever other strongholds your race makes use of. Not all places will be stocked with equipment, but usually they have something.
** There are also underground locations, such as the dungeons underneath keeps, or the catacombs under temples, that contain plenty of equipment. These underground places are liable to be populated with unfriendly creatures, so beware.
* You can also take along companions and have them killed, or just plainly murder people and loot their corpses for stuff.
* You can earn some money by exchanging some loot with the local populace for coins, and then buy equipment off of soldiers you might meet in towns. Use the exchange personal item option, as only shopkeepers accept the straight trade option. Remember that coins only have nominal value in the civilization they've been minted, but gems are equally valuable anywhere. You can also trade your own crafts or clothing in exchange for the armor the soldiers are wearing.
* Warehouses in Human towns tend to have items in them, including, weaponry, food, Items of high value, and along them is armor. Though a cheeky way to get equipment, it works if you want to have a fast adventure.
* If you don't mind extra time, you can also start a "temporary" fortress, make as much armor as you could and then abandon/retire to return there as an adventurer later.
** Although this may take a while, with this method your adventurer may obtain quite precious, powerful and nearly unobtainable otherwise items like a full set ☼Adamantium armor☼.
** You can also make some other items quite important to an adventurer, such as ☼weapons☼ or a huge amount of lightweight trade goods, like platinum rings encrusted with diamonds. This may provide an even better alternative to coins than just simple cut gems, depending on the skills of your dwarves.
** If you choose to abandon the fortress instead of retiring, remember to put your precious preserved goods to some [[Lead|heavy]] bin or an [[Bridge|inaccessible]] place, as items tend to scarce all over the fortress if they have a walkable path from an edge of the map (see [[Abandon]]).

=== How do I increase my skills and attributes? ===

Here are some techniques for raising your skills; very rapidly in some cases.

Most of these skill-raising techniques involve repeatedly entering the same keystrokes. To assist with this you can use a [[DF2014:Macro|macro]] to make entering the same sequence of keystrokes over and over again much easier.

Increasing skills increases associated attributes which may in turn benefit other skills. For example, sharpening rocks using {{k|x}} will increase Knapping which will increase a number of attributes that help with combat skills. See [[Attribute#Skills_by_Associated_Attributes|Skills and Associated Attributes]] for a mostly complete list.

*'''Fighting and Wrestling''' — A good way to raise your Fighting and Wrestling skills and related attributes is to go find a small, relatively harmless animal and wrestle with it repeatedly. You can wrestle hitting {{k|b}} for the wrestling option after selecting the creature to fight. Continually grabbing and releasing a creature is sufficient to raise your skill, and you can do it indefinitely with the same animal as it won't be injured (unless you auto-wrestle it). Wrestling will increase Kinesthetic Sense, Spatial Sense, and to a lesser extent, Endurance. You may also somewhat increase Dodging and Shield User this way as the creature takes swipes at you.<p>It's possible to change your {{k|C}}ombat preferences for attacking and dodging to ''Close Combat'' and ''Stand Ground'', respectively, allowing you to simply walk into the helpless critter to wrestle it. (Standing your ground prevents you from moving to dodge attacks, so your wrestling can continue almost uninterrupted.) You will, however, perform occasional throws and take-downs as long as the creature remains standing, which may result in their eventual bleeding to death. Strangulation is also a repeated concern, as it will render the victim unconscious, thus making you have to wait until it regains consciousness before you can continue auto-wrestling it (though you may still raise your Wrestler and Fighter skills by 10 points for every time you ''release'' a limb - though this must be done manually and must be repeatedly confirmed, once the creature is rendered unconscious). Another concern with auto-wrestling some animals is that you will perform joint locks, and break hips, knees, and ankles in the process, which can cause the creature to bleed to death. If you can wrangle a creature incapable of blood-loss and strangulation in a high-FPS area (such as a crab on a frozen beach), you can easily raise all associated skills and attributes to Legendary and Superhuman in the course of a few minutes.</p>
*'''Shield User, Armor User, and Dodging''' - In addition to wrestling the creature, you can also sit back and let it attack you to raise your defensive skills. If you have metal armor, then a small animal like a gopher can't do any real damage to you when it hits. Also, to place emphasis more heavily on shield blocking, you can change your attack {{K|C}}ombat preference to ''Stand Ground''. The wrestling-a-crab-on-a-frozen-beach method also works fantastically for this.
*'''Weapon Skills and Fighting''' — Once your defensive skills are getting up there and your agility is high enough, you might want to try fighting [[bogeyman|bogeymen]] to increase your weapon skill. Just make sure to fight them one at a time while running away. If you don't know what a bogeyman is yet then you are probably not ready to try this. Also, doing difficult targeted shots will gain more experience and keep the training dummy alive longer.
*'''Throwing and Archery''' — Throwing rocks with {{k|t}} will raise your Throwing and Archery skills. Throwing objects at creatures, while not terribly effective, can still be a quite handy skill. Although throwing is a way to raise Archery without wasting ammunition, there is a non-wasteful method that additionally increases bow/crossbow skills.<p>The most efficient way to level via throwing is to forgo using a macro and separate training into two phases: {{k|g}}etting and {{k|t}}hrowing. First, find a tile with an indefinite amount of throwable objects (e.g., snow, rocks, mud, etc.). Then, sequentially mash {{k|g}} and whatever key the rocks are assigned to until both your forearms explode. Rest. Then, sequentially mash {{k|t}}, followed by some consistent key assigned to your rocks, then {{k|Enter}}, until you've emptied your inventory. Rest. Rinse and repeat. (You may wish to empty your inventory beforehand such that the rocks are assigned to a key close to {{k|t}}, allowing you to keep one hand on {{k|Enter}} and another on {{k|t}}.)</p>
*'''Marksman, Bowman, and Archery''' — Raising the bow and crossbow weapon-specific skills is best done by shooting at a wall or cliff with no floor directly beneath it. If bolts or arrows hit a wall that has floor/ground on the same z-level, then the ammunition will be destroyed. ''However'', ammunition that falls at least one z-level after hitting a wall will remain intact. So, simply find something like a hill inside a castle, stand on it, then shoot at a wall which is on the same z-level you are. The arrows will hit the wall and fall one z-level to the ground, remaining intact. You can then {{k|g}}et the arrows and {{k|f}}ire them at the wall again from the hill, ad infinitum. You can also stand next to a wall that's two or more z-levels high, aiming at the wall one z-level up by hitting {{k|<}} after hitting {{k|f}}. Whatever method you employ, the key is that the arrow needs to fall at least one z-level after hitting a wall to remain intact. Using a macro will speed this up greatly.<p>An alternative and much easier way to train any ranged attack is to simply shoot one or more z-levels straight above into the air, by using {{k|f}} than {{k|<}} , any ammunition used seems incapable of causing harm to the one launching it and lands undamaged under their feet for easy retrieval, however this may be considered a bug and/or exploit.</p>
*'''Ambushing and Swimming''' — An efficient way to raise Ambushing is to sneak over large stretches of land. Ideally, this would be done in a biome containing sparse vegetation and few threatening creatures to blunder into and reduce FPS (e.g., a frozen beach). Sneaking on fast travel will not raise Ambushing.<p>Although less efficient for raising only Ambushing, it's also possible to sneak and swim at the same time, thus combining their training. '''Just make sure you start with at least Novice in swimming''', or you'll find swimming practically impossible to train. Swimming can very quickly improve your Strength, Agility, and Endurance. Additionally, if you can safely drown and then recover (e.g., by moving under a bridge and then back before suffocating), this will raise both Toughness and Endurance at a ''ridiculous'' pace— a single step spent drowning will raise both attributes by a fifth of a point apiece.</p>
*'''Observer''' — You can't really power-level this skill as it is slow and difficult to train, which is why you're advised to sink some points into it during character creation. However, one way to train it appears to be sleeping or walking around in the wilderness, allowing yourself to be repeatedly ambushed. This is, however, inherently dangerous. Running away from these encounters would probably be faster than slaying your assailants, if not generally safer for your character (but not for your companions, hoh boy).<p>Successfully detecting traps found in tombs and catacombs (performed automatically) will also raise Observer. However, without decent skill to begin with, you'll be torn to pieces by the many traps you'll fail to see. Otherwise, once you've found one or more traps, it's possible to grind experience by sleeping/waiting an hour, thus resetting the traps. Rinse and repeat.</p><p>As of version 0.40.23, one seems to acquire skill in Observer from regular combat, as it's used to tell what weapon an enemy is using to attack you.</p>
*'''Spatial and Kinesthetic Sense''' - While sharpening rocks with {{k|x}} will improve your Knapping skill, it more importantly increases your Spatial Sense and Kinesthetic Sense attributes, which affect a number of other skills. Knapping can be combined with throwing via a macro to keep your inventory from filling up.
*'''Other Stats''' - Other useful stats like Strength, Agility, and Toughness will increase significantly as the fighting and defense skills increase, so you don't need to do anything other than what you'd normally be doing to increase these.

=== I managed to escape but my limbs are chopped off. Now what? ===

'Tis but a scratch!

Unfortunately, there is only one way to get them back, and that is by becoming a [[werebeast]] and surviving until the next full moon. But as long as you have at least one leg and one arm left you can actually do pretty well. First, get a crutch from somewhere, such as a general store, and make sure it's in one of your hands. Once you do that you should be able to {{k|s}}tand back up again. (However, if spinal nervous tissue damage is what has disabled your ability to stand, crutches ''will not'' help you in that regard.) You will notice that your speed is now much slower than before.

Now go find someplace reasonably safe and walk back and forth until your Crutch Walking skill gets up to Legendary or above. You will notice your speed increasing as your skill levels up until your speed is completely back to normal. As a bonus you'll probably see some stat increases as well. You can continue to dodge with a crutch just as well as before.

You can wield a sword, shield, and crutch all in one hand, so even if you are missing an arm then you're all set. If you are missing both arms but still have both legs then unfortunately you'll be limited to biting, dodging, and wrestling with legs. If you're missing both arms and one leg then your movement will be limited and you'll be limited to biting and wrestling with your one remaining leg. And if all limbs are missing then you'll be limited to rolling around on the ground biting things.

Though you might actually be able to do surprisingly well as a Legendary Biter, especially if you powerlevel your strength to the point where you can shake things around by the teeth ripping limbs off, if you lose both legs then your character is going to be severely limited just due to the poor movement rate, so at that point it's probably best to opt for retirement or a glorious death in battle.

=== What creatures of night can I become? ===

You basically have four different choices.

Firstly, you can become a [[necromancer|'''necromancer''']].
* That gives you some traits of an undead. Namely, you don't need to eat, sleep or drink, don't tire or age, zombies or mummies don't attack you and your physical stats are permanently fixed.
* The last one means it's wise to train them beforehand.
* You also can raise dead from the {{K|x}} menu. Depending on the flavor of your spell, zombies can be slow, very slow or not slow at all. They will be listed as companions.
* Undead minions are extremely useful, but will cause problems if you intend to interact with civilization ever again. They are however an easy way to gain manpower for construction.
* To become a necromancer, find a necromancer tower and obtain a book or slab containing secrets of life and death from there, then read it. Note that most of the books are useless. In younger worlds necromancers may not have built their towers yet, in which case they'll be hanging at a zombie bandit camp, slab under the arm.

Secondly, you can become a [[vampire|'''vampire''']].
* That gives you most traits of an undead. In addition to the listed above, you don't feel pain, don't breathe and are immune to most syndromes.
* Your strength, agility and toughness are doubled.
* They're still fixed forever, so, again, be prepared.
* You gain blood vision, in which all creatures with blood not in your field of view will be represented with {{Tile|☼|4:0:1}}.
* Despite not needing to drink water, you have a hunger for warm blood. To satisfy it, beat someone or something unconscious and {{K|e}}at their blood.
* Anyone that witnesses you feeding on blood will turn hostile, unlike in older versions where companions would only care if you drained someone they cared about.
* To become a vampire, defeat one in combat and drink his blood.
* In version 0.42.01, it is now possible to be "cursed" by a god into becoming a vampire by desecrating statues/totems/altars dedicated to them. This can be done by pressing {{k|u}} while adjacent to interact with them, and toppling them. {{version|0.42.01}}

Thirdly, you can become a [[werebeast|'''werebeast''']].
* This gives you the (uncontrolled) ability to transform into a powerful half-man, half-beast on a full moon.
* There's a fixed list of animals on which the werebeast is based, including goat, llama, lizard, horse, monitor, buffalo, moose, tortoise, camel, kangaroo, ape, gecko, bear, hyena, warthog, iguana, skink, shrew, elk, skunk, pig, raccoon, panda, mole, badger, armadillo, mammoth and more.
* Most importantly, upon transformation (both ways) all your wounds, including missing limbs, are instantly healed.
* You don't show any abnormalcy outside of beast form. You are still mortal.
* When in beast form, everything is hostile to you, you don't need to drink, eat, sleep or breathe, don't feel pain, don't tire and are immune to some syndromes.
* One randomly chosen metal is ten times as deadly to you than usual. All other materials deal you half damage.
* Werebeast's size is several times their base animal size, but no less than 80000. This means all armor will be too small for you while in beast form. But you can still use a shield.
* Also, some werebeasts are truly gigantic — weremammoth has a size of 9000000, on par with demons.
* To become a werebeast, make one bite you. It has to be in the beast form.
* In version 0.42.01, it is now possible to be "cursed" by a god into becoming a werebeast by desecrating statues/totems/altars dedicated to them. This can be done by pressing {{k|u}} while adjacent to interact with them, and toppling them.{{version|0.42.01}}
* You cannot be a werebeast and a vampire at the same time.

And finally, you can become a mist [[zombie|'''zombie''']].
* This makes you undead. In addition to vampire traits, you can see without eyes and can't die via blood loss or beheading. Note that you don't have health point limit raised zombies have.
* You become permanently hostile to everyone except other undead.
* Your strength and toughness are tripled and fixed. Train beforehand.
* Depending on the flavor of zombie virus, your speed may or may not drop to 20% or 60% of its normal value.
* To become a mist zombie, find a mist/fog cloud that zombifies creatures and run into it.
* You cannot become a vampire or a werebeast if you are already a zombie. The other way, however, is fine.

==See also==
*[[Adventure mode quick reference]]
*[[Adventure mode quick start]]

==A glimpse into the Future==
{{D for dwarf}}

* Passage from "Shooting <s>for</s> the sky", the giant toad bone bound book by Nefil Blackbone the human necromancer :

{{Quote|align=left|
... While seemingly absurd, the practice of ones abilities with a ranged weapon can be furthered by directing said weapon towards the sky.
After all, during day time the sky has one giant target that might even seem so large that it's impossible to miss, and the night sky has many smaller ones.
It has been well documented that hitting the target may not be necessary to achieve improvement in ones skill with said arms, thus it is reasonable to expect every subsequent shot after the first will hit a tad closer to it's intended target, this has further lead me to believe in the possibility of sky exploration, for with this logic at some point the projectile will actually hit it's target and could subsequently be replaced with a test [[goblin|dummy]] to further resolve survival issues and empty ones [[invader|guest]] [[stockpile|accommodations]] in one go.
Finally with said preparations accomplished it would be possible to explore whatever is beyond that great blue/black border above.
However some skeptical dwarven scholars suggest this to be impossible and rather place their bets on the tried and tested dwarven [[bridge|launch system]], while notable human scholars propose using bigger [[catapult|armaments]] to accomplish the goal.
This is how the great space race between the Elves, Dwarves and Humans began, which would later on lead to massive intergalactic conflicts, space goblin invasions, immortal human emperors, elven space gates, interplanetary clown-storms all under the name of the humble dwarven hammer of war ...}}

{{Getting Started}}
{{Category|Adventurer mode}}
{{Category|Interface}}

Topic

2016-08-30T02:52:04Z

FortressBuilder: /* Engineering */ Fix link

{{Quality|Superior|06:10, 17 May 2015 (UTC)}}
{{av}}

{{new in v0.42}}
{{Expand Topic}}

[[File:Topics.svg|thumb|500px|A diagram of all knowledge topics.]]

'''Topics''' (also '''Tech''' or '''Innovations''') are part of [[knowledge]].

There are around 300 innovations that can be discovered. Many of them have requirements, and many do not, so it's kind of a tech forest/grassland rather than a tree. Notably missing are innovations related to practical labors in the game (which will be added later in development).

Several innovations require innovations from other branches, and since all knowledge is individually tracked, that implies some investigators will need to be at least well-read if not skilled in various topics (there aren't currently joint research projects). There are some old and new mechanisms in place to ensure this happens.

There are 9 "branches" of the knowledge system.
==Astronomy==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Dates of lunar and solar eclipses
|
|[[wikipedia:Saros (astronomy)|Saros (astronomy)]]
|-
|Daylight variation with solar year
|The variation of daylight with the season
|[[wikipedia:Daytime#Daytime variations with latitude and seasons|Daytime § Daytime variations with latitude and seasons]]
|-
|Geocentrism
|The theory that the sun moves around the world
|[[wikipedia:Geocentric model|Geocentric model]]
|-
|Height of tides vs moon and sun
|The height of the tides, the moon and the sun
|[[wikipedia:Pytheas#Pytheas_on_the_tides|Pytheas § Pytheas on the tides]] and [[wikipedia:Tide|Tide]]
|-
|Heliocentrism
|The theory that the world moves around the sun
|[[wikipedia:Heliocentric model|Heliocentric model]]
|-
|Empirical observation
|Methods of empirical observation in astronomy
|[[wikipedia:Empirical evidence|Empirical evidence]]
|-
|Path models
|
|[[wikipedia:Orbit modeling|Orbit modeling]]
|-
|Path of the moon
|The path of the moon
|[[wikipedia:Orbit of the Moon|Orbit of the Moon]]
|-
|Phases of the moon
|The phases of the moon
|[[wikipedia:Lunar phase|Lunar phase]]
|-
|Precession of equinoxes
|
|[[wikipedia:Axial precession|Axial precession]]
|-
|Relationship between lunar solar year
|The relationship between the lunar and solar year
|[[wikipedia:Lunisolar calendar|Lunisolar calendar]]
|-
|Shape of the world
|
|[[wikipedia:Spherical Earth|Spherical Earth]]
|-
|Star catalogues 100
|
|[[wikipedia:Star catalogue|Star catalogue]]
|-
|Star catalogues 1000
|
|[[wikipedia:Star catalogue|Star catalogue]]
|-
|Astrography
| The creation of star charts
|[[wikipedia:Star chart|Star chart]]
|-
|Stellar Spectroscopy
|The classification of stars based on the light they emit
|[[wikipedia:Astronomical spectroscopy|Astronomical spectroscopy]]
|-
|Star magnitude classification
|
|[[wikipedia:Magnitude (astronomy)|Magnitude (astronomy)]]
|-
|Summer winter moon
|The rise of the moon according to the season
|[[wikipedia:Lunar calendar|Lunar calendar]]
|-
|Summer winter sun
| The rise of the sun according to the season
|[[wikipedia:Solar calendar|Solar calendar]]
|-
|Tides and the moon
| The relationship between the moon and the tides
|[[wikipedia:Seleucus_of_Seleucia#Tides|Seleucus of Seleucia § Tides]] and [[wikipedia:Tide|Tide]]
|}

==Chemistry==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Adhesives
|The preparation and use of adhesive materials
|[[wikipedia:Adhesive|Adhesive]]
|-
|Aqua regia
|The preparation of aqua regia
|[[wikipedia:Aqua regia|Aqua regia]]
|-
|Spirit of niter
|The preparation of spirit of niter
|[[wikipedia:Nitric acid|Nitric acid]]
|-
|Oil of vitriol
|The preparation of oil of vitriol
|[[wikipedia:Sulfuric acid|Sulfuric acid]]
|-
|Alkali and acids
|The classification of alkali and acids
|[[wikipedia:pH|pH]]
|-
|Combustibles
|The classification of combustible materials
|[[wikipedia:Combustibility|Combustibility]]
|-
|Elemental theory
|The classification of materials based on which elemental materials might form them
|[[wikipedia:Chemical element|Chemical element]]
|-
|Ores
|The classification of ores
|[[wikipedia:Ore|Ore]]
|-
|Scratch test
|
|[[wikipedia:Scratch hardness|Scratch hardness]]
|-
|Alembic
|The construction and use of the alembic
|[[wikipedia:Alembic|Alembic]]
|-
|Blast furnace
|The construction and use of the blast furnace
|[[wikipedia:Blast furnace|Blast furnace]]
|-
|Crucible
| The construction and use of the crucible
|[[wikipedia:Crucible|Crucible]]
|-
|Ampoule
|The construction and use of the ampoule
|[[wikipedia:Ampoule|Ampoule]]
|-
|Beaker
| The construction and use of the beaker
|[[wikipedia:Beaker|Beaker]]
|-
|Flask
|
|[[wikipedia:Flask|Flask]]
|-
|Funnel
|The construction and use of the funnel
|[[wikipedia:Funnel|Funnel]]
|-
|Retort
|The construction and use of the retort
|[[wikipedia:Retort|Retort]]
|-
|Vial
|The construction and use of the vial
|[[wikipedia:Vial|Vial]]
|-
|Lab ovens
|The construction and use of laboratory ovens
|[[wikipedia:Laboratory oven|Laboratory oven]]
|-
|Systematic experiments
|Methods for performing experiments systematically in the laboratory
|[[wikipedia:Scientific method|Scientific method]]
|-
|Theory of distillation
|The theory and methods involved in distillation
|[[wikipedia:Distillation|Distillation]]
|-
|Theory of evaporation
|The theory and methods involved in evaporation
|[[wikipedia:Evapotation|Evapotation]]
|-
|Theory of liquid liquid extraction
|The theory and methods involved in the extraction of a constituent liquid from one solution to another
|[[wikipedia:Liquid–liquid extraction|Liquid–liquid extraction]]
|-
|Alloys
| The mixture of metals to produce alloys
|[[wikipedia:Alloy|Alloy]]
|}

==Engineering==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Armillary sphere
|The construction and use of armillary spheres
|[[wikipedia:Armillary sphere|Armillary sphere]]
|-
|Astrolabe
|The construction and use of the astrolabe
|[[wikipedia:Astrolabe|Astrolabe]]
|-
|Dioptra
|The construction and use of the dioptra
|[[wikipedia:Dioptra|Dioptra]]
|-
|Mural instrument
|
|[[wikipedia:Mural instrument|Mural instrument]]
|-
|Orrery
|
|[[wikipedia:Orrery|Orrery]]
|-
|Spherical astrolabe
|
|[[wikipedia:Armillary sphere|Armillary sphere]]
|-
|Wood lamination
|The use of lamination
|[[wikipedia:Lamination|Lamination]]
|-
|Models and templates
|The use of models and templates in engineering
|[[wikipedia:Prototype|Prototype]] and [[wikipedia:Stencil|Stencil]]
|-
|Archimedes principle
|
|[[wikipedia:Archimedes' principle|Archimedes' principle]]
|-
|Force pump
|
|[[wikipedia:Piston pump#Force pump|Piston pump § Force pump]]
|-
|Theory of siphon
|The action of the siphon
|[[wikipedia:Siphon|Siphon]]
|-
|Valves
|The construction and use of valves
|[[wikipedia:Valve|Valve]]
|-
|Astrarium
|
|[[wikipedia:Astrarium|Astrarium]]
|-
|Conical water clock
|
|
|-
|Hourglass
|
|[[wikipedia:Hourglass|Hourglass]]
|-
|Mechanical clock
|
|[[wikipedia:Clock#Early mechanical clocks|Clock § Early mechanical clocks]]
|-
|Shadow clock
|The use of shadows to tell direction and time
|[[wikipedia:Sundial|Sundial]]
|-
|Water clock
|The use of water-based devices to tell time
|[[wikipedia:Water clock|Water clock]]
|-
|Water clock reservoir
|The use of reservoirs in water-based clocks to improve their accuracy
|[[wikipedia:Zhang_Heng#Extra_tank_for_inflow_clepsydra|Zhang Heng § Extra tank for inflow clepsydra]]
|-
|Balance wheel
|
|[[wikipedia:Balance wheel|Balance wheel]]
|-
|Bellows
|The construction and use of the bellows
|[[wikipedia:Bellows|Bellows]]
|-
|Camshaft
|
|[[wikipedia:Camshaft|Camshaft]]
|-
|Chain drive
|The construction and use of chain drives
|[[wikipedia:Chain drive|Chain drive]]
|-
|Chariot odometer
|
|[[wikipedia:Odometer|Odometer]]
|-
|Combination lock
|
|[[wikipedia:Combination lock|Combination lock]]
|-
|Crank
|
|[[wikipedia:Crank (mechanism)|Crank (mechanism)]]
|-
|Crankshaft
|
|[[wikipedia:Crankshaft|Crankshaft]]
|-
|Differential gear
|
|[[wikipedia:Differential (mechanical device)|Differential (mechanical device)]]
|-
|Double acting piston bellows
|
|[[wikipedia:Bellows|Bellows]]
|-
|Lever
|The construction and use of the lever
|[[wikipedia:Lever|Lever]]
|-
|Mechanical compass
|
|[[wikipedia:Compass|Compass]]
|-
|Padlock
|The construction and use of the padlock
|[[wikipedia:Padlock|Padlock]]
|-
|Piston
|
|[[wikipedia:Piston pump#Force pump|Piston pump § Force pump]]
|-
|Pulley
|The construction and use of the pulley
|[[wikipedia:Pulley|Pulley]]
|-
|Screw
|The construction and use of the screw
|[[wikipedia:Screw|Screw]]
|-
|Straight beam balance
|The construction and use of the straight-beam balance
|[[wikipedia:Weighing scale#Mechanical balances|Weighing scale § Mechanical balances]]
|-
|Theory of gears
|The reasons why gears are effective
|[[wikipedia:Gear|Gear]]
|-
|Theory of lever
|The reasons why the lever is effective
|[[wikipedia:Lever|Lever]]
|-
|Theory of pulley
|The reasons why pulleys are effective
|[[wikipedia:Pulley|Pulley]]
|-
|Theory of screw
|The reasons why screws are effective
|[[wikipedia:Screw|Screw]]
|-
|Theory of wedge
|The reasons why the wedge is effective
|[[wikipedia:Wedge (mechanical device)|Wedge]]
|-
|Theory of wheel and axle
|The reasons why the wheel-and-axle construction is effective
|[[wikipedia:Wheel and axle|Wheel and axle]]
|-
|Trip hammer
|
|[[wikipedia:Trip hammer|Trip hammer]]
|-
|Tumbler lock
|The construction and use of the tumbler lock
|[[wikipedia:Pin tumbler lock|Pin tumbler lock]]
|-
|Verge escapement
|The construction and use of the verge escapement
|[[wikipedia:Verge escapement|Verge escapement]]
|-
|Warded lock
|The construction and use of the warded lock
|[[wikipedia:Warded lock|Warded lock]]
|-
|Water powered piston bellows
|
|[[wikipedia:Du_Shi#The_Water-Powered_Blast_Furnace|Du Shi § The Water-Powered Blast Furnace]]
|-
|Water powered sawmill
|
|[[wikipedia:Watermill|Watermill]]
|-
|Water powered trip hammer
|
|[[wikipedia:Trip hammer|Trip hammer]] and [[wikipedia:Water wheel|Water wheel]]
|-
|Water wheel
|
|[[wikipedia:Water wheel|Water wheel]]
|-
|Windlass
| The construction and use of the windlass
|[[wikipedia:Windlass|Windlass]]
|-
|Atmospheric refraction
|
|[[wikipedia:Atmospheric refraction|Atmospheric refraction]]
|-
|Camera obscura
|The construction and use of the camera obscura
|[[wikipedia:Camera obscura|Camera obscura]]
|-
|Cause of twilight
|
|[[wikipedia:Atmospheric optics|Atmospheric optics]]
|-
|Crystal lens
|The construction and use of the crystal lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:Crystal|Crystal]]
|-
|Glass lens
|The construction and use of the glass lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:Glass|Glass]]
|-
|Height of atmosphere
|
|
|-
|Law of refraction
|
|[[wikipedia:Snell's law|Snell's law]]
|-
|Parabolic mirror
|
|[[wikipedia:Parabolic reflector|Parabolic reflector]]
|-
|Theory of color
|
|[[wikipedia:Color theory|Color theory]]
|-
|Theory of rainbows
|
|[[wikipedia:Rainbows|Rainbows]]
|-
|Water filled spheres
|The construction and use of water-filled sphere as a lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:History_of_optics#Early_history_of_optics|History of optics § Early history of optics]]
|}

==Geography==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Accurate maps
|
|[[wikipedia:Map|Map]]
|-
|Cartography
|The process involved in creating maps
|[[wikipedia:Cartography|Cartography]]
|-
|Distance scale
|
|[[wikipedia:Scale (map)|Scale (map)]]
|-
|Economic
|The placement of economic information on maps
|[[wikipedia:Economic geography|Economic geography]]
|-
|Geological
|The placement of geological information on maps
|[[wikipedia:Geologic map|Geologic map]]
|-
|Grid system
|
|[[wikipedia:Grid reference|Grid reference]]
|-
|Height measurements
|
|[[wikipedia:Topographic map|Topographic map]] and [[wikipedia:Levelling|Levelling]]
|-
|Map projections
|
|[[wikipedia:Map projection|Map projection]]
|-
|Atlases
|The collection of maps and other information together into a single text
|[[wikipedia:Atlas|Atlas]]
|-
|Econometrics
|The process of economic data collection
|[[wikipedia:Econometrics|Econometrics]]
|-
|Surveying
|The process of surveying land
|[[wikipedia:Surveying|Surveying]]
|-
|Cartographical surveying
|
|[[wikipedia:Cartography|Cartography]] and [[wikipedia:Surveying|Surveying]]
|-
|Engineering surveying
|
|[[wikipedia:Construction surveying|Construction surveying]]
|-
|Land surveying
|
|[[wikipedia:Cadastral surveying|Cadastral surveying]]
|-
|Military surveying
|
|[[wikipedia:Construction surveying|Construction surveying]] and [[wikipedia:Military engineerin|Military engineering]]
|-
|Surveying staff
|The construction and use of the surveying staff
|[[wikipedia:Level staff|Level staff]]
|-
|Triangulation
|
|[[wikipedia:Triangulation|Triangulation]]
|-
|Delta formation
|The process of the formation of deltas at the mouths of rivers
|[[wikipedia:River delta#Formation|River delta § Formation]]
|-
|Latitude climate zones
|
|[[wikipedia:Clime|Clime]]
|-
|Origin of rainfall from evap condense
|The origin of rainfall through evaporation and condensation
|[[wikipedia:Evaporation|Evaporation]] and [[wikipedia:Condensation|Condensation]]
|-
|Water cycle
|A world-wide cycle involving precipitation, oceans, rivers, and other forms of water
|[[wikipedia:Water cycle|Water cycle]]
|-
|Anemology
|The forces that govern wind patterns
|[[wikipedia:Global wind patterns|Global wind patterns]]
|}

==History==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Alternate history
|The exploration of how history would be different if some key past events had transpired differently
|[[wikipedia:Alternate history|Alternate history]]
|-
|Autobiographical adventure
|The method of writing a biography of oneself, particularly as it concerns a military campaign or adventure
|[[wikipedia:Autobiography|Autobiography]]
|-
|Biographical dictionaries
|The compilation of brief biographies into one large collection
|[[wikipedia:Biographical dictionary|Biographical dictionary]]
|-
|Biography
|The method of writing the history of a single individual
|[[wikipedia:Biography|Biography]]
|-
|Comparative biography
|The method of compiling several biographies to compare and contrast the subjects' character and to gain insight into history
|
|-
|Comparative anthropology
|The method of comparing and contrasting different cultures
|[[wikipedia:Cross-cultural studies|Cross-cultural studies]]
|-
|Cultural history
|The method of accurately and comprehensively describing cultures and civilizations
|[[wikipedia:Cultural history|Cultural history]]
|-
|Encyclopedia
|
|[[wikipedia:Encyclopedia|Encyclopedia]]
|-
|Genealogy
|The compilation of family lineages and methods of displaying them artfully
|[[wikipedia:Genealogy|Genealogy]]
|-
|Treatise on tech evolution
|
|[[wikipedia:Technological evolution|Technological evolution]]
|-
|Archaeology
|The method of collecting and evaluating artifacts to learn about history and culture
|[[wikipedia:Archaeology|Archaeology]]
|-
|Source reliability
|The reliability of sources
|[[wikipedia:Source criticism|Source criticism]]
|-
|Personal interviews
|Using personal interviews as sources
|[[wikipedia:Interview|Interview]]
|-
|Role of cultural differences
| The role of cultural differences in source reliability and interpretation
|[[wikipedia:Cultural relativism|Cultural relativism]]
|-
|Role of state bias and propaganda
|
|[[wikipedia:Propaganda|Propaganda]]
|-
|Role of systemic bias
|
|[[wikipedia:Systemic bias|Systemic bias]]
|-
|Historical causation
|The causes of historical events
|[[wikipedia:Causality#History|Causality § History]]
|-
|Historical cycles
|The notion of historical, governmental and social cycles
|[[wikipedia:Cyclic history|Cyclic history]]
|-
|Sociology
|The notion of bonds between members of a community
|[[wikipedia:Sociology|Sociology]]
|-
|Social conflict
|
|[[wikipedia:Social conflict|Social conflict]]
|}

==Mathematics==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Equations
|The technique of balancing and completion for solving equations
|[[wikipedia:The Compendious Book on Calculation by Completion and Balancing|The Compendious Book on Calculation by Completion and Balancing]], [[wikipedia:Algebra|Algebra]], and [[wikipedia:Equation|Equation]]
|-
|Divergence of harmonic series
|The divergence of the harmonic series
|[[wikipedia:Harmonic series (mathematics)|Harmonic series (mathematics)]]
|-
|Large sums
|Simple formulas for certain arbitrarily large sums
|[[wikipedia:Summation|Summation]]
|-
|Pascal's triangle
|A triangular configuration of numbers relating to the successive powers of any sum
|[[wikipedia:Pascal's triangle|Pascal's triangle]]
|-
|Quadratic by completing square
|The solving of quadratic equations by completion of the square
|[[wikipedia:Completing the square|Completing the square]]
|-
|Quadratic formula
|A formula which solves quadratic equations
|[[wikipedia:Quadratic formula|Quadratic formula]]
|-
|Solving higher order polynomials
|Methods for solving certain equations involving powers higher than the quadratic
|[[wikipedia:Galois theory|Galois theory]] 
|-
|Systems of equations
|Methods of solving systems of equations
|[[wikipedia:Linear system|Linear system]]
|-
|Sum-difference trig identities
|Trigonometric identities relating to the sums and differences of angles
|[[wikipedia:List of trigonometric identities#Angle sum and difference identities|List of trigonometric identities § Angle sum and difference identities]]
|-
|Area enclosed by line and parabola
|The area enclosed by a parabola and a line
|[[wikipedia:The Quadrature of the Parabola|The Quadrature of the Parabola]]
|-
|Area of circle
|
|[[wikipedia:Area of a disk|Area of a disk]]
|-
|Area of triangle from side lengths
|
|[[wikipedia:Heron's formula|Heron's formula]]
|-
|Basic geometry
|Geometric objects: points, lines, circles, triangles, and so on
|[[wikipedia:Geometry|Geometry]]
|-
|Conic sections
|The categorization and properties of conic sections
|[[wikipedia:Conic section|Conic section]]
|-
|Irrational numbers
|The existence of incommensurable ratios
|[[wikipedia:Irrational number|Irrational number]]
|-
|Geometric mean
|The relationship between the length of the altitude of a right triangle and the lengths of the segments into which it divides the hypotenuse
|[[wikipedia:Geometric mean theorem|Geometric mean theorem]]
|-
|Inscribed triangle on diameter is right
|The angles of triangles inscribed in a circle with one edge on the diameter
|[[wikipedia:Thales' theorem|Thales' theorem]]
|-
|Isosceles base angles equal
|The equality of the base angle of isosceles triangles
|[[wikipedia:Pons asinorum|Pons asinorum]]
|-
|Law of sines
|
|[[wikipedia:Law of sines|Law of sines]]
|-
|Existence of pi
|The relationship between the area of a circle and its radius, involving the ratio of the circumference of the circle to its diameter
|[[wikipedia:Pi|Pi]]
|-
|Pi to 6 digits
|
|[[wikipedia:Zu Chongzhi#Mathematics|Zu Chongzhi § Mathematics]] and [[wikipedia:Milü|Milü]]
|-
|Chords
|The properties of chords
|[[wikipedia:Chord (geometry)|Chord (geometry)]]
|-
|Pythagorean theorem
|The relationship between the lengths of the hypotenuse of a right triangle and the other two sides
|[[wikipedia:Pythagorean theorem|Pythagorean theorem]]
|-
|Pythagorean triples 3 digit
|Examples of triples of large whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Pythagorean triples 4 digit
|Examples of triples of very large whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Pythagorean triples small
|Examples of triples of small whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Similar and congruent triangles
|The properties of similar and congruent triangles
|[[wikipedia:Similarity (geometry)|Similarity (geometry)]] and [[wikipedia:Congruence (geometry)|Congruence (geometry)]]
|-
|Surface area of sphere
|The computation of the surface area of a sphere
|[[wikipedia:Sphere#Surface area|Sphere § Surface area]]
|-
|Chord tables
|A table of chord lengths indexed by angle
|[[wikipedia:Ptolemy's table of chords|Ptolemy's table of chords]]
|-
|Volume of cone
|The computation of the volume of a cone
|[[wikipedia:Cone#Volume|Cone § Volume]]
|-
|Volume of pyramid
|The computation of the volume of different pyramids
|[[wikipedia:Pyramid (geometry)#Volume|Pyramid (geometry) § Volume]]
|-
|Volume of sphere
|The computation of the volume of a sphere
|[[wikipedia:Sphere#Volume|Sphere § Volume]]
|-
|Axioms
|Axiomatic reasoning
|[[wikipedia:Axiomatic system|Axiomatic system]]
|-
|Method of exhaustion
|An approximation of the ratio of a circumference of a circle to its diameter, using the area of polygons and the method of exhaustion
|[[wikipedia:Method of exhaustion|Method of exhaustion]]
|-
|Proof by contradiction
|The method of proof by contradiction
|[[wikipedia:Proof by contradiction|Proof by contradiction]]
|-
|Symbol for addition
|The idea of using symbolic notation for addition
|[[wikipedia:Plus and minus signs#Plus sign|Plus and minus signs § Plus sign]]
|-
|Scientific notation
|Notation for very large numbers
|[[wikipedia:Scientific notation|Scientific notation]]
|-
|Negative numbers
|Notation for negative quantities
|[[wikipedia:Negative number|Negative number]]
|-
|Place values
|Positional notation
|[[wikipedia:Positional notation|Positional notation]]
|-
|Algebra
|Notation for abbreviating the unknown and other elements of an equation in a systematic and useful fashion
|[[wikipedia:Algebra|Algebra]]
|-
|Zero
|A symbol for nothingness
|[[wikipedia:0 (number)|0 (number)]]
|-
|Euclidean Algorithm
| An algorithm for computing the greatest common divisor of two numbers
|[[wikipedia:Euclidean algorithm|Euclidean algorithm]]
|-
|Chinese remainder algorithm
|An algorithm for computing a number which has given remainders when divided by several given primes
|[[wikipedia:Chinese remainder theorem|Chinese remainder theorem]]
|-
|Division
|An algorithm for dividing one number into another, possibly yielding a remainder
|[[wikipedia:Euclidean division|Euclidean division]]
|-
|Euclid's Theorem
|A proof that there are infinitely many prime numbers
|[[wikipedia:Euclid's theorem|Euclid's theorem]]
|-
|Irrationality of root 2
|A proof that the length of a diagonal of a square is incommensurable with its edge
|[[wikipedia:Square root of 2#Proofs of irrationality|Square root of 2 § Proofs of irrationality]]
|-
|Approximation of root 2
|An approximation for the length of the diagonal of a square
|[[wikipedia:Square root of 2#History|Square root of 2 § History]]
|-
|Sieve algorithm for primes
|
|[[wikipedia:Sieve of Eratosthenes|Sieve of Eratosthenes]]
|-
|Unique prime factorization
|The unique decomposition of a number into products of its prime divisors
|[[wikipedia:Fundamental theorem of arithmetic|Fundamental theorem of arithmetic]]
|}

==Medicine==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Anesthesia
|Anesthesia
|[[wikipedia:Anesthesia|Anesthesia]]
|-
|Asylum for mentally ill
|
|[[wikipedia:Psychiatric hospital|Psychiatric hospital]]
|-
|Autopsy
|
|[[wikipedia:Autopsy|Autopsy]]
|-
|Cataract surgery
|
|[[wikipedia:Cataract surgery|Cataract surgery]]
|-
|Cauterization
|Cauterization
|[[wikipedia:Cauterization|Cauterization]]
|-
|Fracture immobilization
|
|[[wikipedia:Bone fracture#Immobilization|Bone fracture § Immobilization]]
|-
|Fracture treatment
|The treatment of fractures
|[[wikipedia:Bone fracture#Treatment|Bone fracture § Treatment]]
|-
|Hernia surgery
|Hernia surgery
|[[wikipedia:Hernia#Surgery|Hernia § Surgery]]
|-
|Hospital lab
|
|[[wikipedia:Medical laboratory|Medical laboratory]]
|-
|Lithotomy surgery
|The lithotomy surgery
|[[wikipedia:Lithotomy|Lithotomy]]
|-
|Medical school
|
|[[wikipedia:Medical school|Medical school]]
|-
|Physical examination
|The method of physical examination in diagnosing illness
|[[wikipedia:Physical examination|Physical examination]]
|-
|Professional hospital staff
|
|[[wikipedia:Surgeon|Surgeon]] and [[wikipedia:Physician|Physician]]
|-
|Specialized wards
|
|[[wikipedia:Hospital#Departments or wards|Hospital § Departments or wards]]
|-
|Draining
| The surgical method of draining
|[[wikipedia:Drain (surgery)|Drain (surgery)]]
|-
|Excision
|The surgical method of excision
|
|-
|Incision
|The surgical method of incision
|[[wikipedia:Surgical incision|Surgical incision]]
|-
|Ligature
|The surgical method of ligature
|[[wikipedia:Ligature (medicine)|Ligature (medicine)]]
|-
|Probing
|The surgical method of probing
|
|-
|Scraping
|The surgical method of scraping
|
|-
|Suturing
|The surgical method of suturing
|[[wikipedia:Surgical suture|Surgical suture]]
|-
|Tracheotomy surgery
|The tracheotomy surgery
|[[wikipedia:Tracheotomy|Tracheotomy]]
|-
|Traumatic injuries
|The treatment of traumatic injuries
|[[wikipedia:Major trauma|Major trauma]]
|-
|Acute and chronic conditions
|The distinction between acute and chronic conditions
|[[wikipedia:Acute (medicine)|Acute (medicine)]] and [[wikipedia:Chronic condition|Chronic condition]]
|-
|Anatomical studies
|Anatomical studies for medical edification
|[[wikipedia:Human body|Human body]]
|-
|Blood vessels
|
|[[wikipedia:Blood vessel|Blood vessel]]
|-
|Classification of bodily fluids
|The classification of bodily fluids
|[[wikipedia:Body fluid|Body fluid]]
|-
|Classification of mental illnesses
|
|[[wikipedia:Mental disorder|Mental disorder]]
|-
|Classification of muscles
|
|[[wikipedia:Muscle|Muscle]]
|-
|Comparative anatomy
|
|
|-
|Convalescence
|
|[[wikipedia:Convalescence|Convalescence]]
|-
|Disease and fouled water
|The connection between disease and fouled water
|[[wikipedia:Waterborne diseases|Waterborne diseases]]
|-
|Pathology
|The classification of disease
|[[wikipedia:Nosology|Nosology]]
|-
|Endemic disease
|
|[[wikipedia:Endemic (epidemiology)|Endemic (epidemiology)]]
|-
|Epidemic disease
| The theory of epidemic disease
|[[wikipedia:Epidemic|Epidemic]]
|-
|Exacerbation
|The notion of the exacerbation of a patient's condition
|[[wikipedia:Exacerbation|Exacerbation]]
|-
|Eye anatomy
|The anatomy of the eye
|[[wikipedia:Human eye|Human eye]]
|-
|Fracture classification
|The classification of fractures
|[[wikipedia:Bone fracture#Classification|Bone fracture § Classification]]
|-
|Motor vs sensory nerves
|
|[[wikipedia:Motor nerve|Motor nerve]] and [[wikipedia:Sensory nerve|Sensory nerve]]
|-
|Nervous system function
|
|[[wikipedia:Nervous system|Nervous system]]
|-
|Paroxysm
|The notion of paroxysm
|[[wikipedia:Paroxysmal attack|Paroxysmal attack]]
|-
|Prognosis
|Determining the likely outcome given a patient's current status
|[[wikipedia:Prognosis|Prognosis]]
|-
|Pulmonary circulation
|
|[[wikipedia:Pulmonary circulation|Pulmonary circulation]]
|-
|Pulmonary medicine
| Pulmonary medicine
|[[wikipedia:Pulmonology|Pulmonology]]
|-
|Reaction time
|
|[[wikipedia:Mental chronometry|Mental chronometry]]
|-
|Relapse
|
|[[wikipedia:Relapse|Relapse]]
|-
|Specialized surgical instruments
|The use of specialized surgical instruments
|[[wikipedia:Surgical instrument|Surgical instrument]]
|-
|Surgical models
|The use of practice models in surgery
|
|-
|The voice
|The source of the voice
|[[wikipedia:Phonation|Phonation]]
|-
|Toxicology
|The classification of toxic substances
|[[wikipedia:Toxicology|Toxicology]]
|-
|Treatment of mental illnesses
|
|[[wikipedia:Treatment of mental disorders|Treatment of mental disorders]]
|-
|Animal remedies
|Remedies prepared from animals
|[[wikipedia:Traditional Chinese medicine#Animal substances|Traditional Chinese medicine § Animal substances]]
|-
|Animals as surgical models
|The use of animals as surgical models
|
|-
|Bandages
|The method of bandaging wounds
|[[wikipedia:Bandage|Bandage]]
|-
|Dedicated hospitals
|
|[[wikipedia:Hospital|Hospital]]
|-
|Forceps
|
|[[wikipedia:Forceps|Forceps]]
|-
|Herbal remedies
|Herbal remedies
|[[wikipedia:Herbalism|Herbalism]]
|-
|Mineral remedies
|Mineral remedies
|[[wikipedia:List of traditional Chinese medicines#Minerals|List of traditional Chinese medicines § Minerals]]
|-
|Mud bags as surgical models
|The use of mud bags as surgical models
|
|-
|Orthopedic cast
|
|[[wikipedia:Orthopedic cast|Orthopedic cast]]
|-
|Plants as surgical models
|
|
|-
|Scalpel
|
|[[wikipedia:Scalpel|Scalpel]]
|-
|Needles
| The construction and use of surgical needles
|[[wikipedia:Surgical suture#Needles|Surgical suture § Needles]]
|-
|Surgical scissors
|
|[[wikipedia:Surgical scissors|Surgical scissors]]
|-
|Traction bench
|
|[[wikipedia:Traction (orthopedics)|Traction (orthopedics)]]
|}

==Naturalist==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Dissection
|The dissection of creatures
|[[wikipedia:Dissection|Dissection]]
|-
|Anatomy
|The anatomical study of creatures
|[[wikipedia:Anatomy|Anatomy]]
|-
|Veterinary medicine
|The diseases of creatures
|[[wikipedia:Veterinary medicine|Veterinary medicine]]
|-
|Embryology
|The embriological development of creatures
|[[wikipedia:Embryology|Embryology]]
|-
|Foraging behavior
|The foraging behavior and diet of creatures
|[[wikipedia:Foraging|Foraging]]
|-
|Migration
|The migratory patterns of creatures
|[[wikipedia:Animal migration|Animal migration]]
|-
|Reproductive behavior
|The reproductive behavior of creatures
|[[wikipedia:Reproduction|Reproduction]]
|-
|Social behavior
|The social behavior of creatures
|[[wikipedia:Social behavior|Social behavior]]
|-
|Physical taxonomy
|The classification of creatures by their physical features
|[[wikipedia:Taxonomy (biology)|Taxonomy (biology)]]
|-
|Climactic adaptation
|The way that creatures are suited to the climates in which they live
|[[wikipedia:Climatic adaptation|Climatic adaptation]]
|-
|Comparative anatomy
|
|[[wikipedia:Comparative anatomy|Comparative anatomy]]
|-
|Food chain
|
|[[wikipedia:Food chain|Food chain]]
|-
|Struggle for existence
|The struggle for survival among creatures
|[[wikipedia:Struggle for existence|Struggle for existence]]
|}

==Philosophy==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Nature of beauty
|Discourse on the nature of beauty
|[[wikipedia:Beauty (ancient thought)|Beauty (ancient thought)]]
|-
|Value of art
|
|[[wikipedia:Aesthetics|Aesthetics]]
|-
|Belief
|Discourse on the nature of belief
|[[wikipedia:Epistemology#Belief|Epistemology § Belief]]
|-
|Justification
|Discourse on the nature of justification
|[[wikipedia:Epistemology#Justification|Epistemology § Justification]]
|-
|Perception
|Discourse on the nature of perception
|[[wikipedia:Philosophy of perception|Philosophy of perception]]
|-
|Truth
|
|[[wikipedia:Epistemology#Truth|Epistemology § Truth]]
|-
|Individual value
|Discourse on the meaning of individual happiness
|[[wikipedia:Value (ethics)#Personal values|Value (ethics) § Personal values]]
|-
|State consequentialism
|Discourse on ethics as it regards the benefit of the state
|[[wikipedia:State consequentialism|State consequentialism]]
|-
|Interpersonal Ethics
|Discourse on ethics as applied to interpersonal conduct
|
|-
|Medical
|Discourse on medical ethics
|[[wikipedia:Medical ethics|Medical ethics]]
|-
|Military
|Discourse on ethics as applied to war
|[[wikipedia:Ethics#Military ethics|Ethics § Military ethics]]
|-
|Analogical inference
|
|[[wikipedia:Argument from analogy|Argument from analogy]]
|-
|Deductive reasoning
|Deductive reasoning
|[[wikipedia:Deductive reasoning|Deductive reasoning]]
|-
|Dialectic reasoning
|
|[[wikipedia:Dialectic|Dialectic]]
|-
|Direct inference
|
|[[wikipedia:Statistical syllogism|Statistical syllogism]]
|-
|Formal reasoning
|Formal reasoning
|[[wikipedia:Reason|Reason]]
|-
|Hypothetical syllogisms
|Hypothetical syllogisms
|[[wikipedia:Hypothetical syllogism|Hypothetical syllogism]]
|-
|Inductive reasoning
|
|[[wikipedia:Inductive reasoning|Inductive reasoning]]
|-
|Propositional logic
|
|[[wikipedia:Propositional calculus|Propositional calculus]]
|-
|Syllogistic logic
|Syllogistic logic
|[[wikipedia:Syllogism|Syllogism]]
|-
|Causation
|The nature of causation
|[[wikipedia:Causality|Causality]]
|-
|Events
|Discourse on the nature of events
|[[wikipedia:Event (philosophy)|Event (philosophy)]]
|-
|Existence
|
|[[wikipedia:Existence|Existence]]
|-
|Mind body
|Discourse on the nature of mind and body
|[[wikipedia:Mind–body problem|Mind–body problem]]
|-
|Objects and properties
|
|[[wikipedia:Essence|Essence]]
|-
|Processes
|
|[[wikipedia:Process philosophy|Process philosophy]]
|-
|Time
|Discourse on the nature of time
|[[wikipedia:Time|Time]]
|-
|Wholes and parts
|The relationship between wholes and parts
|[[wikipedia:Mereology|Mereology]]
|-
|Education
|Education, its forms and recommendations
|[[wikipedia:Education|Education]]
|-
|Dictionary
|Dictionaries
|[[wikipedia:Dictionary|Dictionary]]
|-
|Etymology
|The notion of etymology
|[[wikipedia:Etymology|Etymology]]
|-
|Grammar
|Grammar
|[[wikipedia:Grammar|Grammar]]
|-
|Law
|Discourse on law
|[[wikipedia:Law|Law]]
|-
|Diplomacy
|Discourse on diplomacy
|[[wikipedia:Diplomacy|Diplomacy]]
|-
|Economic policy
|Discourse on economic policy
|[[wikipedia:Economic policy|Economic policy]]
|-
|Government forms
|Discourse on government
|[[wikipedia:Government|Government]]
|-
|Social welfare
|Discourse on social welfare
|[[wikipedia:Welfare|Welfare]]
|-
|Value agendas
|the philosopher will choose a [[Belief]] that they have and write about that: Format "Worthlessness/nuances/value of (belief)" Reading books that push these will result in a dwarves' (or adventurer's) values changing. [[http://www.bay12forums.com/smf/index.php?topic=154197.0|Citation]] [[http://www.bay12games.com/dwarves/|2 (Devlog on 7/25/2015]]
|[[wikipedia:Propaganda|Propaganda]]
|}
{{Category|World}}

Announcements.txt

2016-05-14T09:30:22Z

FortressBuilder: fix version

{{Quality|Fine|03:01, 6 November 2013 (UTC)}}
{{av}}
{{old|Missing several announcements added in 0.40.xx}}
{{File|DF/data/init/announcements.txt}}
The '''announcements.txt''' file can be used to control the types of announcements displayed in Dwarf Fortress and how they are displayed in various modes. This can often be useful to stop recentering on birth announcements, for example.

== Syntax ==
['''ANNOUNCEMENT NAME''''':option:option''...]
=== Available options ===
{| class="wikitable"
|-
! Option
! Description
! Notes
|-
| {{text anchor|D_D}} or {{text anchor|D_DISPLAY}}
| Causes the announcement to be displayed at the bottom of the screen in [[Fortress mode]] (and be viewable in the {{k|a}}nnouncements list).
| The default for [[Announcement#Minor announcements|minor announcements]] including profession changes, [[weather]], job cancellations, and striking new minerals while [[mining]].
|-
| {{text anchor|A_D}} or {{text anchor|A_DISPLAY}}
| Causes the announcement to be displayed at the bottom of the screen in [[Adventure mode]] (and be viewable in the {{k|a}}nnouncements list).
|
|-
| {{text anchor|P}} or {{text anchor|PAUSE}}
| Pauses the game when the announcement occurs.
|
|-
| {{text anchor|R}} or {{text anchor|RECENTER}}
| Recenters the game to the location of the announcement when the announcement occurs.
| Commonly used for [[baby|births]], [[caravan]] arrivals, and [[ambush]]es. Use of this without the [[#PAUSE|pause]] option is not recommended, since your screen will recenter without warning.
|-
| {{text anchor|BOX}} or {{text anchor|DO_MEGA}}
| Causes a box to appear in the middle of the screen, requiring {{k|Enter}} to close it.
| This is often used with [[Announcement#Game-changing announcements|game-changing announcements]].
|-
| {{text anchor|UCR}} or {{text anchor|UNIT_COMBAT_REPORT}}
| Causes the announcement to appear in all [[reports]]. A new report will be created if none are active.
| Commonly used for adventure mode combat moves.
|-
| {{text anchor|UCR_A}} or {{text anchor|UNIT_COMBAT_REPORT_ALL_ACTIVE}}
| Nearly identical to [[#UCR|UNIT_COMBAT_REPORT]], but does not create a new report if none are active.
|
|-
| {{text anchor|NONE}}
| Specified announcements won't be displayed.
| Useful when you want to get rid of unwanted messages.
|}

== List of announcements ==
{| class="wikitable sortable"
|-
! Announcement
! Description/Notes
|-
| {{text anchor|REACHED_PEAK}}
| rowspan=2 | See [[calendar]]
|-
| {{text anchor|ERA_CHANGE}}
|-
| {{text anchor|ENDGAME_EVENT_1}}
| rowspan=2 | Discovery of the [[HFS]]
|-
| {{text anchor|ENDGAME_EVENT_2}}
|-
| {{text anchor|FEATURE_DISCOVERY}}
| Discovery of [[cavern]]s and their various features
|-
| {{text anchor|STRUCK_DEEP_METAL}}
| Striking [[adamantine]]
|-
| {{text anchor|STRUCK_MINERAL}}
| rowspan=2 | Striking a mineral while [[mining]]
|-
| {{text anchor|STRUCK_ECONOMIC_MINERAL}}
|-
| {{text anchor|COMBAT_TWIST_WEAPON}}
| rowspan=43 | Used in [[combat]], most often in [[adventure mode]] (also in the [[arena]])
|-
| {{text anchor|COMBAT_LET_ITEM_DROP}}
|-
| {{text anchor|COMBAT_START_CHARGE}}
|-
| {{text anchor|COMBAT_SURPRISE_CHARGE}}
|-
| {{text anchor|COMBAT_JUMP_DODGE_PROJ}}
|-
| {{text anchor|COMBAT_JUMP_DODGE_STRIKE}}
|-
| {{text anchor|COMBAT_DODGE}}
|-
| {{text anchor|COMBAT_COUNTERSTRIKE}}
|-
| {{text anchor|COMBAT_BLOCK}}
|-
| {{text anchor|COMBAT_PARRY}}
|-
| {{text anchor|COMBAT_CHARGE_COLLISION}}
|-
| {{text anchor|COMBAT_CHARGE_DEFENDER_TUMBLES}}
|-
| {{text anchor|COMBAT_CHARGE_DEFENDER_KNOCKED_OVER}}
|-
| {{text anchor|COMBAT_CHARGE_ATTACKER_TUMBLES}}
|-
| {{text anchor|COMBAT_CHARGE_ATTACKER_BOUNCE_BACK}}
|-
| {{text anchor|COMBAT_CHARGE_TANGLE_TOGETHER}}
|-
| {{text anchor|COMBAT_CHARGE_TANGLE_TUMBLE}}
|-
| {{text anchor|COMBAT_CHARGE_RUSH_BY}}
|-
| {{text anchor|COMBAT_CHARGE_MANAGE_STOP}}
|-
| {{text anchor|COMBAT_CHARGE_OBSTACLE_SLAM}}
|-
| {{text anchor|COMBAT_WRESTLE_LOCK}}
|-
| {{text anchor|COMBAT_WRESTLE_CHOKEHOLD}}
|-
| {{text anchor|COMBAT_WRESTLE_TAKEDOWN}}
|-
| {{text anchor|COMBAT_WRESTLE_THROW}}
|-
| {{text anchor|COMBAT_WRESTLE_RELEASE_LOCK}}
|-
| {{text anchor|COMBAT_WRESTLE_RELEASE_CHOKE}}
|-
| {{text anchor|COMBAT_WRESTLE_RELEASE_GRIP}}
|-
| {{text anchor|COMBAT_WRESTLE_STRUGGLE}}
|-
| {{text anchor|COMBAT_WRESTLE_RELEASE_LATCH}}
|-
| {{text anchor|COMBAT_WRESTLE_STRANGLE_KO}}
|-
| {{text anchor|COMBAT_WRESTLE_ADJUST_GRIP}}
|-
| {{text anchor|COMBAT_GRAB_TEAR}}
|-
| {{text anchor|COMBAT_STRIKE_DETAILS}}
|-
| {{text anchor|COMBAT_STRIKE_DETAILS_2}}
|-
| {{text anchor|COMBAT_EVENT_ENRAGED}}
|-
| {{text anchor|COMBAT_EVENT_STUCKIN}}
|-
| {{text anchor|COMBAT_EVENT_LATCH_BP}}
|-
| {{text anchor|COMBAT_EVENT_LATCH_GENERAL}}
|-
| {{text anchor|COMBAT_EVENT_PROPELLED_AWAY}}
|-
| {{text anchor|COMBAT_EVENT_KNOCKED_OUT}}
|-
| {{text anchor|COMBAT_EVENT_STUNNED}}
|-
| {{text anchor|COMBAT_EVENT_WINDED}}
|-
| {{text anchor|COMBAT_EVENT_NAUSEATED}}
|-
| {{text anchor|MIGRANT_ARRIVAL_NAMED}}
|
|-
| {{text anchor|MIGRANT_ARRIVAL}}
| The arrival of [[migrants]]
|-
| {{text anchor|DIG_CANCEL_WARM}}
| rowspan=2 | The [[Main:Digging designation canceled|cancellation]] of a mining task due to potentially dangerous stone.
|-
| {{text anchor|DIG_CANCEL_DAMP}}
|-
| {{text anchor|AMBUSH_DEFENDER}}
| rowspan=14 | Discovering an [[ambush]]
|-
| {{text anchor|AMBUSH_RESIDENT}}
|-
| {{text anchor|AMBUSH_THIEF}}
|-
| {{text anchor|AMBUSH_THIEF_SUPPORT_SKULKING}}
|-
| {{text anchor|AMBUSH_THIEF_SUPPORT_NATURE}}
|-
| {{text anchor|AMBUSH_THIEF_SUPPORT}}
|-
| {{text anchor|AMBUSH_MISCHIEVOUS}}
|-
| {{text anchor|AMBUSH_SNATCHER}}
|-
| {{text anchor|AMBUSH_SNATCHER_SUPPORT}}
|-
| {{text anchor|AMBUSH_AMBUSHER_NATURE}}
|-
| {{text anchor|AMBUSH_AMBUSHER}}
|-
| {{text anchor|AMBUSH_INJURED}}
|-
| {{text anchor|AMBUSH_OTHER}}
|-
| {{text anchor|AMBUSH_INCAPACITATED}}
|-
| {{text anchor|CARAVAN_ARRIVAL}}
| Arrival of a [[caravan]]
|-
| {{text anchor|NOBLE_ARRIVAL}}
| Arrival of a [[noble]]
|-
| {{text anchor|D_MIGRANTS_ARRIVAL}}
| rowspan=3| Arrival of a [[migrant]] wave
|-
| {{text anchor|D_MIGRANT_ARRIVAL}}
|-
| {{text anchor|D_MIGRANT_ARRIVAL_DISCOURAGED}}
|-
| {{text anchor|D_NO_MIGRANT_ARRIVAL}}
| The failure of [[migrants]] to show up in Fortress mode
|-
| {{text anchor|ANIMAL_TRAP_CATCH}}
| A [[vermin]] was caught in an [[animal trap]]
|-
| {{text anchor|ANIMAL_TRAP_ROBBED}}
| Failure to catch a [[vermin]]
|-
| {{text anchor|MISCHIEF_LEVER}}
| rowspan=4| Fun caused by a [[gremlin|certain mischievous creature]]
|-
| {{text anchor|MISCHIEF_PLATE}}
|-
| {{text anchor|MISCHIEF_CAGE}}
|-
| {{text anchor|MISCHIEF_CHAIN}}
|-
| {{text anchor|DIPLOMAT_ARRIVAL}}
| Arrival of a [[diplomat]]
|-
| {{text anchor|LIAISON_ARRIVAL}}
| Arrival of an [[outpost liaison]]
|-
| {{text anchor|TRADE_DIPLOMAT_ARRIVAL}}
|
|-
| {{text anchor|CAVE_COLLAPSE}}
| [[Cave-in]]
|-
| {{text anchor|BIRTH_CITIZEN}}
| Birth of a [[baby]]
|-
| {{text anchor|BIRTH_ANIMAL}}
| Birth of an [[animal]]
|-
| {{text anchor|STRANGE_MOOD}}
| A citizen has entered a [[strange mood]]
|-
| {{text anchor|MADE_ARTIFACT}}
| An [[artifact]] was created
|-
| {{text anchor|NAMED_ARTIFACT}}
| A soldier named his equipment.
|-
| {{text anchor|ITEM_ATTACHMENT}}
| A soldier has become attached to his equipment.
|-
| {{text anchor|VERMIN_CAGE_ESCAPE}}
| A [[vermin]] escapes from a [[cage]]/[[animal trap]]
|-
| {{text anchor|TRIGGER_WEB}}
|
|-
| {{text anchor|MOOD_BUILDING_CLAIMED}}
| A [[strange mood|moody]] dwarf has claimed a workshop
|-
| {{text anchor|ARTIFACT_BEGUN}}
| A dwarf has began construction of an [[artifact]]
|-
| {{text anchor|MEGABEAST_ARRIVAL}}
| Arrival of a [[megabeast]]
|-
| {{text anchor|BERSERK_CITIZEN}}
| A citizen has gone [[berserk]]
|-
| {{text anchor|MAGMA_DEFACES_ENGRAVING}}
| rowspan=2| An [[engraving]] has melted in a magma
|-
| {{text anchor|ENGRAVING_MELTS}}
|-
| {{text anchor|MASTERPIECE_ARCHITECTURE}}
| rowspan=2| Construction of a [[masterwork|masterpiece]] [[building]]
|-
| {{text anchor|MASTERPIECE_CONSTRUCTION}}
|-
| {{text anchor|MASTER_ARCHITECTURE_LOST}}
| A [[masterwork|masterpiece]] [[building]] has been destroyed
|-
| {{text anchor|MASTER_CONSTRUCTION_LOST}}
|-
| {{text anchor|ADV_AWAKEN}}
|
|-
| {{text anchor|ADV_SLEEP_INTERRUPTED}}
|
|-
| {{text anchor|ADV_REACTION_PRODUCTS}}
|
|-
| {{text anchor|CANCEL_JOB}}
| [[Job]] cancellations
|-
| {{text anchor|ADV_CREATURE_DEATH}}
| Killing a creature in [[adventure mode]]
|-
| {{text anchor|CITIZEN_DEATH}}
| Death of a citizen in [[fortress mode]]
|-
| {{text anchor|PET_DEATH}}
| The death of a [[pet]], causing a negative [[thought]] for its owner
|-
| {{text anchor|FALL_OVER}}
| Falling over
|-
| {{text anchor|CAUGHT_IN_FLAMES}}
| Catching [[fire]]
|-
| {{text anchor|CAUGHT_IN_WEB}}
| Being caught in a [[web]]
|-
| {{text anchor|UNIT_PROJECTILE_SLAM_BLOW_APART}}
| rowspan=2| Fall damage
|-
| {{text anchor|UNIT_PROJECTILE_SLAM}}
|-
| {{text anchor|UNIT_PROJECTILE_SLAM_INTO_UNIT}}
| Falling onto a [[creature]]
|-
| {{text anchor|VOMIT}}
| [[Vomit]]ing
|-
| {{text anchor|LOSE_HOLD_OF_ITEM}}
| Losing hold of an item
|-
| {{text anchor|REGAIN_CONSCIOUSNESS}}
| [[unconscious|Regaining consciousness]]
|-
| {{text anchor|FREE_FROM_WEB}}
| Freeing from a [[web]]
|-
| {{text anchor|PARALYZED}}
| A creature is [[syndrome|paralyzed]]
|-
| {{text anchor|OVERCOME_PARALYSIS}}
| A creature is no longer [[syndrome|paralyzed]]
|-
| {{text anchor|NOT_STUNNED}}
| A creature is no longer [[stun]]ned
|-
| {{text anchor|EXHAUSTION}}
| [[Exhaustion]]
|-
| {{text anchor|PAIN_KO}}
| [[Unconsciousness]] caused by [[pain]]
|-
| {{text anchor|BREAK_GRIP}}
| Breaking a wrestling grip
|-
| {{text anchor|NO_BREAK_GRIP}}
| Being unable to break a wrestling grip
|-
| {{text anchor|BLOCK_FIRE}}
| Blocking a [[fire]] attack
|-
| {{text anchor|BREATHE_FIRE}}
| A creature breathes [[fire]]
|-
| {{text anchor|SHOOT_WEB}}
| A creature shoots [[web]]s
|-
| {{text anchor|PULL_OUT_DROP}}
|
|-
| {{text anchor|STAND_UP}}
| Standing up
|-
| {{text anchor|MARTIAL_TRANCE}}
| Going into a [[martial trance]]
|-
| {{text anchor|MAT_BREATH}}
| A creature spits a [[glob]] of a substance
|-
| {{text anchor|NIGHT_ATTACK_STARTS}}
| rowspan=3| [[Bogeymen]] attack
|-
| {{text anchor|NIGHT_ATTACK_ENDS}}
|-
| {{text anchor|NIGHT_ATTACK_TRAVEL}}
|-
| {{text anchor|GHOST_ATTACK}}
|
|-
| {{text anchor|LAIR_HUNTER}}
|
|-
| {{text anchor|TRAVEL_SITE_DISCOVERY}}
| Discovering a [[site]]
|-
| {{text anchor|TRAVEL_SITE_BUMP}}
| You can't travel through a certain [[site]]
|-
| {{text anchor|ADVENTURE_INTRO}}
| Beginning an [[adventure]]
|-
| {{text anchor|CREATURE_SOUND}}
| You hear the sound of a creature. See [[Capybara]] for details
|-
| {{text anchor|CREATURE_STEALS_OBJECT}}
| A [[creature]] stole an [[item]]
|-
| {{text anchor|FOUND_TRAP}}
| Discovery of a [[trap]] in [[adventure mode]]
|-
| {{text anchor|BODY_TRANSFORMATION}}
| Transformation into a [[werebeast]] or otherwise
|-
| {{text anchor|INTERACTION_ACTOR}}
| See [[Interaction token#VERB]]
|-
| {{text anchor|INTERACTION_TARGET}}
| See [[Interaction token#TARGET_VERB]]
|-
| {{text anchor|UNDEAD_ATTACK}}
|
|-
| {{text anchor|CITIZEN_MISSING}}
| A citizen has gone missing
|-
| {{text anchor|PET_MISSING}}
| A pet has gone missing
|-
| {{text anchor|MARKET_CHATTER}}
|
|-
| {{text anchor|STRANGE_RAIN_SNOW}}
| rowspan=2 | The appearance of unusual [[weather]]
|-
| {{text anchor|STRANGE_CLOUD}}
|-
| {{text anchor|SIMPLE_ANIMAL_ACTION}}
|
|-
| {{text anchor|FLOUNDER_IN_LIQUID}}
| Floundering in [[water]]
|-
| {{text anchor|TRAINING_DOWN_TO_SEMI_WILD}}
| A trained animal has reverted to a semi-wild state (Fortress mode). If the animal is not [[animal trainer|trained]] properly, it will become wild and possibly attack your dwarves.
|-
| {{text anchor|TRAINING_FULL_REVERSION}}
| An animal has reverted to a wild state (follows the previous announcement)
|-
| {{text anchor|ANIMAL_TRAINING_KNOWLEDGE}}
| See [[Animal trainer#Taming|Animal trainer]]
|-
| {{text anchor|SKIP_ON_LIQUID}}
|
|-
| {{text anchor|DODGE_FLYING_OBJECT}}
| Dodging a shot [[arrow]]
|-
| {{text anchor|REGULAR_CONVERSATION}}
|
|-
| {{text anchor|CONFLICT_CONVERSATION}}
|
|-
| {{text anchor|FLAME_HIT}}
|
|-
| {{text anchor|EMBRACE}}
|
|-
| {{text anchor|BANDIT_EMPTY_CONTAINER}}
|
|-
| {{text anchor|BANDIT_GRAB_ITEM}}
|
|-
| {{text anchor|COMBAT_EVENT_ATTACK_INTERRUPTED}}
|
|-
| {{text anchor|COMBAT_WRESTLE_CATCH_ATTACK}}
|
|-
| {{text anchor|FAIL_TO_GRAB_SURFACE}}
| Failing to grab a tile
|-
| {{text anchor|LOSE_HOLD_OF_SURFACE}}
| Losing hold of a surface while [[climb]]ing
|-
| {{text anchor|TRAVEL_COMPLAINT}}
|
|-
| {{text anchor|LOSE_EMOTION}}
|
|-
| {{text anchor|REORGANIZE_POSSESSIONS}}
| A soldier reorganizes his equipment
|-
| {{text anchor|PUSH_ITEM}}
|
|-
| {{text anchor|DRAW_ITEM}}
| Drawing out a weapon
|-
| {{text anchor|STRAP_ITEM}}
| Strapping a weapon
|-
| {{text anchor|GAIN_SITE_CONTROL}}
|
|-
| {{text anchor|FORT_POSITION_SUCCESSION}}
|
|-
| {{text anchor|STRESSED_CITIZEN}}
|
|-
| {{text anchor|CITIZEN_LOST_TO_STRESS}}
|
|-
| {{text anchor|CITIZEN_TANTRUM}}
| A citizen starts [[tantrum]]ing
|-
| {{text anchor|MOVED_OUT_OF_RANGE}}
| An [[attack]]ed creature has moved out of range
|-
| {{text anchor|CANNOT_JUMP}}
| You are unable to [[jump]]
|-
| {{text anchor|NO_TRACKS}}
|
|-
| {{text anchor|ALREADY_SEARCHED_AREA}}
|
|-
| {{text anchor|SEARCH_FOUND_SOMETHING}}
|
|-
| {{text anchor|SEARCH_FOUND_NOTHING}}
|
|-
| {{text anchor|NOTHING_TO_INTERACT}}
|
|-
| {{text anchor|NOTHING_TO_EXAMINE}}
|
|-
| {{text anchor|YOU_YIELDED}}
| You assume a [[yield|submissive posture]]
|-
| {{text anchor|YOU_UNYIELDED}}
| You no longer assume a [[yield|submissive posture]]
|-
| {{text anchor|YOU_STRAP_ITEM}}
| You strap a weapon
|-
| {{text anchor|YOU_DRAW_ITEM}}
| You draw out a weapon
|-
| {{text anchor|NO_GRASP_TO_DRAW_ITEM}}
| You have no free grasp to draw out a weapon
|-
| {{text anchor|NO_ITEM_TO_STRAP}}
|
|-
| {{text anchor|NO_INV_TO_REMOVE}}
|
|-
| {{text anchor|NO_INV_TO_WEAR}}
| You have nothing left to wear
|-
| {{text anchor|NO_INV_TO_EAT}}
| You have nothing to eat/drink
|-
| {{text anchor|NO_INV_TO_CONTAIN}}
| You have no suitable container for an item
|-
| {{text anchor|NO_INV_TO_DROP}}
| You gave nothing to drop
|-
| {{text anchor|NOTHING_TO_PICK_UP}}
| There is nothing to pick up
|-
| {{text anchor|NO_INV_TO_THROW}}
| You have nothing to throw
|-
| {{text anchor|NO_INV_TO_FIRE}}
|
|-
| {{text anchor|CURRENT_SMELL}}
| [[Smell]]ing in [[adventure mode]]
|-
| {{text anchor|CURRENT_WEATHER}}
| Checking [[weather]] in [[adventure mode]]
|-
| {{text anchor|CURRENT_TEMPERATURE}}
| Checking [[temperature]] in [[adventure mode]]
|-
| {{text anchor|CURRENT_DATE}}
| Checking [[time]] in [[adventure mode]]
|-
| {{text anchor|NO_GRASP_FOR_PICKUP}}
| You have no free grasp to pick up an item
|-
| {{text anchor|TRAVEL_ADVISORY}}
|
|-
| {{text anchor|CANNOT_CLIMB}}
| You are unable to [[climb]]
|-
| {{text anchor|CANNOT_STAND}}
| You are unable to stand up
|-
| {{text anchor|MUST_UNRETRACT_FIRST}}
|
|-
| {{text anchor|CANNOT_REST}}
|
|-
| {{text anchor|CANNOT_MAKE_CAMPFIRE}}
|
|-
| {{text anchor|MADE_CAMPFIRE}}
| You make a [[campfire]]
|-
| {{text anchor|CANNOT_SET_FIRE}}
|
|-
| {{text anchor|SET_FIRE}}
| You set a [[fire]]
|-
| {{text anchor|DAWN_BREAKS}}
| rowspan=3| Change of a time of day
|-
| {{text anchor|NOON}}
|-
| {{text anchor|NIGHTFALL}}
|-
| {{text anchor|NO_INV_INTERACTION}}
|
|-
| {{text anchor|EMPTY_CONTAINER}}
|
|-
| {{text anchor|TAKE_OUT_OF_CONTAINER}}
|
|-
| {{text anchor|NO_CONTAINER_FOR_ITEM}}
|
|-
| {{text anchor|PUT_INTO_CONTAINER}}
|
|-
| {{text anchor|EAT_ITEM}}
| You eat an item
|-
| {{text anchor|DRINK_ITEM}}
| You drink an item
|-
| {{text anchor|CONSUME_FAILURE}}
| You lick an item
|-
| {{text anchor|DROP_ITEM}}
| You drop an item
|-
| {{text anchor|PICK_UP_ITEM}}
| You pick up an item
|-
| {{text anchor|YOU_BUILDING_INTERACTION}}
| Interaction with a [[building]] in [[adventure mode]]
|-
| {{text anchor|YOU_ITEM_INTERACTION}}
| Interaction with an [[item]] in [[adventure mode]]
|-
| {{text anchor|YOU_TEMPERATURE_EFFECTS}}
|
|-
| {{text anchor|RESOLVE_SHARED_ITEMS}}
|
|-
| {{text anchor|COUGH_BLOOD}}
| [[Syndrome|Coughing blood]]
|-
| {{text anchor|VOMIT_BLOOD}}
| [[Syndrome|Vomiting blood]]
|-
| {{text anchor|POWER_LEARNED}}
| Learning a new power
|-
| {{text anchor|YOU_FEED_ON_SUCKEE}}
| [[Vampire|Sucking blood]]
|-
| {{text anchor|PROFESSION_CHANGES}}
| Changing a profession
|-
| {{text anchor|RECRUIT_PROMOTED}}
|
|-
| {{text anchor|SOLDIER_BECOMES_MASTER}}
| A [[soldier]] has mastered a weapon [[skill]]
|-
| {{text anchor|MERCHANTS_UNLOADING}}
| The [[merchants]] are unloading their goods
|-
| {{text anchor|MERCHANTS_NEED_DEPOT}}
| The [[merchants]] need a [[trade depot]]
|-
| {{text anchor|MERCHANT_WAGONS_BYPASSED}}
| The [[merchants]]' wagons have bypassed the site
|-
| {{text anchor|MERCHANTS_LEAVING_SOON}}
| The [[merchants]] will leave soon
|-
| {{text anchor|MERCHANTS_EMBARKED}}
| The [[merchants]] are leaving the site
|-
| {{text anchor|PET_LOSES_DEAD_OWNER}}
|
|-
| {{text anchor|PET_ADOPTS_OWNER}}
|
|-
| {{text anchor|VERMIN_BITE}}
| A [[vermin]] bites/stings a creature
|-
| {{text anchor|UNABLE_TO_COMPLETE_BUILDING}}
| Dwarves were unable to construct a [[building]]
|-
| {{text anchor|JOBS_REMOVED_FROM_UNPOWERED_BUILDING}}
|
|-
| {{text anchor|CITIZEN_SNATCHED}}
| A [[child]] has been abducted by a [[snatcher]]
|-
| {{text anchor|VERMIN_DISTURBED}}
|
|-
| {{text anchor|LAND_GAINS_STATUS}}
|
|-
| {{text anchor|LAND_ELEVATED_STATUS}}
|
|-
| {{text anchor|MASTERPIECE_CRAFTED}}
| Crafting a [[masterwork]]
|-
| {{text anchor|ARTWORK_DEFACED}}
| A [[masterwork]] was destroyed
|-
| {{text anchor|ANIMAL_TRAINED}}
|
|-
| {{text anchor|DYED_MASTERPIECE}}
| An item has been [[masterwork|masterfully]] [[dyer|dyed]]
|-
| {{text anchor|COOKED_MASTERPIECE}}
| Cooking a [[masterwork|masterful]] [[prepared meal|meal]]
|-
| {{text anchor|MANDATE_ENDS}}
| A [[noble]] ended a [[mandate]]
|-
| {{text anchor|SLOWDOWN_ENDS}}
|
|-
| {{text anchor|FAREWELL_HELPER}}
|
|-
| {{text anchor|ELECTION_RESULTS}}
|
|-
| {{text anchor|SITE_PRESENT}}
|
|-
| {{text anchor|CONSTRUCTION_SUSPENDED}}
| Construction of a [[building]] was suspended
|-
| {{text anchor|LINKAGE_SUSPENDED}}
|
|-
| {{text anchor|QUOTA_FILLED}}
|
|-
| {{text anchor|JOB_OVERWRITTEN}}
|
|-
| {{text anchor|NOTHING_TO_CATCH_IN_WATER}}
| A [[fisherman]] can't catch anything in the water
|-
| {{text anchor|DEMAND_FORGOTTEN}}
|
|-
| {{text anchor|NEW_DEMAND}}
|
|-
| {{text anchor|NEW_MANDATE}}
|
|-
| {{text anchor|PRICES_ALTERED}}
|
|-
| {{text anchor|NAMED_RESIDENT_CREATURE}}
|
|-
| {{text anchor|SOMEBODY_GROWS_UP}}
| Somebody has grown up
|-
| {{text anchor|GUILD_REQUEST_TAKEN}}
|
|-
| {{text anchor|GUILD_WAGES_CHANGED}}
|
|-
| {{text anchor|NEW_WORK_MANDATE}}
|
|-
| {{text anchor|CITIZEN_BECOMES_SOLDIER}}
|
|-
| {{text anchor|CITIZEN_BECOMES_NONSOLDIER}}
|
|-
| {{text anchor|PARTY_ORGANIZED}}
|
|-
| {{text anchor|POSSESSED_TANTRUM}}
| A dwarf possesed by a [[ghost]] is throwing a [[tantrum]]
|-
| {{text anchor|BUILDING_TOPPLED_BY_GHOST}}
| A building was toppled by a [[ghost]]
|-
| {{text anchor|MASTERFUL_IMPROVEMENT}}
| An item has been [[masterwork|masterfully]] decorated
|-
| {{text anchor|MASTERPIECE_ENGRAVING}}
| A [[masterwork|masterpiece]] [[engraving]] was created
|-
| {{text anchor|MARRIAGE}}
|
|-
| {{text anchor|NO_MARRIAGE_CELEBRATION}}
|
|-
| {{text anchor|CURIOUS_GUZZLER}}
| An animal drank stockpiled [[booze]]
|-
| {{text anchor|WEATHER_BECOMES_CLEAR}}
| The [[weather]] clears
|-
| {{text anchor|WEATHER_BECOMES_SNOW}}
| It starts [[snow]]ing
|-
| {{text anchor|WEATHER_BECOMES_RAIN}}
| It starts [[rain]]ing
|-
| {{text anchor|SEASON_WET}}
|
|-
| {{text anchor|SEASON_DRY}}
|
|-
| {{text anchor|SEASON_SPRING}}
| rowspan=4| Change of a season
|-
| {{text anchor|SEASON_SUMMER}}
|-
| {{text anchor|SEASON_AUTUMN}}
|-
| {{text anchor|SEASON_WINTER}}
|-
| {{text anchor|GUEST_ARRIVAL}}{{version|0.42.01}}
| Arrival of a [[visitor]]
|-
| {{text anchor|CANNOT_SPEAK}}{{version|0.42.01}}
| You are unable to speak
|-
| {{text anchor|RESEARCH_BREAKTHROUGH}}{{version|0.42.01}}
|
|-
| {{text anchor|SERVICE_ORDER_DELIVERY}}{{version|0.42.01}}
|
|-
| {{text anchor|PERFORMANCE_START_FAILURE}}{{version|0.42.01}}
|
|-
| {{text anchor|BEGIN_ACTIVITY}}{{version|0.42.01}}
|
|-
| {{text anchor|MIDDLE_OF_ACTIVITY}}{{version|0.42.01}}
|
|-
| {{text anchor|ACTIVITY_SECTION_CHANGE}}{{version|0.42.01}}
|
|-
| {{text anchor|CONCLUDE_ACTIVITY}}{{version|0.42.01}}
|
|-
| {{text anchor|LEARNED_WRITTEN_CONTENT}}{{version|0.42.01}}
|
|-
| {{text anchor|LEARNED_ART_FORM}}{{version|0.42.01}}
|
|-
| {{text anchor|PERFORMER_UPDATE}}{{version|0.42.01}}
|
|-
| {{text anchor|BUILDING_DESTROYED_OR_TOPPLED}}{{version|0.42.01}}
| A [[creature]] destroyed a [[building]]
|-
| {{text anchor|DEITY_CURSE}}{{version|0.42.01}}
| Being cursed by a [[deity]]
|-
| {{text anchor|COMPOSITION_COMPLETE}}{{version|0.42.01}}
|
|-
| {{text anchor|COMPOSITION_FAILED}}{{version|0.42.01}}
|
|-
| {{text anchor|NEW_APPRENTICESHIP}}{{version|0.42.01}}
|
|-
| {{text anchor|PETITION_IGNORED}}{{version|0.42.01}}
|
|-
| {{text anchor|CANNOT_CHOP_TREE}}{{version|0.43.01}}
|
|-
| {{text anchor|CHOP_TREE}}{{version|0.43.01}}
|
|-
| {{text anchor|CANNOT_CONSTRUCT}}{{version|0.43.01}}
|
|}

{{gamedata}}
{{files}}

DF2014 Talk:Instrument

2016-03-07T20:05:35Z

FortressBuilder: /* Regarding non-generated instruments */

http://www.bay12forums.com/smf/index.php?topic=154254.0
Collected by bay12 forum user Aranna.

Posting here so it doesn't get lost. Should be useful for the person expanding this article.[[User:CLA|CLA]] ([[User talk:CLA|talk]]) 15:29, 3 December 2015 (UTC)

== Instruments ==
An incomplete list
{| class = "wikitable sortable"
! Instrument
! Part
! Material
! Produced at
|-
|Nir
|Nir keyboard
|Stone
|Craftsdwarf Workshop
|-
|
|Nir case
|Ceramic
|Kiln
|-
|
|Nir bells
|Stone
|Craftsdwarf Workshop
|-
|Etes
|Etes body
|Bones
|Craftsdwarf Workshop
|-
|
|Etes strings
|Metal
|Metalsmith's Forge
|-
|
|Etes hammers
|Metal
|Metalsmith's Forge
|-
|Theb
|Theb bellows
|Leather
|Leather Works
|-
|
|Theb bag
|Leather
|Leather Works
|-
|
|Theb melody pipes
|Ceramic
|Kiln
|-
|
|Theb drone pipes
|Stone
|Craftsdwarf Workshop
|-
|Tiklon
|Tiklon bars
|Wood
|Craftsdwarf Workshop
|-
|
|Tiklon stands
|Glass
|Glass Furnace
|-
|Kurel
|Kurel drum
|Stone
|Mason's Workshop
|-
|
|Kurel head
|Leather
|Leather Works
|-
|Ingtak
|Ingtak triangles
|Metal
|Metalsmith's Forge
|-
|
|Ingtak stand
|Metal
|Metalsmith's Forge
|-
|Mishin
|Mishin drum
|Ceramic
|Kiln
|-
|
|Mishin head
|Leather
|Leather Works
|-
|
|Mishin hammers
|Metal
|Metalsmith's Forge
|-
|Metul
|
|
|
|-
|Letom
|
|Bones
|Craftsdwarf Workshop
|-
|}
[[User:Ashameron|Ashameron]] ([[User talk:Ashameron|talk]]) 10:33, 19 December 2015 (UTC)

==Multiple copies?==

From the article:

:" It is possible for larger instrument to require multiple copies of the same instrument piece. For example, a gitnuk is a larger instrument that must be assembled with 1 gitnuk body and 5 gitnuk bar."

In my experience, even though an instrument is described as having several (e.g. blocks), the complete set is created by single job (e.g. forge blocks).--[[User:Loci|Loci]] ([[User talk:Loci|talk]]) 21:26, 29 January 2016 (UTC)

==Regarding non-generated instruments==

Going to test whether the older instrument entity token still functions, and whether instruments made that way are usuable in musical forms. Unless anyone has already attempted this? --[[User:Valos|Valos]] ([[User talk:Valos|talk]]) 18:38, 7 March 2016 (UTC)

:<code>raw/objects/examples and notes/item_instrument_example.txt</code> says they do, though I haven't tried it out. [[User:FortressBuilder|FortressBuilder]] ([[User talk:FortressBuilder|talk]]) 20:05, 7 March 2016 (UTC)

Topic

2016-03-06T19:39:50Z

FortressBuilder: /* Mathematics */ Fix link

{{Quality|Superior|06:10, 17 May 2015 (UTC)}}
{{av}}

{{new in v0.42}}
{{Expand Topic}}

[[File:Topics.svg|thumb|500px|A diagram of all knowledge topics.]]

'''Topics''' (also '''Tech''' or '''Innovations''') are part of [[knowledge]].

There are around 300 innovations that can be discovered. Many of them have requirements, and many do not, so it's kind of a tech forest/grassland rather than a tree. Notably missing are innovations related to practical labors in the game (which will be added later in development).

Several innovations require innovations from other branches, and since all knowledge is individually tracked, that implies some investigators will need to be at least well-read if not skilled in various topics (there aren't currently joint research projects). There are some old and new mechanisms in place to ensure this happens.

There are 9 "branches" of the knowledge system.
==Astronomy==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Dates of lunar and solar eclipses
|
|[[wikipedia:Saros (astronomy)|Saros (astronomy)]]
|-
|Daylight variation with solar year
|The variation of daylight with the season
|[[wikipedia:Daytime#Daytime variations with latitude and seasons|Daytime § Daytime variations with latitude and seasons]]
|-
|Geocentrism
|The theory that the sun moves around the world
|[[wikipedia:Geocentric model|Geocentric model]]
|-
|Height of tides vs moon and sun
|The height of the tides, the moon and the sun
|[[wikipedia:Pytheas#Pytheas_on_the_tides|Pytheas § Pytheas_on_the_tides]] and [[wikipedia:Tide|Tide]]
|-
|Heliocentrism
|The theory that the world moves around the sun
|[[wikipedia:Heliocentric model|Heliocentric model]]
|-
|Empirical observation
|Methods of empirical observation in astronomy
|[[wikipedia:Empirical evidence|Empirical evidence]]
|-
|Path models
|
|[[wikipedia:Orbit modeling|Orbit modeling]]
|-
|Path of the moon
|The path of the moon
|[[wikipedia:Orbit of the Moon|Orbit of the Moon]]
|-
|Phases of the moon
|The phases of the moon
|[[wikipedia:Lunar phase|Lunar phase]]
|-
|Precession of equinoxes
|
|[[wikipedia:Axial precession|Axial precession]]
|-
|Relationship between lunar solar year
|The relationship between the lunar and solar year
|[[wikipedia:Lunisolar calendar|Lunisolar calendar]]
|-
|Shape of the world
|
|[[wikipedia:Spherical Earth|Spherical Earth]]
|-
|Star catalogues 100
|
|[[wikipedia:Star catalogue|Star catalogue]]
|-
|Star catalogues 1000
|
|[[wikipedia:Star catalogue|Star catalogue]]
|-
|Astrography
| The creation of star charts
|[[wikipedia:Star chart|Star chart]]
|-
|Stellar Spectroscopy
|The classification of stars based on the light they emit
|[[wikipedia:Astronomical spectroscopy|Astronomical spectroscopy]]
|-
|Star magnitude classification
|
|[[wikipedia:Magnitude (astronomy)|Magnitude (astronomy)]]
|-
|Summer winter moon
|The rise of the moon according to the season
|[[wikipedia:Lunar calendar|Lunar calendar]]
|-
|Summer winter sun
| The rise of the sun according to the season
|[[wikipedia:Solar calendar|Solar calendar]]
|-
|Tides and the moon
| The relationship between the moon and the tides
|[[wikipedia:Seleucus_of_Seleucia#Tides|Seleucus_of_Seleucia § Tides]] and [[wikipedia:Tide|Tide]]
|}

==Chemistry==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Adhesives
|The preparation and use of adhesive materials
|[[wikipedia:Adhesive|Adhesive]]
|-
|Aqua regia
|The preparation of aqua regia
|[[wikipedia:Aqua regia|Aqua regia]]
|-
|Spirit of niter
|The preparation of spirit of niter
|[[wikipedia:Nitric acid|Nitric acid]]
|-
|Oil of vitriol
|The preparation of oil of vitriol
|[[wikipedia:Sulfuric acid|Sulfuric acid]]
|-
|Alkali and acids
|The classification of alkali and acids
|[[wikipedia:pH|pH]]
|-
|Combustibles
|The classification of combustible materials
|[[wikipedia:Combustibility|Combustibility]]
|-
|Elemental theory
|The classification of materials based on which elemental materials might form them
|[[wikipedia:Chemical element|Chemical element]]
|-
|Ores
|The classification of ores
|[[wikipedia:Ore|Ore]]
|-
|Scratch test
|
|[[wikipedia:Scratch hardness|Scratch hardness]]
|-
|Alembic
|The construction and use of the alembic
|[[wikipedia:Alembic|Alembic]]
|-
|Blast furnace
|The construction and use of the blast furnace
|[[wikipedia:Blast furnace|Blast furnace]]
|-
|Crucible
| The construction and use of the crucible
|[[wikipedia:Crucible|Crucible]]
|-
|Ampoule
|The construction and use of the ampoule
|[[wikipedia:Ampoule|Ampoule]]
|-
|Beaker
| The construction and use of the beaker
|[[wikipedia:Beaker|Beaker]]
|-
|Flask
|
|[[wikipedia:Flask|Flask]]
|-
|Funnel
|The construction and use of the funnel
|[[wikipedia:Funnel|Funnel]]
|-
|Retort
|The construction and use of the retort
|[[wikipedia:Retort|Retort]]
|-
|Vial
|The construction and use of the vial
|[[wikipedia:Vial|Vial]]
|-
|Lab ovens
|The construction and use of laboratory ovens
|[[wikipedia:Laboratory oven|Laboratory oven]]
|-
|Systematic experiments
|Methods for performing experiments systematically in the laboratory
|[[wikipedia:Scientific method|Scientific method]]
|-
|Theory of distillation
|The theory and methods involved in distillation
|[[wikipedia:Distillation|Distillation]]
|-
|Theory of evaporation
|The theory and methods involved in evaporation
|[[wikipedia:Evapotation|Evapotation]]
|-
|Theory of liquid liquid extraction
|The theory and methods involved in the extraction of a constituent liquid from one solution to another
|[[wikipedia:Liquid–liquid extraction|Liquid–liquid extraction]]
|-
|Alloys
| The mixture of metals to produce alloys
|[[wikipedia:Alloy|Alloy]]
|}

==Engineering==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Armillary sphere
|The construction and use of armillary spheres
|[[wikipedia:Armillary sphere|Armillary sphere]]
|-
|Astrolabe
|The construction and use of the astrolabe
|[[wikipedia:Astrolabe|Astrolabe]]
|-
|Dioptra
|The construction and use of the dioptra
|[[wikipedia:Dioptra|Dioptra]]
|-
|Mural instrument
|
|[[wikipedia:Mural instrument|Mural instrument]]
|-
|Orrery
|
|[[wikipedia:Orrery|Orrery]]
|-
|Spherical astrolabe
|
|[[wikipedia:Armillary sphere|Armillary sphere]]
|-
|Wood lamination
|The use of lamination
|[[wikipedia:Lamination|Lamination]]
|-
|Models and templates
|The use of models and templates in engineering
|[[wikipedia:Prototype|Prototype]] and [[wikipedia:Stencil|Stencil]]
|-
|Archimedes principle
|
|[[wikipedia:Archimedes' principle|Archimedes' principle]]
|-
|Force pump
|
|[[wikipedia:Piston pump#Force pump|Piston pump § Force pump]]
|-
|Theory of siphon
|The action of the siphon
|[[wikipedia:Siphon|Siphon]]
|-
|Valves
|The construction and use of valves
|[[wikipedia:Valve|Valve]]
|-
|Astrarium
|
|[[wikipedia:Astrarium|Astrarium]]
|-
|Conical water clock
|
|
|-
|Hourglass
|
|[[wikipedia:Hourglass|Hourglass]]
|-
|Mechanical clock
|
|[[wikipedia:Clock#Early mechanical clocks|Clock § Early mechanical clocks]]
|-
|Shadow clock
|The use of shadows to tell direction and time
|[[wikipedia:Sundial|Sundial]]
|-
|Water clock
|The use of water-based devices to tell time
|[[wikipedia:Water clock|Water clock]]
|-
|Water clock reservoir
|The use of reservoirs in water-based clocks to improve their accuracy
|[[wikipedia:Zhang_Heng#Extra_tank_for_inflow_clepsydra|Zhang Heng § Extra tank for inflow clepsydra]]
|-
|Balance wheel
|
|[[wikipedia:Balance wheel|Balance wheel]]
|-
|Bellows
|The construction and use of the bellows
|[[wikipedia:Bellows|Bellows]]
|-
|Camshaft
|
|[[wikipedia:Camshaft|Camshaft]]
|-
|Chain drive
|The construction and use of chain drives
|[[wikipedia:Chain drive|Chain drive]]
|-
|Chariot odometer
|
|[[wikipedia:Odometer|Odometer]]
|-
|Combination lock
|
|[[wikipedia:Combination lock|Combination lock]]
|-
|Crank
|
|[[wikipedia:Crank (mechanism)|Crank (mechanism)]]
|-
|Crankshaft
|
|[[wikipedia:Crankshaft|Crankshaft]]
|-
|Differential gear
|
|[[wikipedia:Differential (mechanical device)|Differential (mechanical device)]]
|-
|Double acting piston bellows
|
|[[wikipedia:Bellows|Bellows]]
|-
|Lever
|The construction and use of the lever
|[[wikipedia:Lever|Lever]]
|-
|Mechanical compass
|
|[[wikipedia:Compass|Compass]]
|-
|Padlock
|The construction and use of the padlock
|[[wikipedia:Padlock|Padlock]]
|-
|Piston
|
|[[wikipedia:Piston pump#Force pump|Piston pump § Force pump]]
|-
|Pulley
|The construction and use of the pulley
|[[wikipedia:Pulley|Pulley]]
|-
|Screw
|The construction and use of the screw
|[[wikipedia:Screw|Screw]]
|-
|Straight beam balance
|The construction and use of the straight-beam balance
|[[wikipedia:Weighing scale#Mechanical balances|Weighing scale § Mechanical balances]]
|-
|Theory of gears
|The reasons why gears are effective
|[[wikipedia:Gear|Gear]]
|-
|Theory of lever
|The reasons why the lever is effective
|[[wikipedia:Lever|Lever]]
|-
|Theory of pulley
|The reasons why pulleys are effective
|[[wikipedia:Pulley|Pulley]]
|-
|Theory of screw
|The reasons why screws are effective
|[[wikipedia:Screw|Screw]]
|-
|Theory of wedge
|The reasons why the wedge is effective
|[[wikipedia:Wedge|Wedge]]
|-
|Theory of wheel and axle
|The reasons why the wheel-and-axle construction is effective
|[[wikipedia:Wheel and axle|Wheel and axle]]
|-
|Trip hammer
|
|[[wikipedia:Trip hammer|Trip hammer]]
|-
|Tumbler lock
|The construction and use of the tumbler lock
|[[wikipedia:Pin tumbler lock|Pin tumbler lock]]
|-
|Verge escapement
|The construction and use of the verge escapement
|[[wikipedia:Verge escapement|Verge escapement]]
|-
|Warded lock
|The construction and use of the warded lock
|[[wikipedia:Warded lock|Warded lock]]
|-
|Water powered piston bellows
|
|[[wikipedia:Du_Shi#The_Water-Powered_Blast_Furnace|Du Shi § The Water-Powered Blast Furnace]]
|-
|Water powered sawmill
|
|[[wikipedia:Watermill|Watermill]]
|-
|Water powered trip hammer
|
|[[wikipedia:Trip hammer|Trip hammer]] and [[wikipedia:Water wheel|Water wheel]]
|-
|Water wheel
|
|[[wikipedia:Water wheel|Water wheel]]
|-
|Windlass
| The construction and use of the windlass
|[[wikipedia:Windlass|Windlass]]
|-
|Atmospheric refraction
|
|[[wikipedia:Atmospheric refraction|Atmospheric refraction]]
|-
|Camera obscura
|The construction and use of the camera obscura
|[[wikipedia:Camera obscura|Camera obscura]]
|-
|Cause of twilight
|
|[[wikipedia:Atmospheric optics|Atmospheric optics]]
|-
|Crystal lens
|The construction and use of the crystal lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:Crystal|Crystal]]
|-
|Glass lens
|The construction and use of the glass lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:Glass|Glass]]
|-
|Height of atmosphere
|
|
|-
|Law of refraction
|
|[[wikipedia:Snell's law|Snell's law]]
|-
|Parabolic mirror
|
|[[wikipedia:Parabolic reflector|Parabolic reflector]]
|-
|Theory of color
|
|[[wikipedia:Color theory|Color theory]]
|-
|Theory of rainbows
|
|[[wikipedia:Rainbows|Rainbows]]
|-
|Water filled spheres
|The construction and use of water-filled sphere as a lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:History_of_optics#Early_history_of_optics|History of optics § Early history of optics]]
|}

==Geography==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Accurate maps
|
|[[wikipedia:Map|Map]]
|-
|Cartography
|The process involved in creating maps
|[[wikipedia:Cartography|Cartography]]
|-
|Distance scale
|
|[[wikipedia:Scale (map)|Scale (map)]]
|-
|Economic
|The placement of economic information on maps
|[[wikipedia:Economic geography|Economic geography]]
|-
|Geological
|The placement of geological information on maps
|[[wikipedia:Geologic map|Geologic map]]
|-
|Grid system
|
|[[wikipedia:Grid reference|Grid reference]]
|-
|Height measurements
|
|[[wikipedia:Topographic map|Topographic map]] and [[wikipedia:Levelling|Levelling]]
|-
|Map projections
|
|[[wikipedia:Map projection|Map projection]]
|-
|Atlases
|The collection of maps and other information together into a single text
|[[wikipedia:Atlas|Atlas]]
|-
|Econometrics
|The process of economic data collection
|[[wikipedia:Econometrics|Econometrics]]
|-
|Surveying
|The process of surveying land
|[[wikipedia:Surveying|Surveying]]
|-
|Cartographical surveying
|
|[[wikipedia:Cartography|Cartography]] and [[wikipedia:Surveying|Surveying]]
|-
|Engineering surveying
|
|[[wikipedia:Construction surveying|Construction surveying]]
|-
|Land surveying
|
|[[wikipedia:Cadastral surveying|Cadastral surveying]]
|-
|Military surveying
|
|[[wikipedia:Construction surveying|Construction surveying]] and [[wikipedia:Military engineerin|Military engineering]]
|-
|Surveying staff
|The construction and use of the surveying staff
|[[wikipedia:Level staff|Level staff]]
|-
|Triangulation
|
|[[wikipedia:Triangulation|Triangulation]]
|-
|Delta formation
|The process of the formation of deltas at the mouths of rivers
|[[wikipedia:River delta#Formation|River delta § Formation]]
|-
|Latitude climate zones
|
|[[wikipedia:Clime|Clime]]
|-
|Origin of rainfall from evap condense
|The origin of rainfall through evaporation and condensation
|[[wikipedia:Evaporation|Evaporation]] and [[wikipedia:Condensation|Condensation]]
|-
|Water cycle
|A world-wide cycle involving precipitation, oceans, rivers, and other forms of water
|[[wikipedia:Water cycle|Water cycle]]
|-
|Anemology
|The forces that govern wind patterns
|[[wikipedia:Global wind patterns|Global wind patterns]]
|}

==History==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Alternate history
|The exploration of how history would be different if some key past events had transpired differently
|[[wikipedia:Alternate history|Alternate history]]
|-
|Autobiographical adventure
|The method of writing a biography of oneself, particularly as it concerns a military campaign or adventure
|[[wikipedia:Autobiography|Autobiography]]
|-
|Biographical dictionaries
|The compilation of brief biographies into one large collection
|[[wikipedia:Biographical dictionary|Biographical dictionary]]
|-
|Biography
|The method of writing the history of a single individual
|[[wikipedia:Biography|Biography]]
|-
|Comparative biography
|The method of compiling several biographies to compare and contrast the subjects' character and to gain insight into history
|
|-
|Comparative anthropology
|The method of comparing and contrasting different cultures
|[[wikipedia:Cross-cultural studies|Cross-cultural studies]]
|-
|Cultural history
|The method of accurately and comprehensively describing cultures and civilizations
|[[wikipedia:Cultural history|Cultural history]]
|-
|Encyclopedia
|
|[[wikipedia:Encyclopedia|Encyclopedia]]
|-
|Genealogy
|The compilation of family lineages and methods of displaying them artfully
|[[wikipedia:Genealogy|Genealogy]]
|-
|Treatise on tech evolution
|
|[[wikipedia:Technological evolution|Technological evolution]]
|-
|Archaeology
|The method of collecting and evaluating artifacts to learn about history and culture
|[[wikipedia:Archaeology|Archaeology]]
|-
|Source reliability
|The reliability of sources
|[[wikipedia:Source criticism|Source criticism]]
|-
|Personal interviews
|Using personal interviews as sources
|[[wikipedia:Interview|Interview]]
|-
|Role of cultural differences
| The role of cultural differences in source reliability and interpretation
|[[wikipedia:Cultural relativism|Cultural relativism]]
|-
|Role of state bias and propaganda
|
|[[wikipedia:Propaganda|Propaganda]]
|-
|Role of systemic bias
|
|[[wikipedia:Systemic bias|Systemic bias]]
|-
|Historical causation
|The causes of historical events
|[[wikipedia:Causality#History|Causality § History]]
|-
|Historical cycles
|The notion of historical, governmental and social cycles
|[[wikipedia:Cyclic history|Cyclic history]]
|-
|Sociology
|The notion of bonds between members of a community
|[[wikipedia:Sociology|Sociology]]
|-
|Social conflict
|
|[[wikipedia:Social conflict|Social conflict]]
|}

==Mathematics==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Equations
|The technique of balancing and completion for solving equations
|[[wikipedia:The Compendious Book on Calculation by Completion and Balancing|The Compendious Book on Calculation by Completion and Balancing]], [[wikipedia:Algebra|Algebra]], and [[wikipedia:Equation|Equation]]
|-
|Divergence of harmonic series
|The divergence of the harmonic series
|[[wikipedia:Harmonic series (mathematics)|Harmonic series (mathematics)]]
|-
|Large sums
|Simple formulas for certain arbitrarily large sums
|[[wikipedia:Summation|Summation]]
|-
|Pascal's triangle
|A triangular configuration of numbers relating to the successive powers of any sum
|[[wikipedia:Pascal's triangle|Pascal's triangle]]
|-
|Quadratic by completing square
|The solving of quadratic equations by completion of the square
|[[wikipedia:Completing the square|Completing the square]]
|-
|Quadratic formula
|A formula which solves quadratic equations
|[[wikipedia:Quadratic formula|Quadratic formula]]
|-
|Solving higher order polynomials
|Methods for solving certain equations involving powers higher than the quadratic
|[[wikipedia:Galois theory|Galois theory]] 
|-
|Systems of equations
|Methods of solving systems of equations
|[[wikipedia:Linear system|Linear system]]
|-
|Sum-difference trig identities
|Trigonometric identities relating to the sums and differences of angles
|[[wikipedia:List of trigonometric identities#Angle sum and difference identities|List of trigonometric identities § Angle sum and difference identities]]
|-
|Area enclosed by line and parabola
|The area enclosed by a parabola and a line
|[[wikipedia:The Quadrature of the Parabola|The Quadrature of the Parabola]]
|-
|Area of circle
|
|[[wikipedia:Area of a disk|Area of a disk]]
|-
|Area of triangle from side lengths
|
|[[wikipedia:Heron's formula|Heron's formula]]
|-
|Basic geometry
|Geometric objects: points, lines, circles, triangles, and so on
|[[wikipedia:Geometry|Geometry]]
|-
|Conic sections
|The categorization and properties of conic sections
|[[wikipedia:Conic section|Conic section]]
|-
|Irrational numbers
|The existence of incommensurable ratios
|[[wikipedia:Irrational number|Irrational number]]
|-
|Geometric mean
|The relationship between the length of the altitude of a right triangle and the lengths of the segments into which it divides the hypotenuse
|[[wikipedia:Geometric mean theorem|Geometric mean theorem]]
|-
|Inscribed triangle on diameter is right
|The angles of triangles inscribed in a circle with one edge on the diameter
|[[wikipedia:Thales' theorem|Thales' theorem]]
|-
|Isosceles base angles equal
|The equality of the base angle of isosceles triangles
|[[wikipedia:Pons asinorum|Pons asinorum]]
|-
|Law of sines
|
|[[wikipedia:Law of sines|Law of sines]]
|-
|Existence of pi
|The relationship between the area of a circle and its radius, involving the ratio of the circumference of the circle to its diameter
|[[wikipedia:Pi|Pi]]
|-
|Pi to 6 digits
|
|[[wikipedia:Zu Chongzhi#Mathematics|Zu Chongzhi § Mathematics]] and [[wikipedia:Milü|Milü]]
|-
|Chords
|The properties of chords
|[[wikipedia:Chord (geometry)|Chord (geometry)]]
|-
|Pythagorean theorem
|The relationship between the lengths of the hypotenuse of a right triangle and the other two sides
|[[wikipedia:Pythagorean theorem|Pythagorean theorem]]
|-
|Pythagorean triples 3 digit
|Examples of triples of large whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Pythagorean triples 4 digit
|Examples of triples of very large whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Pythagorean triples small
|Examples of triples of small whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Similar and congruent triangles
|The properties of similar and congruent triangles
|[[wikipedia:Similarity (geometry)|Similarity (geometry)]] and [[wikipedia:Congruence (geometry)|Congruence (geometry)]]
|-
|Surface area of sphere
|The computation of the surface area of a sphere
|[[wikipedia:Sphere#Surface area|Sphere § Surface area]]
|-
|Chord tables
|A table of chord lengths indexed by angle
|[[wikipedia:Ptolemy's table of chords|Ptolemy's table of chords]]
|-
|Volume of cone
|The computation of the volume of a cone
|[[wikipedia:Cone#Volume|Cone § Volume]]
|-
|Volume of pyramid
|The computation of the volume of different pyramids
|[[wikipedia:Pyramid (geometry)#Volume|Pyramid (geometry) § Volume]]
|-
|Volume of sphere
|The computation of the volume of a sphere
|[[wikipedia:Sphere#Volume|Sphere § Volume]]
|-
|Axioms
|Axiomatic reasoning
|[[wikipedia:Axiomatic system|Axiomatic system]]
|-
|Method of exhaustion
|An approximation of the ratio of a circumference of a circle to its diameter, using the area of polygons and the method of exhaustion
|[[wikipedia:Method of exhaustion|Method of exhaustion]]
|-
|Proof by contradiction
|The method of proof by contradiction
|[[wikipedia:Proof by contradiction|Proof by contradiction]]
|-
|Symbol for addition
|The idea of using symbolic notation for addition
|[[wikipedia:Plus and minus signs#Plus sign|Plus and minus signs § Plus sign]]
|-
|Scientific notation
|Notation for very large numbers
|[[wikipedia:Scientific notation|Scientific notation]]
|-
|Negative numbers
|Notation for negative quantities
|[[wikipedia:Negative number|Negative number]]
|-
|Place values
|Positional notation
|[[wikipedia:Positional notation|Positional notation]]
|-
|Algebra
|Notation for abbreviating the unknown and other elements of an equation in a systematic and useful fashion
|[[wikipedia:Algebra|Algebra]]
|-
|Zero
|A symbol for nothingness
|[[wikipedia:0 (number)|0 (number)]]
|-
|Euclidean Algorithm
| An algorithm for computing the greatest common divisor of two numbers
|[[wikipedia:Euclidean algorithm|Euclidean algorithm]]
|-
|Chinese remainder algorithm
|An algorithm for computing a number which has given remainders when divided by several given primes
|[[wikipedia:Chinese remainder theorem|Chinese remainder theorem]]
|-
|Division
|An algorithm for dividing one number into another, possibly yielding a remainder
|[[wikipedia:Euclidean division|Euclidean division]]
|-
|Euclid's Theorem
|A proof that there are infinitely many prime numbers
|[[wikipedia:Euclid's theorem|Euclid's theorem]]
|-
|Irrationality of root 2
|A proof that the length of a diagonal of a square is incommensurable with its edge
|[[wikipedia:Square root of 2#Proofs of irrationality|Square root of 2 § Proofs of irrationality]]
|-
|Approximation of root 2
|An approximation for the length of the diagonal of a square
|[[wikipedia:Square root of 2#History|Square root of 2 § History]]
|-
|Sieve algorithm for primes
|
|[[wikipedia:Sieve of Eratosthenes|Sieve of Eratosthenes]]
|-
|Unique prime factorization
|The unique decomposition of a number into products of its prime divisors
|[[wikipedia:Fundamental theorem of arithmetic|Fundamental theorem of arithmetic]]
|}

==Medicine==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Anesthesia
|Anesthesia
|[[wikipedia:Anesthesia|Anesthesia]]
|-
|Asylum for mentally ill
|
|[[wikipedia:Psychiatric hospital|Psychiatric hospital]]
|-
|Autopsy
|
|[[wikipedia:Autopsy|Autopsy]]
|-
|Cataract surgery
|
|[[wikipedia:Cataract surgery|Cataract surgery]]
|-
|Cauterization
|Cauterization
|[[wikipedia:Cauterization|Cauterization]]
|-
|Fracture immobilization
|
|[[wikipedia:Bone fracture#Immobilization|Bone fracture § Immobilization]]
|-
|Fracture treatment
|The treatment of fractures
|[[wikipedia:Bone fracture#Treatment|Bone fracture § Treatment]]
|-
|Hernia surgery
|Hernia surgery
|[[wikipedia:Hernia#Surgery|Hernia § Surgery]]
|-
|Hospital lab
|
|[[wikipedia:Medical laboratory|Medical laboratory]]
|-
|Lithotomy surgery
|The lithotomy surgery
|[[wikipedia:Lithotomy|Lithotomy]]
|-
|Medical school
|
|[[wikipedia:Medical school|Medical school]]
|-
|Physical examination
|The method of physical examination in diagnosing illness
|[[wikipedia:Physical examination|Physical examination]]
|-
|Professional hospital staff
|
|[[wikipedia:Surgeon|Surgeon]] and [[wikipedia:Physician|Physician]]
|-
|Specialized wards
|
|[[wikipedia:Hospital#Departments or wards|Hospital § Departments or wards]]
|-
|Draining
| The surgical method of draining
|[[wikipedia:Drain (surgery)|Drain (surgery)]]
|-
|Excision
|The surgical method of excision
|
|-
|Incision
|The surgical method of incision
|[[wikipedia:Surgical incision|Surgical incision]]
|-
|Ligature
|The surgical method of ligature
|[[wikipedia:Ligature (medicine)|Ligature (medicine)]]
|-
|Probing
|The surgical method of probing
|
|-
|Scraping
|The surgical method of scraping
|
|-
|Suturing
|The surgical method of suturing
|[[wikipedia:Surgical suture|Surgical suture]]
|-
|Tracheotomy surgery
|The tracheotomy surgery
|[[wikipedia:Tracheotomy|Tracheotomy]]
|-
|Traumatic injuries
|The treatment of traumatic injuries
|[[wikipedia:Major trauma|Major trauma]]
|-
|Acute and chronic conditions
|The distinction between acute and chronic conditions
|[[wikipedia:Acute (medicine)|Acute (medicine)]] and [[wikipedia:Chronic condition|Chronic condition]]
|-
|Anatomical studies
|Anatomical studies for medical edification
|[[wikipedia:Human body|Human body]]
|-
|Blood vessels
|
|[[wikipedia:Blood vessel|Blood vessel]]
|-
|Classification of bodily fluids
|The classification of bodily fluids
|[[wikipedia:Body fluid|Body fluid]]
|-
|Classification of mental illnesses
|
|[[wikipedia:Mental disorder|Mental disorder]]
|-
|Classification of muscles
|
|[[wikipedia:Muscle|Muscle]]
|-
|Comparative anatomy
|
|
|-
|Convalescence
|
|[[wikipedia:Convalescence|Convalescence]]
|-
|Disease and fouled water
|The connection between disease and fouled water
|[[wikipedia:Waterborne diseases|Waterborne diseases]]
|-
|Pathology
|The classification of disease
|[[wikipedia:Nosology|Nosology]]
|-
|Endemic disease
|
|[[wikipedia:Endemic (epidemiology)|Endemic (epidemiology)]]
|-
|Epidemic disease
| The theory of epidemic disease
|[[wikipedia:Epidemic|Epidemic]]
|-
|Exacerbation
|The notion of the exacerbation of a patient's condition
|[[wikipedia:Exacerbation|Exacerbation]]
|-
|Eye anatomy
|The anatomy of the eye
|[[wikipedia:Human eye|Human eye]]
|-
|Fracture classification
|The classification of fractures
|[[wikipedia:Bone fracture#Classification|Bone fracture § Classification]]
|-
|Motor vs sensory nerves
|
|[[wikipedia:Motor nerve|Motor nerve]] and [[wikipedia:Sensory nerve|Sensory nerve]]
|-
|Nervous system function
|
|[[wikipedia:Nervous system|Nervous system]]
|-
|Paroxysm
|The notion of paroxysm
|[[wikipedia:Paroxysmal attack|Paroxysmal attack]]
|-
|Prognosis
|Determining the likely outcome given a patient's current status
|[[wikipedia:Prognosis|Prognosis]]
|-
|Pulmonary circulation
|
|[[wikipedia:Pulmonary circulation|Pulmonary circulation]]
|-
|Pulmonary medicine
| Pulmonary medicine
|[[wikipedia:Pulmonology|Pulmonology]]
|-
|Reaction time
|
|[[wikipedia:Mental chronometry|Mental chronometry]]
|-
|Relapse
|
|[[wikipedia:Relapse|Relapse]]
|-
|Specialized surgical instruments
|The use of specialized surgical instruments
|[[wikipedia:Surgical instrument|Surgical instrument]]
|-
|Surgical models
|The use of practice models in surgery
|
|-
|The voice
|The source of the voice
|[[wikipedia:Phonation|Phonation]]
|-
|Toxicology
|The classification of toxic substances
|[[wikipedia:Toxicology|Toxicology]]
|-
|Treatment of mental illnesses
|
|[[wikipedia:Treatment of mental disorders|Treatment of mental disorders]]
|-
|Animal remedies
|Remedies prepared from animals
|[[wikipedia:Traditional Chinese medicine#Animal substances|Traditional Chinese medicine § Animal substances]]
|-
|Animals as surgical models
|The use of animals as surgical models
|
|-
|Bandages
|The method of bandaging wounds
|[[wikipedia:Bandage|Bandage]]
|-
|Dedicated hospitals
|
|[[wikipedia:Hospital|Hospital]]
|-
|Forceps
|
|[[wikipedia:Forceps|Forceps]]
|-
|Herbal remedies
|Herbal remedies
|[[wikipedia:Herbalism|Herbalism]]
|-
|Mineral remedies
|Mineral remedies
|[[wikipedia:List of traditional Chinese medicines#Minerals|List of traditional Chinese medicines § Minerals]]
|-
|Mud bags as surgical models
|The use of mud bags as surgical models
|
|-
|Orthopedic cast
|
|[[wikipedia:Orthopedic cast|Orthopedic cast]]
|-
|Plants as surgical models
|
|
|-
|Scalpel
|
|[[wikipedia:Scalpel|Scalpel]]
|-
|Needles
| The construction and use of surgical needles
|[[wikipedia:Surgical suture#Needles|Surgical suture § Needles]]
|-
|Surgical scissors
|
|[[wikipedia:Surgical scissors|Surgical scissors]]
|-
|Traction bench
|
|[[wikipedia:Traction (orthopedics)|Traction (orthopedics)]]
|}

==Naturalist==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Dissection
|The dissection of creatures
|[[wikipedia:Dissection|Dissection]]
|-
|Anatomy
|The anatomical study of creatures
|[[wikipedia:Anatomy|Anatomy]]
|-
|Veterinary medicine
|The diseases of creatures
|[[wikipedia:Veterinary medicine|Veterinary medicine]]
|-
|Embryology
|The embriological development of creatures
|[[wikipedia:Embryology|Embryology]]
|-
|Foraging behavior
|The foraging behavior and diet of creatures
|[[wikipedia:Foraging|Foraging]]
|-
|Migration
|The migratory patterns of creatures
|[[wikipedia:Animal migration|Animal migration]]
|-
|Reproductive behavior
|The reproductive behavior of creatures
|[[wikipedia:Reproduction|Reproduction]]
|-
|Social behavior
|The social behavior of creatures
|[[wikipedia:Social behavior|Social behavior]]
|-
|Physical taxonomy
|The classification of creatures by their physical features
|[[wikipedia:Taxonomy (biology)|Taxonomy (biology)]]
|-
|Climactic adaptation
|The way that creatures are suited to the climates in which they live
|[[wikipedia:Climatic adaptation|Climatic adaptation]]
|-
|Comparative anatomy
|
|[[wikipedia:Comparative anatomy|Comparative anatomy]]
|-
|Food chain
|
|[[wikipedia:Food chain|Food chain]]
|-
|Struggle for existence
|The struggle for survival among creatures
|[[wikipedia:Struggle for existence|Struggle for existence]]
|}

==Philosophy==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Nature of beauty
|Discourse on the nature of beauty
|[[wikipedia:Beauty (ancient thought)|Beauty (ancient thought)]]
|-
|Value of art
|
|[[wikipedia:Aesthetics|Aesthetics]]
|-
|Belief
|Discourse on the nature of belief
|[[wikipedia:Epistemology#Belief|Epistemology § Belief]]
|-
|Justification
|Discourse on the nature of justification
|[[wikipedia:Epistemology#Justification|Epistemology § Justification]]
|-
|Perception
|Discourse on the nature of perception
|[[wikipedia:Philosophy of perception|Philosophy of perception]]
|-
|Truth
|
|[[wikipedia:Epistemology#Truth|Epistemology § Truth]]
|-
|Individual value
|Discourse on the meaning of individual happiness
|[[wikipedia:Value (ethics)#Personal values|Value (ethics) § Personal values]]
|-
|State consequentialism
|Discourse on ethics as it regards the benefit of the state
|[[wikipedia:State consequentialism|State consequentialism]]
|-
|Interpersonal Ethics
|Discourse on ethics as applied to interpersonal conduct
|
|-
|Medical
|Discourse on medical ethics
|[[wikipedia:Medical ethics|Medical ethics]]
|-
|Military
|Discourse on ethics as applied to war
|[[wikipedia:Ethics#Military ethics|Ethics § Military ethics]]
|-
|Analogical inference
|
|[[wikipedia:Argument from analogy|Argument from analogy]]
|-
|Deductive reasoning
|Deductive reasoning
|[[wikipedia:Deductive reasoning|Deductive reasoning]]
|-
|Dialectic reasoning
|
|[[wikipedia:Dialectic|Dialectic]]
|-
|Direct inference
|
|[[wikipedia:Statistical syllogism|Statistical syllogism]]
|-
|Formal reasoning
|Formal reasoning
|[[wikipedia:Reason|Reason]]
|-
|Hypothetical syllogisms
|Hypothetical syllogisms
|[[wikipedia:Hypothetical syllogism|Hypothetical syllogism]]
|-
|Inductive reasoning
|
|[[wikipedia:Inductive reasoning|Inductive reasoning]]
|-
|Propositional logic
|
|[[wikipedia:Propositional calculus|Propositional calculus]]
|-
|Syllogistic logic
|Syllogistic logic
|[[wikipedia:Syllogism|Syllogism]]
|-
|Causation
|The nature of causation
|[[wikipedia:Causality|Causality]]
|-
|Events
|Discourse on the nature of events
|[[wikipedia:Event (philosophy)|Event (philosophy)]]
|-
|Existence
|
|[[wikipedia:Existence|Existence]]
|-
|Mind body
|Discourse on the nature of mind and body
|[[wikipedia:Mind–body problem|Mind–body problem]]
|-
|Objects and properties
|
|[[wikipedia:Essence|Essence]]
|-
|Processes
|
|[[wikipedia:Process philosophy|Process philosophy]]
|-
|Time
|Discourse on the nature of time
|[[wikipedia:Time|Time]]
|-
|Wholes and parts
|The relationship between wholes and parts
|[[wikipedia:Mereology|Mereology]]
|-
|Education
|Education, its forms and recommendations
|[[wikipedia:Education|Education]]
|-
|Dictionary
|Dictionaries
|[[wikipedia:Dictionary|Dictionary]]
|-
|Etymology
|The notion of etymology
|[[wikipedia:Etymology|Etymology]]
|-
|Grammar
|Grammar
|[[wikipedia:Grammar|Grammar]]
|-
|Law
|Discourse on law
|[[wikipedia:Law|Law]]
|-
|Diplomacy
|Discourse on diplomacy
|[[wikipedia:Diplomacy|Diplomacy]]
|-
|Economic policy
|Discourse on economic policy
|[[wikipedia:Economic policy|Economic policy]]
|-
|Government forms
|Discourse on government
|[[wikipedia:Government|Government]]
|-
|Social welfare
|Discourse on social welfare
|[[wikipedia:Welfare|Welfare]]
|}
{{Category|World}}

Plant token

2016-03-02T19:12:36Z

FortressBuilder: /* Shrub Tokens */ Merge season tokens into one table row (descriptions are mostly the same)

{{Quality|Fine|11:40, 18 May 2015 (UTC)}}
{{av}}
The default plants are stored in the plant_standard.txt file, while grasses are stored in plant_grasses.txt.

==Basic Tokens==
These tokens are specified for all plants and define their most basic characteristics.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|NAME}}
|
*name
| The singular form of the plants name as seen in game.

|-
| {{text anchor|NAME_PLURAL}}
|
*name
| The plural form of the plants name as seen in game.

|-
| {{text anchor|ADJ}}
|
*adjective
| The word or phrase used to describe items made from this plant.

|-
| {{text anchor|ALL_NAMES}}
|
*name
| Sets the NAME, NAME_PLURAL, and ADJ to the specified string.

|-
| {{text anchor|PREFSTRING}}
|
*reason
| What dwarves can like this object for (e.g. "Urist likes plump helmets for their rounded tops.")

|-
| {{text anchor|MATERIAL}}
|
*material_name
| Starts defining a new local plant material with the given name and '''no''' properties.

|-
| {{text anchor|USE_MATERIAL}}
|
*material_name
*old_material
| Starts defining a new local plant material with the given name and using the properties of another local plant material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
|
*material_name
*template_name
| Starts defining a new local plant material with the given name and using the properties of the specified material template.

|-
| {{text anchor|BASIC_MAT}}
|
* [[Material token|material]]
| Sets the basic material of the plant. According to Toady, you can use other materials (for instance, iron) but the game may hiccup on plants that aren't structurally plants. For crops, said material should have [STRUCTURAL_PLANT_MAT] to permit proper stockpiling. Generally, this should be "LOCAL_PLANT_MAT:material_name", using a material defined using MATERIAL, USE_MATERIAL, or USE_MATERIAL_TEMPLATE.
|}

==Environment Tokens==
These tokens, also applicable to all plants, specify where the plants grow.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|UNDERGROUND_DEPTH}}
|
*minimum
*maximum
| Designates the highest and lowest cavern levels that the plant can appear in if its [[biome token|biome]] is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that are available at depth 1. Defaults to 0:0 (surface only).

|-
| {{text anchor|GOOD}}
|
| Restricts the plant to growing in Good regions. Cannot be combined with [EVIL].

|-
| {{text anchor|EVIL}}
|
| Restricts the plant to growing in Evil regions. Cannot be combined with [GOOD].

|-
| {{text anchor|SAVAGE}}
|
| Restricts the plant to growing in Savage regions (regardless of alignment).

|-
| {{text anchor|FREQUENCY}}
|
*freq (0-100)
| How frequently this plant is generated in a particular area. Defaults to 50. Plants with valid [[biome token]]s and [FREQUENCY:0] will not grow in the wild, but will still be available for entity use and farm plots.

|-
| {{text anchor|WET}}
|
| Allows the plant to grow near water features.

|-
| {{text anchor|DRY}}
|
| Allows the plant to grow away from water features.

|-
| {{text anchor|BIOME}}
|
*biome
| What [[biome token|biome]] this plant appears in.

|}

==Growth Tokens==
These tokens are used for all plants and specify growths growing on a plant.

Edible or otherwise usable growths should have [STOCKPILE_PLANT_GROWTH] in their [[material definition token|material definitions]] for proper stockpiling. This also lets them be collected from plant gathering and farming jobs.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|GROWTH}}
|
*name
| Defines a plant growth. Takes the below tokens as arguments.

|-
| {{text anchor|GROWTH_NAME}}
|
*singular
*plural (STP for standard plural)
| The name of a plant growth.

|-
| {{text anchor|GROWTH_ITEM}}
|
* [[item token]]
* [[material token]]
| Specifies what item this growth is and what it is made of. Generally, the item type should be PLANT_GROWTH:NONE.

|-
| {{text anchor|GROWTH_HOST_TILE}}
|
*plant part
| Specifies on which part of the plant or tree the growth appears, usually for multi-tile [[tree]]s. Valid tokens are:
*TWIGS
*BRANCHES_AND_TWIGS / LIGHT_BRANCHES_AND_TWIGS
*BRANCHES / LIGHT_BRANCHES
*ALL_BRANCHES_AND_TWIGS
*HEAVY_BRANCHES / DIRECTED_BRANCHES
*HEAVY_BRANCHES_AND_TRUNK / DIRECTED_BRANCHES_AND_TRUNK
*TRUNK
*ROOTS
*CAP
*SAPLING

|-
| {{text anchor|GROWTH_TRUNK_HEIGHT_PERC}}
|
*integer:integer
|

|-
| {{text anchor|GROWTH_DENSITY}}
|
*integer
| Currently has no effect.

|-
| {{text anchor|GROWTH_TIMING}}
|
*[[time]] ticks (0-403200)
| Specifies at which part of the year the growth appears. Default is all year round.

A single growth can only have one GROWTH_TIMING tag. If multiple are declared, the last one will be used. To make a growth appear multiple times during the year, you need to create a different growth for every GROWTH_TIMING interval. By using the same material for all of the duplicate growths, all of them will be stockpiled together and be eligible for the same reactions. Edible/brewable growths will have separate entries in the kitchen menu, though.

There is no known way to declare a growth timing that lasts from winter into spring. Including numbers below 0 or above 403200 in the range will make the growth available at all times, as though you hadn't defined a growth timing at all. So will including a range for which the start time is later than the end time.

|-
| {{text anchor|GROWTH_PRINT}}
|
*overworld tile
*item tile
*colour
*timing (0-403200), ALL or NONE
*priority
| Specifies the appearance of the growth. Can be specified more than once, for example for autumn leaves. Transitions between different timing periods will happen gradually over the course of 2000 ticks.

The GROWTH_PRINT tile will only be displayed when the growth in question is actually present, even if its timing parameter is ALL.

|-
| {{text anchor|GROWTH_HAS_SEED}}
|
| The growth drops a seed if eaten raw.

|-
| {{text anchor|GROWTH_DROPS_OFF}}
|
| Growths drop from the plant, producing a cloud of items which fall on the ground, which [[herbalist]]s can collect.
|-
| {{text anchor|GROWTH_DROPS_OFF_NO_CLOUD}}
|
| Growths drop collectable items from the plant without producing item clouds.

|}

==Tree Tokens==
These tokens are used only for trees.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|TREE}}
|
* [[Material token|material]] or NONE
| Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material. Setting the material to NONE will give no wood from this tree.

|-
| {{text anchor|TRUNK_NAME}}
|
*name
| What the trunk of the tree is named.

|-
| {{text anchor|MAX_TRUNK_HEIGHT}}
|
*1-8
| The maximum z-level height of a mature tree's trunk, starting from about two z-levels above ground and going up.

|-
| {{text anchor|MAX_TRUNK_DIAMETER}}
|
*1-3
| Upper limit of trunk thickness, in tiles. Counted separately for all branching trunks. Has a geometric effect on log yield.

|-
| {{text anchor|TRUNK_PERIOD}}
|
*integer
| The number of years the trunk takes to grow one Z-level upward.

|-
| {{text anchor|TRUNK_WIDTH_PERIOD}}
|
*integer
| The number of years the trunk takes to grow another tile wider.

|-
| {{text anchor|LIGHT_BRANCHES_NAME}}
|
*name
| What thin branches of the tree are named.

|-
| {{text anchor|BRANCH_DENSITY}} / {{text anchor|LIGHT_BRANCHES_DENSITY}}
|
*integer
| How dense the branches grow on this tree.

|-
| {{text anchor|BRANCH_RADIUS}} / {{text anchor|LIGHT_BRANCH_RADIUS}}
|
*integer
| The radius to which branches can reach. Appears to never reach further than seven tiles from the centre. Does not depend on the trunk branching amount or where trunks are.

|-
| {{text anchor|HEAVY_BRANCHES_NAME}} / {{text anchor|DIRECTED_BRANCHES_NAME}}
|
*name
| What thick branches of the tree are named.

|-
| {{text anchor|HEAVY_BRANCH_DENSITY}} / {{text anchor|DIRECTED_BRANCH_DENSITY}}
|
*integer
| Similar to BRANCH_DENSITY for thick branches.

|-
| {{text anchor|HEAVY_BRANCH_RADIUS}} / {{text anchor|DIRECTED_BRANCH_RADIUS}}
|
*integer
| Similar as BRANCH_RADIUS for thick branches.

|-
| {{text anchor|TRUNK_BRANCHING}}
|
*integer
| How much the trunk branches out. 0 makes the trunk straight.

|-
| {{text anchor|ROOT_NAME}} / {{text anchor|ROOTS_NAME}}
|
*name
| What the roots of the tree are named.

|-
| {{text anchor|ROOT_DENSITY}}
|
*integer
| Density of the root growth.

|-
| {{text anchor|ROOT_RADIUS}}
|
*integer
| How wide the roots reach out.

|-
| {{text anchor|TWIGS_NAME}}
|
*name
| What the twigs of the tree are named.

|-
| {{text anchor|TWIGS_SIDE_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear on the side of branches. Defaults to 1.

|-
| {{text anchor|TWIGS_ABOVE_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear above branches. Defaults to 1.

|-
| {{text anchor|TWIGS_BELOW_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear below branches. Defaults to 0.

|-
| {{text anchor|TWIGS_SIDE_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear on the side of heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_ABOVE_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear above heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_BELOW_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear below heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_SIDE_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear on the side of the trunk. Defaults to 0.

|-
| {{text anchor|TWIGS_ABOVE_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear above the trunk. Defaults to 0.

|-
| {{text anchor|TWIGS_BELOW_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear below the trunk. Defaults to 0.

|-
| {{text anchor|TREE_HAS_MUSHROOM_CAP}}
|
| The tree has a rounded cap-hood like a giant mushroom. This severely stunts a tree's maximum height - see the [http://www.bay12games.com/dwarves/mantisbt/view.php?id=7313#c26413 bug report.]

|-
| {{text anchor|CAP_NAME}}
|
*name
| What this mushroom-cap is called. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|CAP_PERIOD}}
|
*integer
| Similar to the other PERIOD tags, influences the rate of the mushroom cap growth. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|CAP_RADIUS}}
|
*integer
| The radius of a mushroom cap. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|STANDARD_TILE_NAMES}}
|
| Uses the standard names for the tree components (roots, trunk, branches, etc.)

|-
| {{text anchor|TREE_TILE}}
|
*tile
| The tile used for trees of this type on the world map. Defaults to 24 (↑).

|-
| {{text anchor|DEAD_TREE_TILE}}
|
*tile
| The tile used for (un)dead trees and deciduous trees (generally in winter) of this type. Defaults to 198 (╞).

|-
| {{text anchor|SAPLING_TILE}}
|
*tile
| The tile used for saplings of this tree. Defaults to 231 (τ).

|-
| {{text anchor|DEAD_SAPLING_TILE}}
|
*tile
| The tile used for dead saplings of this tree. Defaults to 231 (τ).

|-
| {{text anchor|TREE_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the tree on the map. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_TREE_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the tree on the map when (un)dead. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SAPLING_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of saplings of this tree. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SAPLING_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of dead saplings of this tree. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SAPLING_DROWN_LEVEL}}
|
*depth
| The water depth at which saplings of this tree will drown. Exact behavior is unknown. Defaults to 4.

|-
| {{text anchor|TREE_DROWN_LEVEL}}
|
*depth
| The water depth at which this tree will drown. Exact behavior is unknown. Defaults to 7.

|-
| {{text anchor|SAPLING}}
|
| Makes young versions of the tree be called "[tree name] sapling"; otherwise, they are called "young [tree name]".

|}

==Shrub Tokens==
These tokens are used for non-grass, non-tree plants.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|SPRING}}, {{text anchor|SUMMER}}, {{text anchor|AUTUMN}}, {{text anchor|WINTER}}
|
| Allows the plant to grow in farm plots during the given season.

If the plant is a surface plant, allows it to grow in the wild during this season; wild surface plants without this token will disappear at the beginning of the season. Underground plants grow wild in all seasons, regardless of their season tokens.

|-
| {{text anchor|GROWDUR}}
|
*time
| How long the plant takes to grow to harvest in a farm plot. Unit hundreds of ticks, See [[Time]]. There are 1008 GROWDUR units in a season. Defaults to 300.

|-
| {{text anchor|VALUE}}
|
*value
| Has no known effect. Previously set the value of the harvested plant.

|-
| {{text anchor|PICKED_TILE}}
|
*tile
| The tile used when the plant is harvested whole, or is ready to be picked from a farm plot. May either be a cp437 tile number, or a character between single quotes. See [[Main:character table|character table]]. Defaults to 231 (τ).

|-
| {{text anchor|DEAD_PICKED_TILE}}
|
*tile
| The tile used when a plant harvested whole has wilted. Defaults to 169 (⌐).

|-
| {{text anchor|SHRUB_TILE}}
|
*tile
| The tile used to represent this plant when it is wild, alive, and has no growths. Defaults to 34 (").

|-
| {{text anchor|DEAD_SHRUB_TILE}}
|
*tile
| The tile used to represent this plant when it is dead in the wild. Defaults to 34 (").

|-
| {{text anchor|CLUSTERSIZE}}
|
*size
| The maximum stack size collected when gathered via herbalism (possibly also from farm plots?). Defaults to 5.

|-
| {{text anchor|PICKED_COLOR}}
|
*foreground
*background
*bright
| The color of the plant when it has been picked whole, or when it is ready for harvest in a farm plot. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_PICKED_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant when it has been picked whole, but has wilted. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SHRUB_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant when it is alive, wild, and has no growths. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SHRUB_COLOR}}
|
*foreground
*background
*bright
|The [[color]] of the plant when it is dead in the wild. Defaults to 6:0:0 (brown).

|-
| {{text anchor|SHRUB_DROWN_LEVEL}}
|
*depth
| The water depth at which this plant will drown. Exact behavior is unknown. Defaults to 4.

|-
| {{text anchor|DRINK}}
|
* [[Material token|material]]
| Names a [[alcohol|drink]] made from the plant, allowing it to be used in entity resources. Previously also permitted brewing the plant into [[alcohol]] made of this material. Now, a MATERIAL_REACTION_PRODUCT of type DRINK_MAT should be used on the proper plant material.

|-
| {{text anchor|MILL}}
|
* [[Material token|material]]
| Permits milling the plant at a [[quern]] or [[millstone]] into a powder made of this material and allows its use in entity resources. Said material should have [POWDER_MISC_PLANT] to permit proper stockpiling.

|-
| {{text anchor|THREAD}}
|
* [[Material token|material]]
| Permits processing the plant at a [[farmer's workshop]] to yield threads made of this material and allows its use in entity resources. Said material should have [THREAD_PLANT] to permit proper stockpiling.

|-
| {{text anchor|SEED}}
|
*name
*name_plural
*foreground
*background
*bright
*[[Material token|material]]
| Causes the plant to yield plantable seeds made of this material and having these properties. Said material should have [SEED_MAT] to permit proper stockpiling.

|-
| {{text anchor|EXTRACT_STILL_VIAL}}
|
* [[Material token|material]]
| Permits processing the plant into a [[vial]] at a [[still]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK].

|-
| {{text anchor|EXTRACT_VIAL}}
|
*[[Material token|material]]
| Permits processing the plant into a [[vial]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK].

|-
| {{text anchor|EXTRACT_BARREL}}
|
* [[Material token|material]]
| Permits processing the plant into a [[barrel]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:BARREL].

|}

==Grass Tokens==
These tokens are used only for [[grass]]es.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|GRASS}}
|
| Makes the plant behave as a type of grass. This allows animals to graze on it, and prevents it and its growths from being picked by herbalists. (Grass growths can still be picked in adventure mode, however.)

|-
| {{text anchor|GRASS_TILES}}
|
*tile
*tile
*tile
*tile
| Specifies the 4 tiles used to represent grass of this type. If VARIED_GROUND_TILES is disabled in d_init.txt, these are seemingly ignored. Defaults to 46:44:96:39 (.,`').

|-
| {{text anchor|ALT_PERIOD}}
|
*period
*offset
| How often the grass switches between its main tiles and alternate tiles. The "period" value determines how quickly (in frames) the grass animates, and the "offset" value specifies how much of that time is spent displaying the alternate tiles. If the "offset" value is greater than or equal to the "period" value, the grass will only display using the alternate tiles.{{verify}} Defaults to 0:0.

|-
| {{text anchor|ALT_GRASS_TILES}}
|
*tile
*tile
*tile
*tile
| When used with ALT_PERIOD, specifies the 4 alternate tiles used to represent grass of this type. Defaults to 46:44:96:39 (.,`'). Dead grass does not animate.

|-
| {{text anchor|GRASS_COLORS}}
|
*color 1 (fore:back:bright)
*color 2 (fore:back:bright)
*dry color (fore:back:bright)
*dead color (fore:back:bright)
| Specifies the color of this grass. Defaults to 2:0:1:2:0:0:6:0:1:6:0:0 (light green, dark green, yellow, brown).
|}

{{Category|Modding}}
{{Category|Tokens}}

Topic

2016-02-28T12:44:09Z

FortressBuilder: /* Mathematics */ Some more names

{{Quality|Superior|06:10, 17 May 2015 (UTC)}}
{{av}}

{{new in v0.42}}
{{Expand Topic}}

[[File:Topics.svg|thumb|A diagram of all knowledge topics.]]

'''Topics''' (also '''Tech''' or '''Innovations''') are part of [[knowledge]].

There are around 300 innovations that can be discovered. Many of them have requirements, and many do not, so it's kind of a tech forest/grassland rather than a tree. Notably missing are innovations related to practical labors in the game (which will be added later in development).

Several innovations require innovations from other branches, and since all knowledge is individually tracked, that implies some investigators will need to be at least well-read if not skilled in various topics (there aren't currently joint research projects). There are some old and new mechanisms in place to ensure this happens.

There are 9 "branches" of the knowledge system.
==Astronomy==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Dates of lunar and solar eclipses
|
|[[wikipedia:Saros (astronomy)|Saros (astronomy)]]
|-
|Daylight variation with solar year
|The variation of daylight with the season
|[[wikipedia:Daytime#Daytime variations with latitude and seasons|Daytime § Daytime variations with latitude and seasons]]
|-
|Geocentrism
|The theory that the sun moves around the world
|[[wikipedia:Geocentric model|Geocentric model]]
|-
|Height of tides vs moon and sun
|The height of the tides, the moon and the sun
|[[wikipedia:Pytheas#Pytheas_on_the_tides|Pytheas § Pytheas_on_the_tides]] and [[wikipedia:Tide|Tide]]
|-
|Heliocentrism
|The theory that the world moves around the sun
|[[wikipedia:Heliocentric model|Heliocentric model]]
|-
|Empirical observation
|Methods of empirical observation in astronomy
|[[wikipedia:Empirical evidence|Empirical evidence]]
|-
|Path models
|
|[[wikipedia:Orbit modeling|Orbit modeling]]
|-
|Path of the moon
|The path of the moon
|[[wikipedia:Orbit of the Moon|Orbit of the Moon]]
|-
|Phases of the moon
|The phases of the moon
|[[wikipedia:Lunar phase|Lunar phase]]
|-
|Precession of equinoxes
|
|[[wikipedia:Axial precession|Axial precession]]
|-
|Relationship between lunar solar year
|The relationship between the lunar and solar year
|[[wikipedia:Lunisolar calendar|Lunisolar calendar]]
|-
|Shape of the world
|
|[[wikipedia:Spherical Earth|Spherical Earth]]
|-
|Star catalogues 100
|
|[[wikipedia:Star catalogue|Star catalogue]]
|-
|Star catalogues 1000
|
|[[wikipedia:Star catalogue|Star catalogue]]
|-
|Astrography
| The creation of star charts
|[[wikipedia:Star chart|Star chart]]
|-
|Stellar Spectroscopy
|The classification of stars based on the light they emit
|[[wikipedia:Astronomical spectroscopy|Astronomical spectroscopy]]
|-
|Star magnitude classification
|
|[[wikipedia:Magnitude (astronomy)|Magnitude (astronomy)]]
|-
|Summer winter moon
|The rise of the moon according to the season
|[[wikipedia:Lunar calendar|Lunar calendar]]
|-
|Summer winter sun
| The rise of the sun according to the season
|[[wikipedia:Solar calendar|Solar calendar]]
|-
|Tides and the moon
| The relationship between the moon and the tides
|[[wikipedia:Seleucus_of_Seleucia#Tides|Seleucus_of_Seleucia § Tides]] and [[wikipedia:Tide|Tide]]
|}

==Chemistry==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Adhesives
|The preparation and use of adhesive materials
|[[wikipedia:Adhesive|Adhesive]]
|-
|Aqua regia
|The preparation of aqua regia
|[[wikipedia:Aqua regia|Aqua regia]]
|-
|Spirit of niter
|The preparation of spirit of niter
|[[wikipedia:Nitric acid|Nitric acid]]
|-
|Oil of vitriol
|The preparation of oil of vitriol
|[[wikipedia:Sulfuric acid|Sulfuric acid]]
|-
|Alkali and acids
|The classification of alkali and acids
|[[wikipedia:pH|pH]]
|-
|Combustibles
|The classification of combustible materials
|[[wikipedia:Combustibility|Combustibility]]
|-
|Elemental theory
|The classification of materials based on which elemental materials might form them
|[[wikipedia:Chemical element|Chemical element]]
|-
|Ores
|The classification of ores
|[[wikipedia:Ore|Ore]]
|-
|Scratch test
|
|[[wikipedia:Scratch hardness|Scratch hardness]]
|-
|Alembic
|The construction and use of the alembic
|[[wikipedia:Alembic|Alembic]]
|-
|Blast furnace
|The construction and use of the blast furnace
|[[wikipedia:Blast furnace|Blast furnace]]
|-
|Crucible
| The construction and use of the crucible
|[[wikipedia:Crucible|Crucible]]
|-
|Ampoule
|The construction and use of the ampoule
|[[wikipedia:Ampoule|Ampoule]]
|-
|Beaker
| The construction and use of the beaker
|[[wikipedia:Beaker|Beaker]]
|-
|Flask
|
|[[wikipedia:Flask|Flask]]
|-
|Funnel
|The construction and use of the funnel
|[[wikipedia:Funnel|Funnel]]
|-
|Retort
|The construction and use of the retort
|[[wikipedia:Retort|Retort]]
|-
|Vial
|The construction and use of the vial
|[[wikipedia:Vial|Vial]]
|-
|Lab ovens
|The construction and use of laboratory ovens
|[[wikipedia:Laboratory oven|Laboratory oven]]
|-
|Systematic experiments
|Methods for performing experiments systematically in the laboratory
|[[wikipedia:Scientific method|Scientific method]]
|-
|Theory of distillation
|The theory and methods involved in distillation
|[[wikipedia:Distillation|Distillation]]
|-
|Theory of evaporation
|The theory and methods involved in evaporation
|[[wikipedia:Evapotation|Evapotation]]
|-
|Theory of liquid liquid extraction
|The theory and methods involved in the extraction of a constituent liquid from one solution to another
|[[wikipedia:Liquid–liquid extraction|Liquid–liquid extraction]]
|-
|Alloys
| The mixture of metals to produce alloys
|[[wikipedia:Alloy|Alloy]]
|}

==Engineering==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Armillary sphere
|The construction and use of armillary spheres
|[[wikipedia:Armillary sphere|Armillary sphere]]
|-
|Astrolabe
|The construction and use of the astrolabe
|[[wikipedia:Astrolabe|Astrolabe]]
|-
|Dioptra
|The construction and use of the dioptra
|[[wikipedia:Dioptra|Dioptra]]
|-
|Mural instrument
|
|[[wikipedia:Mural instrument|Mural instrument]]
|-
|Orrery
|
|[[wikipedia:Orrery|Orrery]]
|-
|Spherical astrolabe
|
|[[wikipedia:Armillary sphere|Armillary sphere]]
|-
|Wood lamination
|The use of lamination
|[[wikipedia:Lamination|Lamination]]
|-
|Models and templates
|The use of models and templates in engineering
|[[wikipedia:Prototype|Prototype]] and [[wikipedia:Stencil|Stencil]]
|-
|Archimedes principle
|
|[[wikipedia:Archimedes' principle|Archimedes' principle]]
|-
|Force pump
|
|[[wikipedia:Piston pump#Force pump|Piston pump § Force pump]]
|-
|Theory of siphon
|The action of the siphon
|[[wikipedia:Siphon|Siphon]]
|-
|Valves
|The construction and use of valves
|[[wikipedia:Valve|Valve]]
|-
|Astrarium
|
|[[wikipedia:Astrarium|Astrarium]]
|-
|Conical water clock
|
|
|-
|Hourglass
|
|[[wikipedia:Hourglass|Hourglass]]
|-
|Mechanical clock
|
|[[wikipedia:Clock#Early mechanical clocks|Clock § Early mechanical clocks]]
|-
|Shadow clock
|The use of shadows to tell direction and time
|[[wikipedia:Sundial|Sundial]]
|-
|Water clock
|The use of water-based devices to tell time
|[[wikipedia:Water clock|Water clock]]
|-
|Water clock reservoir
|The use of reservoirs in water-based clocks to improve their accuracy
|[[wikipedia:Zhang_Heng#Extra_tank_for_inflow_clepsydra|Zhang Heng § Extra tank for inflow clepsydra]]
|-
|Balance wheel
|
|[[wikipedia:Balance wheel|Balance wheel]]
|-
|Bellows
|The construction and use of the bellows
|[[wikipedia:Bellows|Bellows]]
|-
|Camshaft
|
|[[wikipedia:Camshaft|Camshaft]]
|-
|Chain drive
|The construction and use of chain drives
|[[wikipedia:Chain drive|Chain drive]]
|-
|Chariot odometer
|
|[[wikipedia:Odometer|Odometer]]
|-
|Combination lock
|
|[[wikipedia:Combination lock|Combination lock]]
|-
|Crank
|
|[[wikipedia:Crank (mechanism)|Crank (mechanism)]]
|-
|Crankshaft
|
|[[wikipedia:Crankshaft|Crankshaft]]
|-
|Differential gear
|
|[[wikipedia:Differential (mechanical device)|Differential (mechanical device)]]
|-
|Double acting piston bellows
|
|[[wikipedia:Bellows|Bellows]]
|-
|Lever
|The construction and use of the lever
|[[wikipedia:Lever|Lever]]
|-
|Mechanical compass
|
|[[wikipedia:Compass|Compass]]
|-
|Padlock
|The construction and use of the padlock
|[[wikipedia:Padlock|Padlock]]
|-
|Piston
|
|[[wikipedia:Piston pump#Force pump|Piston pump § Force pump]]
|-
|Pulley
|The construction and use of the pulley
|[[wikipedia:Pulley|Pulley]]
|-
|Screw
|The construction and use of the screw
|[[wikipedia:Screw|Screw]]
|-
|Straight beam balance
|The construction and use of the straight-beam balance
|[[wikipedia:Weighing scale#Mechanical balances|Weighing scale § Mechanical balances]]
|-
|Theory of gears
|The reasons why gears are effective
|[[wikipedia:Gear|Gear]]
|-
|Theory of lever
|The reasons why the lever is effective
|[[wikipedia:Lever|Lever]]
|-
|Theory of pulley
|The reasons why pulleys are effective
|[[wikipedia:Pulley|Pulley]]
|-
|Theory of screw
|The reasons why screws are effective
|[[wikipedia:Screw|Screw]]
|-
|Theory of wedge
|The reasons why the wedge is effective
|[[wikipedia:Wedge|Wedge]]
|-
|Theory of wheel and axle
|The reasons why the wheel-and-axle construction is effective
|[[wikipedia:Wheel and axle|Wheel and axle]]
|-
|Trip hammer
|
|[[wikipedia:Trip hammer|Trip hammer]]
|-
|Tumbler lock
|The construction and use of the tumbler lock
|[[wikipedia:Pin tumbler lock|Pin tumbler lock]]
|-
|Verge escapement
|The construction and use of the verge escapement
|[[wikipedia:Verge escapement|Verge escapement]]
|-
|Warded lock
|The construction and use of the warded lock
|[[wikipedia:Warded lock|Warded lock]]
|-
|Water powered piston bellows
|
|[[wikipedia:Du_Shi#The_Water-Powered_Blast_Furnace|Du Shi § The Water-Powered Blast Furnace]]
|-
|Water powered sawmill
|
|[[wikipedia:Watermill|Watermill]]
|-
|Water powered trip hammer
|
|[[wikipedia:Trip hammer|Trip hammer]] and [[wikipedia:Water wheel|Water wheel]]
|-
|Water wheel
|
|[[wikipedia:Water wheel|Water wheel]]
|-
|Windlass
| The construction and use of the windlass
|[[wikipedia:Windlass|Windlass]]
|-
|Atmospheric refraction
|
|[[wikipedia:Atmospheric refraction|Atmospheric refraction]]
|-
|Camera obscura
|The construction and use of the camera obscura
|[[wikipedia:Camera obscura|Camera obscura]]
|-
|Cause of twilight
|
|[[wikipedia:Atmospheric optics|Atmospheric optics]]
|-
|Crystal lens
|The construction and use of the crystal lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:Crystal|Crystal]]
|-
|Glass lens
|The construction and use of the glass lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:Glass|Glass]]
|-
|Height of atmosphere
|
|
|-
|Law of refraction
|
|[[wikipedia:Snell's law|Snell's law]]
|-
|Parabolic mirror
|
|[[wikipedia:Parabolic reflector|Parabolic reflector]]
|-
|Theory of color
|
|[[wikipedia:Color theory|Color theory]]
|-
|Theory of rainbows
|
|[[wikipedia:Rainbows|Rainbows]]
|-
|Water filled spheres
|The construction and use of water-filled sphere as a lens
|[[wikipedia:Lens (optics)|Lens (optics)]] and [[wikipedia:History_of_optics#Early_history_of_optics|History of optics § Early history of optics]]
|}

==Geography==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Accurate maps
|
|[[wikipedia:Map|Map]]
|-
|Cartography
|The process involved in creating maps
|[[wikipedia:Cartography|Cartography]]
|-
|Distance scale
|
|[[wikipedia:Scale (map)|Scale (map)]]
|-
|Economic
|The placement of economic information on maps
|[[wikipedia:Economic geography|Economic geography]]
|-
|Geological
|The placement of geological information on maps
|[[wikipedia:Geologic map|Geologic map]]
|-
|Grid system
|
|[[wikipedia:Grid reference|Grid reference]]
|-
|Height measurements
|
|[[wikipedia:Topographic map|Topographic map]] and [[wikipedia:Levelling|Levelling]]
|-
|Map projections
|
|[[wikipedia:Map projection|Map projection]]
|-
|Atlases
|The collection of maps and other information together into a single text
|[[wikipedia:Atlas|Atlas]]
|-
|Econometrics
|The process of economic data collection
|[[wikipedia:Econometrics|Econometrics]]
|-
|Surveying
|The process of surveying land
|[[wikipedia:Surveying|Surveying]]
|-
|Cartographical surveying
|
|[[wikipedia:Cartography|Cartography]] and [[wikipedia:Surveying|Surveying]]
|-
|Engineering surveying
|
|[[wikipedia:Construction surveying|Construction surveying]]
|-
|Land surveying
|
|[[wikipedia:Cadastral surveying|Cadastral surveying]]
|-
|Military surveying
|
|[[wikipedia:Construction surveying|Construction surveying]] and [[wikipedia:Military engineerin|Military engineering]]
|-
|Surveying staff
|The construction and use of the surveying staff
|[[wikipedia:Level staff|Level staff]]
|-
|Triangulation
|
|[[wikipedia:Triangulation|Triangulation]]
|-
|Delta formation
|The process of the formation of deltas at the mouths of rivers
|[[wikipedia:River delta#Formation|River delta § Formation]]
|-
|Latitude climate zones
|
|[[wikipedia:Clime|Clime]]
|-
|Origin of rainfall from evap condense
|The origin of rainfall through evaporation and condensation
|[[wikipedia:Evaporation|Evaporation]] and [[wikipedia:Condensation|Condensation]]
|-
|Water cycle
|A world-wide cycle involving precipitation, oceans, rivers, and other forms of water
|[[wikipedia:Water cycle|Water cycle]]
|-
|Anemology
|The forces that govern wind patterns
|[[wikipedia:Global wind patterns|Global wind patterns]]
|}

==History==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Alternate history
|The exploration of how history would be different if some key past events had transpired differently
|[[wikipedia:Alternate history|Alternate history]]
|-
|Autobiographical adventure
|The method of writing a biography of oneself, particularly as it concerns a military campaign or adventure
|[[wikipedia:Autobiography|Autobiography]]
|-
|Biographical dictionaries
|The compilation of brief biographies into one large collection
|[[wikipedia:Biographical dictionary|Biographical dictionary]]
|-
|Biography
|The method of writing the history of a single individual
|[[wikipedia:Biography|Biography]]
|-
|Comparative biography
|The method of compiling several biographies to compare and contrast the subjects' character and to gain insight into history
|
|-
|Comparative anthropology
|The method of comparing and contrasting different cultures
|[[wikipedia:Cross-cultural studies|Cross-cultural studies]]
|-
|Cultural history
|The method of accurately and comprehensively describing cultures and civilizations
|[[wikipedia:Cultural history|Cultural history]]
|-
|Encyclopedia
|
|[[wikipedia:Encyclopedia|Encyclopedia]]
|-
|Genealogy
|The compilation of family lineages and methods of displaying them artfully
|[[wikipedia:Genealogy|Genealogy]]
|-
|Treatise on tech evolution
|
|[[wikipedia:Technological evolution|Technological evolution]]
|-
|Archaeology
|The method of collecting and evaluating artifacts to learn about history and culture
|[[wikipedia:Archaeology|Archaeology]]
|-
|Source reliability
|The reliability of sources
|[[wikipedia:Source criticism|Source criticism]]
|-
|Personal interviews
|Using personal interviews as sources
|[[wikipedia:Interview|Interview]]
|-
|Role of cultural differences
| The role of cultural differences in source reliability and interpretation
|[[wikipedia:Cultural relativism|Cultural relativism]]
|-
|Role of state bias and propaganda
|
|[[wikipedia:Propaganda|Propaganda]]
|-
|Role of systemic bias
|
|[[wikipedia:Systemic bias|Systemic bias]]
|-
|Historical causation
|The causes of historical events
|[[wikipedia:Causality#History|Causality § History]]
|-
|Historical cycles
|The notion of historical, governmental and social cycles
|[[wikipedia:Cyclic history|Cyclic history]]
|-
|Sociology
|The notion of bonds between members of a community
|[[wikipedia:Sociology|Sociology]]
|-
|Social conflict
|
|[[wikipedia:Social conflict|Social conflict]]
|}

==Mathematics==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Equations
|The technique of balancing and completion for solving equations
|[[wikipedia:The Compendious Book on Calculation by Completion and Balancing|The Compendious Book on Calculation by Completion and Balancing]], [[wikipedia:Algebra|Algebra]] and [[wikipedia:Equation|Equation]]
|-
|Divergence of harmonic series
|The divergence of the harmonic series
|[[wikipedia:Harmonic series (mathematics)|Harmonic series (mathematics)]]
|-
|Large sums
|Simple formulas for certain arbitrarily large sums
|[[wikipedia:Summation|Summation]]
|-
|Pascal's triangle
|A triangular configuration of numbers relating to the successive powers of any sum
|[[wikipedia:Pascal's triangle|Pascal's triangle]]
|-
|Quadratic by completing square
|The solving of quadratic equations by completion of the square
|[[wikipedia:Completing the square|Completing the square]]
|-
|Quadratic formula
|A formula which solves quadratic equations
|[[wikipedia:Quadratic formula|Quadratic formula]]
|-
|Solving higher order polynomials
|Methods for solving certain equations involving powers higher than the quadratic
|[[wikipedia:Galois theory|Galois theory]] 
|-
|Systems of equations
|Methods of solving systems of equations
|[[wikipedia:Linear system|Linear system]]
|-
|Angle sum difference trig identities
|Trigonometric identities relating to the sums and differences of angles
|[[wikipedia:List of trigonometric identities#Angle sum and difference identities|List of trigonometric identities § Angle sum and difference identities]]
|-
|Area enclosed by line and parabola
|The area enclosed by a parabola and a line
|[[wikipedia:The Quadrature of the Parabola|The Quadrature of the Parabola]]
|-
|Area of circle
|
|[[wikipedia:Area of a disk|Area of a disk]]
|-
|Area of triangle from side lengths
|
|[[wikipedia:Heron's formula|Heron's formula]]
|-
|Basic geometry
|Geometric objects: points, lines, circles, triangles, and so on
|[[wikipedia:Geometry|Geometry]]
|-
|Conic sections
|The categorization and properties of conic sections
|[[wikipedia:Conic section|Conic section]]
|-
|Existence of incommensurable ratios
|The existence of incommensurable ratios
|[[wikipedia:Irrational number|Irrational number]]
|-
|Geometric mean theorem
|The relationship between the length of the altitude of a right triangle and the lengths of the segments into which it divides the hypotenuse
|[[wikipedia:Geometric mean theorem|Geometric mean theorem]]
|-
|Inscribed triangle on diameter is right
|The angles of triangles inscribed in a circle with one edge on the diameter
|[[wikipedia:Thales' theorem|Thales' theorem]]
|-
|Isosceles base angles equal
|The equality of the base angle of isosceles triangles
|[[wikipedia:Pons asinorum|Pons asinorum]]
|-
|Law of sines
|
|[[wikipedia:Law of sines|Law of sines]]
|-
|Existence of pi
|The relationship between the area of a circle and its radius, involving the ratio of the circumference of the circle to its diameter
|[[wikipedia:Pi|Pi]]
|-
|Pi to 6 digits
|
|[[wikipedia:Zu Chongzhi#Mathematics|Zu Chongzhi § Mathematics]] and [[wikipedia:Milü|Milü]]
|-
|Properties of chords
|The properties of chords
|[[wikipedia:Chord (geometry)|Chord (geometry)]]
|-
|Pythagorean theorem
|The relationship between the lengths of the hypotenuse of a right triangle and the other two sides
|[[wikipedia:Pythagorean theorem|Pythagorean theorem]]
|-
|Pythagorean triples 3 digit
|Examples of triples of large whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Pythagorean triples 4 digit
|Examples of triples of very large whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Pythagorean triples small
|Examples of triples of small whole numbers which, when taken together, are the lengths of the sides of a right triangle
|[[wikipedia:Pythagorean triples|Pythagorean triples]]
|-
|Similar and congruent triangles
|The properties of similar and congruent triangles
|[[wikipedia:Similarity (geometry)|Similarity (geometry)]] and [[wikipedia:Congruence (geometry)|Congruence (geometry)]]
|-
|Surface area of sphere
|The computation of the surface area of a sphere
|[[wikipedia:Sphere#Surface Area|Sphere § Surface Area]]
|-
|Table of chord values
|A table of chord lengths indexed by angle
|[[wikipedia:Ptolemy's table of chords|Ptolemy's table of chords]]
|-
|Volume of cone
|The computation of the volume of a cone
|[[wikipedia:Cone#Volume|Cone § Volume]]
|-
|Volume of pyramid
|The computation of the volume of different pyramids
|[[wikipedia:Pyramid (geometry)#Volume|Pyramid (geometry) § Volume]]
|-
|Volume of sphere
|The computation of the volume of a sphere
|[[wikipedia:Sphere#Volume|Sphere § Volume]]
|-
|Axiomatic reasoning
|Axiomatic reasoning
|[[wikipedia:Axiomatic system|Axiomatic system]]
|-
|Exhaustion
|An approximation of the ratio of a circumference of a circle to its diameter, using the area of polygons and the method of exhaustion
|[[wikipedia:Method of exhaustion|Method of exhaustion]]
|-
|Proof by contradiction
|The method of proof by contradiction
|[[wikipedia:Proof by contradiction|Proof by contradiction]]
|-
|Symbol for addition
|The idea of using symbolic notation for addition
|[[wikipedia:Plus and minus signs#Plus sign|Plus and minus signs § Plus sign]]
|-
|Scientific notation
|Notation for very large numbers
|[[wikipedia:Scientific notation|Scientific notation]]
|-
|Negative numbers
|Notation for negative quantities
|[[wikipedia:Negative number|Negative number]]
|-
|Place values
|Positional notation
|[[wikipedia:Positional notation|Positional notation]]
|-
|Algebra
|Notation for abbreviating the unknown and other elements of an equation in a systematic and useful fashion
|[[wikipedia:Algebra|Algebra]]
|-
|Zero
|A symbol for nothingness
|[[wikipedia:0 (number)|0 (number)]]
|-
|Euclidean Algorithm
| An algorithm for computing the greatest common divisor of two numbers
|[[wikipedia:Euclidean algorithm|Euclidean algorithm]]
|-
|Chinese remainder algorithm
|An algorithm for computing a number which has given remainders when divided by several given primes
|[[wikipedia:Chinese remainder theorem|Chinese remainder theorem]]
|-
|Division
|An algorithm for dividing one number into another, possibly yielding a remainder
|[[wikipedia:Euclidean division|Euclidean division]]
|-
|Euclid's Theorem
|A proof that there are infinitely many prime numbers
|[[wikipedia:Euclid's theorem|Euclid's theorem]]
|-
|Irrationality of root 2
|A proof that the length of a diagonal of a square is incommensurable with its edge
|[[wikipedia:Square root of 2#Proofs of irrationality|Square root of 2 § Proofs of irrationality]]
|-
|Approximation of root 2
|An approximation for the length of the diagonal of a square
|[[wikipedia:Square root of 2#History|Square root of 2 § History]]
|-
|Sieve algorithm for primes
|
|[[wikipedia:Sieve of Eratosthenes|Sieve of Eratosthenes]]
|-
|Unique prime factorization
|The unique decomposition of a number into products of its prime divisors
|[[wikipedia:Fundamental theorem of arithmetic|Fundamental theorem of arithmetic]]
|}

==Medicine==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Anesthesia
|Anesthesia
|[[wikipedia:Anesthesia|Anesthesia]]
|-
|Asylum for mentally ill
|
|[[wikipedia:Psychiatric hospital|Psychiatric hospital]]
|-
|Autopsy
|
|[[wikipedia:Autopsy|Autopsy]]
|-
|Cataract surgery
|
|[[wikipedia:Cataract surgery|Cataract surgery]]
|-
|Cauterization
|Cauterization
|[[wikipedia:Cauterization|Cauterization]]
|-
|Fracture immobilization
|
|[[wikipedia:Bone fracture#Immobilization|Bone fracture § Immobilization]]
|-
|Fracture treatment
|The treatment of fractures
|[[wikipedia:Bone fracture#Treatment|Bone fracture § Treatment]]
|-
|Hernia surgery
|Hernia surgery
|[[wikipedia:Hernia#Surgery|Hernia § Surgery]]
|-
|Hospital lab
|
|[[wikipedia:Medical laboratory|Medical laboratory]]
|-
|Lithotomy surgery
|The lithotomy surgery
|[[wikipedia:Lithotomy|Lithotomy]]
|-
|Medical school
|
|[[wikipedia:Medical school|Medical school]]
|-
|Physical examination
|The method of physical examination in diagnosing illness
|[[wikipedia:Physical examination|Physical examination]]
|-
|Professional hospital staff
|
|[[wikipedia:Surgeon|Surgeon]] and [[wikipedia:Physician|Physician]]
|-
|Specialized wards
|
|[[wikipedia:Hospital#Departments or wards|Hospital § Departments or wards]]
|-
|Draining
| The surgical method of draining
|[[wikipedia:Drain (surgery)|Drain (surgery)]]
|-
|Excision
|The surgical method of excision
|
|-
|Incision
|The surgical method of incision
|[[wikipedia:Surgical incision|Surgical incision]]
|-
|Ligature
|The surgical method of ligature
|[[wikipedia:Ligature (medicine)|Ligature (medicine)]]
|-
|Probing
|The surgical method of probing
|
|-
|Scraping
|The surgical method of scraping
|
|-
|Suturing
|The surgical method of suturing
|[[wikipedia:Surgical suture|Surgical suture]]
|-
|Tracheotomy surgery
|The tracheotomy surgery
|[[wikipedia:Tracheotomy|Tracheotomy]]
|-
|Traumatic injuries
|The treatment of traumatic injuries
|[[wikipedia:Major trauma|Major trauma]]
|-
|Acute and chronic conditions
|The distinction between acute and chronic conditions
|[[wikipedia:Acute (medicine)|Acute (medicine)]] and [[wikipedia:Chronic condition|Chronic condition]]
|-
|Anatomical studies
|Anatomical studies for medical edification
|[[wikipedia:Human body|Human body]]
|-
|Blood vessels
|
|[[wikipedia:Blood vessel|Blood vessel]]
|-
|Classification of bodily fluids
|The classification of bodily fluids
|[[wikipedia:Body fluid|Body fluid]]
|-
|Classification of mental illnesses
|
|[[wikipedia:Mental disorder|Mental disorder]]
|-
|Classification of muscles
|
|[[wikipedia:Muscle|Muscle]]
|-
|Comparative anatomy
|
|
|-
|Convalescence
|
|[[wikipedia:Convalescence|Convalescence]]
|-
|Disease and fouled water
|The connection between disease and fouled water
|[[wikipedia:Waterborne diseases|Waterborne diseases]]
|-
|Pathology
|The classification of disease
|[[wikipedia:Nosology|Nosology]]
|-
|Endemic disease
|
|[[wikipedia:Endemic (epidemiology)|Endemic (epidemiology)]]
|-
|Epidemic disease
| The theory of epidemic disease
|[[wikipedia:Epidemic|Epidemic]]
|-
|Exacerbation
|The notion of the exacerbation of a patient's condition
|[[wikipedia:Exacerbation|Exacerbation]]
|-
|Eye anatomy
|The anatomy of the eye
|[[wikipedia:Human eye|Human eye]]
|-
|Fracture classification
|The classification of fractures
|[[wikipedia:Bone fracture#Classification|Bone fracture § Classification]]
|-
|Motor vs sensory nerves
|
|[[wikipedia:Motor nerve|Motor nerve]] and [[wikipedia:Sensory nerve|Sensory nerve]]
|-
|Nervous system function
|
|[[wikipedia:Nervous system|Nervous system]]
|-
|Paroxysm
|The notion of paroxysm
|[[wikipedia:Paroxysmal attack|Paroxysmal attack]]
|-
|Prognosis
|Determining the likely outcome given a patient's current status
|[[wikipedia:Prognosis|Prognosis]]
|-
|Pulmonary circulation
|
|[[wikipedia:Pulmonary circulation|Pulmonary circulation]]
|-
|Pulmonary medicine
| Pulmonary medicine
|[[wikipedia:Pulmonology|Pulmonology]]
|-
|Reaction time
|
|[[wikipedia:Mental chronometry|Mental chronometry]]
|-
|Relapse
|
|[[wikipedia:Relapse|Relapse]]
|-
|Specialized surgical instruments
|The use of specialized surgical instruments
|[[wikipedia:Surgical instrument|Surgical instrument]]
|-
|Surgical models
|The use of practice models in surgery
|
|-
|The voice
|The source of the voice
|[[wikipedia:Phonation|Phonation]]
|-
|Toxicology
|The classification of toxic substances
|[[wikipedia:Toxicology|Toxicology]]
|-
|Treatment of mental illnesses
|
|[[wikipedia:Treatment of mental disorders|Treatment of mental disorders]]
|-
|Animal remedies
|Remedies prepared from animals
|[[wikipedia:Traditional Chinese medicine#Animal substances|Traditional Chinese medicine § Animal substances]]
|-
|Animals as surgical models
|The use of animals as surgical models
|
|-
|Bandages
|The method of bandaging wounds
|[[wikipedia:Bandage|Bandage]]
|-
|Dedicated hospitals
|
|[[wikipedia:Hospital|Hospital]]
|-
|Forceps
|
|[[wikipedia:Forceps|Forceps]]
|-
|Herbal remedies
|Herbal remedies
|[[wikipedia:Herbalism|Herbalism]]
|-
|Mineral remedies
|Mineral remedies
|[[wikipedia:List of traditional Chinese medicines#Minerals|List of traditional Chinese medicines § Minerals]]
|-
|Mud bags as surgical models
|The use of mud bags as surgical models
|
|-
|Orthopedic cast
|
|[[wikipedia:Orthopedic cast|Orthopedic cast]]
|-
|Plants as surgical models
|
|
|-
|Scalpel
|
|[[wikipedia:Scalpel|Scalpel]]
|-
|Needles
| The construction and use of surgical needles
|[[wikipedia:Surgical suture#Needles|Surgical suture § Needles]]
|-
|Surgical scissors
|
|[[wikipedia:Surgical scissors|Surgical scissors]]
|-
|Traction bench
|
|[[wikipedia:Traction (orthopedics)|Traction (orthopedics)]]
|}

==Naturalist==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Dissection
|The dissection of creatures
|[[wikipedia:Dissection|Dissection]]
|-
|Anatomy
|The anatomical study of creatures
|[[wikipedia:Anatomy|Anatomy]]
|-
|Veterinary medicine
|The diseases of creatures
|[[wikipedia:Veterinary medicine|Veterinary medicine]]
|-
|Embryology
|The embriological development of creatures
|[[wikipedia:Embryology|Embryology]]
|-
|Foraging behavior
|The foraging behavior and diet of creatures
|[[wikipedia:Foraging|Foraging]]
|-
|Migration
|The migratory patterns of creatures
|[[wikipedia:Animal migration|Animal migration]]
|-
|Reproductive behavior
|The reproductive behavior of creatures
|[[wikipedia:Reproduction|Reproduction]]
|-
|Social behavior
|The social behavior of creatures
|[[wikipedia:Social behavior|Social behavior]]
|-
|Physical taxonomy
|The classification of creatures by their physical features
|[[wikipedia:Taxonomy (biology)|Taxonomy (biology)]]
|-
|Climactic adaptation
|The way that creatures are suited to the climates in which they live
|[[wikipedia:Climatic adaptation|Climatic adaptation]]
|-
|Comparative anatomy
|
|[[wikipedia:Comparative anatomy|Comparative anatomy]]
|-
|Food chain
|
|[[wikipedia:Food chain|Food chain]]
|-
|Struggle for existence
|The struggle for survival among creatures
|[[wikipedia:Struggle for existence|Struggle for existence]]
|}

==Philosophy==
{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
|-
|Nature of beauty
|Discourse on the nature of beauty
|[[wikipedia:Beauty (ancient thought)|Beauty (ancient thought)]]
|-
|Value of art
|
|[[wikipedia:Aesthetics|Aesthetics]]
|-
|Belief
|Discourse on the nature of belief
|[[wikipedia:Epistemology#Belief|Epistemology § Belief]]
|-
|Justification
|Discourse on the nature of justification
|[[wikipedia:Epistemology#Justification|Epistemology § Justification]]
|-
|Perception
|Discourse on the nature of perception
|[[wikipedia:Philosophy of perception|Philosophy of perception]]
|-
|Truth
|
|[[wikipedia:Epistemology#Truth|Epistemology § Truth]]
|-
|Individual value
|Discourse on the meaning of individual happiness
|[[wikipedia:Value (ethics)#Personal values|Value (ethics) § Personal values]]
|-
|State consequentialism
|Discourse on ethics as it regards the benefit of the state
|[[wikipedia:State consequentialism|State consequentialism]]
|-
|Interpersonal Ethics
|Discourse on ethics as applied to interpersonal conduct
|
|-
|Medical
|Discourse on medical ethics
|[[wikipedia:Medical ethics|Medical ethics]]
|-
|Military
|Discourse on ethics as applied to war
|[[wikipedia:Ethics#Military ethics|Ethics § Military ethics]]
|-
|Analogical inference
|
|[[wikipedia:Argument from analogy|Argument from analogy]]
|-
|Deductive reasoning
|Deductive reasoning
|[[wikipedia:Deductive reasoning|Deductive reasoning]]
|-
|Dialectic reasoning
|
|[[wikipedia:Dialectic|Dialectic]]
|-
|Direct inference
|
|[[wikipedia:Statistical syllogism|Statistical syllogism]]
|-
|Formal reasoning
|Formal reasoning
|[[wikipedia:Reason|Reason]]
|-
|Hypothetical syllogisms
|Hypothetical syllogisms
|[[wikipedia:Hypothetical syllogism|Hypothetical syllogism]]
|-
|Inductive reasoning
|
|[[wikipedia:Inductive reasoning|Inductive reasoning]]
|-
|Propositional logic
|
|[[wikipedia:Propositional calculus|Propositional calculus]]
|-
|Syllogistic logic
|Syllogistic logic
|[[wikipedia:Syllogism|Syllogism]]
|-
|Causation
|The nature of causation
|[[wikipedia:Causality|Causality]]
|-
|Events
|Discourse on the nature of events
|[[wikipedia:Event (philosophy)|Event (philosophy)]]
|-
|Existence
|
|[[wikipedia:Existence|Existence]]
|-
|Mind body
|Discourse on the nature of mind and body
|[[wikipedia:Mind–body problem|Mind–body problem]]
|-
|Objects and properties
|
|[[wikipedia:Essence|Essence]]
|-
|Processes
|
|[[wikipedia:Process philosophy|Process philosophy]]
|-
|Time
|Discourse on the nature of time
|[[wikipedia:Time|Time]]
|-
|Wholes and parts
|The relationship between wholes and parts
|[[wikipedia:Mereology|Mereology]]
|-
|Education
|Education, its forms and recommendations
|[[wikipedia:Education|Education]]
|-
|Dictionary
|Dictionaries
|[[wikipedia:Dictionary|Dictionary]]
|-
|Etymology
|The notion of etymology
|[[wikipedia:Etymology|Etymology]]
|-
|Grammar
|Grammar
|[[wikipedia:Grammar|Grammar]]
|-
|Law
|Discourse on law
|[[wikipedia:Law|Law]]
|-
|Diplomacy
|Discourse on diplomacy
|[[wikipedia:Diplomacy|Diplomacy]]
|-
|Economic policy
|Discourse on economic policy
|[[wikipedia:Economic policy|Economic policy]]
|-
|Government forms
|Discourse on government
|[[wikipedia:Government|Government]]
|-
|Social welfare
|Discourse on social welfare
|[[wikipedia:Welfare|Welfare]]
|}
{{Category|World}}

DF2014 Talk:Topic

2016-02-28T12:07:08Z

FortressBuilder: /* We aren't even half way there */

==We aren't even half way there==
There are around 130 innovations/topics/technologies listed so far. Toady says there are around 300.

Techniques for researching:

* Turn entire Fortress into scholars
* Monitor what they discuss / ponder every few minutes
* Record the innovation name and description (Press {{k|j}} when highlighting the dwarf in the unit list to see the description)
* Might be best to do this in several worlds generated with longer histories

I also went through Legends mode and sorted through a crap load of books (under artifacts), but this way doesn't always give you the innovation name. And it's a pain.

Any other suggestions? [[User:Brightgalrs|Brightgalrs]] ([[User talk:Brightgalrs|talk]]) 16:18, 4 December 2015 (UTC)

Writing books in adv mode is also a good way to do it.
[[User:Untrustedlife|Untrustedlife]] ([[User talk:Untrustedlife|talk]]) 17:07, 4 December 2015 (UTC)

:Didn't think of that. Very nice.[[User:Brightgalrs|Brightgalrs]] ([[User talk:Brightgalrs|talk]]) 17:21, 4 December 2015 (UTC)

Ah, having not played fortress mode in the new release, I didn't realize that there were official names for the topics. I just thought the name was supposed to briefly describe the topic. I will remove the names from all the topics I have added.
One good thing about using legends mode is that you know for certain which field a topic is a part of, since it says stuff like, "In 88, Sut became a philosopher in Hawktwinkle." "In the early summer of 91, Sut independently discovered discourse on medical ethics." That could have conceivably been a medical science innovation, but obviously since Sut was a philosopher, it is a philosophy inovation. --[[User:Figwat|Figwat]] ([[User talk:Figwat|talk]]) 05:57, 5 December 2015 (UTC)

Lots of knowledge flags have been [https://github.com/DFHack/df-structures/commit/db79fe8058839d1582cc1bfdd73a51ec9bbde20c added to df-structures] recently. I don't know how the names were found or how reliable the information is, but it might be a good starting point for the full list of topics. --[[User:FortressBuilder|FortressBuilder]] ([[User talk:FortressBuilder|talk]]) 15:57, 18 December 2015 (UTC)
:Used this list to complete the list in the article. Some of the names are probably wrong, however.[[User:Brightgalrs|Brightgalrs]] ([[User talk:Brightgalrs|talk]]) 06:22, 27 February 2016 (UTC)
::Maybe we could look for the correct strings in the exe file? Version 0.42.06 seems to have them around offset 0xB72AA0. [[User:FortressBuilder|FortressBuilder]] ([[User talk:FortressBuilder|talk]]) 12:07, 28 February 2016 (UTC)

== Reminders ==

* Record both the name and description
* The description should be all words after "The topic being discussed concerns..." or whatever it is.
* Try to sort the innovation in the right section of this article
* If it isn't obvious which it fits under (or it seems fits under multiple) just put it in the "unsorted" section
* More research will be done when Dwarf Therapist is updated
** In particular, monitoring dwarf's skill gain to pinpoint the correct branch(s) a topic should be sorted under.
[[User:Brightgalrs|Brightgalrs]] ([[User talk:Brightgalrs|talk]]) 16:27, 4 December 2015 (UTC)

== Names of Innovations ==
Apparently there are different names the innovations/topics/technologies are called in different fortresses. Example:
{|
|The Screw
|The construction and use of the screw
|-
|Screws within Reason
|The construction and use of the screw
|}
Are they the same?

Do we keep both / combine them / try to find a more common name?
Another example of how it is currently handled on the page:
{|
|Gear Mechanics<br />Gears
|The reasons why gears are effective
|}
[[User:Ashameron|Ashameron]] ([[User talk:Ashameron|talk]]) 11:19, 19 December 2015 (UTC)
:Are you sure "Screws within Reason" is not a title of a book or something? [[User:Brightgalrs|Brightgalrs]] ([[User talk:Brightgalrs|talk]]) 06:22, 27 February 2016 (UTC)

Reaction

2016-02-02T14:37:26Z

FortressBuilder: Undo revision 223167 by 47.61.157.118 (talk): Unnecessary (already listed on the linked page)

{{Quality|Superior|19:56, 28 August 2013 (UTC)}}
{{av}}

Reactions are modular, editable formulas that take specific ingredients, or reagents, and use them to produce a desired item. A lot of reactions are hardcoded — building beds or creating glass, for example — but a few are freely editable, and it's quite simple to add additional ones.

== Reaction differences between modes ==
In [[Fortress mode]], reactions are linked to specific buildings, and must be added to a civilization's [[Entities|entity file]] to be usable by that civilization. This has the useful effect of limiting new items and materials (such as special [[wood]] or [[metal]]) to civilizations that have the requisite reaction -- so that if you give your custom civilization a reaction to produce star metal or some other custom material, only they will be able to use it.

In [[Adventure mode]], reactions are freely available in the {{k|x}} menu via the {{DFtext|create}} option, and any adventurer character can make free use of them. Reagents may be held in the hands or dropped on the ground, but cannot be used within a backpack or quiver. There are several bugs with Adventure mode reactions, chief of which is the fact that you cannot select liquid reagents.{{verify}} 

==Anatomy of a reaction==

Reactions are found within reaction_x files (such as reaction_smelter or reaction_other). Generally speaking they adhere to the following structure:

[REACTION:<identifier>]
[NAME:<name>]
[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
[REAGENT:A:150:BAR:NONE:POTASH:NONE]
[PRODUCT:100:1:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:<SKILL TOKEN>]
[AUTOMATIC]
[ADVENTURE_MODE_ENABLED]
* ''[[#Reaction identifier|identifier]]'': The internal ID of the reaction.
* ''[[#Reaction name|name]]'': The name of the reaction, visible to the player in the Fortress mode or Adventure mode menus.
* ''[[#Building|building]]'': The building ID that the reaction uses, and the relevant keyboard shortcut.
* ''[[#Reagents|...reagents...]]'': Zero or more reagents (ingredients) that are required to be in stock for the reaction to be possible.
* ''[[#Products|...products...]]'': Zero or more products that are created from the reaction.
* ''[[#fuel|fuel]]'': (optional) If present, the reaction requires charcoal, coke or a magma-powered workshop.
* ''[[#skill|skill]]'': (optional) The skill required and trained by the reaction.
* ''[[#automatic|automatic]]'': (optional) If present, the reaction will automatically be enqueued whenever it can possibly be performed.
* ''[[#adventure mode|adventure mode]]'': (optional) If present, the reaction is used by the player in Adventure mode instead.

=== Reaction identifier ===

The reaction identifier may be anything, so long as it is unique within the raw data files. A good habit to get into is to append a short prefix or suffix to each name related to the name of your mod, to ensure nobody else is going to make an identical reaction and thereby mess up the game if their mod is run alongside yours.

=== Reaction name ===

This can be anything at all, and is usually used to describe the reaction. '''Tan a hide''', for example, is the name of the default leather-producing reaction. Generally this should be written as a small descriptive verb phrase, with the first letter capitalized, for consistency with the existing reactions.

=== Building ===

[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
* ''name'': The ID (that is the internal TOKEN each building can be refered to into reactions) of the building where this reaction will appear in the tasks menu.
* ''key'': The keyboard shortcut used to queue up the reaction.

The BUILDING NAME is the name of the building that will house this reaction, and the building key is the keyboard shortcut that will queue up the reaction. If two reactions have the same key, then one of them will be assigned a different key, the first alphabetically available at the building.

Valid buildings TOKENS are as follows:
* KILN - [[Kiln]] and [[Magma kiln]]
* SMELTER - [[Smelter]] and [[Magma smelter]]
* TANNER - [[Tanner's shop]]
* KITCHEN - [[Kitchen]]
* QUERN - [[Quern]]
* MILLSTONE - [[Millstone]]
* STILL - [[Still]]
* FARMER - [[Farmer's workshop]]
* CRAFTSMAN - [[Craftsdwarf's workshop]]
* GLASS{{version|0.42.01}} - [[Glass furnace]]
* WOOD{{version|0.42.01}} - [[Wood furnace]]
* MASON{{version|0.42.01}} - [[Mason's workshop]]
* ASHERY{{version|0.42.01}} - [[Ashery]]
* LEATHER{{version|0.42.01}} - [[Leather works]]
* BOWYER{{version|0.42.01}} - [[Bowyer's workshop]]
* SIEGE{{version|0.42.01}} - [[Siege workshop]]
* CLOTHES{{version|0.42.01}} - [[Clothier's shop]]
* METALSMITH{{version|0.42.01}} - [[Metalsmith's forge]]
* CARPENTER{{version|0.42.01}} - [[Carpenter's workshop]]
* Any custom (raw-defined) building type, such as:
** SOAP_MAKER - [[Soap maker's workshop]]
** SCREW_PRESS - [[Screw press]]

Specifying multiple BUILDING tokens will cause the reaction to be available at all of the specified buildings.

===Category===

{{new in v0.42}}

Categories are custom submenus for buildings' reaction menus. A reaction doesn't require a category, but if you have a lot of reactions, categories can be invaluable for organizing and presenting those reactions to players.

Categories can be nested indefinitely - you can have a category within a category within a category within a category within a category within... but as a practical matter, nesting categories more than 2 deep is not recommended.

Categories currently have no effect on adventure mode reactions.

====Defining a category====

Each category needs to be defined within a reaction, usually one which should appear within its menu. Categories only need to be defined once.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description
|-
| CATEGORY || Category ID || The category ID is a unique identifier for the category. It is only used in the raws, and will not appear in the game.

If you're defining multiple categories within the same reaction - for example, if you intend the reaction to be nested two deep, and haven't yet defined the super-category - the ''last'' CATEGORY token within the reaction definition is the one that the reaction will appear in.
|-
| CATEGORY_NAME || String || The name of the category as displayed in-game.
|-
| CATEGORY_DESCRIPTION || String || Optional. If present, when the category is highlighted in a building menu, this string will be displayed in the Helpful Hint box.
|-
| CATEGORY_PARENT || Category ID || Optional. If present, this category will be a submenu of the indicated category, rather than a submenu of the reaction's building.
|-
| CATEGORY_KEY || Hotkey token || Optional. If present, this category can be selected from its parent menu (whether a building or a parent category) using the given hotkey.
|}

====Adding reactions to an existing category====

Just include the tag [CATEGORY:<category_id>] within your reaction definition, and if the category exists, your reaction will be added to its menu. You can only add reactions to custom categories.

Each reaction can belong to only one category.

=== Reagents ===
REAGENTs are a little bit complicated. They are the ingredients that the reaction will use. You can define as many as you like within a reaction.

[REAGENT:<name>:<quantity>:<item token>:<material token>][...modifiers...]
* ''[[#name|name]]'': The name of the reagent, local to the reaction.
* ''[[#quantity|quantity]]'': The amount of the item that will be used in the reaction.
* ''[[#item_token|item token]]'': The type (and subtype) of the item you require.
* ''[[#material_token|material token]]'': The material the item should be made of.
* ''[[#Modifiers|...modifiers...]]'': Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

==== name ====
The name field is a small string used to identify the reagent within the reaction. The name is not visible to the player. It is local to the reaction and does not need to be unique across all of the reactions, so you can reuse the same names over and over, although each reagent within the same individual reaction must have a different name.

Most reagents are simply named '''A''', '''B''', and so forth in default reactions, although names such as '''TOOLSTONE''' or '''FLUX''' will also work equally well. The PRODUCT may make reference to this name – for instance, if a container '''B''' is specified as a reagent, PRODUCT_TO_CONTAINER:B specifies that container.

==== quantity ====
The quantity differs between item types. Generally speaking, cloth, thread, powder, bars, liquids and globs use numbers representing the size of material within one item, and everything else uses a static quantity. While REAGENT:A:'''''10''''':'''''THREAD''''':NONE:NONE:NONE thread is an extremely tiny portion of a random spool of thread, REAGENT:A:'''''10''''':'''''TOY''''':NONE:NONE:NONE is ten unique, solid toy items.

Sometimes the quantity of product is directly connected with the quantity of reagent; it seems to be 150 / REAGENT <quantity> (rounding down) so that Reagent <quantity> of 3 gives 50 product and a <quantity> of 4 gives 37. (150/4=37.5) [List of item types this applies to? Bars, for instance.]

==== item token ====
Item tokens are of the form ITEM_TYPE:ITEM_SUBTYPE.

The item type is the sort of item you require; WEAPON, TOY or SKIN_TANNED, for example. A [[item token|full list]] is available.

For reagents, the item token can also be set to ANY_RAW_MATERIAL:NONE (to permit BAR, BOULDER, POWDER_MISC, or GLOB) or ANY_CRAFT:NONE (to permit FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET). Internally, these special values are both converted to NONE:NONE and merely set special modifiers (similar to [BUILDMAT]) - they cannot be used in any other context.

The item subtype is name of the exact item that you require. Examples are ITEM_WEAPON_SPEAR or ITEM_TOY_PUZZLEBOX. Some items, like quivers or backpacks, or chunks of stone or metal, only require the item token to be filled in, so if you're asking for those you should set the subtype to NONE. Subtypes are defined within the local raw data files and their exact names can be referenced by looking at the corresponding file.

For backwards compatibility, reagents can also accept "METAL_ORE:metal_id" in place of both the item and material tokens - this is equivalent to using the reagent BOULDER:NONE:NONE:NONE with the modifier [METAL_ORE:metal_id] (see below).

==== material token ====
Material tokens come in several forms - see [[material token|here]] for a full list. For most reagents, this will typically be INORGANIC:MATERIAL_ID or NONE:NONE (to allow multiple materials using other filters).

==== Modifiers ====
Reagents may also have extra tokens added on afterwards, placed just after the REAGENT tag.

A list of them follows:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [REACTION_CLASS:X]
| Reagent material must have the specified reaction class - see below for more details.
|-
| [HAS_MATERIAL_REACTION_PRODUCT:X]
| Reagent material must have the specified material reaction product - see below for more details.
|-
| [HAS_ITEM_REACTION_PRODUCT:X]
| Reagent material must have the specified item reaction product - see below for more details. This can be used interchangeably with HAS_MATERIAL_REACTION_PRODUCT.
|-
| [CONTAINS:X]
| Reagent is a container that holds the specified reagent (where ''X'' is the [[#name|name]] of the reagent).
|-
| [UNROTTEN]
| Reagent must not be rotten, mainly for organic materials.
|-
| style="vertical-align: top"| [CONTAINS_LYE]
| Reagent must be a BARREL or TOOL which contains at least one item of type LIQUID_MISC made of LYE. Use of this token is discouraged, as it does not work with buckets (instead, use [CONTAINS:lye] — note the colon — and a corresponding lye reagent [REAGENT:lye:150:LIQUID_MISC:NONE:LYE]).
|-
| [POTASHABLE]
| Alias for [CONTAINS_LYE].
|-
| [NOT_WEB]
| Reagent must be collected (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| [WEB_ONLY]
| Reagent must be undisturbed (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| [EMPTY]
| If the reagent is a container, it must be empty.
|-
| [NOT_CONTAIN_BARREL_ITEM]
| If the reagent is a container, it must not contain [[lye]] or [[milk]]. Not necessary if specifying [EMPTY].
|-
| [BAG]
| Reagent must be a bag - that is, a BOX made of plant fiber, silk, yarn, or leather.
|-
| [GLASS_MATERIAL]
| Reagent material must have the [IS_GLASS] token. All 3 types of [[glass]] have this token hardcoded.
|-
| [BUILDMAT]
| Reagent must be a general [[building material]] - BAR, BLOCKS, BOULDER, or WOOD.
|-
| [FIRE_BUILD_SAFE]
| Reagent material must be solid and stable at temperatures approaching 11000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe.
|-
| [MAGMA_BUILD_SAFE]
| Reagent material must be solid and stable at temperatures approaching 12000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe.
|-
| [CAN_USE_ARTIFACT]
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.
|-
| [WORTHLESS_STONE_ONLY]
| Reagent material must be non-[[economic]].
|-
| [ANY_PLANT_MATERIAL]
| Reagent material must be subordinate to a PLANT object.
|-
| [ANY_SILK_MATERIAL]
| Reagent material must have the [SILK] token.
|-
| [ANY_YARN_MATERIAL]
| Reagent material must have the [YARN] token.
|-
| [ANY_SOAP_MATERIAL]
| Reagent material must have the [SOAP] token.
|-
| [ANY_LEATHER_MATERIAL]
| Reagent material must have the [LEATHER] token.
|-
| [ANY_BONE_MATERIAL]
| Reagent material must have the [BONE] token.
|-
| [ANY_STRAND_TISSUE]
| Reagent is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT].
|-
| [ANY_SHELL_MATERIAL]
| Reagent material must have the [SHELL] token.
|-
| [ANY_TOOTH_MATERIAL]
| Reagent material must have the [TOOTH] token.
|-
| [ANY_HORN_MATERIAL]
| Reagent material must have the [HORN] token.
|-
| [ANY_PEARL_MATERIAL]
| Reagent material must have the [PEARL] token.
|-
| [IS_SAND_MATERIAL]
| Reagent material must have the [SOIL_SAND] token.
|-
| [USE_BODY_COMPONENT]
| Reagent must be a body part (CORPSE or CORPSEPIECE). Must be used even if your reagent item type is CORPSE or CORPSEPIECE, otherwise it will match any item.
|-
| [NO_EDGE_ALLOWED]
| Reagent must not have an edge - excludes sharp stones (produced using knapping) and most types of weapon/ammo.
|-
| [NOT_ENGRAVED]
| Reagent has not been engraved (excludes memorial slabs).
|-
| [NOT_IMPROVED]
| Reagent has not been decorated.
|-
| [DOES_NOT_ABSORB]
| Reagent material must have [ABSORPTION:0]
|-
| [FOOD_STORAGE_CONTAINER]
| Reagent is either a BARREL or a TOOL with the FOOD_STORAGE use.
|-
| [HARD_ITEM_MATERIAL]
| Reagent material must have [ITEMS_HARD].
|-
| [METAL_ITEM_MATERIAL]
| Reagent material must have [ITEMS_METAL].
|-
| [NOT_PRESSED]
| Reagent must not be in the SOLID_PRESSED state.
|-
| [METAL_ORE:X]
| Reagent material must be an ore of the specified metal.
|-
| [MIN_DIMENSION:X]
| Reagent's item dimension must be at least this large. The reagent's item type must be BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, CLOTH, or GLOB for this to work.
|-
| [HAS_TOOL_USE:X]
| Reagent must be a [[tool]] with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.
|-
| [PRESERVE_REAGENT]
| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.
|-
| [DOES_NOT_DETERMINE_PRODUCT_AMOUNT]
| Reagent quantity is ignored for the purposes of producing extra outputs. Typically used for containers so that [[stack]]s of reagents will correctly produce additional outputs.
|}

Generally speaking, if you set a field in a reagent to NONE, the reaction won't discriminate when it comes to that particular field. For example, if you require a BOULDER reagent but leave the material as NONE:NONE, it will grab any available BOULDER-type item regardless of material.

===Products===
Products are the end product of the reaction. A reaction can have as many products as it likes.

Products are almost identical to reagents, except that they do not need to be named, can't have fields undefined, and don't use the quantity field to determine the product size. Instead, the token PRODUCT_DIMENSION:X is tacked on after the PRODUCT token, determining the size of the product.

Products can be produced directly to a container using the [PRODUCT_TO_CONTAINER:<IDENTIFIER>] token, where the IDENTIFIER is the name of a reagent. This requires the reagent to have the PRESERVE_REAGENT token.

Restating this in the above style, we have:
[PRODUCT:<probability>:<quantity>:<item token>:<material token>][...modifiers...][PRODUCT_DIMENSION:X][PRODUCT_TO_CONTAINER:<IDENTIFIER>]

====probability====
The percentage chance the product will be produced when the reaction is completed.

====quantity====
Determines how many of the product will be produced. For the item types AMMO, REMAINS, MEAT, FISH, FISH_RAW, PLANT, PLANT_GROWTH, DRINK, CHEESE, LIQUID_MISC, COIN, and EGG, the resulting items will be created as a single [[stack]], while all other item types will produce multiple individual items.

If a reaction can take stacks of input items, then it will attempt to perform the reaction enough times to consume as many full sets of reagents as it can - for example, if a reaction "1 piece of meat + 2 pieces of fish -> 3 pieces of cheese" is given a stack of 5 meat and 5 fish, it will produce 6 pieces of cheese and leave 3 meat and 1 fish behind. Using the token DOES_NOT_DETERMINE_PRODUCT_AMOUNT allows a reagent to be excluded from this calculation - for example, with the reaction "1 plant + 1 barrel -> 5 alcohol (into barrel)", using this on the barrel allows the reaction to be performed as "5 plant + 1 barrel -> 25 alcohol" instead of "5 plant + 5 barrel -> 25 alcohol".

====item token====
The [[item token]] and subtype of the item you produce.

If you want the item type and material to be derived from one of the reagents, you can use GET_ITEM_DATA_FROM_REAGENT:reagent:REACTION_PRODUCT_ID in place of both the item token ''and'' the material token below. You can also specify GET_ITEM_DATA_FROM_REAGENT:reagent:NONE in order to make a direct copy of the source item, though this will not work for complex items such as corpses or prepared meals.

For products, this can also be set to CRAFTS:NONE to produce up to three random [[craft]] items. This value cannot be used in any other context.

====material token====
A [[material token]] describing what the product will be made of.

If you want the product's material to be derived from one of the reagents, you can use GET_MATERIAL_FROM_REAGENT:reagent:REACTION_PRODUCT_ID in place of the material token. You can also specify GET_MATERIAL_FROM_REAGENT:reagent:NONE in order to directly use the reagent's own material.

====Product modifiers====
Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [FORCE_EDGE]
| Product is given a sharp edge. Used for knapping.
|-
| [PRODUCT_PASTE]
| Product is created in the SOLID_PASTE state.
|-
| [PRODUCT_PRESSED]
| Product is created in the SOLID_PRESSED state.
|-
| [PRODUCT_DIMENSION:<size>]
| Specifies the dimensions of the product. A product of 150 is typical for BAR, POWDER_MISC, LIQUID_MISC, DRINK, and GLOB. 15000 is typical for THREAD, and a size of 10000 is typical for CLOTH. Has no effect on any other item types. Note: this is not the actual volume of the product, which is hard-coded by the item token.
|-
| [PRODUCT_TO_CONTAINER:<id>]
| Places the product in a container; <id> must be the name of a reagent with the PRESERVE_REAGENT token and a container item type.

|}

===Improvements===
Improvements are applied to existing reagents. A reaction can have as many improvements as it likes.

Restating this in the above style, we have:
[IMPROVEMENT:<probability>:<reagent name>:<improvement type>:<material token>]

====probability====
The percentage chance the improvement will be applied to the reagent when the reaction is completed.

====reagent name====
The name of the reagent that will be improved. In order to be meaningful, this reagent must have [PRESERVE_REAGENT].

====improvement type====
The following improvement types can be used:
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| COVERED
| Item is encrusted/studded/decorated with <material>.
|-
| GLAZED
| Item is glazed with <material>.
|-
| RINGS_HANGING
| Item is adorned with hanging rings of <material>.
|-
| BANDS
| Item is encircled with bands of <material>.
|-
| SPIKES
| Item menaces with spikes of <material>.
|-
| PAGES
| Adds pages to a [[book]].
|}

All other item improvement tokens (ART_IMAGE, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE, and ILLUSTRATION) are ignored.

====material token====
A [[material token]] describing what the decoration will be made of.

If you want the decoration's material to be derived from one of the reagents, you can use GET_MATERIAL_FROM_REAGENT:reagent:REACTION_PRODUCT_ID in place of the material token. You can also specify GET_MATERIAL_FROM_REAGENT:reagent:NONE in order to directly use the reagent's own material.

===Other tokens===

==== fuel ====
The FUEL token means that the reaction requires coke or charcoal to be performed. Fuel is not needed when the reaction is performed at a magma workshop (a [[magma kiln]], [[magma smelter]], or any custom building having [NEEDS_MAGMA]).

==== skill ====
The SKILL token determines what [[Skill token|skill]] the reaction requires and what skill it trains. Only one skill may be specified. For custom reactions, the amount of experience gained is linearly correlated with the amount of product created; a reaction with no product will yield no experience for the performing dwarf. Similarly, the amount of time a reaction takes is correlated with experience gained: if a reaction has zero experience gain due to having no skill associated, the reaction will take minimal time.

==== automatic ====
The AUTOMATIC token means that the reaction will be queued automatically if the reaction reagents are all present.

This token only works with jobs performed at a [[kiln]], [[smelter]], [[tanner's shop]], [[kitchen]], or custom workshop, and [[standing orders]] allow you to limit which ones trigger; custom reactions performed at a [[quern]], [[millstone]]{{verify}}, [[still]]{{verify}} or [[craftsdwarf's workshop]]{{verify}} cannot be made automatic.

==== adventure mode enabled ====
The ADVENTURE_MODE_ENABLED token means that this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files.

==== max multiplier ====
The [MAX_MULTIPLIER:<#>] specifies how many times to do the reaction. This can be used to limit stacked reagent use to the specified quantity instead of the whole stack.{{version|0.42.01}}

==Reaction classes and products==

When you're doing things like tanning hides or brewing alcohol, having separate reactions for every single possible raw material is unwieldy and terrible. However, you can let the reaction itself ask the material for details and process them all with the same reaction. There are three types of tags to dictate this behavior.

===Reaction classes===

The simplest token is the reaction class. If it is tacked on a material, a reaction can limit reagents to only those materials that have the specified arbitrary [REACTION_CLASS:whatever] identifier.

We want a reaction that smelts iron and flux into pig iron. However, there's half-dozen different stones that count as flux. Instead of clogging up the smelter job menu with half-dozen nearly identical reactions that all take in either dolomite or limestone or marble for the same result, we use a reaction class.

[REACTION:PIG_IRON_MAKING]
[NAME:make pig iron bars]
[BUILDING:SMELTER:NONE]
[REAGENT:A:150:BAR:NO_SUBTYPE:METAL:IRON]
[REAGENT:B:1:BOULDER:NO_SUBTYPE:NONE:NONE]'''[REACTION_CLASS:FLUX]'''
[REAGENT:C:150:BAR:NO_SUBTYPE:COAL:NO_MATGLOSS]
[PRODUCT:100:1:BAR:NO_SUBTYPE:METAL:PIG_IRON][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:SMELT]

Note how reagent B asks for "NONE:NONE" as its material. This means "boulders of any kind as long as they have the reaction class named FLUX". Stuff like calcite, here:

[INORGANIC:CALCITE]
[USE_MATERIAL_TEMPLATE:STONE_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:calcite][DISPLAY_COLOR:7:7:1][TILE:'"']
'''[REACTION_CLASS:FLUX]'''
[ENVIRONMENT_SPEC:LIMESTONE:CLUSTER_SMALL:100]
[ENVIRONMENT_SPEC:MARBLE:CLUSTER_SMALL:100]
[MATERIAL_VALUE:2]
[IS_STONE]
[MELTING_POINT:12902]
[SOLID_DENSITY:2930]

The label itself can be absolutely anything. It's only used to find a match between the material and the reaction. Note that some reaction classes have special meanings to the game itself - notably, the [[site finder]] knows that "FLUX" should be connected to the "Flux stone" filter.

===Material reaction products===

But what if it's not all the same what materials the members of the reaction class put out? If a tanner starts working on a bear pelt, a horse hide, some dragon scales and a section of human skin, surely they all can't produce generic boot leather! No, the reaction must get the chance to ask the "reaction class" what the reagent should turn out as. We will declare a material reaction product.

[REACTION:TAN_A_HIDE]
[NAME:tan a hide]
[BUILDING:TANNER:CUSTOM_T]
[REAGENT:flaps of skin:1:NONE:NONE:NONE:NONE][USE_BODY_COMPONENT][UNROTTEN]
'''[HAS_MATERIAL_REACTION_PRODUCT:BOOT_FABRIC]'''
[PRODUCT:100:1:SKIN_TANNED:NONE:'''GET_MATERIAL_FROM_REAGENT:flaps of skin:BOOT_FABRIC''']
[SKILL:TANNER]
[AUTOMATIC]

Where you'd usually have some fresh bodypart with the BOOT_FABRIC reaction class produce some generic SKIN_TANNED, this goes further. Instead of declaring a material, he spool of pattern-ready tailoring leather (SKIN_TANNED) now comes out as whatever the skin flaps' material reaction product (named BOOT_FABRIC) says in the material's definition (GET_MATERIAL_FROM_REAGENT). And what does it say?

[MATERIAL_TEMPLATE:SKIN_TEMPLATE]
[STATE_COLOR:ALL_SOLID:GRAY]
[STATE_NAME:ALL_SOLID:skin]
[STATE_ADJ:ALL_SOLID:skin]
...
[ABSORPTION:100]
'''[MATERIAL_REACTION_PRODUCT:BOOT_FABRIC:LOCAL_CREATURE_MAT:LEATHER]'''
[IMPLIES_ANIMAL_KILL]
[ROTS]

It says that the caller of the BOOT_FABRIC hook always comes out as the LEATHER of whatever creature the skin has been peeled off of (LOCAL_CREATURE_MAT). Make it BOOT_FABRIC:INORGANIC:GOLD instead and your tanner turns into Midas. Use your imagination.

As with reaction classes, some MATERIAL_REACTION_PRODUCT identifiers have special meanings to the game itself - notably, the [[site finder]] knows that "FIRED_MAT" should be connected to the "Clay" filter, and "CHEESE_MAT" is used when making [[cheese]] from [[milk]].

===Item reaction products===

The version 0.40 added an even more powerful form of the above. Where material reaction products can only affect what type of stuff the predestined end product is made of, item reaction products can decide the entire end result ahead of time. Item AND material.

Let's assume for a moment that we're completely tired of leather earrings and hair crowns. We want a crafting reaction that takes cloth and only produces things that make sense.

[REACTION:TAILOR_THE_BEST_THING]
[NAME:weave something that makes sense]
[BUILDING:CRAFTSMAN]
[REAGENT:woven fabric:1:CLOTH:NONE:NONE:NONE]
'''[HAS_ITEM_REACTION_PRODUCT:BEST_OPTION]'''
[PRODUCT:100:1:'''GET_ITEM_DATA_FROM_REAGENT:woven fabric:BEST_OPTION''']
[SKILL:CLOTHIER]

Now we need to come up with the counterpart tags in the materials. Hmmm... cotton is thin and soft, so it makes pretty good undergarments. An undershirt, maybe?

[PLANT:COTTON] Gossypium hirsutum / sp.
[NAME:cotton plant][NAME_PLURAL:cotton plants][ADJ:cotton plant]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[DRY][BIOME:ANY_TROPICAL]
[VALUE:2]
...
[USE_MATERIAL_TEMPLATE:THREAD:THREAD_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
'''[ITEM_REACTION_PRODUCT:BEST_OPTION:ARMOR:ITEM_ARMOR_TUNIC:LOCAL_PLANT_MAT:THREAD]'''
...

Then jute fabric. Isn't that burlap? And what's about the only thing they make from burlap?

[PLANT:JUTE] Corchorus capsularis / Corchorus olitorius
[NAME:jute plant][NAME_PLURAL:jute plants][ADJ:jute plant]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[DRY][BIOME:ANY_TROPICAL]
[VALUE:2]
...
[USE_MATERIAL_TEMPLATE:THREAD:THREAD_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
'''[ITEM_REACTION_PRODUCT:BEST_OPTION:BOX:NONE:LOCAL_PLANT_MAT:THREAD]'''
...

Sacks, of course! Wait, how about silk?

[CREATURE:SPIDER_CAVE]
[DESCRIPTION:A tiny underground bug, sought after for its thread.]
[NAME:cave spider:cave spiders:cave spider]
...
[USE_MATERIAL_TEMPLATE:SILK:SILK_TEMPLATE]
'''[ITEM_REACTION_PRODUCT:BEST_OPTION:PANTS:ITEM_PANTS_THONG:LOCAL_CREATURE_MAT:SILK]'''
...

This goes on for as long as you let it. The ITEM_REACTION_PRODUCT declares the identifier and then the item and material with subtypes, just like a normal reaction's product line would.

Do note that MATERIAL_REACTION_PRODUCT and ITEM_REACTION_PRODUCT use the same IDs, so you cannot have both a material and item reaction product of the same name. Also, though you cannot use GET_ITEM_DATA_FROM_REAGENT with a MATERIAL_REACTION_PRODUCT (there'd be no item type information), you '''can''' use GET_MATERIAL_FROM_REAGENT on an ITEM_REACTION_PRODUCT (in case you want to force your own item type).

==Reactions and world generation==

There are several things to keep in mind when you're adding reactions to a game that already exists.

* Most entity changes require a regen, but adding PERMITTED_REACTION tokens for reactions that existed at the time of world generation to the entity file in the save directory do not.
* Adding reactions to the raws in a save directory requires you to regen the world.
* You can alter an existing reaction in any way you like without regenning the world, so long as you don't alter the reaction identifier.

==Full Token List==
For the sake of convenience and readability this is a complete compilation of the previously listed reaction tokens in alphabetical order

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ADVENTURE_MODE_ENABLED}}
|
| this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files

|-
| {{text anchor|ANY_BONE_MATERIAL}}
|
| Reagent material must have the [BONE] token.

|-
| {{text anchor|ANY_HORN_MATERIAL}}
|
| Reagent material must have the [HORN] token.

|-
| {{text anchor|ANY_LEATHER_MATERIAL}}
|
| Reagent material must have the [LEATHER] token.

|-
| {{text anchor|ANY_PEARL_MATERIAL}}
|
| Reagent material must have the [PEARL] token.

|-
| {{text anchor|ANY_PLANT_MATERIAL}}
|
| Reagent material must be subordinate to a PLANT object.

|-
| {{text anchor|ANY_SHELL_MATERIAL}}
|
| Reagent material must have the [SHELL] token.

|-
| {{text anchor|ANY_SILK_MATERIAL}}
|
| Reagent material must have the [SILK] token.

|-
| {{text anchor|ANY_SOAP_MATERIAL}}
|
| Reagent material must have the [SOAP] token.

|-
| {{text anchor|ANY_STRAND_TISSUE}}
|
| Reagent is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT].

|-
| {{text anchor|ANY_TOOTH_MATERIAL}}
|
| Reagent material must have the [TOOTH] token.

|-
| {{text anchor|ANY_YARN_MATERIAL}}
|
| Reagent material must have the [YARN] token.

|-
| {{text anchor|AUTOMATIC}}
|
| the reaction will be queued automatically if the reaction reagents are all present.

|-
| {{text anchor|BAG}}
|
| Reagent has to be a bag. Intended to be used with an item type of BOX, to prevent chests, coffers, and other containers from being used instead.

|-
| {{text anchor|BUILDING}}
|
* Building name
* in-building reaction hotkey
| Sets the building that the reaction will be performed in, and the button used to queue the reaction once that building's menu is accessed in-game

|-
| {{text anchor|BUILDMAT}}
|
| Reagent is able to be used to build structures (Stone, Wood, Blocks, Bars?).

|-
| {{text anchor|CAN_USE_ARTIFACT}}
|
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.

|-
| {{text anchor|CONTAINS}}
| required content
| Reagent is a container that holds the specified reagent.

|-
| {{text anchor|CONTAINS_LYE}}
|
| If the reagent is a container, it must contain LYE. No longer used - instead, use one reagent for the LYE itself and another reagent with [CONTAINS:lye_reagent].

|-
| {{text anchor|DOES_NOT_ABSORB}}
|
| Reagent material must have [ABSORPTION:0]

|-
| {{text anchor|DOES_NOT_DETERMINE_PRODUCT_AMOUNT}}
|
| Performing a reaction with large [[stack]]s of inputs can allow multiple sets of outputs to be produced. Setting this flag causes the reagent to be ignored in this process - for example, with the reaction "1 plant + 1 barrel -> 5 alcohol (into barrel)", using this on the barrel allows the reaction to be performed as "5 plant + 1 barrel -> 25 alcohol" instead of "5 plant + 5 barrel -> 25 alcohol".

|-
| {{text anchor|EMPTY}}
|
| If the reagent is a container, it must be empty.

|-
| {{text anchor|FIRE_BUILD_SAFE}}
|
| Reagent must be considered fire safe - i.e. not wood, and not coal.

|-
| {{text anchor|FORCE_EDGE}}
|
| Product is given a sharp edge. Used for knapping.

|-
| {{text anchor|FUEL}}
|
| Requires that the reaction either use up a unit of coal or charcoal or else be performed at a magma workshop

|-
| {{text anchor|GLASS_MATERIAL}}
|
| Reagent material has [IS_GLASS].

|-
| {{text anchor|HAS_ITEM_REACTION_PRODUCT}}
| PRODUCT_ID (custom)
| Similar to MATERIAL_REACTION_PRODUCT, but requires the reagen'ts material to have a matching ITEM_REACTION_PRODUCT entry.

|-
| {{text anchor|HAS_MATERIAL_REACTION_PRODUCT}}
| PRODUCT_ID (custom)
| Similar to REACTION_CLASS, but requires the reagent's material to have a matching [[Material definition token|MATERIAL_REACTION_PRODUCT]] entry. Intended for reactions which transform one class of material into another, such as skin->leather and fat->tallow.

|-
| {{text anchor|HAS_TOOL_USE}}
| Tool-use token
| Reagent must be a [[tool]] with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.

|-
| {{text anchor|IMPROVEMENT}}
|
* Probability
* Reagent Name
* Improvement type
* Material Token
| Improvement types include BANDS, COVERED, GLAZED, RINGS_HANGING, and SPIKES

|-
| {{text anchor|MAGMA_BUILD_SAFE}}
|
| Currently broken - behaves exactly the same as FIRE_BUILD_SAFE.

|-
| {{text anchor|METAL_ORE}}
|
* Inorganic material
| Reagent material must be an ore of the specified metal

|-
| {{text anchor|MIN_DIMENSION}}
|
* size
| Requires that the reagent have a dimension of at least this value. Only effective with BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, CLOTH, and GLOB items.

|-
| {{text anchor|NAME}}
| name
| defines the name used by the reaction in-game

|-
| {{text anchor|NO_EDGE_ALLOWED}}
|
| Reagent must not be sharpened (used for knapping).

|-
| {{text anchor|NOT_CONTAIN_BARREL_ITEM}}
|
| If the reagent is a Barrel, it must not contain an item that has to reside in a barrel. Barrel items appear to be lye and milk. Alcohol appears to be covered as part of [EMPTY]. A reaction which places an item in a barrel should probably have both tags.

|-
| {{text anchor|NOT_ENGRAVED}}
|
| Reagent must not be engraved?

|-
| {{text anchor|NOT_IMPROVED}}
|
| Reagent has not been decorated.

|-
| {{text anchor|NOT_PRESSED}}
|
| Reagent must not be in the SOLID_PRESSED state.

|-
| {{text anchor|NOT_WEB}}
|
| Reagent must be "collected" - used with THREAD:NONE to exclude webs.

|-
| {{text anchor|POTASHABLE}}
|
| Alias for CONTAINS_LYE.

|-
| {{text anchor|PRESERVE_REAGENT}}
|
| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.

|-
| {{text anchor|PRODUCT}}
|
*Probability of success (%)
*Quantity
*Item token:subtype
*Material token:subtype
| Defines a thing that comes out of the reaction. GET_MATERIAL_FROM_REAGENT and GET_ITEM_DATA_FROM_REAGENT can be used to defer the choice of material and/or item to the appropriate tag in a given reagent's material - the former comes in place of the material token, the latter replaces both the item and material tokens. See above for detailed information on how the hooks work.

|-
| {{text anchor|PRODUCT_DIMENSION}}
| size
| Specifies the size of the product. A size of 150 is typical for BAR, POWDER_MISC, LIQUID_MISC, DRINK, and GLOB. A size of 15000 is typical for THREAD, and a size of 10000 is typical for CLOTH.

|-
| {{text anchor|PRODUCT_PASTE}}
|
| Product is created in the SOLID_PASTE state.

|-
| {{text anchor|PRODUCT_PRESSED}}
|
| Product is created in the SOLID_PRESSED state.

|-
| {{text anchor|PRODUCT_TO_CONTAINER}}
| Reagent ID
| Places the product in a container; <id> must be the name of a reagent with the PRESERVE_REAGENT token and a container item type.

|-
| {{text anchor|REACTION}}
| Identifier
| defines a new reaction

|-
| {{text anchor|REACTION_CLASS}}
| CLASS_ID (custom)
| Requires the reagent's material to have a matching [[Material definition token|REACTION_CLASS]] entry. Intended for reactions which accept a variety of materials but where the input material does not determine the output material, such as FLUX (for making pig iron and steel) and GYPSUM (for producing plaster powder).

|-
| {{text anchor|REAGENT}}
|
* name/id
* quantity
* [[item token]]
* [[material token]]
| Requires a given reagent as an input for a reaction

|-
| {{text anchor|SKILL}}
| Skill Token
| Skill used by the reaction

|-
| {{text anchor|UNROTTEN}}
|
| Reagent must not be rotten, mainly for organic materials.

|-
| {{text anchor|USE_BODY_COMPONENT}}
|
| Reagent material must come off a creature's body.

|-
| {{text anchor|WEB_ONLY}}
|
| Reagent must be "undisturbed" - used with THREAD:NONE to gather webs.

|-
| {{text anchor|WORTHLESS_STONE_ONLY}}
|
| Reagent is not made of an economic stone.

|}

{{Category|Modding}}
{{Category|Tokens}}

Adventurer mode

2016-01-30T09:56:35Z

FortressBuilder: Spelling and formatting

{{old}}
{{Quality|Exceptional|Jan 2016}}
{{av}}

:''This is a detailed reference guide for Adventurer Mode. For a tutorial see the [[Adventure mode quick start|Adventure Mode Quickstart Guide]].
:''See [[Adventure Mode quick reference]] to quickly look up key commands.

In '''Adventurer Mode''' (also called "adventure mode") you create a single adventurer ([[dwarf]], [[human]], [[elf]], [[goblin]], or one of the varieties of [[animal people]]) who starts out somewhere in one of your generated worlds. You can learn about what ails the world and go on [[quest]]s to end those troubles (or get brutally murdered trying), and you can venture into the wilderness to find [[cave]]s, shrines, lairs, abandoned towers, and other [[Site|towns and settlements]]. You can even visit your previously abandoned and retired [[fortress]]es and take all the precious items you yourself once created.

Unlike [[Fortress mode]], Adventurer Mode is a sort of advanced [http://en.wikipedia.org/wiki/Sandbox_game open world] version of [http://en.wikipedia.org/wiki/Rogue_%28computer_game%29 rogue] or [http://en.wikipedia.org/wiki/Nethack nethack] taking place in the same procedurally generated worlds used for Fortress Mode. Whereas in fortress mode you are in charge of a large group of people in real-time restricted to a small parcel, in adventurer mode you control a single character in a turn-based manner, roaming the entire world freely.

=World Selection=

You can play Adventurer mode in any world that has a civilization with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token (which are elf, dwarf, humans, goblins, as well as animal people{{version|0.42.01}}). Humans inhabit cities, towns, and the occasional above-ground fortress. Elves inhabit forest retreats. Dwarves are spread between "deep sites" which sometimes do not contain a direct connection to the surface, and "hill dwarves" which inhabit a loose collection of mounds built into hillsides. Goblins typically live in Dark Fortresses. Lastly, Animal People can live with any civilization, in virtually any location. Human cities and towns are currently the only sites with shops and other places to officially buy goods.

If you have previously built a fort in the world that you select, your adventurer will be able to go visit it. If you have selected to "retire" the fortress rather than abandon it, you will likely be able to encounter all the inhabitants from fortress mode. However, they will likely not have the same level of activity as they would in a bustling fortress-mode fort.

=Character Creation=

==Race and Civilization==
Any race with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token is playable in adventure mode. In an unmodded game, this means [[Dwarves]], [[Elves]], and [[Human|Humans]]. All three races can complete the same quests.

*'''Humans''' Always originate from one of the villages in the world, begin with bronze, copper, or iron weapons, and can use any of the items sold by shopkeepers (who, for the time being, are only found in human towns and only sell human-sized clothing/armor). They also start with the widest variety of weapon skills.

*'''Human Outsiders''' Human Outsiders are humans that aren't from that world or any of its villages. They simply appear in the wilderness, a stranger to all. You may always play as an outsider, even if the world is otherwise completely uninhabited. Outsiders can only start with Spear User and Knife User as weapon skills, and they cannot start with Armor User or Shield User. They also start out literally naked with no clothing, but can wear any human-sized armor that they trade for, steal, or loot. "Outsiders" of other races can be played if you add the [[Entity_token#Gameplay|INDIV_CONTROLLABLE]] token to the race's entity definition.

*'''Dwarves''' have the advantage of being able to go into a [[martial trance]] when fighting multiple foes at once. This gives them many combat bonuses, which aids their survival greatly. They are the only race which can start with steel weapons, but they wear "small" sized clothing (like goblins and elves) which means that they're unable to wear human clothing and armor found in shops. Goblin armor fits them, making Dark Fortresses (if your computer can handle them) and bandits a viable source of armor; if you're up for it, you could also just rob some dwarves. They can start with almost the same weapon skills as civilized humans. Many larger weapons must be wielded two-handed by dwarves, due to their size.

*'''Elves''' start with very weak wooden weapons and have a more limited list of weapon skills during character creation. They have the advantage that they have higher natural speed. Elves also have the AT_PEACE_WITH_NATURE tag. This makes all wildlife passive towards them. Like dwarves they wear small sized clothing and will have the same problem finding suitable armor.

*'''Kobolds''' can be played only if there are no other civilizations and there are kobolds. They are very small and weak in combat and a huge challenge compared to the other races. They wear even smaller armor than the other races and armor will be impossible to find for them, unless you are absurdly lucky and run into armored kobolds.

*'''Intelligent Wilderness Creatures'''{{version|0.42.01}} can be played not only in varying conditions as above, but also as part of another parent civilization such as elves, humans, and dwarves. They come in various sizes, shapes and abilities, and as such a short description cannot be given.

If no civilization for a given race exists in a world you can only play as an outsider.

== Status ==

Determines the number of starting skill and attribute points, which does not change based on race:
*'''Peasant:''' 15 attribute, 35 skill
*'''Hero:''' 35 attribute, 95 skill
*'''Demigod:''' 105 attribute, 161 skill
The number of skill points is less significant than the number of attribute points because the time it takes to go from Peasant to Demigod in skill terms is much less than what it would take to go from Peasant to Demigod in attribute terms.

== Starting Attributes ==

[[Attribute|Attributes]] are divided into Body and Soul attributes. This section provides some guidance for allocating attributes as it relates to adventurer mode.

=== Body ===

*'''Strength''': Alters the damage you inflict in melee regardless of weapon used. Increases muscle size. This increased muscular layer helps prevent damage, although this is a pretty minor effect. Increasing strength, at least in adventurers, increases movement speed (albeit not as much as agility) due to better carrying capacity.
*'''Agility''': This attribute is directly related to a character's Speed and is also used in combat skills. Agility is really, really important as being faster than the enemies allows you to get more hits in before they can fight back and lets you run away more easily.
*'''Toughness''': Reduces physical damage inflicted on you. Also relates to defensive combat skills.
*'''Endurance''': Reduces the rate at which the adventurer becomes exhausted. Becoming exhausted causes you to collapse, helpless and immobile and can cause you to pass out.
*'''Recuperation''': Increases the rate of wound healing. Not as important as Toughness. Recuperation isn't that useful in adventurer mode since you usually have as much time to rest as you need assuming you can escape a situation alive.
*'''Disease Resistance''': Seems to have some effect on vampirism infectivity; may have to do with infected wounds.

=== Soul ===

Some of these are useful for adventure-mode-applicable skills, but some are totally useless except as dump stats.

*'''Analytical Ability''': Useful for Tracker, Knapping and Student. Analytical Ability seems to have an influence on the quality of written creations, such as Poems, as well as ability to speak about ideals.{{version|0.42.01}}

*'''Focus''': Affects Archer, Ambusher, Observer.

*'''Willpower''': Affects Fighter, Crutch Walker and Swimmer. Willpower is really important as it governs how easily you'll pass out from extreme pain. Low willpower is a death sentence if you are seriously wounded, as you'll pass out and have your head caved in. Broken bones currently cause enough pain that even very high willpower usually won't keep you conscious. For non bone injuries however willpower can keep you going long enough to kill enemies, or at least get away from them.

*'''Creativity''': Unknown at the moment what Creativity does in 42.01, early !Science! seems to have found that this influences quality of poems, songs, and dances. It may also influence "make believe", now able to be performed by children.{{version|0.42.01}}

*'''Intuition''': Helps with Observer, which aids in spotting concealed enemies, ambushes, and identifying attacks from opponents.

*'''Patience''': May have some effect on dealings with others as a result of the new conversation system.{{Verify}}

*'''Memory''': Memory is applied to the Student and Reading skills. Higher Student improves the ability to learn from demonstrations in fortress mode, but it isn't certain whether it has any application in adventurer mode. It's also unknown what benefits come from of higher Reading capability.

*'''Linguistic Ability''': Affects any speaking and writing ability, improves the ability to communication both thoughts and feelings to listeners. Likely also required for 'eloquent speech'. {{Verify}}

*'''Spatial Sense''': Important. Affects combat skills, Ambusher, Crutch Walker, Swimmer, Observer, Knapping. Also, prevents/reduces the chance of stumbling during a dance.{{version|0.42.01}}

*'''Musicality''': Influences the Adventurers ability to perform music and song well. This, so far works for all instruments, one can play a flute, guitar, any other instrument equally well, given that the adventurer has equal skills in all instrument fields.{{version|0.42.01}}

*'''Kinesthetic Sense''': Affects most combat skills, walking with crutches, swimming and dancing

*'''Empathy''': Affects social skills such as Persuader, Flatterer, Judge of Intent, and other Social skills that may not be applied in adventurer mode.

*'''Social Awareness''': Increases the number of followers you can have at a given "fame" level. Normally you start with a limit of two. Increasing this stat by one level raises that to three. Your fame still plays a big part in whenever you can recruit followers or not. This attribute also helps with Persuader and Judge of Intent.

=== Attribute Advancement Cap ===

Adventure mode attributes are capped at double the starting value or the starting value plus the racial average, whichever is greater. Humans, for example, have a racial average strength of 1,000. If a human adventurer starts with an ''above average'' strength of 1,100, then his strength will ultimately be capped at 2,200. Had this human started with a ''below average'' strength of 900, then his strength would be capped at 1,900 instead. For the purpose of maximizing final attributes, this makes it important to start with as many attributes in the ''superior'' range as possible (more attributes per point allocated), while avoiding taking any penalties to even remotely important attributes (big attribute deductions per point recovered). As a consequence of the attribute cap, demigod adventurers will always have a much higher potential for advancement than mere peasants and heroes.

== Starting Skills ==

Not all races have the same sets of skills available at character creation time, but keep in mind that all starting [[skill]]s, as well as ones not available at character creation, can be improved through use in game.

This section will specifically address starting skills as they relate to adventure mode. For a full description of combat skills see [[Combat skill]]. Other skills that you can't start with, but which can be increased in game (such as Butchery) are described elsewhere.

=== Weapon ===

The weapon you start out with will be based on which of these, plus the unarmed combat skills, is the highest. In other words, even if Swordsman is your highest weapon skill, you won't start with a sword if your Wrestler or Striker skills are better. Usually the best choice anyway is to specialize in just one melee weapon skill. Regardless of weapon skills, a '''large copper dagger''' will always be included in the starting equipment, which is handy for throwing at enemies that are just a step away or finishing off a foe pinned down by a stuck weapon. If you don't select any offensive skills, you will also start with a spear, just as an outsider would.

Not all races/civilizations can start with all of these skills. Dwarves can't start with Bowman, Pikeman, or Lasher. Elves can only use Swordsman, Bowman, and Spearman. Of the playable races, only humans have access to Pikeman and Lasher. Strangely, only outsiders can start with Knife User.

Note that different races have different names for their weapon skills. Axegoblin, Axedwarf etc.

Crossbowman is an exception. Dwarves call this skill Marksdwarf, although bow skill is referred to as Bow Dwarf as you'd expect. Elite Axe and Hammer dwarves are referred to as Lords.

*'''Axeman''': allows characters to use axes, great axes, and halberds more effectively. Useful for cleaving off limbs.
*'''Bowman''': skill allows characters to use bows more effectively. Useful for taking down enemies at a distance.
*'''Crossbowman''': allows characters to use crossbows more effectively. Useful for taking down enemies at a distance.
*'''Hammerman''': allows characters to use crossbows in melee, mauls, and war hammers more effectively. Useful for breaking limbs.
*'''Knife User''': allows characters to use large daggers and knives more effectively. Useful for stabbing things.
*'''Lasher''': allows characters to use whips and scourges more effectively. Very deadly weapons.
*'''Maceman''': allows characters to use flails, maces, and morningstars more effectively. Similar to hammers.
*'''Pikeman''': allows characters to use pikes more effectively. Like spears, but much bigger.
*'''Spearman''': allows characters to use spears more effectively. Useful for stabbing things.
*'''Swordsman''': allows characters to use blowguns and bows in melee, long swords, scimitars, short swords, and two-handed swords more effectively. Useful for cutting, stabbing, and whacking, but less effective than more dedicated weapons.

=== General Combat ===

These two skills can be raised rather quickly in game and so you probably want to skip spending any points on them at the start.

*'''Fighter''': This increases with, and contributes to, melee combat whether armed or unarmed. It appears that the purpose of it is to allow melee experience to contribute to melee combat in general regardless of weapon. Repeatedly wrestling (grabbing and releasing) even a small creature will raise this skill.
*'''Archer''': This increases with, and contributes to, ranged combat including throwing. It works similarly to Fighter except for ranged attacks. It can be easily raised by repeatedly throwing rocks, making it advisable for archers to practice their marksmanship with rock throwing before using up the more finite and expensive forms of ammunition. Shooting at a wall with adjacent upward ramp one level below and picking back projectiles is also a good idea (such places often happen to be in keeps and fortresses). See the FAQ section on [[#How do I increase my skills and attributes?|increasing your skills and attributes]] for information on raising bowman/marksman skills.

=== Defensive ===

These skills are critical for survival. Starting out with good ability in one (especially Shield User or Armor User) if not all is strongly advised.

*'''Shield User''': Ability to block attacks with shields. Starting with even novice skill in this means that the adventurer will start with a shield. This is a no-brainer unless you're creating a two handed weapon user, and lack a broadness or height modifier on your character - necessary for one-handing any two-handed weapon, without penalty.
*'''Armor User''': A higher level of this skill reduces the encumbrance penalties of armor, allowing you to move faster when wearing it. It also affects how well armor protects you and this makes a huge difference. Unskilled armor users gain little protection. This is noticeable as you'll begin seeing far more combat reports about hits either striking you though armor, (you managed to use your armor to lessen the force of the blow) or being deflected by your armor (you used your armor to avoid the hit entirety) as your skill rises and you learn to actually use your armor to deflect hits. It is highly advised to train your armor skill before entering battle with it as the speed penalties of lower levels can be a serious handicap.
*'''Dodger''': Ability to dodge out of the way of attacks. Dodger is incredibly important and will allow you to avoid many, many hits that would have otherwise injured you. Especially important when you are fighting unarmored and can't afford a battle axe in the chest. Boost this to talented or at least close to it.

=== Unarmed Combat and Improvised Weapons ===

While some of them come in handy at times, they can generally be raised fairly easily in game, especially Wrestler and Thrower.

*'''Wrestler''': Ability to grapple, restrain, take-down, throw opponents, etc. Higher skill means all of these moves succeed more often. See [[#Wrestling and Unarmed Attacks]] for details. Can be raised very easily in game.
*'''Striker''': Punching ability. Turns handy when weapons get stuck and there is no time to wrest them back.
*'''Kicker''': Kicking ability. Same as Striker. Kicks are slower but more deadly than punches; heavy kicks are particularly good at crushing and exploding heads.
*'''Biter''': Biting ability. Biting is surprisingly effective even with non animal races as after biting you can shake opponents around by your teeth, causing great damage and possibly ripping off body parts, although with sapient races this tends to lean more towards fingers or toes, perhaps the occasional hand or foot.
*'''Thrower''': Throwing any miscellaneous object including rocks, knives, axes, swords, heads, etc. Skill affects accuracy and damage caused.
*'''Misc. Object User''': Ability to beat things to death with anything that comes at hand, from bags to coins to their own severed body parts. Also somewhat more commonly used for shield bashing. This skill affects combat with any object, from a rock to a beehive. There are no separate skills for different items. Items actually intended to be weapons, like swords or axes, are unaffected by this skill.

A well written article on martial arts "Kisat Dur" can be found on the forums [http://www.bay12forums.com/smf/index.php?topic=148015.0 here].

=== Movement and Awareness ===

*'''[[Observer]]''': Helps one to notice things like ambushes, enemies who are "sneaking" (stealth movement), and traps. Detection range increases with skill, but up to a maximum of 3 tiles away. Higher levels give more information regarding opponents. Hard to train. Adding some points here is advisable.
*'''[[Swimmer]]''': Allows movement through water without drowning. A Novice swimmer can swim but will revert to being unable to swim if stunned, which happens when falling even 1 z-level into the water, or possibly after an unfriendly encounter with a creature in the water. An Adequate swimmer can swim normally (not drown) while stunned. For this reason, ''starting out as an Adequate swimmer is advisable.'' If you don't, at least start as Novice and go get some swimming practice right away.
*'''[[Ambusher]]''': The skill of {{K|S}}neaking around unobserved. This can be raised fairly easily by sneaking around while traveling from place to place when speed is not important. Enemies will have "sight ranges" from where they can detect a sneaking adventurer. The red zone of sight is where they will see you immediately and begin chasing you; the yellow is where they might see you. Staying out of sight will allow you to silently assassinate your foes, as they rarely seem to notice a knife in their back in time.
*'''[[Climber]]''': The skill of climbing up walls, into trees, and around the edges of gorges. Higher levels reduce the chance of falling and increase the speed of a climbing character.
*'''[[Tracker]]''': The skill of tracking your quarry, whether it be animals or goblins. Higher levels will let you spot more tracks and help you distinguish different tracks.
*'''[[Crutch-walker]]''': The skill of standing and walking with a crutch for support. This skill only becomes available when attempting to move with a crutch in inventory, and can be developed with or without legs. At Legendary levels, a crutch walker walks with no speed reduction, and simply keeping it in hand will continue to increase attributes.

=== Crafting ===

These allow your character to create things. There is only one skill currently available in an unmodified game.

*'''[[Knapper]]''': The fine art of sharpening rocks by banging them together in a clever manner. The resulting rocks become sharp rocks which do more damage when thrown and can be used for things requiring a sharp edge like butchering. Easy to raise in game and doing so helps with Kinesthetic and Spatial Sense.

=== Social ===

Almost all of these are only used in arguments.

*'''Persuader''': Increases your ability to convince people of your view.
*'''Judge of Intent''': Allows you to tell how the opponent is arguing, unknown if higher levels change anything.
*'''Flatterer''': Increases your ability to flatter your way out of the argument.

=== Other ===

*'''[[Reader]]''': Allows you to read books, signs, and writing in Adventurer mode. Novice level is required in order to become a [[Necromancer]]. Can be trained slowly by reading books (if you can read). Adding more points is a waste, as novice allows you to read anything.
*'''[[Butcher]]''': The art of turning corpses into piles of delicious prepared brains and meat for food. Butchering also makes corpses and body parts less useful to enemy necromancers. You cannot allocate points here during character creation, but that's OK since skill doesn't really affect anything anyway. Except the taste, of course.

= Gameplay =

== Common UI Concepts ==
{{KeyConventions|3}}

== Moving Around ==

=== Local Movement ===
[[File:Advmode_normaltravel_DF2014.png|thumb|400px|An image of normal travel mode. A list of the closest (but not necessarily close) sites is in the top-left corner. On the right side are minimaps of the next two levels down, relative to the player. Along the bottom is information about the player.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Move
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Move
|-
| {{k|Alt}} and a direction key
| Move carefully / Deliberately enter dangerous terrain
|-
| {{k|Shift}}+{{k|<}} or {{k|Shift}}+{{key|5}} (num lock off)
| Ascend
|-
| {{k|Shift}}+{{k|>}} or {{k|Ctrl}}+{{key|5}} (num lock off)
| Descend
|-
| {{k|.}}
| Wait for 10 instants
|-
| {{k|,}}
| Wait for 1 instant
|-
| {{k|s}}
| Stand or lie down
|-
| {{k|S}}
| Open Movement Speed/Sneak Menu
|}

Unless your character is an outsider, you will start out in a race-appropriate town or hamlet; in the standard tileset the @ sign is your character.

The directional keys allow movement. Diagonal movement is particularly important especially when chasing or running away from things.

Use {{k|Alt}}+direction to enter water, jump off of cliffs, or otherwise attempt to enter anything that you can't enter using normal movement commands. Note that when entering water it's best to enter the actual water and not the open space over the water as, in the later case, you will fall in causing you to become stunned which may lead to drowning.

If you hit {{k|j}}, you can jump. This is mostly useful for crossing gorges and crevices, where you have to get to the other side. Occasionally, you can manage to jump onto an opponent and tackle them, which typically causes them to go flying a short distance.

Hitting {{k|.}} allows you to stay in one place and wait for other things to move. {{k|,}} does the same but with a tenth of the time it takes for {{k|.}}.

Use {{k|s}} to sit/lie down. Moving while laying down (crawling) will let you move past NPCs which are standing in your way. Also note that you will frequently get knocked to the ground in combat, and if you don't hit {{k|s}} to stand back up then you will crawl slowly along the ground, giving your opponent a lot of opportunity to attack you.

{{k|S}}neak will allow you to move around invisibly, limited by your Ambusher skill and the Observer skill of nearby creatures. Enemies will have sight cones indicating where they can detect a sneaking adventurer. The central zone of sight (red, violet, or cyan) is where they will see you immediately and begin chasing you; their peripheral vision (yellow) is where they might see you. Violet and cyan central zones indicate the enemy is on a different level than yours, while red means they are on the same level. Staying out of sight will allow you to silently assassinate your foes, as they rarely seem to notice a knife in their back in time. Note that sneak is also affected by a variety of other factors detailed on the {{k|S}}neak screen, such as light level and weather.

If you {{k|h}}old onto a wall or tree, you can climb the wall or tree by using the movement keys. In towns and tamer parts of the countryside, this isn't particularly useful. However, in a combat situation, climbing a tree or wall can give you a height advantage, possibly allowing you to dive-tackle your opponents. Sometimes, mountains will be too steep to walk up the edge, or you will find a deep drop into a ravine. In these cases, you will have to climb up to reach the top, or perhaps jump or climb down one face, then climb up the other.

=== Fast Travel ===
[[File:Advmode_fasttravel_DF2014.png|thumb|400px|Fast Travel screen. The player is in a hamlet, between the houses to the right and the mead hall in the top-left area of the map. The asterisk represents a group of creatures (in this case unfriendly goblins). The world map (in sepia) is on the far right.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|T}}
| Fast Travel
|-
| {{k|d}}
| Exit fast travel mode
|-
| {{k|K}}
| Display detected tracks and odors
|-
| {{k|c}}
| Toggle display of clouds on region map
|-
| {{k|s}}
| Walk around in sneak mode. Exiting fast travel starts you in sneak mode.
|-
| {{k|m}}
| Cycle through maps and significant structures
|-
| {{k|Q}}
| View Quest Log
|-
| {{k|Z}}
| Bring up sleep menu
|-
| {{k|h}}
| Hide parts of the bottom bar
|-
| {{k|>}} and {{k|<}}
| Enter/exit tunnel
|-
|}

Entering Fast Travel mode will allow you to move large distances in a single keypress. Of course, the same amount of time will go by and you can also be interrupted (ambushed) while moving in fast travel mode.

Along the top of the map is a line showing the sky, and the position of the sun and/or moon from west to east. This primarily helps you determine how long you have before it gets dark, at which point you won't be able to see very far, will risk getting attacked by bogeymen, and will be more vulnerable to attack in general.

If you are not near any sites, the {{k|m}} key will toggle a world map, colored in sepia tone (matching the map you see in the quest log). If you are near a site, then {{k|m}} cycles between a list of significant structures where your player is, a regional map (matching what you travel on when away from any site), and the aforementioned world map.

The {{k|c}} key will only show clouds on the region map (the one you travel on outside of sites). Some clouds will be visible regardless of the state of this option.

The {{k|h}} key will cycle through various amounts of the bottom bar of content hidden. The effects of each press are:

* 1 press: hide key reference. Allows you to see status effects on your character if obscured by the key list.
* 2 presses: hide most local name, reducing the bar to one line of text.
* 3 presses: hide less local name, eliminating the bar entirely.
* 4 presses: shows all information

== Status and Information ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|l}}
| Look around
|-
| {{k|Space}}
| Advance/Clear Messages
|-
| {{k|a}}
| View Announcements
|-
| {{k|z}}
| Status
|}

=== Looking Around ===

If you're not sure what a tile is, the {{k|l}}ook command will tell you. In addition to being useful for identifying tiles and creatures, you can also view creatures' equipment and what items are sitting on the ground in a given tile. If in doubt, try the look command.

Move the cursor to the tile you want to look at using direction keys and {{k|Shift}}+direction. It's possible to look up and down z-levels (assuming you have line of sight) using the {{k|<}} and {{k|>}} keys. This, for example, allows you to find out if any flying creatures are above you. Hit {{k|Esc}} to exit look mode and go back to movement mode.

=== Messages ===

The game makes frequent use of messages on the screen to tell you what is going on. If there are a lot of these you may need to use {{k|Space}} to display the rest of the messages that won't fit on the screen. You can always go back and view old messages by pressing {{k|a}}.

=== Status Screen ===

This screen shows your skills, attributes, wounded body parts, health (along with more detailed descriptions of your wounds), lets you view your description, and change your nickname if you want.

=== Saving the Game ===

Hit the {{k|Esc}} key at any time and select {{DFtext|Save Game}} to save your game. You can then come back to it later by using the {{DFtext|Continue Playing}} option in the main menu.

== Searching and Manipulating ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|u}}
| Interact with building, furniture, or mechanism
|-
| {{k|L}}
| Search the nearby area very carefully
|}

The {{k|u}} key can be used to do stuff like pull levers in your abandoned forts. It is also used to lower and raise the bucket when standing right next to a well so you can get water to refill your waterskin with.

{{k|L}} will perform a thorough search of the area that you're standing in, possibly revealing some small creatures.

== Managing Equipment ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|i}}
| Show Inventory
|-
| {{k|d}}
| Drop an item
|-
| {{k|g}}
| Get (pickup) an item off the ground
|-
| {{k|p}}
| Put an item into a container
|-
| {{k|r}}
| Remove an item you are wearing or from a container
|-
| {{k|w}}
| Wear an item
|-
| {{k|I}}
| Interact with an object in an advanced way. (unstick a weapon, refill waterskin etc.)
|-
| {{k|q}}
| Sheath your weapons and shield. (Frees your hands for tasks such as climbing or grabbing)
|}

=== Inventory ===

Press {{k|i}} to display a list of what you are currently carrying. Press {{k|-}} {{k|+}} {{k|*}} {{k|/}} to scroll the list. This list will show you if items are being worn, held in hands, stuck on your body, or are inside a container. Detailed information about an object can be viewed by pressing the key associated with the item.

=== Getting/Dropping Things ===

You can {{k|d}}rop items in your inventory, as well as {{k|g}}et items on the ground on the same tile that you are standing on. If there is more than one item a menu will be listed. Press {{k|-}} {{k|+}} {{k|*}} {{k|/}} to scroll the list if the list is too long to fit on the screen. Note that getting something makes your adventurer pick something up with his or her hands. This often means that you have to use {{k|q}} to sheathe whatever you have in your hands before you pick something up. If you do not (and you do not have a backpack or some other way of storing the object, your adventurer will not pick the item up.

{{k|g}} will also allow you to ignite foliage/any flammable objects adjacent to you. Fires aren't as devastating as one might imagine, but they will cause (most) enemies to path around them, making your crowd control slightly more effective when taking on multiple enemies. As an added bonus, it will also surely piss off the elves.

=== Containers ===

Items can be placed into containers with {{k|p}} and removed with {{k|r}}.

=== Wearing ===

Items can be worn using {{k|w}} and removed using {{k|r}} (the same command used for removing from containers). If an item you want to wear does not show up as an option, then it means you are already wearing too many items in the location used by that item. Try {{K|r}}emoving items in that location and then wear them again in order of priority. You also must put on equipment in an order that makes sense,. for example a shirt first ''then'' the armor, not the other way around. Armor must also be put on in a sensible manner with flexible layers such as chainmail first then rigid plate armor second. After all, who, in real life, would wear chainmail over a hard plate?

''Note that "large" or "small" clothing items are too big / small for your race'' (e.g. a '''large''' giant cave spider silk sock). If you have that problem, try getting clothing from a different source.

After acquiring [[armor]] from one source or another, you'll most likely want to equip it. To do this, first make sure it is in your possession--not on the ground. You can then {{key|w}}ear it, granted you don't already have too much on that equipment slot already. You can {{key|r}}emove or {{key|d}}rop inferior equipment as necessary.

See [[Armor]] for more information on wearing things. One thing to note in particular, DF allows you to wear more than one item in the same location in many situations, for example a copper mail shirt and a copper breastplate. The thin, flexible chain can be worn under the breastplate, but not the other way around.

=== Wielding ===

There is no command for wielding items such as [[weapon]]s in specific hands. Instead, they are automatically equipped when you either {{k|g}}et them from the ground or {{k|r}}emove them from your [[backpack]] - provided the hand that would wield them is free. So in order to change [[weapon]]s or [[shield]]s you should drop items or place them into containers (such as your backpack) until your hands are free, then get items from the floor or remove them from containers which will place them in your hands. For example, put all items into backpack, remove sword from backpack, remove shield from backpack. The items will end up in the right and left hand. Simply remember the {{k|r}}emove command and the {{k|p}}ut into container command.

While normally one would only be able to equip one item in each hand, removing items from your inventory results in them being wielded regardless of whether one's hands are full. This is especially useful with shields, as every shield will contribute a block chance to each incoming attack.

Once equipped, weapons and shields can be quickly drawn and sheathed with {{k|q}}, instantly preparing for attack or freeing your hands. Any number of weapons can be strapped, but only one for each hand will be drawn. Others can be manually {{k|r}}emoved for use, and stowed again without occupying other inventory containers.

It should be noted that Dwarf Fortress does not enforce one particular hand as dominant for everyone, so do not be surprised if your character holds the weapon and [[Armor#Shields and Bucklers|shield]] in hands you yourself would not hold them in.

=== Advanced Interaction ===

The {{k|I}} key allows "complex interaction" with objects in your inventory.

This is used for removing arrows and weapons stuck in wounds which will appear in your inventory when they become stuck in you. Removing stuck arrows can cause bleeding so it is not always a good idea mid combat, but stuck objects will slow you down as you are encumbered by their weight. It s best to remove them as soon as possible when it is safe and you are not in danger of bleeding to death.

Advanced interaction can also be used to steal enemy equipment. Use [[wrestling]] to grab hold of a piece of enemy equipment, such as their weapon, or a helmet protecting their squishy brain and it will appear in the advanced interaction menu. Simply grab the item with a free hand and pull away. If successful, you will now be holding that item in your hands.

This command is particularly useful for getting water. When standing next to a well you press the {{k|u}} key to lower, then raise the bucket, yielding 10 units of water in the bucket. Then you can press the {{k|I}} key to fill your waterskin from the full bucket (alternatively you can press the {{k|e}} key to drink directly from the bucket).

Advanced interactions can be used next to a campfire to heat things, such as any frozen liquids you have in your inventory (or snow lying on the ground) and need to drink. You can refill waterskins from a nearby liquid source as well

===Sheathing===
The {{k|q}} key lets you strap your weapons to your back.

This is useful because you can't climb or wrestle with your hands unless your hands are free.

People will also be less likely to be scared of you on first sight if you don't appear to be ready to attack.

== Time and Weather ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|D}}
| Date
|-
| {{k|P}}
| Temperature
|-
| {{k|W}}
| Weather/Time
|}

The game has a day/night cycle with time passing as various actions take place.

When using quick travel mode, the top line of the screen will indicate the position of the sun in the sky with a yellow "☼"; further to the right of the screen is earlier in the day and further to the left is later in the day.

In local travel mode you'll have to use the {{k|W}} command to learn the position of the sun, when you're in a place where the sun is visible.

At night you won't be able to see nearly as well and you will be more vulnerable to ambush.

The game also has weather and temperature. The most common weather you'll experience is rain. Rain is shown as blue moving dots on the local travel screen and will unsurprisingly cause everything outside to become wet. Temperature is important because if it happens to drop below freezing while you're swimming through water, you'll instantly die from being encased in the ice.

Therefore you might want to keep an eye on the temperature while swimming, especially if it's getting cold.

Also, unlike fortress mode, rivers/other bodies of water can be liquid during the day, and freeze at night. The cycles of freezing can also be erratic from day to day.

Freezing weather can also freeze liquids in your inventory solid, making them undrinkable. If your water freezes and you are thirsty, make a campfire and {{k|I}}nteract with your waterskin to heat it over the fire and melt the ice.

== Sleep ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Z}}
| Sleep
|}

Eventually your character will become {{DFtext|Drowsy|1:0}} and this will get worse until you get sufficient sleep.

Sleep does not necessarily have to coincide with night, but if you're traveling alone when night comes you'll be in danger of being attacked by [[Bogeyman|Bogeymen]]. To avoid this while traveling solo you need to make it to shelter before nightfall and sleep the night away inside a building or abandoned lair. Enter a building, use {{K|k}} to talk to a human, and ask for permission to stay the night. Next press {{K|Z}} to sleep, {{K|d}} to sleep until dawn, then {{K|Enter}} to confirm. ('''NOTE''': If you stay the night in a castle, you have to sleep in the keep which houses the lord/lady of the castle. Sleeping inside the castle but outside the keep still leaves you vulnerable to attack.) Sleeping on an ocean beach also prevents bogeymen from attacking. (If you'd rather not deal with bogeymen, you can disable them by generating a world using [[advanced world generation]] and setting "Number of Night creatures" to 0)

Though sleeping inside can be safe, it's also limiting: any quest site you want to go to has to be within a daytime's round-trip time of a safe habitation, and you have to make your way to there by hopping from one habitation to the next, sleeping at each along the way. A way to avoid this is to travel with companions. If you have any companions with you then Bogeymen won't attack you. You'll still have to sleep at night, though, both to avoid sleep deprivation and because there's no visibility at night. You can still be ambushed at night by wildlife, but that's much less likely than being ambushed by Bogeymen when traveling alone. If you find yourself alone at night with nowhere safe to sleep, the safest bet is to keep traveling until dawn, even if that means running around in circles. You will eventually feel unwell from sleep deprivation, but this can take a considerable amount of time. You can make up for lost sleep once you've found your way to safety.

Note that sleeping in lairs, shrines, and labyrinths makes you safe from ambush, assuming that you or someone else has killed whatever was living there. If you have sufficient shrines/lairs/etc between you and your goal and they are either uninhabited or inhabited by things you are capable of killing then you can travel from lair to lair using each lair as a safe lodging. This is much safer than sleeping out in the open, day or night, even with companions.

If no other options are available, completely surrounding yourself with campfires will keep night marauders at bay as they cannot pass through the fires; the fires will go out after several hours and enable you to move on (you may also be able to jump over the fires). The bogeymen or other enemies may be outside your line of sight, which will prevent you from firing arrows or throwing things at them. In this case, you will have to stand up and lie down {{K|s}} repeatedly until the enemies wander into your range, the fires go out and the enemies can path to you, or dawn breaks.

It should be noted that, as of DF2014, climbing trees and sleeping on them will prevent Bogeyman attacks, as well. This is especially useful if you prefer to play solo, and do not wish to have an army of followers in your employ. This is also useful if you prefer to engage enemies at your own pace (such as via stealth), rather than having your entire follower party immediately charge at anything that is hostile to you. Be wary though, as bogeymen may still be able to reach you by climbing.

== Food and Drink ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|e}}
| Eat or drink something
|}

To find water, you must find a river, stream, or well in a town and fill your waterskin from it, or drink from it directly. Water that may be covering you or your items will not be able to satisfy your thirst.

Note that drinking vampire blood will turn you into a vampire instantly.

Make sure to eat or drink regularly even if you're not hungry or thirsty, as you can only eat or drink thrice at a time: after that you'll need to rest, or wait until you can consume another meal. If you find yourself in need of both food and hydration, make sure to take care of the most urgent problem first, as if you are moderately hungry but severely dehydrated and eat three times, you may die before you have another chance to drink.

If the temperature is low enough you might have trouble finding liquid water. Snow and ice can be heated into water by first making a campfire with {{k|g}} and then performing an advanced interaction with {{k|I}} on the ice or snow in your inventory to heat it. Advanced interactions with your waterskin can also be used to gather water from water sources, or snow from the ground.

== Combat ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Attack adjacent hostile creature
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Attack adjacent hostile creature
|-
| {{k|A}}
| Attack an adjacent creature.
|-
| {{k|f}}
| Fire a projectile
|-
| {{k|t}}
| Throw an item
|-
| {{k|C}}
| Open combat preferences interface
|}

[[Combat]] is the fine art of using physical force to cause injury and death, and it is particularly fun in Dwarf Fortress.

=== Melee Attacks ===

Hostile creatures can be attacked using a non-aimed attack by simply advancing towards your enemy using the arrow keys. Doing a non-aimed attack will also have a chance of freeing up any stuck weapon, though you are more likely to accomplish this by moving away from the enemy, or complexly interacting with the weapon.

Any creature can be attacked by standing next to it and pressing {{k|A}}. Attacking a friendly or unconscious creature (which includes wild animals for elves) will further require a confirmation, given using {{k|alt}}+{{k|y}}.

After selecting (and maybe confirming) which creature you want to attack, {{k|a}} will allow you to make an '''aimed attack'''. You must first select the body part that you want to attack. Look at the difficulty rating for various possible attacks. Impossible attacks will be impossible to land and Easier attacks will be very easy to land. The difficulty rating for an attack does not change depending on your weapon skill. Based on player experiences, a Grand Master weapon user can almost always land a "Tricky" strike, while a Novice generally cannot. Attacks on various locations will also have limits on how "squarely" they can land (due to being out of reach, for example). Square and very square attacks will deal more damage.{{Verify}} Attacks which "can't land squarely" are generally still effective.

Attacks aimed at the head are the most effective; a single attack to the cranium with a weapon will usually put an end to the fight. Aimed attacks are especially useful for dismembering opponents. Opponents who are missing a foot will fall over, thereby greatly lowering their speed, and giving you an immediate edge in the fight. Cutting off both hands also highly recommended for obvious reasons. After all, a field full of armless, one-legged enemies can be a big experience booster for your companions.

Aimed attacks are also especially helpful when fighting giant beasts. Some enemies like giant desert scorpions have lots of redundant body parts, and random attacks waste valuable time on low priority areas while the scorpion is busy injecting venom into the whole party. Lastly, aimed attacks allow you to grab trophies that are not available via butchering. For example, a minotaur's horns can be cut off during a fight, but since its a humanoid, most adventurers will refuse to butcher its corpse after the fight. However, in Dwarf Fortress 2014, all butcherable corpses are able to be butchered, as long as the corpse isn't too mangled.

There are several options below the hitting menu. Quick attacks are faster than regular attacks but weaker. Heavy attacks are slower but attack harder. Wild attacks are faster and hit harder but are inaccurate. Precise attacks are very slow but are much more likely to hit. Multi-attacks allow you to attack several times in a row at a great cost to the effectiveness of any one of the chosen attacks.

=== Ranged Attacks ===

To attack with a ranged weapon press the {{k|f}} key with a ranged weapon (bow, crossbow, etc.) equipped on one hand and select the square where you want to attack. Note that you need to have some sort of ammo, corresponding to the type of ranged weapon you are using (for example, bows use arrows, crossbows use bolts). Otherwise, a message stating "You have nothing left to fire." is displayed in brown. Similarly use the {{k|t}} key to throw any random object in the same manner. Random objects appear to make a random attack if they happen to have more than one possible type.{{Verify}} For example, if you throw a sword it may hit with a blunt impact, a stabbing impact, or a slicing impact. Throwing crossbow bolts with sufficient throwing skill and strength seems to have an effect similar to firing them, although less powerful. On the plus side, you will never lose ammo if you throw it.

It is not possible to aim for specific body parts with ranged or thrown attacks.

Throwing is generally a good skill to have for any adventurer, as it allows you to slow down fleeing foes, both on the ground and in the air without the need of equipping a (cross)bow. Just like {{k|l}}ooking, you can use throwing to view and hit enemies multiple Z levels away from you. If you're lucky, you can simply land a hit that causes the flying enemy to give in to pain, and then let gravity do the rest of the work. Even if the fall doesn't kill them, they will most likely be stunned long enough for you to run up and slaughter them.

=== Wrestling and Unarmed Attacks ===

:''Main article: [[Wrestling]]''

'''[[Wrestling]]''' (grappling) can be performed by selecting an enemy via {{k|A}} followed by {{k|b}} to wrestle. You can wrestle any enemy. Wrestling works somewhat like a targeted attack. Once you grab a creature by some body part, you may be able to make another wrestling attempt that will allow you to perform a throw or takedown.

For a detailed list of moves such as takedowns, throws, choke holds, etc., see [[Wrestling]].

It's also possible to punch, kick, and bite. These are not in the wrestling menu but are performed like normal targeted attacks with {{k|A}}.

=== Weapons ===

[[Weapon]]s are basically divided into axe, sword, spear, pike, mace, whip, bow and hammer, with various versions of these taking up the gray area.

=== Wounds ===

If you get wounded during combat, there's not much that you can do except perhaps run before you get more wounded. Your wounds will heal over time, so just travel around or sleep in a safe place. Some wounds however may never heal, leaving you permanently crippled. Obtaining a crutch may help with this. Or if you are not already a vampire, then you can get bitten by a werebeast during full moon, which will heal all injuries once per month.

If you have some bolts or arrows stuck in your body, they can be removed by using the complex interaction menu {{k|I}}. Select the stuck bolt or arrow from the list and then pull it out with {{k|a}} You'll probably start bleeding after you pull it out, but the bleeding is rarely anything to worry about.

=== Combat Preferences ===

At any time during gameplay (Except fast travel mode), you can press {{k|C}} to open the Combat Preferences menu. There are three different preferences you can set: Attack, Dodge and Charge Defense. These have a few different preferences each:

*'''{{k|a}}ttack'''
**'''According to Opponent''' - The default setting. When set to this, charging happens more or less frequently, depending on the difference in size between you and the opponent. Bigger opponents get charged less, smaller more often. Can be very risky, since a random charge against a huge opponent is likely to get you knocked down and stunned. In the same vein, charging when close to obstacles or other environmental hazards is very dangerous, potentially fatal, if the enemy dodges you.
**'''Strike''' - This setting ensures that you never charge an opponent, but rather just swing your weapon at them. This carries less risk than the above, but you're never going to knock anyone down without hitting their legs or spine. Very preferable against large opponents.
**'''Charge''' - When set to this, you ALWAYS charge. When faced with numerous small enemies (Bogeymen in particular), this can be extremely useful, but remember to switch back when facing something bigger. Charging a large dragon is almost a certain death sentence.
**'''Close Combat''' - With this setting, all your auto-attacks are grapples. Generally not very useful, since the random nature of it tends to prevent you from actually doing any damage with it, but if you continually auto-attack a harmless creature with it your wrestling-skill will be legendary in no time.

*'''{{k|d}}odge'''
**'''Move Around''' - This means you can jump away from attacks, physically moving in a random direction. While this lets you dodge attacks more often, it can also result in you jumping into a wall or down a lake. If you're fighting in really tight spaces, or areas with large pits, you might want to switch to the other option.
**'''Stand Ground''' - As can be expected, you stand your ground. No jumping around, which is useful in the above situation, but risky in the open. If you have room for jumping around, go with Move Around, but otherwise this could be a good idea.

*'''{{k|c}}harge Defense'''
**'''According to Opponent''' - Again, the default setting. You're more likely to stand still against small enemies charging, but will probably prefer moving away from larger ones. Somewhat risky, in that even a somewhat small enemy can stun you by charging.
**'''Dodge Away''' - With this, you'll dodge away from charging enemies, if you can. It's not a sure bet, but it's very much worth it against enemies who like to charge. This is probably the most preferable mode, since you're not losing a whole lot by dodging a small foe charging, but dodging an angry night beast can save you from a world of pain.
**'''Stand Ground''' - If you're certain of your physical superiority to the opponent, you can safely choose this. Standing your ground like a real man/woman might feel hardcore, but getting knocked down in a fight can be extremely dangerous. It probably has some use against bogeymen though, since they're quite small. If you really are much bigger than the enemy, you'll end up knocking THEM down. Most of the time though, charges heavily favor the attacker, so dodging away is probably preferable.

Using Combat Preferences properly can actually save your hide, so it's worth fiddling with. Just don't forget that you've fiddled with them, since a misplaced charge or dodge could end up killing you.

== Talking ==
[[File:Advmode_conversation_DF2014.png|thumb|400px|Talking to someone in Adventurer mode.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|k}}
| Talk to somebody
|}

Now that you know how to kill people, you may also want to know how to talk to and otherwise interact with them in a less violent manner. While this is less entertaining, it can sometimes be useful.

To begin a conversation, press {{k|k}}. Unless someone else has already started a conversation with you (see below if someone has), you will get a cyan X that can be positioned over people you want to talk to with the normal directional keys. Use {{k|-}} and {{k|+}} to select who you want to talk to. Aside from individuals, you can also {{DFtext|Shout out to everybody}}, which will have you talking with everyone in earshot, or you can talk to your deity.

Whenever you want to advance the conversation, you have to press {{k|k}} again and choose the ongoing conversation you wish to continue. You will also see ongoing conversations from people who have started a conversation with you. If you want to talk to someone else during this time, simply {{DFtext|Start a new conversation}}.

* {{DFtext|Greet listener}} — Has you offering a greeting to someone, when you're initiating the conversation.
* {{DFtext|Bypass greeting (new menu)}} — Skips the greeting, taking you straight to the normal conversation menus.
* {{DFtext|Reply to greeting}} — If you aren't the one who started the conversation, this option will let you reply to someone's greeting. They will then talk about some trouble.
* {{DFtext|Refuse conversation}} — Causes you to explicitly refuse to talk to someone who started a conversation with you. Unknown if this has a different effect from simply not doing anything.{{Verify}}
* {{DFtext|Reply to greeting (impersonation)}} — Like {{DFtext|Reply to greeting}}, except you're impersonating a deity.
* {{DFtext|Nevermind}} — This has you back out of having a conversation.

When you start talking to someone, you are presented with a wide array of things to talk about. (If the person you are talking to started the conversation and told you about some trouble, you'll first get a menu related to that trouble. Just press {{k|-}}-{{k|Enter}} to {{DFtext|Change the subject (new menu)}} and get to this first menu.) Your choices are as follows:

{| class="wikitable" style="border:1px solid #ccc;"
| style="text-align:right;width:30%;" | {{DFtext|Return to current topic (new menu)}}
| You'll see this option only if you chose to change the subject in another menu. This will, predictably, take you back to that subject.
|-
| style="text-align:right;" | {{DFtext|Bring up specific incident or rumor (new menu)}}
| Allows you to spread rumors or summarize conflicts you've been a part of. The next step of the conversation will bring up a menu of choices that allow you to ask for directions to places or state your opinion on the incident/rumor.
|-
| style="text-align:right;" | {{DFtext|Create a performance troupe together (group naming menu)}}
| If the listener is in your party as a performer, you can choose this option to create an official troupe.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Ask to become a hearthperson}}
| Only appears when talking to a leader who you aren't under the command of. Allows to become one the leader's guards.
|-
| style="text-align:right;" | {{DFtext|Invite listener to become a hearthperson}}
| Only appears when you are a leader. Allows to become one the leader's guards.
|-
| style="text-align:right;" | {{DFtext|Ask to be made a performer for group}}
| Only appears when you are talking to a leader. Allows you to become performers for the group. Usually, you need to prove your performing capabilities to be accepted.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Ask for your performance troupe to become performers for group}}
| Only appears when you are talking to a leader. Allows your performance troupe to become performers for the group.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Request duty or advice pertaining to service as a hearthperson}}
| Only appears when talking to a leader who are under the command of. You will receive some task to accomplish for the group, if there is anything that needs doing. In 42.xx, these will include killing monsters and bandits, or causing trouble for other groups. Completing these tasks will allow you to gain fame as a loyal soldier in addition to the fame from slaying the beast or killing the bandits.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Bring up the journey together}}
| Only appears when talking to a companion. The next step of the conversation will allow you to cancel the agreement you made with that person, if you so choose.
|-
| style="text-align:right;" | {{DFtext|Inquire about any troubles}}
| Asks the listener what things in the world are bothering them and their people.
|-
| style="text-align:right;" | {{DFtext|Ask for directions (new menu)}}
| Allows you to ask for the location of a specific creature or site. People aren't guaranteed to know, and may instead direct you to someone who does.
|-
| style="text-align:right;" | {{DFtext|Ask about the local ruler}}
| As you might imagine, this gets you some information on who controls this particular area.
|-
| style="text-align:right;" | {{DFtext|Trade or settle debts}}
| Allows you to trade with a merchant or pay for your drink from a tavern keeper. Note that you have to be right next to them for this to work.
|-
| style="text-align:right;" | {{DFtext|Ask about available services, drinks, rooms, etc.}}
| Appears when in a structure, but only works with tavern keepers. Allows you to purchase drinks and rent rooms in a tavern.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Exchange, give, or take personal items}}
| Like {{DFtext|Trade}}, only that it works with non-merchants.
|-
| style="text-align:right;" | {{DFtext|Ask favor, place request, make demand or issue order (new menu)}}
| Takes to a menu of various request you can make, including asking the listener to yield, stay put, or pay homage to your group. The options available depends on who you're talking to.
|-
| style="text-align:right;" | {{DFtext|Ask listener to join you (new menu)}}
| This is how you get companions. You can either ask them to join you on an adventure, to lead you to some location, or to join your performance troupe if they are convinced of your skills.
|-
| style="text-align:right;" | {{DFtext|Claim this site for yourself (group naming menu)}}
| This option allows you to stake a claim on the site you are in.
|-
| style="text-align:right;" | {{DFtext|Ask for permission to stay a day}}
| Allows you to sleep in the listener's building for the night.
|-
| style="text-align:right;" | {{DFtext|Ask about the structure you are in}}
| Tells you about whatever structure you are standing in, if you are standing in one.
|-
| style="text-align:right;" | {{DFtext|Ask about this site's neighbors and trade partners}}
| Lets you learn what sites this site is neighboring and/or trading with.
|-
| style="text-align:right;" | {{DFtext|Ask about the surrounding area}}
| Choosing this will tell you about some location nearby, and why it's significant.
|-
| style="text-align:right;" | {{DFtext|Express your emotions (new menu)}}
| Brings you to a menu where you can state your feelings about an event (such as improving a skill), or say something general about your emotions or thoughts.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|State your values (new menu)}}
| Lets you state one of your [[Personality_trait|value]]s. Doing so will start an argument with the listener if they have differing values, and can train your Persuader, Judge of Intent, Flatterer, Intimidator, and Pacifier [[social skill]]s depending on how you argue.{{version|0.42.01}}
|-
| style="text-align:right;" | {{DFtext|Comment on weather}}
| Small talk about the weather. Really.
|-
| style="text-align:right;" | {{DFtext|Comment on natural surroundings}}
| Same as the weather, only about the nature around you.
|-
| style="text-align:right;" | {{DFtext|Accuse listener of being a night creature}}
| If chosen against a night creature, such as a vampire, it will expose them. Normal individuals will just think you're losing it.
|-
| style="text-align:right;" | {{DFtext|Inquire about listener's profession}}
| Learn what it is the listener does. Useful for lords and ladies and anyone else whose profession isn't listed next to them.
|-
| style="text-align:right;" | {{DFtext|Ask about listener's family}}
| Discover what family the listener has, as expected.
|-
| style="text-align:right;" | {{DFtext|Brag about your past violent acts}}
| Causes you to brag about whatever last violent act you did. Doesn't seem to have an effect, or at least severely less impactful than summarizing the conflict.{{Verify}}
|-
| style="text-align:right;" | {{DFtext|Say goodbye}}
| Ends the conversation.
|}

Note that you can press {{k|Esc}} to not choose anything. The conversation is still ongoing, you have to explicitly say goodbye to end it. Pressing {{k|Esc}} is useful if you need to double-check something before talking.

== Companions ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|c}}
| View companion interface
|}

Companions are the guys who follow you around after you've asked them to join you and they've accepted. Your character will have a limit on the maximum number of companions that is based on fame/reputation level and the ''Social Awareness'' attribute. With average social awareness and the maximum level of fame, the limit is 19 companions. Note that people with no military skills are unlikely to agree to join you, and people with military skills higher than yours will also be unlikely to join you.

You can use the {{k|c}} key to open up a list showing your companions and their relative position to you. This can be useful if one of them runs off somewhere and you want to find them. You can select specific companions who are in visual range in order to view them. This is the same as viewing them with {{k|l}}ook.

You can give or take equipment with a companion by choosing to talk to them and selecting {{DFtext|Exchange, give or take personal items}}. An evil and arguably inefficient way to get equipment is to intentionally get your companions killed and then take their stuff. If you are trying to help your companions, it is important to note that they prefer to store exchanged items in a personal container rather than to equip said items. You must convince your companions to trade away any containers (pouches, quivers, backpacks, etc.) as well as the equipment that you are attempting to replace. Once you have given your companions almost no choice in the matter, they will equip the new items and a message like {{DFtext|The Swordsman reorganizes his possessions.|6:1}} will be displayed.

If they survive long enough/are trained well enough then companions are capable of leveling stats and skills. Thus they are susceptible to gaining a title or having a job title change as well.

Your companions will continue to follow you and fight hostile creatures around you until they die (if you asked them to join you on an adventure) or get you to the proper location (if you asked them to guide you some place). If you want to get rid of your companions at any time, the safe way is to talk to each one of them, ask them about their journey with you, and then cancel the agreement.

If your companions are too far away from you when you enter fast travel, they will become an asterisk on the map where you started fast travel from. This asterisk may try to join up with you during travel. If you keep losing your companions while traveling through rivers, try going to a spot where the river becomes a "minor river" (shown by a single dark blue line). Brooks are obviously also safe to cross.

{{new in v0.42}}
In v0.42, you can have companions join you as performer after you convince them of your skills. This can be used to recruit people you normally couldn't recruit, such as civilians and stronger soldiers.

== Personal Finance ==

=== Trading (barter) ===

In human towns (not hamlets or castles), you can find shops,in Elven Trading trees you can find markets and at depots in dwarven fortresses you can encounter brokers. Once you're inside of a [[shop]] and right next to any of the NPCs, you can use {{K|k}} to {{DFtext|Trade}} with them. Use {{K|Enter}} to select which items to trade, left/right arrow keys to switch between the list of shop items and your items, and up/down arrow keys to scroll through the lists. You can also either {{k|a}}sk for or {{k|o}}ffer currency as part of the process. Once done, press {{K|t}} to trade. The shopkeeper won't get angry if you're not offering enough in trade, so you can start offering just a few items, keep trying again with a little more until the trade is accepted. Once the trade is accepted all of the items you offered will be on the floor underneath you.

After trading, you will find the stuff you gave on the floor at your feet, and the stuff you got in your inventory.

=== Theft ===

You may also pick up the item before buying it, but you should never walk out of a shop carrying an unbought item, as that is theft. It is punishable by death if you are caught, and excommunication if you are not. On any occasion when you have stolen goods from a store (indicated by dollar signs on either side of the item in your inventory), the game requires you to exit the site ''and'' move a considerable distance before allowing you to quick travel. This may make a getaway more difficult if your adventurer is not already faster than anyone else. This only applies to goods in stores; killing townsfolk and taking their personal things, including those of the shopkeep still only requires exiting the site. The moment you are out of sight, you will be able to warp out as usual. Theft and murder remain within entities; even depopulating one country and stealing all its things will not generate ill response in another country.

In some cases, the shop will be abandoned. This will be made clear by the presence of unbought items and the lack of any merchants in the area. You will not be considered a thief by the relevant entity for taking stuff from an abandoned shop.

If the item name is not surrounded by dollar signs, it is never considered stealing, even in situations where it would be in real life.

=== Managing coins ===

You will find that coins from one civilization are nearly worthless in other civilizations. This will typically result in adventurers carrying around lots of now useless coins. Coins can and will encumber your adventurer, eventually reducing your speed. To reduce that effect you can try to exchange your copper and silver coins for gold ones as well as sell all of your loot directly for gold coins. Remember, merchants will always try to pay you in higher denomination currency first but will resort to lower value coins if they run out of anything higher. First, check the merchant's chest to see how much of each type of coins they have.

Coin values are as follows:
* Copper Coin = 1☼
* Silver Coin = 5☼
* Gold Coin = 15☼

To receive the maximum amount of gold coins from that merchant, make sure the amount "they owe you" during the trade is equal to (total amount of gold coins the shop has)*15☼ . If you are selling loot, simply make sure you only trade this worth of goods, and move on to other merchants for the rest. If you wish to exchange copper and silver coins for gold, buy random goods from the merchant until their price is around this value and then sell back all of the goods for their original value but in gold.

Alternatively, you can take your excess coinage and use it to purchase [[Gem|large gems]] at a trinket shop. Large gems make good investments because they are 1) light, 2) variably priced, and 3) equally valuable between different civilizations.

A few goods are strictly superior to all forms of coinage as a store of value, most notably giant cave spider silk items. A suitably sneaky (or powerful) adventurer can murder a few dwarves or goblins for such items for trade and sale for human goods. Giant cave spider silk is a non-renewable resource in a given world - please harvest responsibly.

=== Where to get items to sell ===

The best place to get items to sell is at bandit camps, after you've slaughtered all the bandits. You can loot the clothes and equipment off of the corpses of the bandits (and off your fallen companions, too), plus at the very center of camp there'll be a few scattered weapons and a few bags/chests containing various goods.

The next best way to get items to sell is to kill a creature, butcher their corpse (see below for how), and pick up the edible bits. Butchered bits from the corpses of people (dwarves, elves, humans, etc.) can sometimes be found in monster lairs and these seem to be just as desired by shopkeepers as the products you gain from your own butchering.

Another good early source of income can be bags left in houses and shops, which usually contain plants and food. No one will complain, and the plants inside can be sold at about 2☼ each plus the value of the bag.

At the bottom of the list comes {{k|L}}ooking carefully and selling any small creatures you might find. However, shops will not accept live creatures unless they are in cages. Some rocks, piles of sand, and other things found on the ground nearly everywhere can also be sold for 1☼ each.

You can also try filling your backpack from river - it can hold up to 100 units of water which is worth 100☼ total. After your sell it, water will drop to the floor as a pool, and backpack can be refilled instantly and for free from there. In fact, you can infinitely fill any container from any pool/pile of any liquid/powder, so if you happen to find some precious substance like [[sunshine]] or [[dwarven sugar]], money won't be a problem for you anymore. This is of course an [[exploit]], liable to be fixed at any time. It may be useful in a pinch, but don't rely on it.

Another devious method is to go outside the shop, {{k|g}}rab handfuls of mud and throw it into your backpack, then sell them for 1☼ each. The merchants will gladly buy your rare and valuable mud despite the unlimited free mud just outside their shop.

== Quest Log ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Q}}
| Open quest log
|-
| {{k|Esc}}
| Exit quest log
|-
| {{k|e}} {{k|p}} {{k|s}} {{k|r}} {{k|b}}
| Access various lists
|-
| {{k|m}}
| Switch between the world map and additional info
|-
| {{k|z}}
| Center cursor on location of selected list item, if known
|-
| {{k|c}}
| Center cursor on your location
|-
| {{k|l}}
| Toggle the visibility of the line between you and some other point on the map.
|-
| {{k|f}}
| Filter the list
|-
| {{k|+}} {{k|-}} {{k|*}} {{k|/}}
| Navigate the list
|}

The quest log contains everything you know about the world, such as various events going on, people you know, and various sites. The {{k|m}} key will alternate between a world map that you can navigate, and information on whatever item is highlighted in the list to the right.

There are various kinds of lists you can check on the quest log:

* '''Events''' — A list of events that are happening or have happened. Formatting of the list is {{DFtext|(type)/(description)}}. You can center on the location of the event if you know this. This list is the closest you'll get to some formal quest system.
* '''People''' — A list of people you know. At the start of the game, this list will contain people in your site.
* '''Sites''' — A list of various sites around the world.
* '''Groups''' — A list of groups you know of and your relation to them. Note that you have to press {{k|e}} when you're on the events list in order to reach this list, requiring you to press {{k|e}} at most twice.
* '''Regions''' — A list of regions. The additional information will list the biomes a region possesses.
* '''Bestiary''' — A list of creatures, their characteristics, and where you could find them.

==Crafting==
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|x}}
| Perform action (butcher, create item...)
|}

Adventurers can perform limited crafting, (also known as "reactions"). To access the crafting menu, press {{k|x}}.

* '''[[Knapper|Knapping]]''' allows an adventurer to sharpen a rock. Knapping only works on stones on the ground or in your hands. Choose the {{k|c}}reate option and then select "Make sharp stone". You will be prompted to choose a rock to sharpen ("tool stone"), and then the rock that is to be the hammerstone. The tool stone will be replaced in your hand by a sharp version.

* '''Butchering''' acts similarly to Fortress Mode's [[Butchery]] by converting a corpse into edible products, bones, and skin. A corpse must be on the ground or in your hand. With a sharp object (such as a dagger or knapped stone or even a bolt/arrow) in your hand or on the same tile of the corpse, select the {{k|b}}utcher option, and then you can select the corpse and the sharp tool to butcher with. The corpse will be replaced by its butchering returns.

* '''Spitting''' gives you spit, which can be aimed at someone in much the same way as any projectile. To get this, choose natural ability and then spit in the reactions menu.

You may also gain acquired abilities when you become a creature of the night, such as a necromancer.

= Sites =

More information on each type of site can be found in the site's specific article.

== Civilization ==

[[Civilization]]s are organized groups of creatures (generally of the same race) which build sites such as towns.

=== Human Sites ===

==== Towns {{Raw Tile|+|7:0:0}} {{Raw Tile|*|7:0:0}} {{Raw Tile|#|7:0:0}} {{Raw Tile|☼|7:0:0}} ====
Humans live in towns comprised of buildings and often a paved road. Human towns are highly modular, and are usually near some source of water, either the coast or a river.

Towns appear on the fast travel map (when outside a site) as {{Tile|■|7:0:1}} or {{Tile|■|6:0:1}} symbols which are small collections of buildings. When you are near a human site, large yellow blocks indicate where various houses and shops are found (though not all houses and shops can be found in these blocks; sometimes you'll find a house or two out in a site's fields). You usually have to follow the roads in a yellow block on the fast travel map.

Towns usually have lots of interesting structures which are described fully in the [[town]] article.

==== Hamlets {{Raw Tile|æ|7:0:0}} {{Raw Tile|Æ|7:0:0}} {{Raw Tile|{{=}}|7:0:0}} {{Raw Tile|≡|7:0:0}} ====
Most of the time, the majority of a human civilization's population will live in small [[hamlet]]s, which tend to be sprawled out along coastlines and through river valleys. Like other sites, they can be invaded, and you'll sometimes find them captured by other civilizations, [[necromancer]]s, or criminal syndicates. Human adventurers usually spawn in hamlets.

Note that hamlets are similar in structure to towns, only they have mead halls instead of keeps, and don't have any defensive walls.

=== Dwarven Sites ===

==== Dwarf Fortresses {{Raw Tile|Ω|7:0:1}} ====
These are the randomly generated equivalent of the sites you build in [[dwarf fortress mode]]. [[Fortress]]es are described in detail in the own article. Their main function for adventurers is that they have a central, spiraling ramp that connects the underground and above-ground worlds, particularly in that they connect the subterranean tunnel networks to the rest of the dwarf civilization. They are located at the edges of mountain ranges.

Player-made fortresses are considered dwarf fortresses by the game, in addition to the randomly-generated ones.

==== Mountain Halls {{Raw Tile|Ω|0:0:1}} ====
[[Mountain halls]] are the sites of the "deep dwarves," located far beneath the mountains. They can be accessed via down-stairs found in underground tunnels, and are comprised of a couple of levels that contain bedrooms and large halls filled with smelters or forges.

==== Hillocks {{Raw Tile|Ω|7:0:0}} ====
[[Hillock]]s are the dwarf equivalent to human hamlets. They consist of a few circular mounds filled with dwarf citizens. There doesn't seem to be any settlement pattern for them; they are equally likely to be found in any land [[biome]].

=== Elven Sites ===

==== Forest Retreats {{Raw Tile|î|6:0:1}} {{Raw Tile|¶|6:0:1}} ====
Elves live in [[forest retreat]]s located, unsurprisingly, in [[forest]] biomes. They are essentially clusters of huge [[tree]]s with elves standing in and around them.

=== Goblin Sites ===

==== Dark Fortresses {{Raw Tile|π|0:0:1}} {{Raw Tile|π|5:0:0}} {{Raw Tile|π|5:0:1}} ====
These are the main goblin sites. Some [[dark fortress]]es may contain a [[Underworld spire|certain spoiler]].

==== Dark Pits {{Raw Tile|º|5:0:0}}====
These are the goblin equivalent of hamlets and hillocks. [[Dark Pit]]s are essentially canyons lined with wooden guard towers. They tend to be built in huge clusters around the dark fortresses, such that large chunks of the map may be covered with them.

=== Kobold Sites ===
==== Caves {{Raw Tile|•|#808080|#00DD00}}====
[[Cave]]s are sometimes home to [[kobold]] groups. They are mounds filled with narrow tunnels leading to the [[caverns]] and usually contain piles of random loot resulting from kobold [[Thief|thieving]] incursions.

=== Night Creature Sites ===

==== Necromancer's Towers {{Raw Tile|I|5:0:0}} ====
[[Necromancer]]'s Towers are built by necromancers who have at least 50 followers; younger necromancers may take over towns or camps instead. Usually you can find [[book]]s written by the necromancer, some of which contain [[Necromancer#Adventurer_Mode|the secret to life and death]]. Towers require abundant human populations (low savagery, large tracts of neutral land) and a high number of secrets to be generated in world generation, as necromancers cannot be elf or goblin.

==== Lairs ====
Lairs are the homes of [[night troll]]s. Lairs are mounds or holes in the ground with doors or hatch covers. Most night troll lairs are inhabited by a single creature, but sometimes you'll encounter entire families of five or even ten.

=== Megabeast Sites ===
==== Minotaur's Labyrinths {{Raw Tile|#|0:7:1}}====
A Labyrinth is an intricate network of tunnels often filled with the bodies of previous adventurers slain in [[World generation|worldgen]] by its resident [[minotaur]]. As you explore the labyrinth, you will hear the minotaur taunting you.

==== Shrine {{Raw Tile|Å|7:0:0}} ====
Shrines are huge stone structures surrounded by pillars that are the homes of [[Bronze colossus|bronze colossi]] and [[titan]]s. Several of them can be found on a single site, making its exploration particularly hazardous. [[Demon|Demons]] have also been reported to inhabit them.

= FAQ =

== How do I find an entrance to the underworld? ==
Method 1: Most [[Cave|caves]] lead directly into the first [[cavern]] layer. Although it may be possible to learn of some trouble which originates from a cave{{verify}}, your best bet is to ask people about the surroundings, and hope that they mention a cave at some point. If they don't, travel to another site a fair bit away from where you are and ask someone else.

Method 2: Dwarf [[Fortress|fortresses]] are connected to the [[tunnel]] system, which usually connects to the caverns.

Method 3: You can start a [[dwarf fortress mode]] game, dig to the first cavern layer, retire or abandon the fortress, and then return with your adventurer.

The three cavern layers are connected to each other in [[Deep pit|various]] [[Passage|places]], although they are rather spread out and extremely difficult to find with an adventurer.

Additionally, [[Underworld spire|a certain spoiler]] can be found which leads to [[Hell|another spoiler]], deep underground.

== I keep getting maimed! How can I fight without getting seriously hurt? ==
The best defense is a good offense. If you let your enemies attack you, you're (unsurprisingly) likely to get hurt eventually.
* Try to '''avoid fighting difficult enemies until you get some armor'''. Don't fight enemies at all unless you're sure you can beat them. If you're unsure, you're probably going to get hurt.
* If you have good speed, try to '''fight enemies one-by-one''' — keep moving backwards and only attack when you're within range of just one enemy.
* If you have a slashing weapon, try to '''chop body parts off of your enemy''' — it makes them stop fighting for a turn, allowing you to keep attacking them without being attacked in exchange. Chopping off limbs will also weaken your enemies - taking their arms can prevent them from using weapons, taking their legs can make them slow and knock them down. Chopping off their heads will instantly kill them, but it may take a few (or, with larger enemies such as [[troll]]s, it may take more than fifteen) slashes before the head is severed.
* Remember that '''it's better to let your enemy come to you, than to go to your enemy'''. You have to either move or attack. If you move, you can't attack, so if you move within range to attack your enemy, you allow them to have the first strike (unless you're much faster than them). On the other hand, if you let them move within range of you, then you get to have the first strike. If your enemy is one space away from you, use that as an opportunity to throw a knife or a rock at them; worst case, they will get a bruise or a cut; best case, they will start the melee severely crippled. If you're fast enough, then you can simply step back after getting in that first hit, and they'll have to spend their turn approaching you again. Lather, rinse, repeat.
* Follow the advice under [[#Combat Preferences|Combat Preferences]].

== How can I obtain armor as quickly as possible? ==
* The best way would be to rummage through mead halls, keeps, and fortresses, or whatever other strongholds your race makes use of. Not all places will be stocked with equipment, but usually they have something.
** There are also underground locations, such as the dungeons underneath keeps, or the catacombs under temples, that contain plenty of equipment. These underground places are liable to be populated with unfriendly creatures, so beware.
* You can also take along companions and have them killed, or just plainly murder people and loot their corpses for stuff.
* You can earn some money by exchanging some loot with the local populace for coins, and then buy equipment off of soldiers you might meet in towns. Remember that coins only have nominal value in the civilization they've been minted, but gems are equally valuable anywhere.

== How do I increase my skills and attributes? ==

Here are some techniques for raising your skills; very rapidly in some cases.

Most of these skill-raising techniques involve repeatedly entering the same keystrokes. To assist with this you can use a [[DF2014:Macro|macro]] to make entering the same sequence of keystrokes over and over again much easier.

Increasing skills increases associated attributes which may in turn benefit other skills. For example, sharpening rocks using {{k|x}} will increase Knapping which will increase a number of attributes that help with combat skills. See [[Attribute#Skills_by_Associated_Attributes|Skills and Associated Attributes]] for a mostly complete list.

*'''Fighting and Wrestling''' — A good way to raise your Fighting and Wrestling skills and related attributes is to go find a small, relatively harmless animal and wrestle with it repeatedly. You can wrestle hitting {{k|b}} for the wrestling option after selecting the creature to fight. Continually grabbing and releasing a creature is sufficient to raise your skill, and you can do it indefinitely with the same animal as it won't be injured (unless you auto-wrestle it). Wrestling will increase Kinesthetic Sense, Spatial Sense, and to a lesser extent, Endurance. You may also somewhat increase Dodging and Shield User this way as the creature takes swipes at you.<p>It's possible to change your {{k|C}}ombat preferences for attacking and dodging to ''Close Combat'' and ''Stand Ground'', respectively, allowing you to simply walk into the helpless critter to wrestle it. (Standing your ground prevents you from moving to dodge attacks, so your wrestling can continue almost uninterrupted.) You will, however, perform occasional throws and take-downs as long as the creature remains standing, which may result in their eventual bleeding to death. Strangulation is also a repeated concern, as it will render the victim unconscious, thus making you have to wait until it regains consciousness before you can continue auto-wrestling it (though you may still raise your Wrestler and Fighter skills by 10 points for every time you ''release'' a limb - though this must be done manually and must be repeatedly confirmed, once the creature is rendered unconscious). Another concern with auto-wrestling some animals is that you will perform joint locks, and break hips, knees, and ankles in the process, which can cause the creature to bleed to death. If you can wrangle a creature incapable of blood-loss and strangulation in a high-FPS area (such as a crab on a frozen beach), you can easily raise all associated skills and attributes to Legendary and Superhuman in the course of a few minutes.</p>
*'''Shield User, Armor User, and Dodging''' - In addition to wrestling the creature, you can also sit back and let it attack you to raise your defensive skills. If you have metal armor, then a small animal like a gopher can't do any real damage to you when it hits. Also, to place emphasis more heavily on shield blocking, you can change your attack {{K|C}}ombat preference to ''Stand Ground''. The wrestling-a-crab-on-a-frozen-beach method also works fantastically for this.
*'''Weapon Skills and Fighting''' — Once your defensive skills are getting up there and your agility is high enough, you might want to try fighting [[bogeyman|bogeymen]] to increase your weapon skill. Just make sure to fight them one at a time while running away. If you don't know what a bogeyman is yet then you are probably not ready to try this. Also, doing difficult targeted shots will gain more experience and keep the training dummy alive longer.
*'''Throwing and Archery''' — Throwing rocks with {{k|t}} will raise your Throwing and Archery skills. Throwing objects at creatures, while not terribly effective, can still be a quite handy skill. Although throwing is a way to raise Archery without wasting ammunition, there is a non-wasteful method that additionally increases bow/crossbow skills.<p>The most efficient way to level via throwing is to forgo using a macro and separate training into two phases: {{k|g}}etting and {{k|t}}hrowing. First, find a tile with an indefinite amount of throwable objects (e.g., snow, rocks, mud, etc.). Then, sequentially mash {{k|g}} and whatever key the rocks are assigned to until both your forearms explode. Rest. Then, sequentially mash {{k|t}}, followed by some consistent key assigned to your rocks, then {{k|Enter}}, until you've emptied your inventory. Rest. Rinse and repeat. (You may wish to empty your inventory beforehand such that the rocks are assigned to a key close to {{k|t}}, allowing you to keep one hand on {{k|Enter}} and another on {{k|t}}.)</p>
*'''Marksman, Bowman, and Archery''' — Raising the bow and crossbow weapon-specific skills is best done by shooting at a wall or cliff with no floor directly beneath it. If bolts or arrows hit a wall that has floor/ground on the same z-level, then the ammunition will be destroyed. ''However'', ammunition that falls at least one z-level after hitting a wall will remain intact. So, simply find something like a hill inside a castle, stand on it, then shoot at a wall which is on the same z-level you are. The arrows will hit the wall and fall one z-level to the ground, remaining intact. You can then {{k|g}}et the arrows and {{k|f}}ire them at the wall again from the hill, ad infinitum. You can also stand next to a wall that's two or more z-levels high, aiming at the wall one z-level up by hitting {{k|<}} after hitting {{k|f}}. Whatever method you employ, the key is that the arrow needs to fall at least one z-level after hitting a wall to remain intact. Using a macro will speed this up greatly.<p>An alternative and much easier way to train any ranged attack is to simply shoot one or more z-levels straight above into the air , by using {{k|f}} than {{k|<}} , any ammunition used seems incapable of causing harm to the one launching it and lands undamaged under their feet for easy retrieval , however this may be considered a bug and/or exploit.</p>
*'''Ambushing and Swimming''' — An efficient way to raise Ambushing is to sneak over large stretches of land. Sneaking on the fast travel screen may work as well.{{Verify}} Ideally, this would be done in a biome containing sparse vegetation and few threatening creatures to blunder into and reduce FPS (e.g., a frozen beach).<p>Although less efficient for raising only Ambushing, it's also possible to sneak and swim at the same time, thus combining their training. '''Just make sure you start with at least Novice in swimming''', or you'll find swimming practically impossible to train. Swimming can very quickly improve your Strength, Agility, and Endurance. Additionally, if you can safely drown and then recover (e.g., by moving under a bridge and then back before suffocating), this will raise both Toughness and Endurance at a ''ridiculous'' pace— a single step spent drowning will raise both attributes by a fifth of a point apiece.</p>
*'''Observer''' — You can't really power-level this skill as it is slow and difficult to train, which is why you're advised to sink some points into it during character creation. However, one way to train it appears to be sleeping or walking around in the wilderness, allowing yourself to be repeatedly ambushed. This is, however, inherently dangerous. Running away from these encounters would probably be faster than slaying your assailants, if not generally safer for your character (but not for your companions, hoh boy).<p>Successfully detecting traps found in tombs and catacombs (performed automatically) will also raise Observer. However, without decent skill to begin with, you'll be torn to pieces by the many traps you'll fail to see. Otherwise, once you've found one or more traps, it's possible to grind experience by sleeping/waiting an hour, thus resetting the traps. Rinse and repeat.</p><p>As of version 40_23 one seem to aquire Observer skill from regular combat.</p>
*'''Spatial and Kinesthetic Sense''' - While sharpening rocks with {{k|x}} will improve your Knapping skill, it more importantly increases your Spatial Sense and Kinesthetic Sense attributes, which affect a number of other skills. Knapping can be combined with throwing via a macro to keep your inventory from filling up.
*'''Other Stats''' - Other useful stats like Strength, Agility, and Toughness will increase significantly as the fighting and defense skills increase, so you don't need to do anything other than what you'd normally be doing to increase these.

== I managed to escape but my limbs are chopped off. Now what? ==

'Tis but a scratch!

Unfortunately, there is only one way to get them back, and that is by being bitten by a [[werebeast]] and surviving until the next full moon. But as long as you have at least one leg and one arm left you can actually do pretty well. First, get a crutch from somewhere, such as a general store, and make sure it's in one of your hands. Once you do that you should be able to {{k|s}}tand back up again. (However, if spinal nervous tissue damage is what has disabled your ability to stand, crutches ''will not'' help you in that regard.) You will notice that your speed is now much slower than before.

Now go find someplace reasonably safe and walk back and forth until your Crutch Walking skill gets up to Legendary or above. You will notice your speed increasing as your skill levels up until your speed is completely back to normal. As a bonus you'll probably see some stat increases as well. You can continue to dodge with a crutch just as well as before.

You can wield a sword, shield, and crutch all in one hand, so even if you are missing an arm then you're all set. If you are missing both arms but still have both legs then unfortunately you'll be limited to biting, dodging, and wrestling with legs. If you're missing both arms and one leg then your movement will be limited and you'll be limited to biting and wrestling with your one remaining leg. And if all limbs are missing then you'll be limited to rolling around on the ground biting things.

Though you might actually be able to do surprisingly well as a Legendary Biter, especially if you powerlevel your strength to the point where you can shake things around by the teeth ripping limbs off, if you lose both legs then your character is going to be severely limited just due to the poor movement rate, so at that point it's probably best to opt for retirement or a glorious death in battle.

== What creatures of night can I become? ==

You basically have four different choices.

Firstly, you can become a [[necromancer|'''necromancer''']].
* That gives you some traits of an undead. Namely, you don't need to eat, sleep or drink, don't tire or age, zombies or mummies don't attack you and your physical stats are permanently fixed.
* The last one means it's wise to train them beforehand.
* You also can raise dead from the {{K|x}} menu. Depending on the flavor of your spell, zombies can be slow, very slow or not slow at all. They will be listed as companions.
* To become a necromancer, find a necromancer tower and obtain a book or slab containing secrets of life and death from there, then read it. Note that most of the books are useless. In younger worlds necromancers may not have built their towers yet, in which case they'll be hanging at a zombie bandit camp, slab under the arm.

Secondly, you can become a [[vampire|'''vampire''']].
* That gives you most traits of an undead. In addition to the listed above, you don't feel pain, don't breathe and immune to most syndromes.
* Your strength, agility and toughness are doubled.
* They're still fixed forever, so, again, be prepared.
* You gain blood vision, in which all creatures with blood not in your field of view will be represented with {{Tile|☼|4:0:1}}.
* Despite not needing to drink water, you have a hunger for warm blood. To satisfy it, beat someone or something unconscious and {{K|e}}at their blood.
* To become a vampire, defeat one in combat and drink his blood.
* In version 0.42.01, it is now possible to be "cursed" by a god into becoming a vampire by desecrating statues\totems\altars dedicated to them. This can be done by pressing {{k|u}} while adjacent to interact with them, and toppling them. {{version|0.42.01}}

Thirdly, you can become a [[werebeast|'''werebeast''']].
* This gives you the (uncontrolled) ability to transform into a powerful half-man, half-beast on a full moon.
* There's a fixed list of animals on which the werebeast is based, including goat, llama, lizard, horse, monitor, buffalo, moose, tortoise, camel, kangaroo, ape, gecko, bear, hyena, warthog, iguana, skink, shrew, elk, skunk, pig, raccoon, panda, mole, badger, armadillo, mammoth and more.
* Most importantly, upon transformation (both ways) all your wounds, including missing limbs, are instantly healed.
* You don't show any abnormalcy outside of beast form. You are still mortal.
* When in beast form, everything is hostile to you, you don't need to drink, eat, sleep or breathe, don't feel pain, don't tire and are immune to some syndromes.
* One randomly chosen metal is ten times as deadly to you than usual. All other materials deal you half damage.
* Werebeast's size is several times their base animal size, but no less than 80000. This means all armor will be too small for you while in beast form. But you can still use a shield.
* Also, some werebeasts are truly gigantic — weremammoth has a size of 9000000, on par with demons.
* To become a werebeast, make one bite you. It has to be in the beast form.
* In version 0.42.01, it is now possible to be "cursed" by a god into becoming a werebeast by desecrating statues\totems\altars dedicated to them. This can be done by pressing {{k|u}} while adjacent to interact with them, and toppling them.{{version|0.42.01}}
* You cannot be a werebeast and a vampire at the same time.

And finally, you can become a mist [[zombie|'''zombie''']].
* This makes you undead. In addition to vampire traits, you can see without eyes and can't die via blood loss or beheading. Note that you don't have health point limit raised zombies have.
* You become permanently hostile to everyone except other undead.
* Your strength and toughness are tripled and fixed. Train beforehand.
* Depending on the flavor of zombie virus, your speed may or may not drop to 20% or 60% of its normal value.
* To become a mist zombie, find a mist/fog cloud that zombifies creatures and run into it.
* You cannot become a vampire or a werebeast if you are already a zombie. The other way, however, is fine.

=See Also=
*[[Main:Adventure Mode quick reference|Adventure Mode Quick Reference]]
*[[Main:Adventure mode quick start|Adventure Mode Quickstart Guide]]

=A glimpse into the Future=
{{D for dwarf}}

* Passage from "Shooting <s>for</s> the sky" , the giant toad bone bound book by Nefil Blackbone the human necromancer :

{{Quote|align=left|
... While seemingly absurd , the practice of ones abilities with a ranged weapon can be furthered by directing said weapon towards the sky .
After all , during day time the sky has one giant target that might even seem so large that it's impossible to miss , and the night sky has many smaller ones .
It has been well documented that hitting the target may not be necessary to achieve improvement in ones skill with said arms , thus it is reasonable to expect every subsequent shot after the first will hit a tad closer to it's intended target , this has further lead me to believe in the possibility of sky exploration , for with this logic at some point the projectile will actually hit it's target and could subsequently be replaced with a test [[goblin|dummy]] to further resolve survival issues and empty ones [[invader|guest]] [[stockpile|accommodations]] in one go .
Finally with said preparations accomplished it would be possible to explore whatever is beyond that great blue/black border above .
However some skeptical dwarven scholars suggest this to be impossible and rather place their bets on the tried and tested dwarven [[bridge|launch system]] , while notable human scholars propose using bigger [[catapult|armaments]] to accomplish the goal .
This is how the great space race between the Elves , Dwarves and Humans began , which would later on lead to massive intergalactic conflicts , space goblin invasions , immortal human emperors , elven space gates , interplanetary clown-storms all under the name of the humble dwarven hammer of war ...}}

{{Getting Started}}
{{Category|Adventurer mode}}
{{Category|Interface}}

Topic

2015-12-23T16:49:31Z

FortressBuilder: Sort some unsorted topics

{{Quality|Superior|06:10, 17 May 2015 (UTC)}}
{{av}}

{{new in v0.42}}
{{Expand Topic}}

'''Topics''' (also '''Tech''' or '''Innovations''') are part of [[knowledge]].

There are around 300 innovations that can be discovered. Many of them have requirements, and many do not, so it's kind of a tech forest/grassland rather than a tree. Notably missing are innovations related to practical labors in the game (which will be added later in development).

Several innovations require innovations from other branches, and since all knowledge is individually tracked, that implies some investigators will need to be at least well-read if not skilled in various topics (there aren't currently joint research projects). There are some old and new mechanisms in place to ensure this happens.

There are 9 "branches" of the knowledge system.
==Astronomy==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The theory that the sun moves around the world
|-
|The Astrolabe
|The construction and use of the astrolabe
|-
|Daylight And Seasons
|The variation of daylight with the season
|-
|
|The relationship between the lunar and solar year
|-
|The Sun and Seasons
|The rise of the sun according to the season
|-
|
|The path of the moon
|-
|The Moon and Seasons
|The rise of the moon according to the season
|-
|Common Sense Tides
|The relationship between the moon and the tides
|-
|
|The creation of star charts
|-
|
|The theory that the world moves around the sun
|-
|
|Methods of empirical observation in astronomy
|-
|The Way With The Phases
|The phases of the moon
|-
|The True Tides And The Sun
|The height of the tides, the moon and the sun
|}

== Chemistry ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The preparation and use of adhesive materials
|-
|
|The classification of ores
|-
|
|The theory and methods involved in evaporation
|-
|
|The classification of materials based on which elemental materials might form them
|-
|
|Methods for performing experiments systematically in the laboratory
|-
|
|The construction and use of the ampoule
|-
|The Vial
|The construction and use of the vial
|-
|
|The construction and use of the alembic
|-
|
|The mixture of metals to produce alloys
|-
|Liquid Extraction
|The theory and methods involved in the extraction of a constituent liquid from one solution to another
|-
|
|The construction and use of the blast furnace
|-
|
|The construction and use of the retort
|-
|
|The classification of alkali and acids
|-
|
|The construction and use of the beaker
|-
|Oil of Vitriol
|The preparation of oil of vitriol
|-
|
|The construction and use of the crucible
|-
|
|The theory and methods involved in distillation
|-
|
|The construction and use of laboratory ovens
|}
* [[wikipedia:Nitric acid|Spirit of niter]]

== Engineering ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|The Pulley
|The construction and use of the pulley
|-
|The Lever
|The construction and use of the lever<br/>The reasons why the lever is effective
|-
|The Windlass
|The construction and use of the windlass
|-
|The Screw
|The construction and use of the screw
|-
|Models and Templates
|The use of models and templates in engineering
|-
|The Warded Lock
|The construction and use of the warded lock
|-
|The Tumbler Lock
|The construction and use of the tumbler lock
|-
|The Siphon
|The action of the siphon
|-
|Gear Mechanics<br />Gears
|The reasons why gears are effective
|-
|The Crystal Lens
|The construction and use of the crystal lens
|-
|The Funnel
|The construction and use of the funnel
|-
|The Glass Lens
|The construction and use of the glass lens
|-
|The Camera Obscura
|The construction and use of the camera obscura
|-
|
|The construction and use of valves
|-
|
|The construction and use of the bellows
|-
|
|The construction and use of the straight-beam balance
|-
|The Wedge
|The reasons why the wedge is effective
|-
|
|The use of water-based devices to tell time
|-
|
|The use of lamination
|-
|The Wheel-and-axle
|The reasons why the wheel-and-axle construction is effective
|-
|
|The reasons why pulleys are effective
|-
|
|The reasons why screws are effective
|-
|Screws within Reason
|The construction and use of the screw
|-
|
|The construction and use of the padlock
|-
|
|The reasons why the lever is effective
|-
|
|The construction and use of water-filled sphere as a lens
|-
|Water Clock Reservoirs
|The use of reservoirs in water-based clocks to improve their accuracy
|-
|Shadow Clocks
|The use of shadows to tell direction and time
|}

[[wikipedia:Differential (mechanical device)|Differential gears]] are a difficult innovation and a prerequisite for [[wikipedia:South-pointing chariot|pointing chariot]]s and [[wikipedia:Astrarium|astrarium]]s.

== Geography ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The process of surveying land
|-
|
|The forces that govern wind patterns
|-
|
|The process of economic data collection
|-
|
|The placement of economic information on maps
|-
|
|The construction and use of the surveying staff
|-
|
|The origin of rainfall through evaporation and condensation
|-
|
|The process involved in creating maps
|-
|
|The process of the formation of deltas at the mouths of rivers
|-
|
|The placement of geological information on maps
|}
The geography innovations include several related to [[wikipedia:cartography|cartography]].

== History ==
Innovations for historians are, in part, writing forms like [[wikipedia:biography|biography]], and then any historian that reads a biography can start writing them as well. Innovations include comparative biographies describing multiple people, and matters of sourcing, etc.

Historians can start to understand how cultural differences and state bias affects source reliability and think a bit about social forces.

{| class = "wikitable sortable"
! Topic
! Description
|-
|Archaeology
|The method of collecting and evaluating artifacts to learn about history and culture
|-
|Cultural History
|The method of accurately and comprehensively describing cultures and civilizations
|-
|Against Cultures
|The method of accurately and comprehensively describing cultures and civilizations
|-
|Source Reliability
|The reliability of sources
|-
|Personal Interviews
|Using personal interviews as sources
|-
|Autobiographical Adventures
|The method of writing a biography of oneself, particularly as it concerns a military campaign or adventure
|-
|
|Discourse on the cause of historical events
|-
|
|The method of writing the history of a single individual
|-
|
|The method of comparing and contrasting different cultures
|-
|
|The role of cultural differences in source reliability and interpretation
|-
|Biographical Dictionaries
|The compilation of brief biographies into one large collection
|-
|
|The compilation of family lineages and methods of displaying them artfully
|-
|Comparative Biography
|The method of compiling several biographies to compare and contrast the subjects' character and to gain insight into history
|-
|
|The exploration of how history would be different if some key past events had transpired differently
|-
|
|The notion of historical, governmental and social cycles
|-
|Historical Causation
|The causes of historical events
|-
|
|The method of examining artifacts to determine how techniques have changed over time
|}

== Mathematics ==
* [[wikipedia:Plus and minus signs#Plus sign|Symbol for addition]]

{| class = "wikitable sortable"
! Topic
! Description
|-
|Positional Notation
|Positional notation
|-
|Large Sums
|Simple formulas for certain arbitrarily large sums
|-
|Equations
|The technique of balancing and completion for solving equations
|-
|Very Large Numbers
|Notation for very large numbers
|-
|Negative quantities
|The notation for negative quantities
|-
|Nothingness
|A symbol for nothingness
|-
|
|The method of proof by contradiction
|-
|Division
|An algorithm for dividing one number into another, possibly yielding a remainder
|-
|
|Geometric objects: points, lines, circles, triangles, and so on
|-
|
|The divergence of the harmonic series
|-
|
|The properties of similar and congruent triangles
|}

== Medical science ==
Medical innovations include dedicated hospitals with specialized wards, staffing, medical labs and treatment for many illnesses.

{| class = "wikitable sortable"
! Topic
! Description
|-
|Incision
|The surgical method of incision
|-
|Diseases
|The diseases of creatures
|-
|Mineral Remedies
|
|-
|Disease Classification
|The classification of disease
|-
|Toxicology
|The classification of toxic substances
|-
|Suturing
|The surgical method of suturing
|-
|Traumatic Injuries
|The treatment of traumatic injuries
|-
|Draining
|The surgical method of draining
|-
|Bandages
|The method of bandaging wounds
|-
|
|The notion of paroxysm
|-
|
|The treatment of fractures
|-
|Scraping
|The surgical method of scraping
|-
|
|Anesthesia
|-
|
|The use of practice models in surgery
|-
|
|The use of specialized surgical instruments
|-
|Anatomical Studies
|Anatomical studies for medical edification
|-
|
|The anatomy of the eye
|-
|Disease and Fouled Water
|The connection between disease and fouled water
|-
|Herbal Remedies
|Herbal remedies
|-
|
|The method of physical examination in diagnosing illness
|-
|Probing
|The surgical method of probing
|-
|
|Determining the likely outcome given a patient's current status
|-
|
|The notion of the exacerbation of a patient's condition
|-
|
|Cauterization
|-
|
|Pulmonary medicine
|-
|
|Remedies prepared from animals
|-
|Lithotomy Surgery
|The lithotomy surgery
|}

== Natural science ==
Toady on natural science innovations:
<blockquote>And so on through the other seven branches - there are innovations in naturalist writings, for example, and then they can investigate specific critters with those in mind when they get down to work observing foraging behavior or performing dissections.</blockquote>

Naturalists can build a theory of [[wikipedia:rainbow|rainbow]]s using water-filled spheres and a [[wikipedia:camera obscura|camera obscura]], and they can calculate the height of the atmosphere based on [[wikipedia:atmospheric refraction|atmospheric refraction]] using the [[wikipedia:law of refraction|law of refraction]] (though it tries not to get into the actual shape of the world, since that might vary).

{| class = "wikitable sortable"
! Topic
! Description
|-
|Physical Features
|The classification of creatures by their physical features
|-
|Climactic Adaptation
|The way that creatures are suited to the climates in which they live
|-
|Migratory Patterns
|The migratory patterns of creatures
|-
|
|A world-wide cycle involving precipitation, oceans, rivers and other forms of water
|-
|Foraging Behavior
|The foraging behavior and diet of creatures
|-
|Reproductive Behavior
|The reproductive behavior of creatures
|-
|Social Behavior
|The social behavior of creatures
|-
|Dissection
|The dissection of creatures
|-
|Embriological Development
|The embriological development of creatures
|}

== Philosophy ==
The specific view that a philosopher takes on, say, the nature of beauty or methods of education will depend on their individual/cultural values, where they apply, and a philosopher that encounters a philosophy book on beauty can then provide their own take (having acquired the innovation).

Toady on philosophy innovations:
<blockquote>For fields like philosophy, I've tried not to make judgments about which ideas are "right" or anything like that, but rather which subjects can be thought about at all.</blockquote>

{| class = "wikitable sortable"
! Topic
! Description
|-
|Value Agendas
|Writers can push value "agendas" if they are skilled enough.

Description format: The [worthlessness | value | nature] of [[[belief]]]

Examples:
* The nature of truth - probably related to TRUTH
* The value of art - probably related to ARTWORK
|-
|Interpersonal Ethics
|Discourse on ethics as applied to interpersonal conduct
|-
|Causation
|The nature of causation
|-
|
|Discourse on diplomacy
|-
|
|Discourse on the meaning of individual happiness
|-
|
|Discourse on economic policy
|-
|
|Discourse on ethics as it regards the benefit of the state
|-
|
|Discourse on the nature of perception
|-
|
|Discourse on the nature of justification
|-
|
|The relationship between objects and their properties
|-
|
|Discourse on the nature of time
|-
|
|Discourse on the nature of mind and body
|-
|
|Discourse on ethics as applied to war
|-
|
|Discourse on the nature of beauty
|-
|
|Discourse on law
|-
|Grammar
|Grammar
|-
|
|Discourse on government
|-
|
|Dictionaries
|-
|Formal Reasoning
|Formal reasoning
|-
|
|Discourse on social welfare
|-
|
|Discourse on the nature of events
|-
|Education
|Education, its forms and recommendations
|-
|
|Discourse on the nature of belief
|-
|
|Discourse on medical ethics
|-
|Whole and Parts
|The relationship between wholes and parts
|-
|
|The notion of etymology
|-
|Social Welfare
|Social welfare, its forms and recommendations
|-
|
|Economic policy, its forms and recommendations
|}

==Unknown/unsorted==
{| class = "wikitable sortable"
! Topic
! Description
|-
|Dictionaries
|
|-
|Water Displacement
|A precise description of buoyancy and water displacement
|}

{{Category|World}}

Adventurer mode

2015-12-20T11:16:27Z

FortressBuilder: Undo revision 222350 by 24.28.152.135 (talk)

{{old}}
{{Quality|Unknown|Dec 2015}}
{{av}}

:''This is a detailed reference guide for Adventurer Mode. For a tutorial see the [[Adventure mode quick start|Adventure Mode Quickstart Guide]].
:''See [[Adventure Mode quick reference]] to quickly look up key commands.

In '''Adventurer Mode''' (also called "adventure mode") you create a single adventurer ([[dwarf]], [[human]], [[elf]], [[goblin]], or one of the varieties of [[animal people]]) who starts out somewhere in one of your generated worlds. You can learn about what ails the world and go on [[quest|quests]] to end those troubles (or get brutally murdered trying), and you can venture into the wilderness to find [[cave|caves]], shrines, lairs, abandoned towers, and other [[Site|towns and settlements]]. You can even visit your previously abandoned and retired [[fortress|fortresses]] and take all the precious items you yourself once created.

Unlike [[Fortress mode]], Adventurer Mode is a sort of advanced [http://en.wikipedia.org/wiki/Sandbox_game open world] version of [http://en.wikipedia.org/wiki/Rogue_%28computer_game%29 rogue] or [http://en.wikipedia.org/wiki/Nethack nethack] taking place in the same procedurally generated worlds used for Fortress Mode. Whereas in fortress mode you are in charge of a large group of people in real-time restricted to a small parcel, in adventurer mode you control a single character in a turn-based manner, roaming the entire world freely.

=World Selection=

You can play Adventurer mode in any world that has a civilization with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token (which are elf, dwarf, humans, goblins, as well as animal people{{version|0.42.01}}). Humans inhabit cities, towns, and the occasional above-ground fortress. Elves inhabit forest retreats. Dwarves are spread between "deep sites" which sometimes do not contain a direct connection to the surface, and "hill dwarves" which inhabit a loose collection of mounds built into hillsides. Goblins typically live in Dark Fortresses. Lastly, Animal People can live with any civilization, in virtually any location. Human cities and towns are currently the only sites with shops and other places to officially buy goods.

If you have previously built a fort in the world that you select, your adventurer will be able to go visit it. If you have selected to "retire" the fortress rather than abandon it, you will likely be able to encounter all of the inhabitants from fortress mode. However, they will likely not have the same level of activity as they would in a bustling fortress-mode fort.

=Character Creation=

==Race and Civilization==
Any race with the [[Entity_token#Gameplay|ADVENTURE_TIER]] token is playable in adventure mode. In an unmodded game, this means [[Dwarves]], [[Elves]], and [[Human|Humans]]. All three races can complete the same quests.

*'''Humans''' Always originate from one of the villages in the world, begin with bronze, copper, or iron weapons, and can use any of the items sold by shopkeepers (who, for the time being, are only found in human towns and only sell human-sized clothing/armor). They also start with the widest variety of weapon skills.

*'''Human Outsiders''' Human Outsiders are humans that aren't from that world or any of its villages. They simply appear in the wilderness, a stranger to all. You may always play as an outsider, even if the world is otherwise completely uninhabited. Outsiders can only start with Spear User and Knife User as weapon skills, and they cannot start with Armor User or Shield User. They also start out literally naked with no clothing, but can wear any human-sized armor that they trade for, steal, or loot. "Outsiders" of other races can be played if you add the [[Entity_token#Gameplay|INDIV_CONTROLLABLE]] token to the race's entity definition.

*'''Dwarves''' have the advantage of being able to go into a [[Martial trance|martial trance]] when fighting multiple foes at once. This gives them many combat bonuses, which aids their survival greatly. They are the only race which can start with steel weapons, but they wear "small" sized clothing (like goblins and elves) which means that they're unable to wear human clothing and armour found in shops. Goblin armor fits them, making Dark Fortresses (if your computer can handle them) and bandits a viable source of armor; if you're up for it, you could also just rob some dwarves. They can start with almost all of the same weapon skills as civilized humans. Many larger weapons must be wielded two-handed by dwarves, due to their size.

*'''Elves''' start with very weak wooden weapons and have a more limited list of weapon skills during character creation. They have the advantage that they have higher natural speed. Elves also have the AT_PEACE_WITH_NATURE tag. This makes all wildlife passive towards them. Like dwarves they wear small sized clothing and will have the same problem finding suitable armour.

*'''Kobolds''' can be played only if there are no other civilizations and there are kobolds. They are very small and weak in combat and a huge challenge compared to the other races. They wear even smaller armour than the other races and armour will be impossible to find for them, unless you are absurdly lucky and run into armoured kobolds.

*'''Intelligent Wilderness Creatures'''{{version|0.42.01}} can be played not only in varying conditions as above, but also as part of another parent civilization such as elves, humans, and dwarves. They come in various sizes, shapes and abilities, and as such a short description cannot be given.

If no civilization for a given race exists in a world you can only play as an outsider.

== Status ==

Determines the number of starting skill and attribute points, which does not change based on race:
*'''Peasant:''' 15 attribute, 35 skill
*'''Hero:''' 35 attribute, 95 skill
*'''Demigod:''' 105 attribute, 161 skill
The number of skill points is less significant than the number of attribute points because the time it takes to go from Peasant to Demigod in skill terms is much less than what it would take to go from Peasant to Demigod in attribute terms.

== Starting Attributes ==

[[Attribute|Attributes]] are divided into Body and Soul attributes. This section provides some guidance for allocating attributes as it relates to adventurer mode.

=== Body ===

*'''Strength''': Alters the damage you inflict in melee regardless of weapon used. Increases muscle size. This increased muscular layer helps prevent damage, although this is a pretty minor effect. Increasing strength, at least in adventurers, increases movement speed (albeit not as much as agility) due to better carrying capacity.
*'''Agility''': This attribute is directly related to a character's Speed and is also used in combat skills. Agility is really, really important as being faster than the enemies allows you to get more hits in before they can fight back and lets you run away more easily.
*'''Toughness''': Reduces physical damage inflicted on you. Also relates to defensive combat skills.
*'''Endurance''': Reduces the rate at which the adventurer becomes exhausted. Becoming exhausted causes you to collapse, helpless and immobile and can cause you to pass out.
*'''Recuperation''': Increases the rate of wound healing. Not as important as Toughness. Recuperation isn't that useful in adventurer mode since you usually have as much time to rest as you need assuming you can escape a situation alive.
*'''Disease Resistance''': Seems to have some effect on vampirism infectivity; may have to do with infected wounds.

=== Soul ===

Some of these are useful for adventure-mode-applicable skills, but some are totally useless except as dump stats.

*'''Analytical Ability''': Useful only for Knapping; should be reduced to minimum.{{Verify}} Analytical Ability seems to have an influence on the quality of written creations, such as Poems, as well as ability to speak about ideals.{{version|0.42.01}}
*'''Focus''': Affects Archer, Ambusher, Observer.

*'''Willpower''': Affects Fighter, Crutch Walker and Swimmer. Willpower is really important as it governs how easily you'll pass out from extreme pain. Low willpower is a death sentence if you are seriously wounded, as you'll pass out and have your head caved in. Broken bones currently cause enough pain that even very high willpower usually won't keep you conscious. For non bone injuries however willpower can keep you going long enough to kill enemies, or at least get away from them.

*'''Creativity''': Unknown at the moment what Creativity does in 42.01, early !Science! seems to have found that this influences quality of poems, songs, and dances. It may also influence "make believe", now able to be performed by children.{{version|0.42.01}}

*'''Intuition''': Helps with Observer, which aids in spotting concealed enemies, ambushes, and identifying attacks from opponents.

*'''Patience''': May have some effect on dealings with others as a result of the new conversation system.{{Verify}}

*'''Memory''': Memory aids greatly in mapping out areas as the higher your memory the longer you'll remember an area. As you explore you'll forget previously explored areas, causing them to appear blank, as if you had never been there. If you have low enough memory you'll forget areas of large locations like underground catacombs while you're still in them, making finding your way very confusing, as things like the exit wont be visible anymore until you find it again. Best to have at least average memory.

*'''Linguistic Ability''': May have some effect on dealings with others as a result of the new conversation system.{{Verify}}

*'''Spatial Sense''': Important. Affects combat skills, Ambusher, Crutch Walker, Swimmer, Observer, Knapping. Also, prevents/reduces the chance of stumbling during a dance.{{version|0.42.01}}

*'''Musicality''': Influences the Adventurers ability to perform music well. This, so far works for all instruments, one can play a flute, guitar, any other instrument equally well, given that the adventurer has equal skills in all instrument fields.{{version|0.42.01}}

*'''Kinaesthetic Sense''': Affects most combat skills, walking with crutches and swimming.

*'''Empathy''': Might increase chance of persuading people to join you.{{Verify}}

*'''Social Awareness''': Increases the number of followers you can have at a given "fame" level. Normally you start with a limit of two. Increasing this stat by one level raises that to three. Your fame still plays a big part in whenever you can recruit followers or not.

=== Attribute Advancement Cap ===

Adventure mode attributes are capped at double the starting value or the starting value plus the racial average, whichever is greater. Humans, for example, have a racial average strength of 1,000. If a human adventurer starts with an ''above average'' strength of 1,100, then his strength will ultimately be capped at 2,200. Had this human started with a ''below average'' strength of 900, then his strength would be capped at 1,900 instead. For the purpose of maximizing final attributes, this makes it important to start with as many attributes in the ''superior'' range as possible (more attributes per point allocated), while avoiding taking any penalties to even remotely important attributes (big attribute deductions per point recovered). As a consequence of the attribute cap, demigod adventurers will always have a much higher potential for advancement than mere peasants and heroes.

== Starting Skills ==

Not all races have the same sets of skills available at character creation time, but keep in mind that all starting [[skill]]s, as well as ones not available at character creation, can be improved through use in game. [[Reader]] is an exception to this.

This section will specifically address starting skills as they relate to adventure mode. For a full description of combat skills see [[Combat skill]]. Other skills that you can't start with, but which can be increased in game (such as Butchery) are described elsewhere.

=== Weapon ===

The weapon you start out with will be based on which of these, plus the unarmed combat skills, is the highest. In other words, even if Swordsman is your highest weapon skill, you won't start with a sword if your Wrestler or Striker skills are better. Usually the best choice anyway is to specialize in just one melee weapon skill. Regardless of weapon skills, a '''large copper dagger''' will always be included in the starting equipment, which is handy for throwing at enemies that are just a step away or finishing off a foe pinned down by a stuck weapon. If you don't select any offensive skills, you will also start with a spear, just as an outsider would.

Not all races/civilizations can start with all of these skills. Dwarves can't start with Bowman, Pikeman, or Lasher. Elves can only use Swordsman, Bowman, and Spearman. Of the playable races, only humans have access to Pikeman and Lasher. Strangely, only outsiders can start with Knife User.

Note that different races have different names for their weapon skills. Axegoblin, Axedwarf etc.

Crossbowman is an exception. Dwarves call this skill Marksdwarf, although bow skill is referred to as Bow Dwarf as you'd expect. Elite Axe and Hammer dwarves are referred to as Lords.

*'''Axeman''': allows characters to use axes, great axes, and halberds more effectively. Useful for cleaving off limbs.
*'''Bowman''': skill allows characters to use bows more effectively. Useful for taking down enemies at a distance.
*'''Crossbowman''': allows characters to use crossbows more effectively. Useful for taking down enemies at a distance.
*'''Hammerman''': allows characters to use crossbows in melee, mauls, and war hammers more effectively. Useful for breaking limbs.
*'''Knife User''' - allows characters to use large daggers and knives more effectively. Useful for stabbing things.
*'''Lasher''' - allows characters to use whips and scourges more effectively. Very deadly weapons.
*'''Maceman''' - allows characters to use flails, maces, and morningstars more effectively. Similar to hammers.
*'''Pikeman''' - allows characters to use pikes more effectively. Like spears, but much bigger.
*'''Spearman''' - allows characters to use spears more effectively. Useful for stabbing things.
*'''Swordsman''' - allows characters to use blowguns and bows in melee, long swords, scimitars, short swords, and two-handed swords more effectively. Useful for cutting, stabbing, and whacking, but less effective than more dedicated weapons.

=== General Combat ===

These two skills can be raised rather quickly in game and so you probably want to skip spending any points on them at the start.

*'''Fighter''' - This increases with, and contributes to, melee combat whether armed or unarmed. It appears that the purpose of it is to allow melee experience to contribute to melee combat in general regardless of weapon. Repeatedly wrestling (grabbing and releasing) even a small creature will raise this skill.
*'''Archer''' - This increases with, and contributes to, ranged combat including throwing. It works similarly to Fighter except for ranged attacks. It can be easily raised by repeatedly throwing rocks, making it advisable for archers to practice their marksmanship with rock throwing before using up the more finite and expensive forms of ammunition. Shooting at a wall with adjacent upward ramp one level below and picking back projectiles is also a good idea (such places often happen to be in keeps and fortresses). See the FAQ section on [[#How do I increase my skills and attributes?|increasing your skills and attributes]] for information on raising bowman/marksman skills.

=== Defensive ===

These skills are critical for survival. Starting out with good ability in one (especially Shield User or Armor User) if not all is strongly advised.

*'''Shield User''' - Ability to block attacks with shields. Starting with even novice skill in this means that the adventurer will start with a shield. This is a no-brainer unless you're creating a two handed weapon user, and lack a broadness or height modifier on your character - necessary for one-handing any two-handed weapon, without penalty.
*'''Armor User''': A higher level of this skill reduces the encumbrance penalties of armour, allowing you to move faster when wearing it. It also affects how well armour protects you and this makes a huge difference. Unskilled armour users gain little protection. This is noticeable as you'll begin seeing far more combat reports about hits either striking you though armour, (you managed to use your armour to lessen the force of the blow) or being deflected by your armour (you used your armour to avoid the hit entirety) as your skill rises and you learn to actually use your armour to deflect hits. It is highly advised to train your armour skill before entering battle with it as the speed penalties of lower levels can be a serious handicap.
*'''Dodger''' - Ability to dodge out of the way of attacks. Dodger is incredibly important and will allow you to avoid many, many hits that would have otherwise injured you. Especially important when you are fighting unarmoured and can't afford a battle axe in the chest. Boost this to talented or at least close to it.

=== Unarmed Combat and Improvised Weapons ===

While some of them come in handy at times, they can generally be raised fairly easily in game, especially Wrestler and Thrower.

*'''Wrestler''' - Ability to grapple, restrain, take-down, throw opponents, etc. Higher skill means all of these moves succeed more often. See [[#Wrestling and Unarmed Attacks]] for details. Can be raised very easily in game.
*'''Striker''' - Punching ability. Turns handy when weapons get stuck and there is no time to wrest them back.
*'''Kicker''' - Kicking ability. Same as Striker. Kicks are slower but more deadly than punches; heavy kicks are particularly good at crushing and exploding heads.
*'''Biter''' - Biting ability. Biting is surprisingly effective even with non animal races as after biting you can shake opponents around by your teeth, causing great damage and possibly ripping off body parts, although with sapient races this tends to lean more towards fingers or toes, perhaps the occasional hand or foot.
*'''Thrower''' - Throwing any miscellaneous object including rocks, knives, axes, swords, heads, etc. Skill affects accuracy and damage caused.
*'''Misc. Object User''' - Ability to beat things to death with anything that comes at hand, from bags to coins to their own severed body parts. Also somewhat more commonly used for shield bashing. This skill affects combat with any object, from a rock to a beehive. There are no separate skills for different items. Items actually intended to be weapons, like swords or axes, are unaffected by this skill.

=== Movement and Awareness ===

*'''[[Observer]]''' - Helps one to notice things like ambushes, enemies who are "sneaking" (stealth movement), and traps. Detection range increases with skill, but up to a maximum of 3 tiles away. Higher levels give more information regarding opponents. Hard to train. Adding some points here is advisable.
*'''[[Swimmer]]''' - Allows movement through water without drowning. A Novice swimmer can swim but will revert to being unable to swim if stunned, which happens when falling even 1 z-level into the water, or possibly after an unfriendly encounter with a creature in the water. An Adequate swimmer can swim normally (not drown) while stunned. For this reason, ''starting out as an Adequate swimmer is advisable.'' If you don't, at least start as Novice and go get some swimming practice right away.
*'''[[Ambusher]]''' - The skill of {{K|S}}neaking around unobserved. This can be raised fairly easily by sneaking around while traveling from place to place when speed is not important. Enemies will have "sight ranges" from where they can detect a sneaking adventurer. The red zone of sight is where they will see you immediately and begin chasing you; the yellow is where they might see you. Staying out of sight will allow you to silently assassinate your foes, as they rarely seem to notice a knife in their back in time.
*'''[[Climber]]''' - The skill of climbing up walls, into trees, and around the edges of gorges. Higher levels reduce the chance of falling and increase the speed of a climbing character.
*'''[[Tracker]]''' - The skill of tracking your quarry, whether it be animals or goblins. Higher levels will let you spot more tracks and help you distinguish different tracks.
*'''[[Crutch-walker]]''' - The skill of standing and walking with a crutch for support. This skill only becomes available when attempting to move with a crutch in inventory, and can be developed with or without legs. At Legendary levels, a crutch walker walks with no speed reduction.

=== Crafting ===

These allow your character to create things. There is only one skill currently available in an unmodified game.

*'''[[Knapper]]''' - The fine art of sharpening rocks by banging them together in a clever manner. The resulting rocks become sharp rocks which do more damage when thrown and can be used for things requiring a sharp edge like butchering. Easy to raise in game and doing so helps with Kinesthetic and Spatial Sense.

=== Other ===

*'''[[Reader]]''' - Allows you to read books, signs, and writing in Adventurer mode. Novice level is required in order to become a [[Necromancer]]. There is no way to increase this skill. Adding more points is a waste, as novice allows you to read anything.
*'''[[Butcher]]''' - The art of turning corpses into piles of delicious prepared brains and meat for food. Butchering also makes corpses and body parts less useful to enemy necromancers. You cannot allocate points here during character creation, but that's OK since skill doesn't really affect anything anyway. Except the taste, of course.

= Gameplay =

== Common UI Concepts ==
{{KeyConventions|3}}

== Moving Around ==

=== Local Movement ===
[[File:Advmode_normaltravel_DF2014.png|thumb|400px|An image of normal travel mode. A list of the closest (but not necessarily close) sites is in the top-left corner. On the right side are minimaps of the next two levels down, relative to the player. Along the bottom is information about the player.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Move
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Move
|-
| {{k|Alt}} and a direction key
| Move carefully / Deliberately enter dangerous terrain
|-
| {{k|<}} or {{k|Shift}}+{{key|5}} (num lock off)
| Ascend
|-
| {{k|>}} or {{k|Ctrl}}+{{key|5}} (num lock off)
| Descend
|-
| {{k|.}}
| Wait for 10 instants
|-
| {{k|,}}
| Wait for 1 instant
|-
| {{k|s}}
| Stand or lie down
|-
| {{k|S}}
| Open Movement Speed/Sneak Menu
|}

Unless your character is an outsider, you will start out in a human town or hamlet; in the standard tileset the @ sign is your character.

The directional keys allow movement. Diagonal movement is particularly important especially when chasing or running away from things.

Use {{k|Alt}}+direction to enter water, jump off of cliffs, or otherwise attempt to enter anything that you can't enter using normal movement commands. Note that when entering water it's best to enter the actual water and not the open space over the water as, in the later case, you will fall in causing you to become stunned which may lead to drowning.

If you hit {{k|j}}, you can jump. This is mostly useful for crossing gorges and crevices, where you have to get to the other side. Occasionally, you can manage to jump onto an opponent and tackle them, which typically causes them to go flying a short distance.

Hitting {{k|.}} allows you to stay in one place and wait for other things to move. {{k|,}} does the same but with a tenth of the time it takes for {{k|.}}.

Use {{k|s}} to sit/lie down. Moving while laying down (crawling) will let you move past NPCs which are standing in your way. Also note that you will frequently get knocked to the ground in combat, and if you don't hit {{k|s}} to stand back up then you will crawl slowly along the ground, giving your opponent a lot of opportunity to attack you.

{{k|S}}neak will allow you to move around invisibly, limited by your Ambusher skill and the Observer skill of nearby creatures. Enemies will have sight cones indicating where they can detect a sneaking adventurer. The central zone of sight (red, violet, or cyan) is where they will see you immediately and begin chasing you; their peripheral vision (yellow) is where they might see you. Violet and cyan central zones indicate the enemy is on a different level than yours, while red means they are on the same level. Staying out of sight will allow you to silently assassinate your foes, as they rarely seem to notice a knife in their back in time. Note that sneak is also affected by a variety of other factors detailed on the {{k|S}}neak screen, such as light level and weather.

If you {{k|h}}old onto a wall or tree, you can climb the wall or tree by using the movement keys. In towns and tamer parts of the countryside, this isn't particularly useful. However, in a combat situation, climbing a tree or wall can give you a height advantage, possibly allowing you to dive-tackle your opponents. Sometimes, mountains will be too steep to walk up the edge, or you will find a deep drop into a ravine. In these cases, you will have to climb up to reach the top, or perhaps jump or climb down one face, then climb up the other.

=== Fast Travel ===
[[File:Advmode_fasttravel_DF2014.png|thumb|400px|Fast Travel screen. The player is in a hamlet, between the houses to the right and the mead hall in the top-left area of the map. The asterisk represents a group of creatures (in this case unfriendly goblins). The world map (in sepia) is on the far right.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|T}}
| Fast Travel
|-
| {{k|d}}
| Exit fast travel mode
|-
| {{k|K}}
| Display detected tracks and odors
|-
| {{k|c}}
| Toggle display of clouds on region map
|-
| {{k|s}}
| Walk around in sneak mode. Exiting fast travel starts you in sneak mode.
|-
| {{k|m}}
| Cycle through maps and significant structures
|-
| {{k|Q}}
| View Quest Log
|-
| {{k|Z}}
| Bring up sleep menu
|-
| {{k|h}}
| Hide parts of the bottom bar
|-
| {{k|>}} and {{k|<}}
| Enter/exit tunnel
|-
|}

Entering Fast Travel mode will allow you to move large distances in a single keypress. Of course, the same amount of time will go by and you can also be interrupted (ambushed) while moving in fast travel mode.

Along the top of the map is a line showing the sky, and the position of the sun and/or moon from west to east. This primarily helps you determine how long you have before it gets dark, at which point you won't be able to see very far, will risk getting attacked by bogeymen, and will be more vulnerable to attack in general.

If you are not near any sites, the {{k|m}} key will toggle a world map, colored in sepia tone (matching the map you see in the quest log). If you are near a site, then {{k|m}} cycles between a list of significant structures where your player is, a regional map (matching what you travel on when away from any site), and the aforementioned world map.

The {{k|c}} key will only show clouds on the region map (the one you travel on outside of sites). Some clouds will be visible regardless of the state of this option.

The {{k|h}} key will cycle through various amounts of the bottom bar of content hidden. The effects of each press are:

* 1 press: hide key reference. Allows you to see status effects on your character if obscured by the key list.
* 2 presses: hide most local name, reducing the bar to one line of text.
* 3 presses: hide less local name, eliminating the bar entirely.
* 4 presses: shows all information

== Status and Information ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|l}}
| Look around
|-
| {{k|Space}}
| Advance/Clear Messages
|-
| {{k|a}}
| View Announcements
|-
| {{k|z}}
| Status
|}

=== Looking Around ===

If you're not sure what a tile is, the {{k|l}}ook command will tell you. In addition to being useful for identifying tiles and creatures, you can also view creatures' equipment and what items are sitting on the ground in a given tile. If in doubt, try the look command.

Move the cursor to the tile you want to look at using direction keys and {{k|Shift}}+direction. It's possible to look up and down z-levels (assuming you have line of sight) using the {{k|<}} and {{k|>}} keys. This, for example, allows you to find out if any flying creatures are above you. Hit {{k|Esc}} to exit look mode and go back to movement mode.

=== Messages ===

The game makes frequent use of messages on the screen to tell you what is going on. If there are a lot of these you may need to use {{k|Space}} to display the rest of the messages that won't fit on the screen. You can always go back and view old messages by pressing {{k|a}}.

=== Status Screen ===

This screen shows your skills, attributes, wounded body parts, health (along with more detailed descriptions of your wounds), lets you view your description, and change your nickname if you want.

=== Saving the Game ===

Hit the {{k|Esc}} key at any time and select {{DFtext|Save Game}} to save your game. You can then come back to it later by using the {{DFtext|Continue Playing}} option in the main menu.

== Searching and Manipulating ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|u}}
| Interact with building, furniture, or mechanism
|-
| {{k|L}}
| Search the nearby area very carefully
|}

The {{k|u}} key can be used to do stuff like pull levers in your abandoned forts. It is also used to lower and raise the bucket when standing right next to a well so you can get water to refill your waterskin with.

{{k|L}} will perform a thorough search of the area that you're standing in, possibly revealing some small creatures.

== Managing Equipment ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|i}}
| Show Inventory
|-
| {{k|d}}
| Drop an item
|-
| {{k|g}}
| Get (pickup) an item off the ground
|-
| {{k|p}}
| Put an item into a container
|-
| {{k|r}}
| Remove an item you are wearing or from a container
|-
| {{k|w}}
| Wear an item
|-
| {{k|I}}
| Interact with an object in an advanced way. (unstick a weapon, refill waterskin etc.)
|-
| {{k|q}}
| Sheath your weapons and shield. (Frees your hands for tasks such as climbing or grabbing)
|}

=== Inventory ===

Press {{k|i}} to display a list of what you are currently carrying. Press {{k|-}} {{k|+}} {{k|*}} {{k|/}} to scroll the list. This list will show you if items are being worn, held in hands, stuck on your body, or are inside a container. Detailed information about an object can be viewed by pressing the key associated with the item.

=== Getting/Dropping Things ===

You can {{k|d}}rop items in your inventory, as well as {{k|g}}et items on the ground on the same tile that you are standing on. If there is more than one item a menu will be listed. Press {{k|-}} {{k|+}} {{k|*}} {{k|/}} to scroll the list if the list is too long to fit on the screen. Note that getting something makes your adventurer pick something up with his or her hands. This often means that you have to use {{k|q}} to sheathe whatever you have in your hands before you pick something up. If you do not (and you do not have a backpack or some other way of storing the object, your adventurer will not pick the item up.

{{k|g}} will also allow you to ignite foliage/any flammable objects adjacent to you. Fires aren't as devastating as one might imagine, but they will cause (most) enemies to path around them, making your crowd control slightly more effective when taking on multiple enemies. As an added bonus, it will also surely piss off the elves.

=== Containers ===

Items can be placed into containers with {{k|p}} and removed with {{k|r}}.

=== Wearing ===

Items can be worn using {{k|w}} and removed using {{k|r}} (the same command used for removing from containers). If an item you want to wear does not show up as an option, then it means you are already wearing too many items in the location used by that item. Try {{K|r}}emoving items in that location and then wear them again in order of priority. You also must put on equipment in an order that makes sense,. for example a shirt first ''then'' the armor, not the other way around. Armour must also be put on in a sensible manner with flexible layers such as chainmail first then rigid plate armour second. After all, who, in real life, would wear chainmail over a hard plate?

''Note that "large" or "small" clothing items are too big / small for your race'' (e.g. a '''large''' giant cave spider silk sock). If you have that problem, try getting clothing from a different source.

After acquiring [[armor]] from one source or another, you'll most likely want to equip it. To do this, first make sure it is in your possession--not on the ground. You can then {{key|w}}ear it, granted you don't already have too much on that equipment slot already. You can {{key|r}}emove or {{key|d}}rop inferior equipment as necessary.

See [[Armor]] for more information on wearing things. One thing to note in particular, DF allows you to wear more than one item in the same location in many situations, for example a copper mail shirt and a copper breastplate. The thin, flexible chain can be worn under the breastplate, but not the other way around.

=== Wielding ===

There is no command for wielding items such as [[weapon]]s in specific hands. Instead, they are automatically equipped when you either {{k|g}}et them from the ground or {{k|r}}emove them from your [[backpack]] - provided the hand that would wield them is free. So in order to change [[weapon]]s or [[shield]]s you should drop items or place them into containers (such as your backpack) until your hands are free, then get items from the floor or remove them from containers which will place them in your hands. For example, put all items into backpack, remove sword from backpack, remove shield from backpack. The items will end up in the right and left hand. Simply remember the {{k|r}}emove command and the {{k|p}}ut into container command.

While normally one would only be able to equip one item in each hand, removing items from your inventory results in them being wielded regardless of whether one's hands are full. This is especially useful with shields, as every shield will contribute a block chance to each incoming attack.

It should be noted that Dwarf Fortress does not enforce one particular hand as dominant for everyone, so do not be surprised if your character holds the weapon and [[Armor#Shields and Bucklers|shield]] in hands you yourself would not hold them in.

=== Advanced Interaction ===

The {{k|I}} key allows "complex interaction" with objects in your inventory.

This is used for removing arrows and weapons stuck in wounds which will appear in your inventory when they become stuck in you. Removing stuck arrows can cause bleeding so it is not always a good idea mid combat, but stuck objects will slow you down as you are encumbered by their weight. It s best to remove them as soon as possible when it is safe and you are not in danger of bleeding to death.

Advanced interaction can also be used to steal enemy equipment. Use [[wrestling]] to grab hold of a piece of enemy equipment, such as their weapon, or a helmet protecting their squishy brain and it will appear in the advanced interaction menu. Simply grab the item with a free hand and pull away. If successful, you will now be holding that item in your hands.

This command is particularly useful for getting water. When standing next to a well you press the {{k|u}} key to lower, then raise the bucket, yielding 10 units of water in the bucket. Then you can press the {{k|I}} key to fill your waterskin from the full bucket (alternatively you can press the {{k|e}} key to drink directly from the bucket).

Advanced interactions can be used next to a campfire to heat things, such as any frozen liquids you have in your inventory (or snow lying on the ground) and need to drink. You can refill waterskins from a nearby liquid source as well

===Sheathing===
The {{k|q}} key lets you strap your weapons to your back.

This is useful because you can't climb or wrestle with your hands unless your hands are free.

People will also be less likely to be scared of you on first sight if you don't appear to be ready to attack.

== Time and Weather ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|D}}
| Date
|-
| {{k|P}}
| Temperature
|-
| {{k|W}}
| Weather/Time
|}

The game has a day/night cycle with time passing as various actions take place.

When using quick travel mode, the top line of the screen will indicate the position of the sun in the sky with a yellow "☼"; further to the right of the screen is earlier in the day and further to the left is later in the day.

In local travel mode you'll have to use the {{k|W}} command to learn the position of the sun, when you're in a place where the sun is visible.

At night you won't be able to see nearly as well and you will be more vulnerable to ambush.

The game also has weather and temperature. The most common weather you'll experience is rain. Rain is shown as blue moving dots on the local travel screen and will unsurprisingly cause everything outside to become wet. Temperature is important because if it happens to drop below freezing while you're swimming through water, you'll instantly die from being encased in the ice.

Therefore you might want to keep an eye on the temperature while swimming, especially if it's getting cold.

Also, unlike fortress mode, rivers/other bodies of water can be liquid during the day, and freeze at night. The cycles of freezing can also be erratic from day to day.

Freezing weather can also freeze liquids in your inventory solid, making them undrinkable. If your water freezes and you are thirsty, make a campfire and {{k|I}}nteract with your waterskin to heat it over the fire and melt the ice.

== Sleep ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Z}}
| Sleep
|}

Eventually your character will become {{DFtext|Drowsy|1:0}} and this will get worse until you get sufficient sleep.

Sleep does not necessarily have to coincide with night, but if you're traveling alone when night comes you'll be in danger of being attacked by [[Bogeyman|Bogeymen]]. To avoid this while traveling solo you need to make it to shelter before nightfall and sleep the night away inside a building or abandoned lair. Enter a building, use {{K|k}} to talk to a human, and ask for permission to stay the night. Next press {{K|Z}} to sleep, {{K|d}} to sleep until dawn, then {{K|Enter}} to confirm. ('''NOTE''': If you stay the night in a castle, you have to sleep in the keep which houses the lord/lady of the castle. Sleeping inside the castle but outside the keep still leaves you vulnerable to attack.) Sleeping on an ocean beach also prevents bogeymen from attacking. (If you'd rather not deal with bogeymen, you can disable them by generating a world using [[advanced world generation]] and setting "Number of Night creatures" to 0)

Though sleeping inside can be safe, it's also limiting: any quest site you want to go to has to be within a daytime's round-trip time of a safe habitation, and you have to make your way to there by hopping from one habitation to the next, sleeping at each along the way. A way to avoid this is to travel with companions. If you have any companions with you then Bogeymen won't attack you. You'll still have to sleep at night, though, both to avoid sleep deprivation and because there's no visibility at night. You can still be ambushed at night by wildlife, but that's much less likely than being ambushed by Bogeymen when traveling alone. If you find yourself alone at night with nowhere safe to sleep, the safest bet is to keep traveling until dawn, even if that means running around in circles. You will eventually feel unwell from sleep deprivation, but this can take a considerable amount of time. You can make up for lost sleep once you've found your way to safety.

Note that sleeping in lairs, shrines, and labyrinths makes you safe from ambush, assuming that you or someone else has killed whatever was living there. If you have sufficient shrines/lairs/etc between you and your goal and they are either uninhabited or inhabited by things you are capable of killing then you can travel from lair to lair using each lair as a safe lodging. This is much safer than sleeping out in the open, day or night, even with companions.

If no other options are available, completely surrounding yourself with campfires will keep night marauders at bay as they cannot pass through the fires; the fires will go out after several hours and enable you to move on (you may also be able to jump over the fires). The bogeymen or other enemies may be outside your line of sight, which will prevent you from firing arrows or throwing things at them. In this case, you will have to stand up and lie down {{K|s}} repeatedly until the enemies wander into your range, the fires go out and the enemies can path to you, or dawn breaks.

It should be noted that, as of DF2014, climbing trees and sleeping on them will prevent Bogeyman attacks, as well. This is especially useful if you prefer to play solo, and do not wish to have an army of followers in your employ. This is also useful if you prefer to engage enemies at your own pace (such as via stealth), rather than having your entire follower party immediately charge at anything that is hostile to you.

== Food and Drink ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|e}}
| Eat or drink something
|}

To find water, you must find a river, stream, or well in a town and fill your waterskin from it, or drink from it directly. Water that may be covering you or your items will not be able to satisfy your thirst.

Note that drinking vampire blood will turn you into a vampire instantly.

Make sure to eat or drink regularly even if you're not hungry or thirsty, as you can only eat or drink thrice at a time: after that you'll need to rest, or wait until you can consume another meal. If you find yourself in need of both food and hydration, make sure to take care of the most urgent problem first, as if you are moderately hungry but severely dehydrated and eat three times, you may die before you have another chance to drink.

If the temperature is low enough you might have trouble finding liquid water. Snow and ice can be heated into water by first making a campfire with {{k|g}} and then performing an advanced interaction with {{k|I}} on the ice or snow in your inventory to heat it. Advanced interactions with your waterskin can also be used to gather water from water sources, or snow from the ground.

== Combat ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}
| Attack adjacent hostile creature
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Attack adjacent hostile creature
|-
| {{k|A}}
| Attack an adjacent creature.
|-
| {{k|f}}
| Fire a projectile
|-
| {{k|t}}
| Throw an item
|-
| {{k|C}}
| Open combat preferences interface
|}

[[Combat]] is the fine art of using physical force to cause injury and death, and it is particularly fun in Dwarf Fortress.

=== Melee Attacks ===

Hostile creatures can be attacked using a non-aimed attack by simply advancing towards your enemy using the arrow keys. Doing a non-aimed attack will also have a chance of freeing up any stuck weapon, though you are more likely to accomplish this by moving away from the enemy, or complexly interacting with the weapon.

Any creature can be attacked by standing next to it and pressing {{k|A}}. Attacking a friendly or unconscious creature (which includes wild animals for elves) will further require a confirmation, given using {{k|alt}}+{{k|y}}.

After selecting (and maybe confirming) which creature you want to attack, {{k|a}} will allow you to make an '''aimed attack'''. You must first select the body part that you want to attack. Look at the difficulty rating for various possible attacks. Impossible attacks will be impossible to land and Easier attacks will be very easy to land. The difficulty rating for an attack does not change depending on your weapon skill. Based on player experiences, a Grand Master weapon user can almost always land a "Tricky" strike, while a Novice generally cannot. Attacks on various locations will also have limits on how "squarely" they can land (due to being out of reach, for example). Square and very square attacks will deal more damage.{{Verify}} Attacks which "can't land squarely" are generally still effective.

Attacks aimed at the head are the most effective; a single attack to the cranium with a weapon will usually put an end to the fight. Aimed attacks are especially useful for dismembering opponents. Opponents who are missing a foot will fall over, thereby greatly lowering their speed, and giving you an immediate edge in the fight. Cutting off both hands also highly recommended for obvious reasons. After all, a field full of armless, one-legged enemies can be a big experience booster for your companions.

Aimed attacks are also especially helpful when fighting giant beasts. Some enemies like giant desert scorpions have lots of redundant body parts, and random attacks waste valuable time on low priority areas while the scorpion is busy injecting venom into the whole party. Lastly, aimed attacks allow you to grab trophies that are not available via butchering. For example, a minotaur's horns can be cut off during a fight, but since its a humanoid, most adventurers will refuse to butcher its corpse after the fight. However, in Dwarf Fortress 2014, all butcherable corpses are able to be butchered, as long as the corpse isn't too mangled.

There are several options below the hitting menu. Quick attacks are faster than regular attacks but weaker. Heavy attacks are slower but attack harder. Wild attacks are faster and hit harder but are inaccurate. Precise attacks are very slow but are much more likely to hit. Multi-attacks allow you to attack several times in a row at a great cost to the effectiveness of any one of the chosen attacks.

=== Ranged Attacks ===

To attack with a ranged weapon press the {{k|f}} key with a ranged weapon (bow, crossbow, etc.) equipped on one hand and select the square where you want to attack. Note that you need to have some sort of ammo, corresponding to the type of ranged weapon you are using (for example, bows use arrows, crossbows use bolts). Otherwise, a message stating "You have nothing left to fire." is displayed in brown. Similarly use the {{k|t}} key to throw any random object in the same manner. Random objects appear to make a random attack if they happen to have more than one possible type.{{Verify}} For example, if you throw a sword it may hit with a blunt impact, a stabbing impact, or a slicing impact. Throwing crossbow bolts with sufficient throwing skill and strength seems to have an effect similar to firing them, although less powerful. On the plus side, you will never lose ammo if you throw it.

It is not possible to aim for specific body parts with ranged or thrown attacks.

Throwing is generally a good skill to have for any adventurer, as it allows you to slow down fleeing foes, both on the ground and in the air without the need of equipping a (cross)bow. Just like {{k|l}}ooking, you can use throwing to view and hit enemies multiple Z levels away from you. If you're lucky, you can simply land a hit that causes the flying enemy to give in to pain, and then let gravity do the rest of the work. Even if the fall doesn't kill them, they will most likely be stunned long enough for you to run up and slaughter them.

=== Wrestling and Unarmed Attacks ===

:''Main article: [[Wrestling]]''

'''[[Wrestling]]''' (grappling) can be performed by selecting an enemy via {{k|A}} followed by {{k|b}} to wrestle. You can wrestle any enemy. Wrestling works somewhat like a targeted attack. Once you grab a creature by some body part, you may be able to make another wrestling attempt that will allow you to perform a throw or takedown.

For a detailed list of moves such as takedowns, throws, choke holds, etc., see [[Wrestling]].

It's also possible to punch, kick, and bite. These are not in the wrestling menu but are performed like normal targeted attacks with {{k|A}}.

=== Weapons ===

[[Weapon]]s are basically divided into axe, sword, spear, pike, mace, whip, bow and hammer, with various versions of these taking up the gray area.

=== Wounds ===

If you get wounded during combat, there's not much that you can do except perhaps run before you get more wounded. Your wounds will heal over time, so just travel around or sleep in a safe place. Some wounds however may never heal, leaving you permanently crippled. Obtaining a crutch may help with this. Or if you are not already a vampire, then you can get bitten by a werebeast during full moon, which will heal all injuries once per month.

If you have some bolts or arrows stuck in your body, they can be removed by using the complex interaction menu {{k|I}}. Select the stuck bolt or arrow from the list and then pull it out with {{k|a}} You'll probably start bleeding after you pull it out, but the bleeding is rarely anything to worry about.

=== Combat Preferences ===

At any time during gameplay (Except fast travel mode), you can press {{k|C}} to open the Combat Preferences menu. There are three different preferences you can set: Attack, Dodge and Charge Defense. These have a few different preferences each:

*'''{{k|a}}ttack'''
**'''According to Opponent''' - The default setting. When set to this, charging happens more or less frequently, depending on the difference in size between you and the opponent. Bigger opponents get charged less, smaller more often. Can be very risky, since a random charge against a huge opponent is likely to get you knocked down and stunned. In the same vein, charging when close to obstacles or other environmental hazards is very dangerous, potentially fatal, if the enemy dodges you.
**'''Strike''' - This setting ensures that you never charge an opponent, but rather just swing your weapon at them. This carries less risk than the above, but you're never going to knock anyone down without hitting their legs or spine. Very preferable against large opponents.
**'''Charge''' - When set to this, you ALWAYS charge. When faced with numerous small enemies (Bogeymen in particular), this can be extremely useful, but remember to switch back when facing something bigger. Charging a large dragon is almost a certain death sentence.
**'''Close Combat''' - With this setting, all your auto-attacks are grapples. Generally not very useful, since the random nature of it tends to prevent you from actually doing any damage with it, but if you continually auto-attack a harmless creature with it your wrestling-skill will be legendary in no time.

*'''{{k|d}}odge'''
**'''Move Around''' - This means you can jump away from attacks, physically moving in a random direction. While this lets you dodge attacks more often, it can also result in you jumping into a wall or down a lake. If you're fighting in really tight spaces, or areas with large pits, you might want to switch to the other option.
**'''Stand Ground''' - As can be expected, you stand your ground. No jumping around, which is useful in the above situation, but risky in the open. If you have room for jumping around, go with Move Around, but otherwise this could be a good idea.

*'''{{k|c}}harge Defense'''
**'''According to Opponent''' - Again, the default setting. You're more likely to stand still against small enemies charging, but will probably prefer moving away from larger ones. Somewhat risky, in that even a somewhat small enemy can stun you by charging.
**'''Dodge Away''' - With this, you'll dodge away from charging enemies, if you can. It's not a sure bet, but it's very much worth it against enemies who like to charge. This is probably the most preferable mode, since you're not losing a whole lot by dodging a small foe charging, but dodging an angry night beast can save you from a world of pain.
**'''Stand Ground''' - If you're certain of your physical superiority to the opponent, you can safely choose this. Standing your ground like a real man/woman might feel hardcore, but getting knocked down in a fight can be extremely dangerous. It probably has some use against bogeymen though, since they're quite small. If you really are much bigger than the enemy, you'll end up knocking THEM down. Most of the time though, charges heavily favor the attacker, so dodging away is probably preferable.

Using Combat Preferences properly can actually save your hide, so it's worth fiddling with. Just don't forget that you've fiddled with them, since a misplaced charge or dodge could end up killing you.

== Talking ==
[[File:Advmode_conversation_DF2014.png|thumb|400px|Talking to someone in Adventurer mode.]]
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|k}}
| Talk to somebody
|}

Now that you know how to kill people, you may also want to know how to talk to and otherwise interact with them in a less violent manner. While this is less entertaining, it can sometimes be useful.

To begin a conversation, press {{k|k}}. Unless someone else has already started a conversation with you (see below if someone has), you will get a cyan X that can be positioned over people you want to talk to with the normal directional keys. Use {{k|-}} and {{k|+}} to select who you want to talk to. Aside from individuals, you can also {{DFtext|Shout out to everybody}}, which will have you talking with everyone in earshot, or you can talk to your deity.

Whenever you want to advance the conversation, you have to press {{k|k}} again and choose the ongoing conversation you wish to continue. You will also see ongoing conversations from people who have started a conversation with you. If you want to talk to someone else during this time, simply {{DFtext|Start a new conversation}}.

* {{DFtext|Greet listener}} — Has you offering a greeting to someone, when you're initiating the conversation.
* {{DFtext|Bypass greeting (new menu)}} — Skips the greeting, taking you straight to the normal conversation menus.
* {{DFtext|Reply to greeting}} — If you aren't the one who started the conversation, this option will let you reply to someone's greeting. They will then talk about some trouble.
* {{DFtext|Refuse conversation}} — Causes you to explicitly refuse to talk to someone who started a conversation with you. Unknown if this has a different effect from simply not doing anything.{{Verify}}
* {{DFtext|Reply to greeting (impersonation)}} — Like {{DFtext|Reply to greeting}}, except you're impersonating a deity.
* {{DFtext|Nevermind}} — This has you back out of having a conversation.

When you start talking to someone, you are presented with a wide array of things to talk about. (If the person you are talking to started the conversation and told you about some trouble, you'll first get a menu related to that trouble. Just press {{k|-}}-{{k|Enter}} to {{DFtext|Change the subject (new menu)}} and get to this first menu.) Your choices are as follows:

{| class="wikitable" style="border:1px solid #ccc;"
| style="text-align:right;width:30%;" | {{DFtext|Return to current topic (new menu)}}
| You'll see this option only if you chose to change the subject in another menu. This will, predictably, take you back to that subject.
|-
| style="text-align:right;" | {{DFtext|Bring up specific incident or rumor (new menu)}}
| Allows you to spread rumors or summarize conflicts you've been a part of. The next step of the conversation will bring up a menu of choices that allow you to ask for directions to places or state your opinion on the incident/rumor.
|-
| style="text-align:right;" | {{DFtext|Ask to become a hearthperson}}
| Only appears when talking to a leader who you aren't under the command of. Allows to become one the leader's guards.
|-
| style="text-align:right;" | {{DFtext|Invite listener to become a hearthperson}}
| Only appears when you are a leader. Allows to become one the leader's guards.
|-
| style="text-align:right;" | {{DFtext|Request duty or advice pertaining to service as a hearthperson}}
| Only appears when talking to a leader who are under the command of. You will receive some task to accomplish for the group, if there is anything that needs doing.
|-
| style="text-align:right;" | {{DFtext|Bring up the journey together}}
| Only appears when talking to a companion. The next step of the conversation will allow you to cancel the agreement you made with that person, if you so choose.
|-
| style="text-align:right;" | {{DFtext|Inquire about any troubles}}
| Asks the listener what things in the world are bothering them and their people.
|-
| style="text-align:right;" | {{DFtext|Ask for directions (new menu)}}
| Allows you to ask for the location of a specific creature or site. People aren't guaranteed to know, and may instead direct you to someone who does.
|-
| style="text-align:right;" | {{DFtext|Ask about the local ruler}}
| As you might imagine, this gets you some information on who controls this particular area.
|-
| style="text-align:right;" | {{DFtext|Trade}}
| Allows you to trade with a merchant. Note that you have to be right next to them for this to work.
|-
| style="text-align:right;" | {{DFtext|Exchange, give, or take personal items}}
| Like {{DFtext|Trade}}, only that it works with non-merchants.
|-
| style="text-align:right;" | {{DFtext|Ask favor, place request, make demand or issue order (new menu)}}
| Takes to a menu of various request you can make, including asking the listener to yield, stay put, or pay homage to your group. The options available depends on who you're talking to.
|-
| style="text-align:right;" | {{DFtext|Ask listener to join you (new menu)}}
| This is how you get companions. You can either ask them to join you on an adventure, or to lead you to some location.
|-
| style="text-align:right;" | {{DFtext|Claim this site for yourself (group naming menu)}}
| This option allows you to stake a claim on the site you are in.
|-
| style="text-align:right;" | {{DFtext|Ask for permission to stay a day}}
| Allows you to sleep in the listener's building for the night.
|-
| style="text-align:right;" | {{DFtext|Ask about the structure you are in}}
| Tells you about whatever structure you are standing in, if you are standing in one.
|-
| style="text-align:right;" | {{DFtext|Ask about this site's neighbors and trade partners}}
| Lets you learn what sites this site is neighboring and/or trading with.
|-
| style="text-align:right;" | {{DFtext|Ask about the surrounding area}}
| Choosing this will tell you about some location nearby, and why it's significant.
|-
| style="text-align:right;" | {{DFtext|Comment on weather}}
| Small talk about the weather. Really.
|-
| style="text-align:right;" | {{DFtext|Comment on natural surroundings}}
| Same as the weather, only about the nature around you.
|-
| style="text-align:right;" | {{DFtext|Accuse listener of being a night creature}}
| If chosen against a night creature, such as a vampire, it will expose them. Normal individuals will just think you're losing it.
|-
| style="text-align:right;" | {{DFtext|Inquire about listener's profession}}
| Learn what it is the listener does. Useful for lords and ladies and anyone else whose profession isn't listed next to them.
|-
| style="text-align:right;" | {{DFtext|Ask about listener's family}}
| Discover what family the listener has, as expected.
|-
| style="text-align:right;" | {{DFtext|Brag about your past violent acts}}
| Causes you to brag about whatever last violent act you did. Doesn't seem to have an effect, or at least severely less impactful than summarizing the conflict.{{Verify}}
|-
| style="text-align:right;" | {{DFtext|Say goodbye}}
| Ends the conversation.
|}

Note that you can press {{k|Esc}} to not choose anything. The conversation is still ongoing, you have to explicitly say goodbye to end it. Pressing {{k|Esc}} is useful if you need to double-check something before talking.

== Companions ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|c}}
| View companion interface
|}

Companions are the guys who follow you around after you've asked them to join you and they've accepted. Your character will have a limit on the maximum number of companions that is based on fame/reputation level and the ''Social Awareness'' attribute. With average social awareness and the maximum level of fame, the limit is 19 companions.

You can use the {{k|c}} key to open up a list showing your companions and their relative position to you. This can be useful if one of them runs off somewhere and you want to find them. You can select specific companions who are in visual range in order to view them. This is the same as viewing them with {{k|l}}ook.

You can give or take equipment with a companion by choosing to talk to them and selecting {{DFtext|Exchange, give or take personal items}}. An evil and arguably inefficient way to get equipment is to intentionally get your companions killed and then take their stuff. If you are trying to help your companions, it is important to note that they prefer to store exchanged items in a personal container rather than to equip said items. You must convince your companions to trade away any containers (pouches, quivers, backpacks, etc.) as well as the equipment that you are attempting to replace. Once you have given your companions almost no choice in the matter, they will equip the new items and a message like {{DFtext|The Swordsman reorganizes his possessions.|6:1}} will be displayed.

If they survive long enough/are trained well enough then companions are capable of leveling stats and skills. Thus they are susceptible to gaining a title or having a job title change as well.

Your companions will continue to follow you and fight hostile creatures around you until they die (if you asked them to join you on an adventure) or get you to the proper location (if you asked them to guide you some place). If you want to get rid of your companions at any time, the safe way is to talk to each one of them, ask them about their journey with you, and then cancel the agreement.

If your companions are too far away from you when you enter fast travel, they will become an asterisk on the map where you started fast travel from. This asterisk may try to join up with you during travel. If you keep losing your companions while traveling through rivers, try going to a spot where the river becomes a "minor river" (shown by a single dark blue line). Brooks are obviously also safe to cross.

== Personal Finance ==

=== Trading (barter) ===

In human towns (not hamlets or castles), you can find shops,in Elven Trading trees you can find markets and at depots in dwarven fortresses you can encounter brokers. Once you're inside of a [[shop]] and right next to any of the NPCs, you can use {{K|k}} to {{DFtext|Trade}} with them. Use {{K|Enter}} to select which items to trade, left/right arrow keys to switch between the list of shop items and your items, and up/down arrow keys to scroll through the lists. You can also either {{k|a}}sk for or {{k|o}}ffer currency as part of the process. Once done, press {{K|t}} to trade. The shopkeeper won't get angry if you're not offering enough in trade, so you can start offering just a few items, keep trying again with a little more until the trade is accepted. Once the trade is accepted all of the items you offered will be on the floor underneath you.

After trading, you will find the stuff you gave on the floor at your feet, and the stuff you got in your inventory.

=== Theft ===

You may also pick up the item before buying it, but you should never walk out of a shop carrying an unbought item, as that is theft. It is punishable by death if you are caught, and excommunication if you are not. On any occasion when you have stolen goods from a store (indicated by dollar signs on either side of the item in your inventory), the game requires you to exit the site ''and'' move a considerable distance before allowing you to quick travel. This may make a getaway more difficult if your adventurer is not already faster than anyone else. This only applies to goods in stores; killing townsfolk and taking their personal things, including those of the shopkeep still only requires exiting the site. The moment you are out of sight, you will be able to warp out as usual. Theft and murder remain within entities; even depopulating one country and stealing all its things will not generate ill response in another country.

In some cases, the shop will be abandoned. This will be made clear by the presence of unbought items and the lack of any merchants in the area. You will not be considered a thief by the relevant entity for taking stuff from an abandoned shop.

If the item name is not surrounded by dollar signs, it is never considered stealing, even in situations where it would be in real life.

=== Managing coins ===

You will find that coins from one civilization are nearly worthless in other civilizations. This will typically result in adventurers carrying around lots of now useless coins. Coins can and will encumber your adventurer, eventually reducing your speed. To reduce that effect you can try to exchange your copper and silver coins for gold ones as well as sell all of your loot directly for gold coins. Remember, merchants will always try to pay you in higher denomination currency first but will resort to lower value coins if they run out of anything higher. First, check the merchant's chest to see how much of each type of coins they have.

Coin values are as follows:
* Copper Coin = 1☼
* Silver Coin = 5☼
* Gold Coin = 15☼

To receive the maximum amount of gold coins from that merchant, make sure the amount "they owe you" during the trade is equal to (total amount of gold coins the shop has)*15☼ . If you are selling loot, simply make sure you only trade this worth of goods, and move on to other merchants for the rest. If you wish to exchange copper and silver coins for gold, buy random goods from the merchant until their price is around this value and then sell back all of the goods for their original value but in gold.

Alternatively, you can take your excess coinage and use it to purchase [[Gem|large gems]] at a trinket shop. Large gems make good investments because they are 1) light, 2) variably priced, and 3) equally valuable between different civilizations.

A few goods are strictly superior to all forms of coinage as a store of value, most notably giant cave spider silk items. A suitably sneaky (or powerful) adventurer can murder a few dwarves or goblins for such items for trade and sale for human goods. Giant cave spider silk is a non-renewable resource in a given world - please harvest responsibly.

=== Where to get items to sell ===

The best place to get items to sell is at bandit camps, after you've slaughtered all the bandits. You can loot the clothes and equipment off of the corpses of the bandits (and off your fallen companions, too), plus at the very center of camp there'll be a few scattered weapons and a few bags/chests containing various goods.

The next best way to get items to sell is to kill a creature, butcher their corpse (see below for how), and pick up the edible bits. Butchered bits from the corpses of people (dwarves, elves, humans, etc.) can sometimes be found in monster lairs and these seem to be just as desired by shopkeepers as the products you gain from your own butchering.

Another good early source of income can be bags left in houses and shops, which usually contain plants and food. No one will complain, and the plants inside can be sold at about 2☼ each plus the value of the bag.

At the bottom of the list comes {{k|L}}ooking carefully and selling any small creatures you might find. However, shops will not accept live creatures unless they are in cages. Some rocks, piles of sand, and other things found on the ground nearly everywhere can also be sold for 1☼ each.

You can also try filling your backpack from river - it can hold up to 100 units of water which is worth 100☼ total. After your sell it, water will drop to the floor as a pool, and backpack can be refilled instantly and for free from there. In fact, you can infinitely fill any container from any pool/pile of any liquid/powder, so if you happen to find some precious substance like [[sunshine]] or [[dwarven sugar]], money won't be a problem for you anymore. This is of course an [[exploit]], liable to be fixed at any time. It may be useful in a pinch, but don't rely on it.

Another devious method is to go outside the shop, {{k|g}}rab handfuls of mud and throw it into your backpack, then sell them for 1☼ each. The merchants will gladly buy your rare and valuable mud despite the unlimited free mud just outside their shop.

== Quest Log ==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|Q}}
| Open quest log
|-
| {{k|Esc}}
| Exit quest log
|-
| {{k|e}} {{k|p}} {{k|s}} {{k|r}} {{k|b}}
| Access various lists
|-
| {{k|m}}
| Switch between the world map and additional info
|-
| {{k|z}}
| Center cursor on location of selected list item, if known
|-
| {{k|c}}
| Center cursor on your location
|-
| {{k|l}}
| Toggle the visibility of the line between you and some other point on the map.
|-
| {{k|f}}
| Filter the list
|-
| {{k|+}} {{k|-}} {{k|*}} {{k|/}}
| Navigate the list
|}

The quest log contains everything you know about the world, such as various events going on, people you know, and various sites. The {{k|m}} key will alternate between a world map that you can navigate, and information on whatever item is highlighted in the list to the right.

There are various kinds of lists you can check on the quest log:

* '''Events''' — A list of events that are happening or have happened. Formatting of the list is {{DFtext|(type)/(description)}}. You can center on the location of the event if you know this. This list is the closest you'll get to some formal quest system.
* '''People''' — A list of people you know. At the start of the game, this list will contain people in your site.
* '''Sites''' — A list of various sites around the world.
* '''Groups''' — A list of groups you know of and your relation to them. Note that you have to press {{k|e}} when you're on the events list in order to reach this list, requiring you to press {{k|e}} at most twice.
* '''Regions''' — A list of regions. The additional information will list the biomes a region possesses.
* '''Bestiary''' — A list of creatures, their characteristics, and where you could find them.

==Crafting==
{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|x}}
| Perform action (butcher, create item...)
|}

Adventurers can perform limited crafting, (also known as "reactions"). To access the crafting menu, press {{k|x}}.

* '''[[Knapper|Knapping]]''' allows an adventurer to sharpen a rock. Knapping only works on stones on the ground or in your hands. Choose the {{k|c}}reate option and then select "Make sharp stone". You will be prompted to choose a rock to sharpen ("tool stone"), and then the rock that is to be the hammerstone. The tool stone will be replaced in your hand by a sharp version.

* '''Butchering''' acts similarly to Fortress Mode's [[Butchery]] by converting a corpse into edible products, bones, and skin. A corpse must be on the ground or in your hand. With a sharp object (such as a dagger or knapped stone or even a bolt/arrow) in your hand or on the same tile of the corpse, select the {{k|b}}utcher option, and then you can select the corpse and the sharp tool to butcher with. The corpse will be replaced by its butchering returns.

* '''Spitting''' gives you spit, which can be aimed at someone in much the same way as any projectile. To get this, choose natural ability and then spit in the reactions menu.

You may also gain acquired abilities when you become a creature of the night, such as a necromancer.

= Sites =

More information on each type of site can be found in the site's specific article.

== Civilization ==

[[Civilization]]s are organized groups of creatures (generally of the same race) which build sites such as towns.

=== Human Sites ===

==== Towns {{Raw Tile|+|7:0:0}} {{Raw Tile|*|7:0:0}} {{Raw Tile|#|7:0:0}} {{Raw Tile|☼|7:0:0}} ====
Humans live in towns comprised of buildings and often a paved road. Human towns are highly modular, and are usually near some source of water, either the coast or a river.

Towns appear on the fast travel map (when outside a site) as {{Tile|■|7:0:1}} or {{Tile|■|6:0:1}} symbols which are small collections of buildings. When you are near a human site, large yellow blocks indicate where various houses and shops are found (though not all houses and shops can be found in these blocks; sometimes you'll find a house or two out in a site's fields). You usually have to follow the roads in a yellow block on the fast travel map.

Towns usually have lots of interesting structures which are described fully in the [[town]] article.

==== Hamlets {{Raw Tile|æ|7:0:0}} {{Raw Tile|Æ|7:0:0}} {{Raw Tile|{{=}}|7:0:0}} {{Raw Tile|≡|7:0:0}} ====
Most of the time, the majority of a human civilization's population will live in small [[hamlet]]s, which tend to be sprawled out along coastlines and through river valleys. Like other sites, they can be invaded, and you'll sometimes find them captured by other civilizations, [[necromancer]]s, or criminal syndicates. Human adventurers usually spawn in hamlets.

Note that hamlets are similar in structure to towns, only they have mead halls instead of keeps, and don't have any defensive walls.

=== Dwarven Sites ===

==== Dwarf Fortresses {{Raw Tile|Ω|7:0:1}} ====
These are the randomly generated equivalent of the sites you build in [[dwarf fortress mode]]. [[Fortress]]es are described in detail in the own article. Their main function for adventurers is that they have a central, spiraling ramp that connects the underground and above-ground worlds, particularly in that they connect the subterranean tunnel networks to the rest of the dwarf civilization. They are located at the edges of mountain ranges.

Player-made fortresses are considered dwarf fortresses by the game, in addition to the randomly-generated ones.

==== Mountain Halls {{Raw Tile|Ω|0:0:1}} ====
[[Mountain halls]] are the sites of the "deep dwarves," located far beneath the mountains. They can be accessed via down-stairs found in underground tunnels, and are comprised of a couple of levels that contain bedrooms and large halls filled with smelters or forges.

==== Hillocks {{Raw Tile|Ω|7:0:0}} ====
[[Hillock]]s are the dwarf equivalent to human hamlets. They consist of a few circular mounds filled with dwarf citizens. There doesn't seem to be any settlement pattern for them; they are equally likely to be found in any land [[biome]].

=== Elven Sites ===

==== Forest Retreats {{Raw Tile|î|6:0:1}} {{Raw Tile|¶|6:0:1}} ====
Elves live in [[forest retreat]]s located, unsurprisingly, in [[forest]] biomes. They are essentially clusters of huge [[tree]]s with elves standing in and around them.

=== Goblin Sites ===

==== Dark Fortresses {{Raw Tile|π|0:0:1}} {{Raw Tile|π|5:0:0}} {{Raw Tile|π|5:0:1}} ====
These are the main goblin sites. Some [[dark fortress]]es may contain a [[Underworld spire|certain spoiler]].

==== Dark Pits {{Raw Tile|º|5:0:0}}====
These are the goblin equivalent of hamlets and hillocks. [[Dark Pit]]s are essentially canyons lined with wooden guard towers. They tend to be built in huge clusters around the dark fortresses, such that large chunks of the map may be covered with them.

=== Kobold Sites ===
==== Caves {{Raw Tile|•|#808080|#00DD00}}====
[[Cave]]s are sometimes home to [[kobold]] groups. They are mounds filled with narrow tunnels leading to the [[caverns]] and usually contain piles of random loot resulting from kobold [[Thief|thieving]] incursions.

=== Night Creature Sites ===

==== Necromancer's Towers {{Raw Tile|I|5:0:0}} ====
[[Necromancer]]'s Towers are built by necromancers who have at least 50 followers; younger necromancers may take over towns or camps instead. Usually you can find [[book]]s written by the necromancer, some of which contain [[Necromancer#Adventurer_Mode|the secret to life and death]]. Towers require abundant human populations (low savagery, large tracts of neutral land) and a high number of secrets to be generated in world generation, as necromancers cannot be elf or goblin.

==== Lairs ====
Lairs are the homes of [[night troll]]s. Lairs are mounds or holes in the ground with doors or hatch covers. Most night troll lairs are inhabited by a single creature, but sometimes you'll encounter entire families of five or even ten.

=== Megabeast Sites ===
==== Minotaur's Labyrinths {{Raw Tile|#|0:7:1}}====
A Labyrinth is an intricate network of tunnels often filled with the bodies of previous adventurers slain in [[World generation|worldgen]] by its resident [[minotaur]]. As you explore the labyrinth, you will hear the minotaur taunting you.

==== Bronze Colossus' Shrine {{Raw Tile|Å|7:0:0}} ====
Shrines are huge stone structures surrounded by pillars that are the homes of [[bronze colossi]] and [[titan]]s. Several of them can be found on a single site, making its exploration particularly hazardous. [[Demons]] have also been reported to inhabit them.

= FAQ =

== How do I find an entrance to the underworld? ==
Method 1: Most [[Cave|caves]] lead directly into the first [[cavern]] layer. Although it may be possible to learn of some trouble which originates from a cave{{verify}}, your best bet is to ask people about the surroundings, and hope that they mention a cave at some point. If they don't, travel to another site a fair bit away from where you are and ask someone else.

Method 2: Dwarf [[Fortress|fortresses]] are connected to the [[tunnel]] system, which usually connects to the caverns.

Method 3: You can start a [[dwarf fortress mode]] game, dig to the first cavern layer, retire or abandon the fortress, and then return with your adventurer.

The three cavern layers are connected to each other in [[Deep pit|various]] [[Passage|places]], although they are rather spread out and extremely difficult to find with an adventurer.

Additionally, [[Underworld spire|a certain spoiler]] can be found which leads to [[Hell|another spoiler]], deep underground.

== I keep getting maimed! How can I fight without getting seriously hurt? ==
The best defense is a good offense. If you let your enemies attack you, you're (unsurprisingly) likely to get hurt eventually.
* Try to '''avoid fighting difficult enemies until you get some armor'''. Don't fight enemies at all unless you're sure you can beat them. If you're unsure, you're probably going to get hurt.
* If you have good speed, try to '''fight enemies one-by-one''' — keep moving backwards and only attack when you're within range of just one enemy.
* If you have a slashing weapon, try to '''chop body parts off of your enemy''' — it makes them stop fighting for a turn, allowing you to keep attacking them without being attacked in exchange. Chopping off limbs will also weaken your enemies - taking their arms can prevent them from using weapons, taking their legs can make them slow and knock them down. Chopping off their heads will instantly kill them, but it may take a few (or, with larger enemies such as [[troll]]s, it may take more than fifteen) slashes before the head is severed.
* Remember that '''it's better to let your enemy come to you, than to go to your enemy'''. You have to either move or attack. If you move, you can't attack, so if you move within range to attack your enemy, you allow them to have the first strike (unless you're much faster than them). On the other hand, if you let them move within range of you, then you get to have the first strike. If your enemy is one space away from you, use that as an opportunity to throw a knife or a rock at them; worst case, they will get a bruise or a cut; best case, they will start the melee severely crippled. If you're fast enough, then you can simply step back after getting in that first hit, and they'll have to spend their turn approaching you again. Lather, rinse, repeat.
* Follow the advice under [[#Combat Preferences|Combat Preferences]].

== How can I obtain armor as quickly as possible? ==
* The best way would be to rummage through mead halls, keeps, and fortresses, or whatever other strongholds your race makes use of. Not all places will be stocked with equipment, but usually they have something.
** There are also underground locations, such as the dungeons underneath keeps, or the catacombs under temples, that contain plenty of equipment. These underground places are liable to be populated with unfriendly creatures, so beware.
* You can also take along companions and have them killed, or just plainly murder people and loot their corpses for stuff.
* You can earn some money by exchanging some loot with the local populace for coins, and then buy equipment off of soldiers you might meet in towns. Remember that coins only have nominal value in the civilization they've been minted, but gems are equally valuable anywhere.

== How do I increase my skills and attributes? ==

Here are some techniques for raising your skills; very rapidly in some cases.

Most of these skill-raising techniques involve repeatedly entering the same keystrokes. To assist with this you can use a [[DF2014:Macro|macro]] to make entering the same sequence of keystrokes over and over again much easier.

Increasing skills increases associated attributes which may in turn benefit other skills. For example, sharpening rocks using {{k|x}} will increase Knapping which will increase a number of attributes that help with combat skills. See [[Attribute#Skills_by_Associated_Attributes|Skills and Associated Attributes]] for a mostly complete list.

*'''Fighting and Wrestling''' — A good way to raise your Fighting and Wrestling skills and related attributes is to go find a small, relatively harmless animal and wrestle with it repeatedly. You can wrestle hitting {{k|b}} for the wrestling option after selecting the creature to fight. Continually grabbing and releasing a creature is sufficient to raise your skill, and you can do it indefinitely with the same animal as it won't be injured (unless you auto-wrestle it). Wrestling will increase Kinesthetic Sense, Spatial Sense, and to a lesser extent, Endurance. You may also somewhat increase Dodging and Shield User this way as the creature takes swipes at you.<p>It's possible to change your {{k|C}}ombat preferences for attacking and dodging to ''Close Combat'' and ''Stand Ground'', respectively, allowing you to simply walk into the helpless critter to wrestle it. (Standing your ground prevents you from moving to dodge attacks, so your wrestling can continue almost uninterrupted.) You will, however, perform occasional throws and take-downs as long as the creature remains standing, which may result in their eventual bleeding to death. Strangulation is also a repeated concern, as it will render the victim unconscious, thus making you have to wait until it regains consciousness before you can continue auto-wrestling it (though you may still raise your Wrestler and Fighter skills by 10 points for every time you ''release'' a limb - though this must be done manually and must be repeatedly confirmed, once the creature is rendered unconscious). Another concern with auto-wrestling some animals is that you will perform joint locks, and break hips, knees, and ankles in the process, which can cause the creature to bleed to death. If you can wrangle a creature incapable of blood-loss and strangulation in a high-FPS area (such as a crab on a frozen beach), you can easily raise all associated skills and attributes to Legendary and Superhuman in the course of a few minutes.</p>
*'''Shield User, Armor User, and Dodging''' - In addition to wrestling the creature, you can also sit back and let it attack you to raise your defensive skills. If you have metal armor, then a small animal like a gopher can't do any real damage to you when it hits. Also, to place emphasis more heavily on shield blocking, you can change your attack {{K|C}}ombat preference to ''Stand Ground''. The wrestling-a-crab-on-a-frozen-beach method also works fantastically for this.
*'''Weapon Skills and Fighting''' — Once your defensive skills are getting up there and your agility is high enough, you might want to try fighting [[bogeyman|bogeymen]] to increase your weapon skill. Just make sure to fight them one at a time while running away. If you don't know what a bogeyman is yet then you are probably not ready to try this. Also, doing difficult targeted shots will gain more experience and keep the training dummy alive longer.
*'''Throwing and Archery''' — Throwing rocks with {{k|t}} will raise your Throwing and Archery skills. Throwing objects at creatures, while not terribly effective, can still be a quite handy skill. Although throwing is a way to raise Archery without wasting ammunition, there is a non-wasteful method that additionally increases bow/crossbow skills.<p>The most efficient way to level via throwing is to forgo using a macro and separate training into two phases: {{k|g}}etting and {{k|t}}hrowing. First, find a tile with an indefinite amount of throwable objects (e.g., snow, rocks, mud, etc.). Then, sequentially mash {{k|g}} and whatever key the rocks are assigned to until both your forearms explode. Rest. Then, sequentially mash {{k|t}}, followed by some consistent key assigned to your rocks, then {{k|Enter}}, until you've emptied your inventory. Rest. Rinse and repeat. (You may wish to empty your inventory beforehand such that the rocks are assigned to a key close to {{k|t}}, allowing you to keep one hand on {{k|Enter}} and another on {{k|t}}.)</p>
*'''Marksman, Bowman, and Archery''' — Raising the bow and crossbow weapon-specific skills is best done by shooting at a wall or cliff with no floor directly beneath it. If bolts or arrows hit a wall that has floor/ground on the same z-level, then the ammunition will be destroyed. ''However'', ammunition that falls at least one z-level after hitting a wall will remain intact. So, simply find something like a hill inside a castle, stand on it, then shoot at a wall which is on the same z-level you are. The arrows will hit the wall and fall one z-level to the ground, remaining intact. You can then {{k|g}}et the arrows and {{k|f}}ire them at the wall again from the hill, ad infinitum. You can also stand next to a wall that's two or more z-levels high, aiming at the wall one z-level up by hitting {{k|<}} after hitting {{k|f}}. Whatever method you employ, the key is that the arrow needs to fall at least one z-level after hitting a wall to remain intact. Using a macro will speed this up greatly.<p>An alternative and much easier way to train any ranged attack is to simply shoot one or more z-levels straight above into the air , by using {{k|f}} than {{k|<}} , any ammunition used seems incapable of causing harm to the one launching it and lands undamaged under their feet for easy retrieval , however this may be considered a bug and/or exploit.</p>
*'''Ambushing and Swimming''' — An efficient way to raise Ambushing is to sneak over large stretches of land. Sneaking on the fast travel screen may work as well.{{Verify}} Ideally, this would be done in a biome containing sparse vegetation and few threatening creatures to blunder into and reduce FPS (e.g., a frozen beach).<p>Although less efficient for raising only Ambushing, it's also possible to sneak and swim at the same time, thus combining their training. '''Just make sure you start with at least Novice in swimming''', or you'll find swimming practically impossible to train. Swimming can very quickly improve your Strength, Agility, and Endurance. Additionally, if you can safely drown and then recover (e.g., by moving under a bridge and then back before suffocating), this will raise both Toughness and Endurance at a ''ridiculous'' pace— a single step spent drowning will raise both attributes by a fifth of a point apiece.</p>
*'''Observer''' — You can't really power-level this skill as it is slow and difficult to train, which is why you're advised to sink some points into it during character creation. However, one way to train it appears to be sleeping or walking around in the wilderness, allowing yourself to be repeatedly ambushed. This is, however, inherently dangerous. Running away from these encounters would probably be faster than slaying your assailants, if not generally safer for your character (but not for your companions, hoh boy).<p>Successfully detecting traps found in tombs and catacombs (performed automatically) will also raise Observer. However, without decent skill to begin with, you'll be torn to pieces by the many traps you'll fail to see. Otherwise, once you've found one or more traps, it's possible to grind experience by sleeping/waiting an hour, thus resetting the traps. Rinse and repeat.</p><p>As of version 40_23 one seem to aquire Observer skill from regular combat.</p>
*'''Spatial and Kinesthetic Sense''' - While sharpening rocks with {{k|x}} will improve your Knapping skill, it more importantly increases your Spatial Sense and Kinesthetic Sense attributes, which affect a number of other skills. Knapping can be combined with throwing via a macro to keep your inventory from filling up.
*'''Other Stats''' - Other useful stats like Strength, Agility, and Toughness will increase significantly as the fighting and defense skills increase, so you don't need to do anything other than what you'd normally be doing to increase these.

== I managed to escape but my limbs are chopped off. Now what? ==

'Tis but a scratch!

Unfortunately, there is only one way to get them back, and that is by being bitten by a [[werebeast]] and surviving until the next full moon. But as long as you have at least one leg and one arm left you can actually do pretty well. First, get a crutch from somewhere, such as a general store, and make sure it's in one of your hands. Once you do that you should be able to {{k|s}}tand back up again. (However, if spinal nervous tissue damage is what has disabled your ability to stand, crutches ''will not'' help you in that regard.) You will notice that your speed is now much slower than before.

Now go find someplace reasonably safe and walk back and forth until your Crutch Walking skill gets up to Legendary or above. You will notice your speed increasing as your skill levels up until your speed is completely back to normal. As a bonus you'll probably see some stat increases as well. You can continue to dodge with a crutch just as well as before.

You can wield a sword, shield, and crutch all in one hand, so even if you are missing an arm then you're all set. If you are missing both arms but still have both legs then unfortunately you'll be limited to biting, dodging, and wrestling with legs. If you're missing both arms and one leg then your movement will be limited and you'll be limited to biting and wrestling with your one remaining leg. And if all limbs are missing then you'll be limited to rolling around on the ground biting things.

Though you might actually be able to do surprisingly well as a Legendary Biter, especially if you powerlevel your strength to the point where you can shake things around by the teeth ripping limbs off, if you lose both legs then your character is going to be severely limited just due to the poor movement rate, so at that point it's probably best to opt for retirement or a glorious death in battle.

== What creatures of night can I become? ==

You basically have four different choices.

Firstly, you can become a [[necromancer|'''necromancer''']].
* That gives you some traits of an undead. Namely, you don't need to eat, sleep or drink, don't tire or age, zombies or mummies don't attack you and your physical stats are permanently fixed.
* The last one means it's wise to train them beforehand.
* You also can raise dead from the {{K|x}} menu. Depending on the flavor of your spell, zombies can be slow, very slow or not slow at all. They will be listed as companions.
* To become a necromancer, find a necromancer tower and obtain a book or slab containing secrets of life and death from there, then read it. Note that most of the books are useless. In younger worlds necromancers may not have built their towers yet, in which case they'll be hanging at a zombie bandit camp, slab under the arm.

Secondly, you can become a [[vampire|'''vampire''']].
* That gives you most traits of an undead. In addition to the listed above, you don't feel pain, don't breathe and immune to most syndromes.
* Your strength, agility and toughness are doubled.
* They're still fixed forever, so, again, be prepared.
* Despite not needing to drink water, you have a hunger for warm blood. To satisfy it, beat someone or something unconscious and {{K|e}}at their blood.
* To become a vampire, defeat one in combat and drink his blood.
* In version 0.42.01, it is now possible to be "cursed" by a god into becoming a vampire by desecrating statues\totems\altars dedicated to them. {{version|0.42.01}}

Thirdly, you can become a [[werebeast|'''werebeast''']].
* This gives you the (uncontrolled) ability to transform into a powerful half-man, half-beast on a full moon.
* There's a fixed list of animals on which the werebeast is based, including goat, llama, lizard, horse, monitor, buffalo, moose, tortoise, camel, kangaroo, ape, gecko, bear, hyena, warthog, iguana, skink, shrew, elk, skunk, pig, raccoon, panda, mole, badger, armadillo, mammoth and more.
* Most importantly, upon transformation (both ways) all your wounds, including missing limbs, are instantly healed.
* You don't show any abnormalcy outside of beast form. You are still mortal.
* When in beast form, everything is hostile to you, you don't need to drink, eat, sleep or breathe, don't feel pain, don't tire and are immune to some syndromes.
* One randomly chosen metal is ten times as deadly to you than usual. All other materials deal you half damage.
* Werebeast's size is several times their base animal size, but no less than 80000. This means all armor will be too small for you while in beast form. But you can still use a shield.
* Also, some werebeasts are truly gigantic — weremammoth has a size of 9000000, on par with demons.
* To become a werebeast, make one bite you. It has to be in the beast form.
* In version 0.42.01, it is now possible to be "cursed" by a god into becoming a werebeast by desecrating statues\totems\altars dedicated to them. {{version|0.42.01}}
* You cannot be a werebeast and a vampire at the same time.

And finally, you can become a mist [[zombie|'''zombie''']].
* This makes you undead. In addition to vampire traits, you can see without eyes and can't die via blood loss or beheading. Note that you don't have health point limit raised zombies have.
* You become permanently hostile to everyone except other undead.
* Your strength and toughness are tripled and fixed. Train beforehand.
* Depending on the flavor of zombie virus, your speed may or may not drop to 20% or 60% of its normal value.
* To become a mist zombie, find a mist/fog cloud that zombifies creatures and run into it.
* You cannot become a vampire or a werebeast if you are already a zombie. The other way, however, is fine.

=See Also=
*[[Main:Adventure Mode quick reference|Adventure Mode Quick Reference]]
*[[Main:Adventure mode quick start|Adventure Mode Quickstart Guide]]

=A glimpse into the Future=
{{D for dwarf}}

* Passage from "Shooting <s>for</s> the sky" , the giant toad bone bound book by Nefil Blackbone the human necromancer :

{{Quote|align=left|
... While seemingly absurd , the practice of ones abilities with a ranged weapon can be furthered by directing said weapon towards the sky .
After all , during day time the sky has one giant target that might even seem so large that it's impossible to miss , and the night sky has many smaller ones .
It has been well documented that hitting the target may not be necessary to achieve improvement in ones skill with said arms , thus it is reasonable to expect every subsequent shot after the first will hit a tad closer to it's intended target , this has further lead me to believe in the possibility of sky exploration , for with this logic at some point the projectile will actually hit it's target and could subsequently be replaced with a test [[goblin|dummy]] to further resolve survival issues and empty ones [[invader|guest]] [[stockpile|accommodations]] in one go .
Finally with said preparations accomplished it would be possible to explore whatever is beyond that great blue/black border above .
However some skeptical dwarven scholars suggest this to be impossible and rather place their bets on the tried and tested dwarven [[bridge|launch system]] , while notable human scholars propose using bigger [[catapult|armaments]] to accomplish the goal .
This is how the great space race between the Elves , Dwarves and Humans began , which would later on lead to massive intergalactic conflicts , space goblin invasions , immortal human emperors , elven space gates , interplanetary clown-storms all under the name of the humble dwarven hammer of war ...}}

{{Getting Started}}
{{Category|Adventurer mode}}
{{Category|Interface}}

DF2014 Talk:Topic

2015-12-18T15:57:05Z

FortressBuilder: /* We aren't even half way there */

==We aren't even half way there==
There are around 130 innovations/topics/technologies listed so far. Toady says there are around 300.

Techniques for researching:

* Turn entire Fortress into scholars
* Monitor what they discuss / ponder every few minutes
* Record the innovation name and description (Press {{k|j}} when highlighting the dwarf in the unit list to see the description)
* Might be best to do this in several worlds generated with longer histories

I also went through Legends mode and sorted through a crap load of books (under artifacts), but this way doesn't always give you the innovation name. And it's a pain.

Any other suggestions? [[User:Brightgalrs|Brightgalrs]] ([[User talk:Brightgalrs|talk]]) 16:18, 4 December 2015 (UTC)

Writing books in adv mode is also a good way to do it.
[[User:Untrustedlife|Untrustedlife]] ([[User talk:Untrustedlife|talk]]) 17:07, 4 December 2015 (UTC)

:Didn't think of that. Very nice.[[User:Brightgalrs|Brightgalrs]] ([[User talk:Brightgalrs|talk]]) 17:21, 4 December 2015 (UTC)

Ah, having not played fortress mode in the new release, I didn't realize that there were official names for the topics. I just thought the name was supposed to briefly describe the topic. I will remove the names from all the topics I have added.
One good thing about using legends mode is that you know for certain which field a topic is a part of, since it says stuff like, "In 88, Sut became a philosopher in Hawktwinkle." "In the early summer of 91, Sut independently discovered discourse on medical ethics." That could have conceivably been a medical science innovation, but obviously since Sut was a philosopher, it is a philosophy inovation. --[[User:Figwat|Figwat]] ([[User talk:Figwat|talk]]) 05:57, 5 December 2015 (UTC)

Lots of knowledge flags have been [https://github.com/DFHack/df-structures/commit/db79fe8058839d1582cc1bfdd73a51ec9bbde20c added to df-structures] recently. I don't know how the names were found or how reliable the information is, but it might be a good starting point for the full list of topics. --[[User:FortressBuilder|FortressBuilder]] ([[User talk:FortressBuilder|talk]]) 15:57, 18 December 2015 (UTC)

== Reminders ==

* Record both the name and description
* The description should be all words after "The topic being discussed concerns..." or whatever it is.
* Try to sort the innovation in the right section of this article
* If it isn't obvious which it fits under (or it seems fits under multiple) just put it in the "unsorted" section
* More research will be done when Dwarf Therapist is updated
** In particular, monitoring dwarf's skill gain to pinpoint the correct branch(s) a topic should be sorted under.
[[User:Brightgalrs|Brightgalrs]] ([[User talk:Brightgalrs|talk]]) 16:27, 4 December 2015 (UTC)

Topic

2015-12-12T16:17:02Z

FortressBuilder: Add more topics

{{Quality|Superior|06:10, 17 May 2015 (UTC)}}
{{av}}

{{new in v0.42}}
{{Expand Topic}}

'''Topics''' (also '''Tech''' or '''Innovations''') are part of [[knowledge]].

There are around 300 innovations that can be discovered. Many of them have requirements, and many do not, so it's kind of a tech forest/grassland rather than a tree. Notably missing are innovations related to practical labors in the game (which will be added later in development).

Several innovations require innovations from other branches, and since all knowledge is individually tracked, that implies some investigators will need to be at least well-read if not skilled in various topics (there aren't currently joint research projects). There are some old and new mechanisms in place to ensure this happens.

There are 9 "branches" of the knowledge system.
==Astronomy==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The theory that the sun moves around the world
|-
|The Astrolabe
|The construction and use of the astrolabe
|-
|Daylight And Seasons
|The variation of daylight with the season
|-
|
|The relationship between the lunar and solar year
|-
|The Sun and Seasons
|The rise of the sun according to the season
|-
|
|The path of the moon
|-
|The Moon and Seasons
|The rise of the moon according to the season
|-
|
|The relationship between the moon and the tides
|-
|
|The creation of star charts
|-
|
|The theory that the world moves around the sun
|-
|
|Methods of empirical observation in astronomy
|-
|
|The phases of the moon
|-
|
|The height of the tides, the moon and the sun
|}

== Chemistry ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The preparation and use of adhesive materials
|-
|
|The classification of ores
|-
|
|The theory and methods involved in evaporation
|-
|
|The classification of materials based on which elemental materials might form them
|-
|
|Methods for performing experiments systematically in the laboratory
|-
|
|The construction and use of the ampoule
|-
|
|The construction and use of the alembic
|-
|
|The mixture of metals to produce alloys
|-
|Liquid Extraction
|The theory and methods involved in the extraction of a constituent liquid from one solution to another
|-
|
|The construction and use of the blast furnace
|-
|
|The construction and use of the retort
|-
|
|The classification of alkali and acids
|-
|
|The construction and use of the beaker
|-
|Oil of Vitriol
|The preparation of oil of vitriol
|-
|
|The construction and use of the crucible
|-
|
|The theory and methods involved in distillation
|-
|
|The construction and use of laboratory ovens
|}
* [[wikipedia:Nitric acid|Spirit of niter]]

== Engineering ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|The Pulley
|The construction and use of the pulley
|-
|The Lever
|The construction and use of the lever<br/>The reasons why the lever is effective
|-
|The Windlass
|The construction and use of the windlass
|-
|The Screw
|The construction and use of the screw
|-
|Models and Templates
|The use of models and templates in engineering
|-
|The Warded Lock
|The construction and use of the warded lock
|-
|The Tumbler Lock
|The construction and use of the tumbler lock
|-
|The Siphon
|The action of the siphon
|-
|Gear Mechanics<br />Gears
|The reasons why gears are effective
|-
|The Crystal Lens
|The construction and use of the crystal lens
|-
|The Funnel
|The construction and use of the funnel
|-
|The Glass Lens
|The construction and use of the glass lens
|-
|The Camera Obscura
|The construction and use of the camera obscura
|-
|
|The construction and use of valves
|-
|
|The construction and use of the bellows
|-
|
|The construction and use of the straight-beam balance
|-
|The Wedge
|The reasons why the wedge is effective
|-
|
|The use of water-based devices to tell time
|-
|
|The use of lamination
|-
|The Wheel-and-axle
|The reasons why the wheel-and-axle construction is effective
|-
|
|The reasons why pulleys are effective
|-
|
|The reasons why screws are effective
|-
|
|The construction and use of the padlock
|-
|
|The reasons why the lever is effective
|-
|
|The construction and use of water-filled sphere as a lens
|-
|Water Clock Reservoirs
|The use of reservoirs in water-based clocks to improve their accuracy
|}

[[wikipedia:Differential (mechanical device)|Differential gears]] are a difficult innovation and a prerequisite for [[wikipedia:South-pointing chariot|pointing chariot]]s and [[wikipedia:Astrarium|astrarium]]s.

== Geography ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The process of surveying land
|-
|
|The forces that govern wind patterns
|-
|
|The process of economic data collection
|-
|
|The placement of economic information on maps
|-
|
|The construction and use of the surveying staff
|-
|
|The origin of rainfall through evaporation and condensation
|-
|
|The process involved in creating maps
|-
|
|The process of the formation of deltas at the mouths of rivers
|-
|
|The placement of geological information on maps
|}
The geography innovations include several related to [[wikipedia:cartography|cartography]].

== History ==
Innovations for historians are, in part, writing forms like [[wikipedia:biography|biography]], and then any historian that reads a biography can start writing them as well. Innovations include comparative biographies describing multiple people, and matters of sourcing, etc.

Historians can start to understand how cultural differences and state bias affects source reliability and think a bit about social forces.

{| class = "wikitable sortable"
! Topic
! Description
|-
|Archaeology
|The method of collecting and evaluating artifacts to learn about history and culture
|-
|Cultural History
|The method of accurately and comprehensively describing cultures and civilizations
|-
|Source Reliability
|The reliability of sources
|-
|Personal Interviews
|Using personal interviews as sources
|-
|Autobiographical Adventures
|The method of writing a biography of oneself, particularly as it concerns a military campaign or adventure
|-
|
|Discourse on the cause of historical events
|-
|
|The method of writing the history of a single individual
|-
|
|The method of comparing and contrasting different cultures
|-
|
|The role of cultural differences in source reliability and interpretation
|-
|Biographical Dictionaries
|The compilation of brief biographies into one large collection
|-
|
|The compilation of family lineages and methods of displaying them artfully
|-
|Comparative Biography
|The method of compiling several biographies to compare and contrast the subjects' character and to gain insight into history
|-
|
|The exploration of how history would be different if some key past events had transpired differently
|-
|
|The notion of historical, governmental and social cycles
|-
|Historical Causation
|The causes of historical events
|-
|
|The method of examining artifacts to determine how techniques have changed over time
|}

== Mathematics ==
* [[wikipedia:Plus and minus signs#Plus sign|Symbol for addition]]

{| class = "wikitable sortable"
! Topic
! Description
|-
|Positional Notation
|Positional notation
|-
|Large Sums
|Simple formulas for certain arbitrarily large sums
|-
|Equations
|The technique of balancing and completion for solving equations
|-
|Very Large Numbers
|Notation for very large numbers
|-
|Negative quantities
|The notation for negative quantities
|-
|Nothingness
|A symbol for nothingness
|-
|
|The method of proof by contradiction
|-
|
|An algorithm for dividing one number into another, possibly yielding a remainder
|-
|
|Geometric objects: points, lines, circles, triangles, and so on
|-
|
|The divergence of the harmonic series
|-
|
|The properties of similar and congruent triangles
|}

== Medical science ==
Medical innovations include dedicated hospitals with specialized wards, staffing, medical labs and treatment for many illnesses.

{| class = "wikitable sortable"
! Topic
! Description
|-
|Diseases
|The diseases of creatures
|-
|Mineral Remedies
|
|-
|Disease Classification
|The classification of disease
|-
|Toxicology
|The classification of toxic substances
|-
|Suturing
|The surgical method of suturing
|-
|Traumatic Injuries
|The treatment of traumatic injuries
|-
|Draining
|The surgical method of draining
|-
|Bandages
|The method of bandaging wounds
|-
|
|The notion of paroxysm
|-
|
|The treatment of fractures
|-
|
|The surgical method of scraping
|-
|
|Anesthesia
|-
|
|The use of practice models in surgery
|-
|
|The use of specialized surgical instruments
|-
|Anatomical Studies
|Anatomical studies for medical edification
|-
|
|The anatomy of the eye
|-
|Disease and Fouled Water
|The connection between disease and fouled water
|-
|Herbal Remedies
|Herbal remedies
|-
|
|The method of physical examination in diagnosing illness
|-
|
|The surgical method of probing
|-
|
|Determining the likely outcome given a patient's current status
|-
|
|The notion of the exacerbation of a patient's condition
|-
|
|Cauterization
|-
|
|Pulmonary medicine
|-
|
|Remedies prepared from animals
|-
|Lithotomy Surgery
|The lithotomy surgery
|}

== Natural science ==
Toady on natural science innovations:
<blockquote>And so on through the other seven branches - there are innovations in naturalist writings, for example, and then they can investigate specific critters with those in mind when they get down to work observing foraging behavior or performing dissections.</blockquote>

Naturalists can build a theory of [[wikipedia:rainbow|rainbow]]s using water-filled spheres and a [[wikipedia:camera obscura|camera obscura]], and they can calculate the height of the atmosphere based on [[wikipedia:atmospheric refraction|atmospheric refraction]] using the [[wikipedia:law of refraction|law of refraction]] (though it tries not to get into the actual shape of the world, since that might vary).

{| class = "wikitable sortable"
! Topic
! Description
|-
|Physical Features
|The classification of creatures by their physical features
|-
|Climactic Adaptation
|The way that creatures are suited to the climates in which they live
|-
|Migratory Patterns
|The migratory patterns of creatures
|-
|
|A world-wide cycle involving precipitation, oceans, rivers and other forms of water
|-
|Foraging Behavior
|The foraging behavior and diet of creatures
|-
|Reproductive Behavior
|The reproductive behavior of creatures
|-
|Social Behavior
|The social behavior of creatures
|-
|Dissection
|The dissection of creatures
|}

== Philosophy ==
The specific view that a philosopher takes on, say, the nature of beauty or methods of education will depend on their individual/cultural values, where they apply, and a philosopher that encounters a philosophy book on beauty can then provide their own take (having acquired the innovation).

Toady on philosophy innovations:
<blockquote>For fields like philosophy, I've tried not to make judgments about which ideas are "right" or anything like that, but rather which subjects can be thought about at all.</blockquote>

{| class = "wikitable sortable"
! Topic
! Description
|-
|Value Agendas
|Writers can push value "agendas" if they are skilled enough.

Description format: The [worthlessness | value | nature] of [[[belief]]]

Examples:
* The nature of truth - probably related to TRUTH
* The value of art - probably related to ARTWORK
|-
|Interpersonal Ethics
|Discourse on ethics as applied to interpersonal conduct
|-
|Causation
|The nature of causation
|-
|
|Discourse on diplomacy
|-
|
|Discourse on the meaning of individual happiness
|-
|
|Discourse on economic policy
|-
|
|Discourse on ethics as it regards the benefit of the state
|-
|
|Discourse on the nature of perception
|-
|
|Discourse on the nature of justification
|-
|
|The relationship between objects and their properties
|-
|
|Discourse on the nature of time
|-
|
|Discourse on the nature of mind and body
|-
|
|Discourse on ethics as applied to war
|-
|
|Discourse on the nature of beauty
|-
|
|Discourse on law
|-
|Grammar
|Grammar
|-
|
|Discourse on government
|-
|
|Dictionaries
|-
|
|Formal reasoning
|-
|
|Discourse on social welfare
|-
|
|Discourse on the nature of events
|-
|Education
|Education, its forms and recommendations
|-
|
|Discourse on the nature of belief
|-
|
|Discourse on medical ethics
|-
|Whole and Parts
|The relationship between wholes and parts
|-
|
|The notion of etymology
|}

==Unknown/unsorted==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|Economic policy, its forms and recommendations
|-
|Dictionaries
|
|-
|Shadow Clocks
|The use of shadows to tell direction and time
|-
|Social Welfare
|Social welfare, its forms and recommendations
|-
|Formal Reasoning
|Formal reasoning
|-
|Water Displacement
|A precise description of buoyancy and water displacement
|}

Topic

2015-12-08T13:25:35Z

FortressBuilder:

{{Quality|Superior|06:10, 17 May 2015 (UTC)}}
{{av}}

{{new in v0.42}}
{{Expand Topic}}

'''Topics''' (also '''Tech''' or '''Innovations''') are part of [[knowledge]].

There are around 300 innovations that can be discovered. Many of them have requirements, and many do not, so it's kind of a tech forest/grassland rather than a tree. Notably missing are innovations related to practical labors in the game (which will be added later in development).

Several innovations require innovations from other branches, and since all knowledge is individually tracked, that implies some investigators will need to be at least well-read if not skilled in various topics (there aren't currently joint research projects). There are some old and new mechanisms in place to ensure this happens.

There are 9 "branches" of the knowledge system.
==Astronomy==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The theory that the sun moves around the world
|-
|The Astrolabe
|The construction and use of the astrolabe
|-
|Daylight And Seasons
|The variation of daylight with the season
|-
|
|The relationship between the lunar and solar year
|-
|The Sun and Seasons
|The rise of the sun according to the season
|-
|
|The path of the moon
|-
|The Moon and Seasons
|The rise of the moon according to the season
|-
|
|The relationship between the moon and the tides
|-
|
|The creation of star charts
|-
|
|The theory that the world moves around the sun
|-
|
|Methods of empirical observation in astronomy
|-
|
|The phases of the moon
|}

== Chemistry ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The preparation and use of adhesive materials
|-
|
|The classification of ores
|-
|
|The theory and method of evaporation
|-
|
|The classification of materials based on which elemental materials might form them
|-
|
|Methods for performing experiments systematically in the laboratory
|-
|
|The construction and use of the ampoule
|-
|
|The construction and use of the alembic
|-
|
|The mixture of metals to produce alloys
|-
|Liquid Extraction
|The theory and methods involved in the extraction of a constituent liquid from one solution to another
|-
|
|The construction and use of the blast furnace
|-
|
|The construction and use of the retort
|-
|
|The classification of alkali and acids
|-
|
|The construction and use of the beaker
|-
|Oil of Vitriol
|The preparation of oil of vitriol
|}
* [[wikipedia:Sulfuric acid|Oil of vitriol]]
* [[wikipedia:Nitric acid|Spirit of niter]]

== Engineering ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|The Pulley
|The construction and use of the pulley
|-
|The Lever
|The construction and use of the lever<br/>The reasons why the lever is effective
|-
|The Windlass
|The construction and use of the windlass
|-
|The Screw
|The construction and use of the screw
|-
|Models and Templates
|The use of models and templates in engineering
|-
|The Warded Lock
|The construction and use of the warded lock
|-
|The Tumbler Lock
|The construction and use of the tumbler lock
|-
|The Siphon
|The action of the siphon
|-
|Gear Mechanics
|The reasons why gears are effective
|-
|The Crystal Lens
|The construction and use of the crystal lens
|-
|The Funnel
|The construction and use of the funnel
|-
|The Glass Lens
|The construction and use of the glass lens
|-
|The Camera Obscura
|The construction and use of the camera obscura
|-
|
|The construction and use of valves
|-
|
|The construction and use of the bellows
|-
|
|The construction and use of the straight-beam balance
|-
|The Wedge
|The reasons why the wedge is effective
|-
|
|The use of water-based devices to tell time
|-
|
|The use of lamination
|-
|The Wheel-and-axle
|The reasons why the wheel-and-axle construction is effective
|-
|
|The reasons why pulleys are effective
|-
|
|The reasons why screws are effective
|}

[[wikipedia:Differential (mechanical device)|Differential gears]] are a difficult innovation and a prerequisite for [[wikipedia:South-pointing chariot|pointing chariot]]s and [[wikipedia:Astrarium|astrarium]]s.

== Geography ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The process of surveying land
|-
|
|The forces that govern wind patterns
|-
|
|The process of economic data collection
|-
|
|The placement of economic information on maps
|-
|
|The construction and use of the surveying staff
|}
The geography innovations include several related to [[wikipedia:cartography|cartography]].

== History ==
Innovations for historians are, in part, writing forms like [[wikipedia:biography|biography]], and then any historian that reads a biography can start writing them as well. Innovations include comparative biographies describing multiple people, and matters of sourcing, etc.

Historians can start to understand how cultural differences and state bias affects source reliability and think a bit about social forces.

{| class = "wikitable sortable"
! Topic
! Description
|-
|Archaeology
|The method of collecting and evaluating artifacts to learn about history and culture
|-
|Cultural History
|The method of accurately and comprehensively describing cultures and civilizations
|-
|Source Reliability
|The reliability of sources
|-
|Personal Interviews
|Using personal interviews as sources
|-
|Autobiographical Adventures
|The method of writing a biography of oneself, particularly as it concerns a military campaign or adventure
|-
|
|Discourse on the cause of historical events
|-
|
|The method of writing the history of a single individual
|-
|
|The method of comparing and contrasting different cultures
|-
|
|The role of cultural differences in source reliability and interpretation
|-
|Biographical Dictionaries
|The compilation of brief biographies into one large collection
|-
|
|The compilation of family lineages and methods of displaying them artfully
|-
|Comparative Biography
|The method of compiling several biographies to compare and contrast the subjects' character and to gain insight into history
|-
|
|The exploration of how history would be different if some key past events had transpired differently the notion of historical, governmental and social cycles
|-
|
|The notion of historical, governmental and social cycles
|-
|Historical Causation
|The causes of historical events
|}

== Mathematics ==
* [[wikipedia:Harmonic series (mathematics)#Divergence|Divergence of harmonic series]]
* [[wikipedia:Plus and minus signs#Plus sign|Symbol for addition]]
* [[wikipedia:Proof by contradiction|Proof by contradiction]]

{| class = "wikitable sortable"
! Topic
! Description
|-
|Positional Notation
|
|-
|Large Sums
|Simple formulas for certain arbitrarily large sums
|-
|Equations
|The technique of balancing and completion for solving equations
|-
|Very Large Numbers
|Notation for very large numbers
|-
|Negative quantities
|The notation for negative quantities
|-
|Nothingness
|A symbol for nothingness
|}

== Medical science ==
Medical innovations include dedicated hospitals with specialized wards, staffing, medical labs and treatment for many illnesses.

{| class = "wikitable sortable"
! Topic
! Description
|-
|Diseases
|The diseases of creatures
|-
|Mineral Remedies
|
|-
|Disease Classification
|The classification of disease
|-
|Toxicology
|The classification of toxic substances
|-
|Suturing
|The surgical method of suturing
|-
|Traumatic Injuries
|The treatment of traumatic injuries
|-
|Draining
|The surgical method of draining
|-
|Bandages
|The method of bandaging wounds
|-
|
|The notion of paroxysm
|-
|
|The treatment of fractures
|-
|
|The surgical method of scraping
|-
|
|Anesthesia
|-
|
|The use of practice models in surgery
|-
|
|The use of specialized surgical instruments
|-
|Anatomical Studies
|Anatomical studies for medical edification
|-
|
|The anatomy of the eye
|-
|Disease and Fouled Water
|The connection between disease and fouled water
|-
|Herbal Remedies
|Herbal remedies
|-
|
|The method of physical examination in diagnosing illness
|-
|
|The surgical method of probing
|-
|
|Determining the likely outcome given a patient's current status
|-
|
|The notion of the exacerbation of a patient's condition
|-
|
|Cauterization
|}

== Natural science ==
Toady on natural science innovations:
<blockquote>And so on through the other seven branches - there are innovations in naturalist writings, for example, and then they can investigate specific critters with those in mind when they get down to work observing foraging behavior or performing dissections.</blockquote>

Naturalists can build a theory of [[wikipedia:rainbow|rainbow]]s using water-filled spheres and a [[wikipedia:camera obscura|camera obscura]], and they can calculate the height of the atmosphere based on [[wikipedia:atmospheric refraction|atmospheric refraction]] using the [[wikipedia:law of refraction|law of refraction]] (though it tries not to get into the actual shape of the world, since that might vary).

{| class = "wikitable sortable"
! Topic
! Description
|-
|Physical Features
|The classification of creatures by their physical features
|-
|Climactic Adaptation
|The way that creatures are suited to the climates in which they live
|-
|Migratory Patterns
|The migratory patterns of creatures
|-
|
|The origin of rainfall through evaporation and condensation
|-
|
|A world-wide cycle involving precipitation, oceans, rivers and other forms of water
|-
|Foraging Behavior
|The foraging behavior and diet of creatures
|-
|Reproductive Behavior
|The reproductive behavior of creatures
|-
|Social Behavior
|The social behavior of creatures
|-
|Dissection
|The dissection of creatures
|}

== Philosophy ==
The specific view that a philosopher takes on, say, the nature of beauty or methods of education will depend on their individual/cultural values, where they apply, and a philosopher that encounters a philosophy book on beauty can then provide their own take (having acquired the innovation).

Toady on philosophy innovations:
<blockquote>For fields like philosophy, I've tried not to make judgments about which ideas are "right" or anything like that, but rather which subjects can be thought about at all.</blockquote>

{| class = "wikitable sortable"
! Topic
! Description
|-
|Value Agendas
|Writers can push value "agendas" if they are skilled enough.

Description format: The [worthlessness | value | nature] of [[[belief]]]

Examples:
* The nature of truth - probably related to TRUTH
* The value of art - probably related to ARTWORK
|-
|Interpersonal Ethics
|Discourse on ethics as applied to interpersonal conduct
|-
|Causation
|The nature of causation
|-
|
|Discourse on diplomacy
|-
|
|Discourse on the meaning of individual happiness
|-
|
|Discourse on economic policy
|-
|
|Discourse on ethics as it regards the benefit of the state
|-
|
|Discourse on the nature of perception
|-
|
|Discourse on the nature of justification
|-
|
|The relationship between objects and their properties
|-
|
|Discourse on the nature of time
|-
|
|Discourse on the nature of mind and body
|-
|
|Discourse on ethics as applied to war
|-
|
|Discourse on the nature of beauty
|-
|
|Discourse on law
|-
|
|Discourse on grammar
|-
|
|Discourse on government
|-
|
|Dictionaries
|-
|
|Formal reasoning
|-
|
|Discourse on social welfare
|-
|
|Discourse on the nature of events
|-
|
|Discourse on education
|-
|
|Discourse on the nature of belief
|-
|
|Discourse on medical ethics
|}

==Unknown/unsorted==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|Economic policy, its forms and recommendations
|-
|Dictionaries
|
|-
|Shadow Clocks
|The use of shadows to tell direction and time
|-
|Social Welfare
|Social welfare, its forms and recommendations
|-
|Formal Reasoning
|Formal reasoning
|-
|Water Displacement
|A precise description of buoyancy and water displacement
|}

Topic

2015-12-07T09:21:27Z

FortressBuilder: Add more topics from Fortress Mode scholars

{{Quality|Superior|06:10, 17 May 2015 (UTC)}}
{{av}}

{{new in v0.42}}
{{Expand Topic}}

'''Topics''' (also '''Tech''' or '''Innovations''') are part of [[knowledge]].

There are around 300 innovations that can be discovered. Many of them have requirements, and many do not, so it's kind of a tech forest/grassland rather than a tree. Notably missing are innovations related to practical labors in the game (which will be added later in development).

Several innovations require innovations from other branches, and since all knowledge is individually tracked, that implies some investigators will need to be at least well-read if not skilled in various topics (there aren't currently joint research projects). There are some old and new mechanisms in place to ensure this happens.

There are 9 "branches" of the knowledge system.
==Astronomy==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The theory that the sun moves around the world
|-
|Daylight And Seasons
|The variation of daylight with the season
|-
|
|The relationship between the lunar and solar year
|-
|The Sun and Seasons
|The rise of the sun according to the season
|-
|
|The path of the moon
|-
|The Moon and Seasons
|The rise of the moon according to the season
|-
|
|The relationship between the moon and the tides
|-
|
|The creation of star charts
|-
|
|The theory that the world moves around the sun
|-
|
|Methods of empirical observation in astronomy
|-
|
|The phases of the moon
|}

== Chemistry ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The preparation and use of adhesive materials
|-
|
|The classification of ores
|-
|
|The theory and method of evaporation
|-
|
|The classification of materials based on which elemental materials might form them
|-
|
|Methods for performing experiments systematically in the laboratory
|-
|
|The construction and use of the ampoule
|-
|
|The construction and use of the alembic
|-
|
|The mixture of metals to produce alloys
|-
|
|The theory and methods involved in the extraction of a constituent liquid from one solution to another
|-
|
|The construction and use of the blast furnace
|-
|
|The construction and use of the retort
|-
|
|The classification of alkali and acids
|-
|
|The construction and use of the beaker
|}
* [[wikipedia:Sulfuric acid|Oil of vitriol]]
* [[wikipedia:Nitric acid|Spirit of niter]]

== Engineering ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|The Pulley
|The construction and use of the pulley
|-
|The Lever
|The construction and use of the lever<br/>The reasons why the lever is effective
|-
|The Windlass
|The construction and use of the windlass
|-
|The Screw
|The construction and use of the screw
|-
|Models and Templates
|The use of models and templates in engineering
|-
|The Warded Lock
|The construction and use of the warded lock
|-
|The Tumbler Lock
|The construction and use of the tumbler lock
|-
|The Siphon
|The action of the siphon
|-
|Gear Mechanics
|The reasons why gears are effective
|-
|The Crystal Lens
|The construction and use of the crystal lens
|-
|The Funnel
|The construction and use of the funnel
|-
|The Glass Lens
|The construction and use of the glass lens
|-
|The Camera Obscura
|The construction and use of the camera obscura
|-
|
|A precise description of buoyancy and water displacement
|-
|
|The construction and use of valves
|-
|
|The construction and use of the bellows
|-
|
|The construction and use of the straight-beam balance
|-
|The Wedge
|The reasons why the wedge is effective
|-
|
|The use of water-based devices to tell time
|-
|
|The use of lamination
|-
|
|The reasons why the wheel-and-axle construction is effective
|-
|
|The reasons why pulleys are effective
|-
|
|The reasons why screws are effective
|}

[[wikipedia:Differential (mechanical device)|Differential gears]] are a difficult innovation and a prerequisite for [[wikipedia:South-pointing chariot|pointing chariot]]s and [[wikipedia:Astrarium|astrarium]]s.

== Geography ==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|The process of surveying land
|-
|
|The forces that govern wind patterns
|-
|
|The process of economic data collection
|-
|
|The placement of economic information on maps
|-
|
|The construction and use of the surveying staff
|}
The geography innovations include several related to [[wikipedia:cartography|cartography]].

== History ==
Innovations for historians are, in part, writing forms like [[wikipedia:biography|biography]], and then any historian that reads a biography can start writing them as well. Innovations include comparative biographies describing multiple people, and matters of sourcing, etc.

Historians can start to understand how cultural differences and state bias affects source reliability and think a bit about social forces.

{| class = "wikitable sortable"
! Topic
! Description
|-
|Archaeology
|The method of collecting and evaluating artifacts to learn about history and culture
|-
|Cultural History
|The method of accurately and comprehensively describing cultures and civilizations
|-
|Source Reliability
|The reliability of sources
|-
|Personal Interviews
|Using personal interviews as sources
|-
|Autobiographical Adventures
|The method of writing a biography of oneself, particularly as it concerns a military campaign or adventure
|-
|
|Discourse on the cause of historical events
|-
|
|The method of writing the history of a single individual
|-
|
|The method of comparing and contrasting different cultures
|-
|
|The role of cultural differences in source reliability and interpretation
|-
|
|The compilation of brief biographies into one large collection
|-
|
|The compilation of family lineages and methods of displaying them artfully
|-
|Comparative Biography
|The method of compiling several biographies to compare and contrast the subjects' character and to gain insight into history
|-
|
|The exploration of how history would be different if some key past events had transpired differently the notion of historical, governmental and social cycles
|-
|
|The notion of historical, governmental and social cycles
|-
|Historical Causation
|The causes of historical events
|}

== Mathematics ==
* [[wikipedia:Harmonic series (mathematics)#Divergence|Divergence of harmonic series]]
* [[wikipedia:Plus and minus signs#Plus sign|Symbol for addition]]
* [[wikipedia:Proof by contradiction|Proof by contradiction]]

{| class = "wikitable sortable"
! Topic
! Description
|-
|Positional Notation
|
|-
|Large Sums
|Simple formulas for certain arbitrarily large sums
|-
|Equations
|The technique of balancing and completion for solving equations
|-
|Very Large Numbers
|Notation for very large numbers
|-
|Negative quantities
|The notation for negative quantities
|-
|Nothingness
|A symbol for nothingness
|}

== Medical science ==
Medical innovations include dedicated hospitals with specialized wards, staffing, medical labs and treatment for many illnesses.

{| class = "wikitable sortable"
! Topic
! Description
|-
|Diseases
|The diseases of creatures
|-
|Mineral Remedies
|
|-
|Disease Classification
|The classification of disease
|-
|Toxicology
|The classification of toxic substances
|-
|Suturing
|The surgical method of suturing
|-
|Traumatic Injuries
|The treatment of traumatic injuries
|-
|Draining
|The surgical method of draining
|-
|Bandages
|The method of bandaging wounds
|-
|
|The notion of paroxysm
|-
|
|The treatment of fractures
|-
|
|The surgical method of scraping
|-
|
|Anesthesia
|-
|
|The use of practice models in surgery
|-
|
|The use of specialized surgical instruments
|-
|Anatomical Studies
|Anatomical studies for medical edification
|-
|
|The anatomy of the eye
|-
|Disease and Fouled Water
|The connection between disease and fouled water
|-
|Herbal Remedies
|Herbal remedies
|-
|
|The method of physical examination in diagnosing illness
|-
|
|The surgical method of probing
|-
|
|Determining the likely outcome given a patient's current status
|-
|
|The notion of the exacerbation of a patient's condition
|-
|
|Cauterization
|}

== Natural science ==
Toady on natural science innovations:
<blockquote>And so on through the other seven branches - there are innovations in naturalist writings, for example, and then they can investigate specific critters with those in mind when they get down to work observing foraging behavior or performing dissections.</blockquote>

Naturalists can build a theory of [[wikipedia:rainbow|rainbow]]s using water-filled spheres and a [[wikipedia:camera obscura|camera obscura]], and they can calculate the height of the atmosphere based on [[wikipedia:atmospheric refraction|atmospheric refraction]] using the [[wikipedia:law of refraction|law of refraction]] (though it tries not to get into the actual shape of the world, since that might vary).

{| class = "wikitable sortable"
! Topic
! Description
|-
|Physical Features
|The classification of creatures by their physical features
|-
|Climactic Adaptation
|The way that creatures are suited to the climates in which they live
|-
|Migratory Patterns
|The migratory patterns of creatures
|-
|
|The origin of rainfall through evaporation and condensation
|-
|
|A world-wide cycle involving precipitation, oceans, rivers and other forms of water
|-
|Water Displacement
|A precise description of buoyancy and water displacement
|-
|Foraging Behavior
|The foraging behavior and diet of creatures
|-
|Reproductive Behavior
|The reproductive behavior of creatures
|-
|Social Behavior
|The social behavior of creatures
|-
|Dissection
|The dissection of creatures
|}

== Philosophy ==
The specific view that a philosopher takes on, say, the nature of beauty or methods of education will depend on their individual/cultural values, where they apply, and a philosopher that encounters a philosophy book on beauty can then provide their own take (having acquired the innovation).

Toady on philosophy innovations:
<blockquote>For fields like philosophy, I've tried not to make judgments about which ideas are "right" or anything like that, but rather which subjects can be thought about at all.</blockquote>

{| class = "wikitable sortable"
! Topic
! Description
|-
|Value Agendas
|Writers can push value "agendas" if they are skilled enough.

Description format: The [worthlessness | value | nature] of [[[belief]]]

Examples:
* The nature of truth - probably related to TRUTH
* The value of art - probably related to ARTWORK
|-
|Interpersonal Ethics
|Discourse on ethics as applied to interpersonal conduct
|-
|Causation
|The nature of causation
|-
|
|Discourse on diplomacy
|-
|
|Discourse on the meaning of individual happiness
|-
|
|Discourse on economic policy
|-
|
|Discourse on ethics as it regards the benefit of the state
|-
|
|Discourse on the nature of perception
|-
|
|Discourse on the nature of justification
|-
|
|The relationship between objects and their properties
|-
|
|Discourse on the nature of time
|-
|
|Discourse on the nature of mind and body
|-
|
|Discourse on ethics as applied to war
|-
|
|Discourse on the nature of beauty
|-
|
|Discourse on law
|-
|
|Discourse on grammar
|-
|
|Discourse on government
|-
|
|Dictionaries
|-
|
|Formal reasoning
|-
|
|Discourse on social welfare
|-
|
|Discourse on the nature of events
|-
|
|Discourse on education
|-
|
|Discourse on the nature of belief
|-
|
|Discourse on medical ethics
|}

==Unknown/unsorted==
{| class = "wikitable sortable"
! Topic
! Description
|-
|
|Economic policy, its forms and recommendations
|-
|Dictionaries
|
|-
|Shadow Clocks
|The use of shadows to tell direction and time
|-
|Social Welfare
|Social welfare, its forms and recommendations
|-
|Formal Reasoning
|Formal reasoning
|}

Skill token

2015-12-06T16:54:04Z

FortressBuilder: Add new tokens

{{Quality|Exceptional|12:05, 18 May 2015 (UTC)}}
{{av}}
{{old}}

==Complete List==
A list of all skill tokens, generally used in [[reaction]]s.

{| {{prettytable}} class="sortable"
|- style='background-color:#ddd'
! #
! Token
! Skill
! Description
|-
|0||MINING||[[Miner]]||Mining
|-
|1||WOODCUTTING||[[Wood cutter]]||Wood Cutting
|-
|2||CARPENTRY||[[Carpenter]]||Carpentry
|-
|3||DETAILSTONE||[[Engraver]]||Engraving
|-
|4||MASONRY||[[Mason]]||Masonry
|-
|5||ANIMALTRAIN||[[Animal trainer]]||Animal Training
|-
|6||ANIMALCARE||[[Animal caretaker]]||Animal Caretaking
|-
|7||DISSECT_FISH||[[Fish dissector]]||Fish Dissection
|-
|8||DISSECT_VERMIN||[[Animal dissector]]||Animal Dissection
|-
|9||PROCESSFISH||[[Fish cleaner]]||Fish Cleaning
|-
|10||BUTCHER||[[Butcher]]||Butchery
|-
|11||TRAPPING||[[Trapper]]||Trapping
|-
|12||TANNER||[[Tanner]]||Tanning
|-
|13||WEAVING||[[Weaver]]||Weaving
|-
|14||BREWING||[[Brewer]]||Brewing
|-
|15||ALCHEMY||[[Alchemist]]||Alchemy
|-
|16||CLOTHESMAKING||[[Clothier]]||Clothes Making
|-
|17||MILLING||[[Miller]]||Milling
|-
|18||PROCESSPLANTS||[[Thresher]]||Threshing
|-
|19||CHEESEMAKING||[[Cheese maker]]||Cheese Making
|-
|20||MILK||[[Milker]]||Milking
|-
|21||COOK||[[Cook]]||Cooking
|-
|22||PLANT||[[Grower]]||Growing
|-
|23||HERBALISM||[[Herbalist]]||Herbalism
|-
|24||FISH||[[Fisherdwarf|Fisherman]]||Fishing
|-
|25||SMELT||[[Furnace operator]]||Furnace Operation
|-
|26||EXTRACT_STRAND||[[Strand extractor]]||Strand Extraction
|-
|27||FORGE_WEAPON||[[Weaponsmith]]||Weaponsmithing
|-
|28||FORGE_ARMOR||[[Armorsmith]]||Armorsmithing
|-
|29||FORGE_FURNITURE||[[Metalsmith]]||Metalsmithing
|-
|30||CUTGEM||[[Gem cutter]]||Gem Cutting
|-
|31||ENCRUSTGEM||[[Gem setter]]||Gem Setting
|-
|32||WOODCRAFT||[[Wood crafter]]||Wood Crafting
|-
|33||STONECRAFT||[[Stone crafter]]||Stone Crafting
|-
|34||METALCRAFT||[[Metal crafter]]||Metal Crafting
|-
|35||GLASSMAKER||[[Glassmaker]]||Glassmaking
|-
|36||LEATHERWORK||[[Leatherworker]]||Leatherworkering[sic]
|-
|37||BONECARVE||[[Bone carver]]||Bone Carving
|-
|38||AXE||[[Axeman]]||Axe
|-
|39||SWORD||[[Swordsman]]||Sword
|-
|40||DAGGER||[[Knife user]]||Knife
|-
|41||MACE||[[Maceman]]||Mace
|-
|42||HAMMER||[[Hammerman]]||Hammer
|-
|43||SPEAR||[[Spearman]]||Spear
|-
|44||CROSSBOW||[[Crossbowman]]||Crossbow
|-
|45||SHIELD||[[Shield user]]||Shield
|-
|46||ARMOR||[[Armor user]]||Armor
|-
|47||SIEGECRAFT||[[Siege engineer]]||Siege Engineering
|-
|48||SIEGEOPERATE||[[Siege operator]]||Siege Operation
|-
|49||BOWYER||[[Bowyer]]||Bowmaking
|-
|50||PIKE||[[Pikeman]]||Pike
|-
|51||WHIP||[[Lasher]]||Lash
|-
|52||BOW||[[Bowman]]||Bow
|-
|53||BLOWGUN||[[Blowgunner]]||Blowgun
|-
|54||THROW||[[Thrower]]||Throwing
|-
|55||MECHANICS||[[Mechanic]]||Machinery
|-
|56||MAGIC_NATURE||[[Druid]]||Nature
|-
|57||SNEAK||[[Ambusher]]||Ambush
|-
|58||DESIGNBUILDING||[[Building designer]]||Building Design
|-
|59||DRESS_WOUNDS||[[Wound dresser]]||Wound Dressing
|-
|60||DIAGNOSE||[[Diagnostician]]||Diagnostics
|-
|61||SURGERY||[[Surgeon]]||Surgery
|-
|62||SET_BONE||[[Bone doctor]]||Bone Setting
|-
|63||SUTURE||[[Suturer]]||Suturing
|-
|64||CRUTCH_WALK||[[Crutch-walker]]||Crutch-walking
|-
|65||WOOD_BURNING||[[Wood burner]]||Wood Burning
|-
|66||LYE_MAKING||[[Lye maker]]||Lye Making
|-
|67||SOAP_MAKING||[[Soaper]]||Soap Making
|-
|68||POTASH_MAKING||[[Potash maker]]||Potash Making
|-
|69||DYER||[[Dyer]]||Dyeing
|-
|70||OPERATE_PUMP||[[Pump operator]]||Pump Operation
|-
|71||SWIMMING||[[Swimmer]]||Swimming
|-
|72||PERSUASION||[[Persuader]]||Persuasion
|-
|73||NEGOTIATION||[[Negotiator]]||Negotiation
|-
|74||JUDGING_INTENT||[[Judge of intent]]||Judging Intent
|-
|75||APPRAISAL||[[Appraiser]]||Appraisal
|-
|76||ORGANIZATION||[[Organizer]]||Organization
|-
|77||RECORD_KEEPING||[[Record keeper]]||Record Keeping
|-
|78||LYING||[[Liar]]||Lying
|-
|79||INTIMIDATION||[[Intimidator]]||Intimidation
|-
|80||CONVERSATION||[[Conversationalist]]||Conversation
|-
|81||COMEDY||[[Comedian]]||Comedy
|-
|82||FLATTERY||[[Flatterer]]||Flattery
|-
|83||CONSOLE||[[Consoler]]||Consoling
|-
|84||PACIFY||[[Pacifier]]||Pacification
|-
|85||TRACKING||[[Tracker]]||Tracking
|-
|86||KNOWLEDGE_ACQUISITION||[[Student]]||Studying
|-
|87||CONCENTRATION||[[Concentration]]||Concentration
|-
|88||DISCIPLINE||[[Discipline]]||Discipline
|-
|89||SITUATIONAL_AWARENESS||[[Observer]]||Observation
|-
|90||WRITING||[[Wordsmith]]||Writing
|-
|91||PROSE||[[Writer]]||Prose
|-
|92||POETRY||[[Poet]]||Poetry
|-
|93||READING||[[Reader]]||Reading
|-
|94||SPEAKING||[[Speaker]]||Speaking
|-
|95||COORDINATION||[[Coordination]]||Coordination
|-
|96||BALANCE||[[Balance]]||Balance
|-
|97||LEADERSHIP||[[Leader]]||Leadership
|-
|98||TEACHING||[[Teacher]]||Teaching
|-
|99||MELEE_COMBAT||[[Fighter]]||Fighting
|-
|100||RANGED_COMBAT||[[Archer]]||Archery
|-
|101||WRESTLING||[[Wrestler]]||Wrestling
|-
|102||BITE||[[Biter]]||Biting
|-
|103||GRASP_STRIKE||[[Striker]]||Striking
|-
|104||STANCE_STRIKE||[[Kicker]]||Kicking
|-
|105||DODGING||[[Dodger]]||Dodging
|-
|106||MISC_WEAPON||[[Misc. object user]]||Misc. Object
|-
|107||KNAPPING||[[Knapper]]||Knapping
|-
|108||MILITARY_TACTICS||[[Military tactics]]||Military Tactics
|-
|109||SHEARING||[[Shearer]]||Shearing
|-
|110||SPINNING||[[Spinner]]||Spinning
|-
|111||POTTERY||[[Potter]]||Pottery
|-
|112||GLAZING||[[Glazer]]||Glazing
|-
|113||PRESSING||[[Presser]]||Pressing
|-
|114||BEEKEEPING||[[Beekeeper]]||Beekeeping
|-
|115||WAX_WORKING||[[Wax worker]]||Wax Working
|-
|116||CLIMBING||[[Climber]]||Climbing
|-
|117||GELD||[[Gelder]]||Gelding
|-
|???||DANCE{{version|0.42.01}}|| ||
|-
|???||MAKE_MUSIC{{version|0.42.01}}|| ||
|-
|???||SING{{version|0.42.01}}|| ||
|-
|???||PLAY_KEYBOARD_INSTRUMENT{{version|0.42.01}}|| ||
|-
|???||PLAY_STRINGED_INSTRUMENT{{version|0.42.01}}|| ||
|-
|???||PLAY_WIND_INSTRUMENT{{version|0.42.01}}|| ||
|-
|???||PLAY_PERCUSSION_INSTRUMENT{{version|0.42.01}}|| ||
|-
|???||CRITICAL_THINKING{{version|0.42.01}}|| ||
|-
|???||LOGIC{{version|0.42.01}}|| ||
|-
|???||MATHEMATICS{{version|0.42.01}}|| ||
|-
|???||ASTRONOMY{{version|0.42.01}}|| ||
|-
|???||CHEMISTRY{{version|0.42.01}}|| ||
|-
|???||GEOGRAPHY{{version|0.42.01}}|| ||
|-
|???||OPTICS_ENGINEER{{version|0.42.01}}|| ||
|-
|???||FLUID_ENGINEER{{version|0.42.01}}|| ||
|-
|???||PAPERMAKING{{version|0.42.01}}|| ||
|-
|???||BOOKBINDING{{version|0.42.01}}|| ||
|}

==Skills By Type==

===General Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| ANIMALCARE
| Animal Caretaker

|-
| ANIMALTRAIN
| Animal Trainer

|-
| BEEKEEPING
| Beekeper

|-
| BONECARVE
| Bonecarver

|-
| BOOKBINDING{{version|0.42.01}}
|

|-
| BOWYER
| Bowyer

|-
| BREWING
| Brewer

|-
| BUTCHER
| Butcher

|-
| CARPENTRY
| Carpenter

|-
| CHEESEMAKING
| Cheese Maker

|-
| CLOTHESMAKING
| Clothier

|-
| COOK
| Cook

|-
| CUTGEM
| Gem Cutter

|-
| DETAILSTONE
| Engraver

|-
| DISSECT_FISH
| Fish Dissector

|-
| DISSECT_VERMIN
| Animal Dissector

|-
| DYER
| Dyer

|-
| ENCRUSTGEM
| Gem Setter

|-
| EXTRACT_STRAND
| Strand Extractor

|-
| FISH
| Fisherman (Fisherdwarf)

|-
| FORGE_ARMOR
| Armorsmith

|-
| FORGE_FURNITURE
| Metalsmith

|-
| FORGE_WEAPON
| Weaponsmith

|-
| GELD
| Gelder

|-
| GLASSMAKER
| Glassmaker

|-
| GLAZING
| Glazer

|-
| HERBALISM
| Herbalist

|-
| LEATHERWORK
| Leatherworker

|-
| LYE_MAKING
| Lye Maker

|-
| MASONRY
| Mason

|-
| MECHANICS
| Mechanic

|-
| METALCRAFT
| Metal Crafter

|-
| MILLING
| Miller

|-
| MILK
| Milker

|-
| MINING
| Miner

|-
| OPERATE_PUMP
| Pump Operator

|-
| PAPERMAKING{{version|0.42.01}}
|

|-
| PLANT
| Grower

|-
| POTASH_MAKING
| Potash Maker

|-
| POTTERY
| Potter

|-
| PRESSING
| Presser

|-
| PROCESSFISH
| Fish Cleaner

|-
| PROCESSPLANTS
| Thresher

|-
| SHEARING
| Shearer

|-
| SIEGECRAFT
| Siege Engineer

|-
| SMELT
| Furnace Operator

|-
| SPINNING
| Spinner

|-
| STONECRAFT
| Stone Crafter

|-
| TANNER
| Tanner

|-
| TRAPPING
| Trapper

|-
| WAX_WORKING
| Wax Worker

|-
| WEAVING
| Weaver

|-
| WOOD_BURNING
| Wood Burner

|-
| WOODCRAFT
| Wood Crafter

|-
| WOODCUTTING
| Wood Cutter

|}

===Medical Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| CRUTCH_WALK
| Crutch-Walker

|-
| DIAGNOSE
| Diagnostician

|-
| DRESS_WOUNDS
| Wound Dresser

|-
| SET_BONE
| Bone Doctor

|-
| SURGERY
| Surgeon

|-
| SUTURE
| Suturer

|}

===Social Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| APPRAISAL
| Appraiser

|-
| COMEDY
| Comedian

|-
| CONSOLE
| Consoler

|-
| FLATTERY
| Flatterer

|-
| INTIMIDATION
| Intimidator

|-
| JUDGING_INTENT
| Judge of Intent

|-
| KNOWLEDGE_ACQUISITION
| Student

|-
| LYING
| Liar

|-
| NEGOTIATION
| Negotiator

|-
| PACIFY
| Pacifier

|-
| PERSUASION
| Persuader

|-
| TEACHING
| Teacher

|}

===Art Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| DANCE{{version|0.42.01}}
|

|-
| MAKE_MUSIC{{version|0.42.01}}
|

|-
| PLAY_KEYBOARD_INSTRUMENT{{version|0.42.01}}
|

|-
| PLAY_PERCUSSION_INSTRUMENT{{version|0.42.01}}
|

|-
| PLAY_STRINGED_INSTRUMENT{{version|0.42.01}}
|

|-
| PLAY_WIND_INSTRUMENT{{version|0.42.01}}
|

|-
| SING{{version|0.42.01}}
|

|}

===Knowledge Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| ASTRONOMY{{version|0.42.01}}
|

|-
| CHEMISTRY{{version|0.42.01}}
|

|-
| CRITICAL_THINKING{{version|0.42.01}}
|

|-
| FLUID_ENGINEER{{version|0.42.01}}
|

|-
| GEOGRAPHY{{version|0.42.01}}
|

|-
| LOGIC{{version|0.42.01}}
|

|-
| MATHEMATICS{{version|0.42.01}}
|

|-
| OPTICS_ENGINEER{{version|0.42.01}}
|

|}

===Administrative Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| APPRAISAL
| Appraiser

|-
| DESIGNBUILDING
| Building Designer

|-
| LEADERSHIP
| Leader

|-
| ORGANIZATION
| Organizer

|-
| RECORD_KEEPING
| Record Keeper

|}

===Military Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| ARMOR
| Armor User

|-
| AXE
| Axeman

|-
| BITE
| Biter

|-
| BLOWGUN
| Blowgunner

|-
| BOW
| Bowman

|-
| CROSSBOW
| Crossbowman

|-
| DAGGER
| Knife User

|-
| DODGING
| Dodger

|-
| GRASP_STRIKE
| Striker

|-
| HAMMER
| Hammerman

|-
| MACE
| Maceman

|-
| MELEE_COMBAT
| Fighter

|-
| MILITARY_TACTICS
| Military Tactics

|-
| MISC_WEAPON
| Misc. Object User

|-
| PIKE
| Pikeman

|-
| RANGED_COMBAT
| Archer

|-
| SHIELD
| Shield user

|-
| SIEGEOPERATE
| Siege Operator

|-
| SITUATIONAL_AWARENESS
| Observer

|-
| SNEAK
| Ambusher

|-
| SPEAR
| Spearman

|-
| STANCE_STRIKE
| Kicker

|-
| SWORD
| Swordsman

|-
| THROW
| Thrower

|-
| WHIP
| Lasher

|-
| WRESTLING
| Wrestler

|}

===Other===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| ALCHEMY
| Alchemist

|-
| CLIMBING
| Climbing

|-
| CONCENTRATION
| Concentration

|-
| CRUTCH_WALK
| Crutch-Walker

|-
| KNAPPING
| Knapper

|-
| KNOWLEDGE_ACQUISITION
| Student

|-
| LEADERSHIP
| Leader

|-
| MAGIC_NATURE
| Druid

|-
| MILITARY_TACTICS
| Military Tactics

|-
| SITUATIONAL_AWARENESS
| Observer

|-
| SNEAK
| Ambusher

|-
| SWIMMING
| Swimmer

|-
| TEACHING
| Teacher

|}

{{Skills}}
{{Category|Modding}}{{Category|Skills}}{{Category|Tokens}}

Unit type token

2015-12-06T16:34:19Z

FortressBuilder: Add new tokens

{{quality|Fine}}{{av}}
{{old}}
For use with various [[entity token]]s, as well as in graphical tilesets.

{| {{prettytable}} class="sortable"
|- style='background-color:#ddd'
! #
! Token
! Unit Type
|-
|0||{{text anchor|MINER}}||[[Miner]]
|-
|1||{{text anchor|WOODWORKER}}||[[Woodworker]]
|-
|2||{{text anchor|CARPENTER}}||[[Carpenter]]
|-
|3||{{text anchor|BOWYER}}||[[Bowyer]]
|-
|4||{{text anchor|WOODCUTTER}}||[[Woodcutter]]
|-
|5||{{text anchor|STONEWORKER}}||[[Stoneworker]]
|-
|6||{{text anchor|ENGRAVER}}||[[Engraver]]
|-
|7||{{text anchor|MASON}}||[[Mason]]
|-
|8||{{text anchor|RANGER}}||[[Ranger]]
|-
|9||{{text anchor|ANIMAL_CARETAKER}}||[[Animal caretaker]]
|-
|10||{{text anchor|ANIMAL_TRAINER}}||[[Animal trainer]]
|-
|11||{{text anchor|HUNTER}}||[[Hunter]]
|-
|12||{{text anchor|TRAPPER}}||[[Trapper]]
|-
|13||{{text anchor|ANIMAL_DISSECTOR}}||[[Animal dissector]]
|-
|14||{{text anchor|METALSMITH}}||[[Metalsmith]]
|-
|15||{{text anchor|FURNACE_OPERATOR}}||[[Furnace operator]]
|-
|16||{{text anchor|WEAPONSMITH}}||[[Weaponsmith]]
|-
|17||{{text anchor|ARMORER}}||[[Armorer]]
|-
|18||{{text anchor|BLACKSMITH}}||[[Blacksmith]]
|-
|19||{{text anchor|METALCRAFTER}}||[[Metalcrafter]]
|-
|20||{{text anchor|JEWELER}}||[[Jeweler]]
|-
|21||{{text anchor|GEM_CUTTER}}||[[Gem cutter]]
|-
|22||{{text anchor|GEM_SETTER}}||[[Gem setter]]
|-
|23||{{text anchor|CRAFTSMAN}}||[[Craftsman]]
|-
|24||{{text anchor|WOODCRAFTER}}||[[Woodcrafter]]
|-
|25||{{text anchor|STONECRAFTER}}||[[Stonecrafter]]
|-
|26||{{text anchor|LEATHERWORKER}}||[[Leatherworker]]
|-
|27||{{text anchor|BONE_CARVER}}||[[Bone carver]]
|-
|28||{{text anchor|WEAVER}}||[[Weaver]]
|-
|29||{{text anchor|CLOTHIER}}||[[Clothier]]
|-
|30||{{text anchor|GLASSMAKER}}||[[Glassmaker]]
|-
|31||{{text anchor|POTTER}}||[[Potter]]
|-
|32||{{text anchor|GLAZER}}||[[Glazer]]
|-
|33||{{text anchor|WAX_WORKER}}||[[Wax worker]]
|-
|34||{{text anchor|STRAND_EXTRACTOR}}||[[Strand extractor]]
|-
|35||{{text anchor|FISHERY_WORKER}}||[[Fishery worker]]
|-
|36||{{text anchor|FISHERMAN}}||[[Fisherman]]
|-
|37||{{text anchor|FISH_DISSECTOR}}||[[Fish dissector]]
|-
|38||{{text anchor|FISH_CLEANER}}||[[Fish cleaner]]
|-
|39||{{text anchor|FARMER}}||[[Farmer]]
|-
|40||{{text anchor|CHEESE_MAKER}}||[[Cheese maker]]
|-
|41||{{text anchor|MILKER}}||[[Milker]]
|-
|42||{{text anchor|COOK}}||[[Cook]]
|-
|43||{{text anchor|THRESHER}}||[[Thresher]]
|-
|44||{{text anchor|MILLER}}||[[Miller]]
|-
|45||{{text anchor|BUTCHER}}||[[Butcher]]
|-
|46||{{text anchor|TANNER}}||[[Tanner]]
|-
|47||{{text anchor|DYER}}||[[Dyer]]
|-
|48||{{text anchor|PLANTER}}||[[Planter]]
|-
|49||{{text anchor|HERBALIST}}||[[Herbalist]]
|-
|50||{{text anchor|BREWER}}||[[Brewer]]
|-
|51||{{text anchor|SOAP_MAKER}}||[[Soap maker]]
|-
|52||{{text anchor|POTASH_MAKER}}||[[Potash maker]]
|-
|53||{{text anchor|LYE_MAKER}}||[[Lye maker]]
|-
|54||{{text anchor|WOOD_BURNER}}||[[Wood burner]]
|-
|55||{{text anchor|SHEARER}}||[[Shearer]]
|-
|56||{{text anchor|SPINNER}}||[[Spinner]]
|-
|57||{{text anchor|PRESSER}}||[[Presser]]
|-
|58||{{text anchor|BEEKEEPER}}||[[Beekeeper ]]
|-
|59||{{text anchor|ENGINEER}}||[[Engineer]]
|-
|60||{{text anchor|MECHANIC}}||[[Mechanic]]
|-
|61||{{text anchor|SIEGE_ENGINEER}}||[[Siege engineer]]
|-
|62||{{text anchor|SIEGE_OPERATOR}}||[[Siege operator]]
|-
|63||{{text anchor|PUMP_OPERATOR}}||[[Pump operator]]
|-
|64||{{text anchor|CLERK}}||[[Clerk]]
|-
|65||{{text anchor|ADMINISTRATOR}}||[[Administrator]]
|-
|66||{{text anchor|TRADER}}||[[Trader]]
|-
|67||{{text anchor|ARCHITECT}}||[[Architect]]
|-
|68||{{text anchor|ALCHEMIST}}||[[Alchemist]]
|-
|69||{{text anchor|DOCTOR}}||[[Doctor]]
|-
|70||{{text anchor|DIAGNOSER}}||[[Diagnoser]]
|-
|71||{{text anchor|BONE_SETTER}}||[[Bone doctor]]
|-
|72||{{text anchor|SUTURER}}||[[Suturer]]
|-
|73||{{text anchor|SURGEON}}||[[Surgeon]]
|-
|74||{{text anchor|MERCHANT}}||[[Merchant]]
|-
|75||{{text anchor|HAMMERMAN}}||[[Hammerman]]
|-
|76||{{text anchor|MASTER_HAMMERMAN}}||[[Hammer lord]]
|-
|77||{{text anchor|SPEARMAN}}||[[Spearman]]
|-
|78||{{text anchor|MASTER_SPEARMAN}}||[[Spearmaster]]
|-
|79||{{text anchor|CROSSBOWMAN}}||[[Crossbowman]]
|-
|80||{{text anchor|MASTER_CROSSBOWMAN}}||[[Elite crossbowman]]
|-
|81||{{text anchor|WRESTLER}}||[[Wrestler]]
|-
|82||{{text anchor|MASTER_WRESTLER}}||[[Elite wrestler]]
|-
|83||{{text anchor|AXEMAN}}||[[Axeman]]
|-
|84||{{text anchor|MASTER_AXEMAN}}||[[Axe lord]]
|-
|85||{{text anchor|SWORDSMAN}}||[[Swordsman]]
|-
|86||{{text anchor|MASTER_SWORDSMAN}}||[[Swordmaster]]
|-
|87||{{text anchor|MACEMAN}}||[[Maceman]]
|-
|88||{{text anchor|MASTER_MACEMAN}}||[[Mace lord]]
|-
|89||{{text anchor|PIKEMAN}}||[[Pikeman]]
|-
|90||{{text anchor|MASTER_PIKEMAN}}||[[Pikemaster]]
|-
|91||{{text anchor|BOWMAN}}||[[Bowman]]
|-
|92||{{text anchor|MASTER_BOWMAN}}||[[Elite bowman]]
|-
|93||{{text anchor|BLOWGUNMAN}}||[[Blowgunner]]
|-
|94||{{text anchor|MASTER_BLOWGUNMAN}}||[[Master blowgunner]]
|-
|95||{{text anchor|LASHER}}||[[Lasher]]
|-
|96||{{text anchor|MASTER_LASHER}}||[[Master lasher]]
|-
|97||{{text anchor|RECRUIT}}||[[Recruit]]
|-
|98||{{text anchor|TRAINED_HUNTER}}||[[Hunting animal]]
|-
|99||{{text anchor|TRAINED_WAR}}||[[War animal]]
|-
|100||{{text anchor|MASTER_THIEF}}||[[Master thief]]
|-
|101||{{text anchor|THIEF}}||[[Thief]]
|-
|102||{{text anchor|STANDARD}}||[[Peasant]]
|-
|103||{{text anchor|CHILD}}||[[Child]]
|-
|104||{{text anchor|BABY}}||[[Baby]]
|-
|105||{{text anchor|DRUNK}}||[[Drunk]]
|-
|106||{{text anchor|MONSTER_SLAYER}}||[[Monster Slayer]]
|-
|107||{{text anchor|SCOUT}}||[[Scout]]
|-
|108||{{text anchor|BEAST_HUNTER}}||[[Beast Hunter]]
|-
|109||{{text anchor|SNATCHER}}||[[Snatcher]]
|-
|110||{{text anchor|MERCENARY}}||[[Mercenary]]
|-
|???||{{text anchor|GELDER}}||[[Gelder]]
|-
|???||{{text anchor|PERFORMER}}{{version|0.42.01}}||[[Performer]]
|-
|???||{{text anchor|POET}}{{version|0.42.01}}||[[Poet]]
|-
|???||{{text anchor|BARD}}{{version|0.42.01}}||[[Bard]]
|-
|???||{{text anchor|DANCER}}{{version|0.42.01}}||[[Dancer]]
|-
|???||{{text anchor|SAGE}}{{version|0.42.01}}||[[Sage]]
|-
|???||{{text anchor|SCHOLAR}}{{version|0.42.01}}||[[Scholar]]
|-
|???||{{text anchor|PHILOSOPHER}}{{version|0.42.01}}||[[Philosopher]]
|-
|???||{{text anchor|MATHEMATICIAN}}{{version|0.42.01}}||[[Mathematician]]
|-
|???||{{text anchor|HISTORIAN}}{{version|0.42.01}}||[[Historian]]
|-
|???||{{text anchor|ASTRONOMER}}{{version|0.42.01}}||[[Astronomer]]
|-
|???||{{text anchor|NATURALIST}}{{version|0.42.01}}||[[Naturalist]]
|-
|???||{{text anchor|CHEMIST}}{{version|0.42.01}}||[[Chemist]]
|-
|???||{{text anchor|GEOGRAPHER}}{{version|0.42.01}}||[[Geographer]]
|-
|???||{{text anchor|SCRIBE}}{{version|0.42.01}}||[[Scribe]]
|-
|???||{{text anchor|PAPERMAKER}}{{version|0.42.01}}||[[Papermaker]]
|-
|???||{{text anchor|BOOKBINDER}}{{version|0.42.01}}||[[Bookbinder]]
|-
|???||{{text anchor|TAVERN_KEEPER}}{{version|0.42.01}}||[[Tavern keeper]]
|}

The following tokens are also permitted in tilesets:

Entity link:
*MEMBER (not useful)
*FORMER_MEMBER (not useful)
*MERCENARY (not useful)
*FORMER_MERCENARY (not useful)
*SLAVE
*FORMER_SLAVE (not useful)
*PRISONER
*FORMER_PRISONER (not useful)
*ENEMY (not useful)
*CRIMINAL

{{Category|Modding}}
{{Category|Tokens}}

Dwarf fortress mode

2015-12-06T13:35:31Z

FortressBuilder:

{{Quality|Exceptional|09:26, 7 May 2015 (UTC)}}
{{av}}
{{old}}
:''[[Modding guide|Modding]] is not covered on this page.''
:''For tutorials about fortress mode, see [[tutorials]].''

'''Fortress mode''' is the more popular of two modes of gameplay in Dwarf Fortress, with the other mode being [[Adventurer mode]]. It is often the mode implied when one talks about Dwarf Fortress. In fortress mode, you pick an embark [[location]], and then assign your seven initial [[dwarves]] some starting [[Skill | skills]], equipment, provisions, and [[animals]] to bring along. After preparations are complete and your hardy explorers [[embark]], they'll be faced with the fortress site you picked down to every little detail, from geologically appropriate stone types to roaring waterfalls to ornery [[Hippo | hippopotami]]. Rather than control individual dwarves, you design everything and your dwarves will go about implementing your designs on their own.

== Goals ==

Dwarf Fortress mode is considered a [http://en.wikipedia.org/wiki/Construction_and_management_simulation_games construction and management simulation game]. This entails that few goals are imposed upon the player by the game.

The most apparent goal is survival, as your endeavors at the chosen site will, [[Reclaim fortress mode|for the moment]], end if the last dwarf dies. With this comes the need to keep your dwarves happy, as unhappy dwarves will cultivate some very unhealthy (yet surprisingly [[Losing|Fun]]) habits like murdering their colleagues.

Another goal of sorts, programmed into the game, is creating a fortress that attracts the king of your civilization. Therefore players typically, but by no means necessarily, choose to expand into a thriving community with skilled [[Labor|workers]], [[military|battle-ready warriors]] and [[nobles]], creating ridiculous amounts of [[wealth|wealth]] like fine [[finished goods|crafts]], excellent armor, valuable [[furniture]], decorated with precious [[gem]]s, all the while protecting them from [[siege|foes]] with deadly [[trap]]s and a trained [[military]]. Avoiding imminent death also requires providing the dwarves with plenty of [[food]] and [[alcohol]], by way of [[farming|farms]] above and below ground, while [[clothing]] from [[leather]] or [[cloth]] will keep them happy.

Of course, every dwarf loves precious [[metal]]s, but the only way to find them is to [[mining|dig]]. Make sure you don't dig too greedily, or too deep, for many creatures dwell in the [[caverns]] below...

== The World ==

To play Dwarf Fortress in fortress mode you must generate a world that includes a dwarven civilization. See [[World generation]] for detailed instructions. After at least one world has been generated you will be able to start the game. Only one game may be going on in a world at the same time.

=== Geographic Features ===
The main features of a world are [[biome]]s on the surface and [[stone layer]]s under the surface, some of which may contain [[aquifer]]s. Other surface features that are significant, but which aren't biomes strictly speaking, are [[river]]s, [[volcano]]es, and [[cave]]s.

There are also [[cavern]]s and magma seas everywhere underground which your dwarves will most likely encounter, but you can't see these on the world map and won't see them on the local map until you dig into them. There may also be other [[Fun]] things underground that you can't see. You will have to find these on your own, if they exist.

=== Inhabitants ===
Every playable world will be inhabited by various [[creature]]s, [[civilization]]s, [[night creature]]s, and [[megabeast]]s (including [[titan]]s and [[forgotten beast]]s) in addition to your dwarves. Even if your dwarves are minding their own business they are practically guaranteed to encounter all of these types of inhabitants at some point in the form of wildlife, invaders, or rampaging forces of nature.

=== History ===
Given that your world includes creatures and civilizations capable of independent action, it also has a history that is viewable in [[legends mode]]. Historical events will show up in [[engraving]]s and other artwork created by your dwarves. Historical dates are expressed in terms of the [[Calendar|Dwarven Calendar]].

You will also be making history as events occur in your fortress and these events will be recorded for all time in the annals of your world, even if you'd rather that they not be. These events may later become the subject of various [[engraving]]s and [[decoration]]s created by your dwarves or those in a later fortress.

== Embarking ==
[[File:FlowchartDF.png|thumb|200px|right|[[::From Caravan to Happy Dwarves|From Caravan to Happy Dwarves]] – a flowchart showing approximately what sequence of actions most people will take after embarking.]]

:''Main article: [[Embark]]''
:''See also: [[Reclaim fortress mode]]''

Before starting to build a fortress you must pick a site, assign skill points to dwarves, and buy starting equipment. This is known as embarking and is a major subject in and of itself. See the [[Embark]] guide for all of the details. Also see [[Starting build]] for more information on outfitting your expedition.

After you embark, the real game begins.

== Gameplay User Interface ==
Your main view of the in-game world is a top-down view of a multi-layered environment. You can move your view in the four main cardinal directions as well as up and down [[Z-level]]s (elevation) to see different layers. There is also a command menu that lets you issue commands that your dutiful dwarves will attempt to follow.

This section covers most of the screens and user interface elements used after embarking, at least in brief. It does not necessarily tell you how to accomplish every task you might need to, but instead just describes what you see on the screen and what various keystrokes do.

Later sections in this document and ''many'' other articles on this wiki help you tie all of this together by describing the sequence of actions needed to accomplish various things in the game; see [[Menu]] for a more detailed reference for the UI itself.

=== Common UI Concepts ===
{{KeyConventions|4}}

=== Pausing and Resuming ===
{| class="wikitable"
|-
| {{K|Space}}
| Pause/Unpause the game
|}

Entering all menus (except the {{K|s}}quads menu) will automatically pause the game, but if you want to pause or unpause the game without entering a menu use {{K|Space}}. You will see {{DFtext|*PAUSED*|3:3:1}} appear in the upper left corner of the window when the game is paused. Certain [[announcement]]s will also pause the game automatically and you will have to unpause it manually to proceed.

=== Main Screen ===

{| class="wikitable"
|-
| [[Image:Mouse-wheeldown.png|20px|Scroll mouse wheel down.]][[Image:Mouse-wheelup.png|20px|Scroll mouse wheel up.]] or {{K|[}} {{K|]}}
| Zoom in and out
|-
| {{k|Tab}}
| Toggle mini-map and command menu.
|-
| {{k|F11}}
| Toggle fullscreen mode
|}

The screen at the top level of the user interface hierarchy consists of the '''main map''', a '''command window''', and an '''overview mini-map''' area along with a few '''status indicators''' around the edge. While the main map is always visible at the top level of the UI, you can use the {{K|Tab}} key to show and hide the command window and overview map areas, giving you more space to view the main map if desired.

=== Options Screen ===
{| class="wikitable"
|-
| {{K|Esc}}
|
* Enter options menu (if at top level)
* Move back up one UI level (if not at top level)
|}

Assuming you are at the top level of the user interface looking at the map, you can hit {{K|Esc}} to enter the options menu. This allows you to do things like save or abandon your game.

*{{DFtext|Return to Game}} – Exit the options menu. You can also just press {{K|Esc}}.
*{{DFtext|Save Game}} – Saves the game, unloads the fortress, and returns to the main menu screen. There is no "save and continue" option, but saves can be [[saved game folder|backed up and reloaded]].
*{{DFtext|Key Bindings}} – A UI for changing the [[Key bindings]].
*{{DFtext|Export Local Image}} – Use this to export each level of your map as .BMP files for use on such things as the [http://mkv25.net/dfma/ Dwarf Fortress Map Archive].
*{{DFtext|Music and Sound}} – Options related to the [[Music | Music]].
*{{DFtext|Abandon the Fortress}} (or {{DFtext|Succumb to Invasion}})   This permanently [[abandon]]s the fortress, saves the map to the world's data files for later use, and returns to the main menu. Once you abandon a fort, all of your dwarves cease to exist, all of your livestock dies, and all items including corpses will be scattered around the map before it is saved. This is how you "give up" on a fortress. You might later [[Reclaim fortress mode|reclaim]] the fortress with a new group of dwarves or visit it with an adventurer in [[Adventurer mode]].
*{{DFtext|Retire the Fortress}}  – This ends the game without destroying the fortress, with citizens, livestock, and items continuing to exist. You may start new games in any mode and can later [[Reclaim fortress mode|unretire]] the fortress.

Notably lacking is an "exit without save" option. Players who wish to quit and leave their previous save unchanged may manually kill the Dwarf Fortress process using the "die" command in DFHack, Windows Task Manager, or the Linux "kill" command.

=== Main Map ===
[[File:bentgirder-embark.png|thumb|300px|Main map on the left, command window on the right.]]
[[Image:3_dimensions.png|right|300px]]
{| class="wikitable"
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}} ( + {{k|Shift}})
| Move map view around
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}} (keypad)
| Move map view around
|-
| {{k|<}} {{k|>}}
| Move one [[Z-level]] up or down.
|-
| {{k|F1}}
| Zoom to starting location (default [[#Hotkeys|hotkey]])
|}
The main map window is what you will be looking at the majority of the time. This is where all of the action happens.

While the play area itself is three-dimensional, the window is not; you can only view one [[Z-level]] at a time. You can change which Z-Level is currently displayed using {{k|<}} and {{k|>}}.

On the far right side of the screen is the '''depth bar''' showing you the approximate depth, below or above ground, of the current [[Z-level]] that the map is displaying. This indicator is relative to the surface, so it will change if you move the map around an area with a non-flat surface, even if you don't press {{K|<}} or {{K|>}}.

==== Map Cursor ====
{| class="wikitable"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}} (keypad)
| Move map cursor 1 tile
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Move map cursor 1 tile
|-
| {{k|Shift}} + direction key
| Move map cursor 10 tiles
|}

After entering a command that involves the map cursor ({{Raw Tile|X|6:0:1}}), you can use {{k|↑}} {{k|↓}} {{k|←}} {{k|→}} as well as the numeric keypad keys to move the cursor around in all eight directions. If you hold {{k|Shift}} while pressing one of these, the cursor will move 10 tiles instead of one, enabling you to move it more quickly.

=== Overview Map ===
The overview mini-map shows a compact version of the entire available map area. This can be useful especially if your embark zone is very large. After the fortress has settled into certain areas of the map, its utility decreases and it can be hidden with {{K|Tab}} to provide more space for the main map.

A cursor that looks like {{Raw Tile|X|6:0:1}} on the overview map shows approximately what part of the map you are viewing in the main map window. Parts of the map inhabited by dwarves will be highlighted in blue.

=== Status Indicators ===
In the upper left corner of the screen you may see some '''report flags''' indicating that new combat-related [[Reports]] have been generated. The flags are:

:{{Tile|C|4:7:1}}: new [[combat]] report available
:{{Tile|H|2:7:1}}: new [[Ambusher#Hunting|hunting]] report available
:{{Tile|S|3:7:1}}: new [[sparring]] report available

Press {{K|r}} to view the new reports in the [[#Combat Reports|reports screen]] and once you do the flags will be reset.

There is also an '''idle counter''', usually in the upper right, indicating how many dwarves are milling around uselessly, in need of something productive to do.

An '''[[FPS]] (Frames Per Second) counter''' may also be present on the screen if it has been enabled. It is disabled by default. See [[Frames per second]] for more information on what this counter means, as well as how to enable/disable it.

=== Command Window ===
[[File:MainMenu.png|The command window.|frame]]
This is where key menus and most of the textual information about tiles and buildings is displayed. You can toggle it between single width, double width, and hidden using {{K|Tab}}. The double-width option is particularly useful when lines of text are too long to fit. Once you become familiar with the UI you may want to hide it completely; it will reappear as needed when you activate a command.

The most important interfaces that use the command window are listed below. Many of these encompass a wide variety of functionality so they will not be fully described here. See the linked articles for more details on how they are used.

== Your Dwarves ==

Your [[Dwarf|dwarves]] are the creatures who implement your designs in between periods of drinking, eating, partying, drinking again, sleeping, and entertaining themselves. While you do not have full control of your dwarves, you have more control over them than any other creatures. Be aware that it is not necessarily always the case that a dwarf is friendly; [[Insanity|insane]] dwarves, [[Werebeast|weredwarves]] or [[Vampire|vampires]] are anything but.

=== Eating, Drinking, and Sleeping ===
Dwarves need [[food]] to eat, [[alcohol]] to drink (water is a poor substitute), and time to [[sleep]]. If only one of these is available, it better be [[alcohol]]; while water will keep dwarves alive, they will actually work more slowly and get unhappy thoughts (see below) if they don't get alcohol to drink.

Dwarves will also get unhappy thoughts if forced to eat a single type of food or drink a single type of alcohol all the time, so variety is also important. Dwarves will get unhappy thoughts if forced to sleep on the floor.

=== Happiness ===
While going about their day, dwarves will get happy and unhappy [[thought]]s depending on what sorts of things happen to them. This will nudge their happiness levels up or down each time one occurs to them. If they become too unhappy they may throw [[tantrum]]s or go completely [[Insanity|berserk]], killing and destroying things.

=== Children and Immigration ===
Periodically new dwarves from the outside world will [[Immigration|migrate]] to your fortress, drawn by tales of, and looking to share in, your wealth and success. Female dwarves will also get pregnant and have [[children]] if they are [[Marriage|married]].

=== Jobs, Labors and Skills ===
Any adult dwarf can perform any [[labor]] even if they have no [[skill]] in that area. Unskilled dwarves will simply be slow and not very good at what they are trying to do. With practice, dwarves will acquire skill, become faster and better at their jobs. A lack of practice for long periods leads to skill "rust".

=== Nobles ===
[[Noble]]s are dwarves who have special positions within your organization. Some of these are appointed such as your broker and bookkeeper, but others such as [[Mayor]] are essentially forced on you by conditions in the game. See the main article on [[Noble]]s for more information.

=== Death ===

Assuming they somehow manage to avoid starving, dehydrating, freezing, drowning, burning, falling, being crushed, or otherwise suffering fatal [[wound]]s or [[soap|infections]], your dwarves will inevitably [[Death|die]] of old age. Unfortunately they are a bit picky about how they are [[Coffin|buried]] or otherwise [[Memorial|memorialized]], and they will [[Ghost|cause trouble]] if they are unsatisfied with their remembrance. Corpses lying around also pose a hazard if there are [[Necromancer|necromancers]] in the area.

A [[Healthcare]] industry might help your wounded dwarves postpone death.

== Digging ==

:''Main article: [[Mining]]''
All of the '''digging''' operations are considered [[Mining]]. Even if your goal is simply to dig out a passage and you don't care about extracting ore, your miners will be generating [[stone]] as a byproduct unless they are digging through [[soil]]. See [[Stone management]] for ways to deal with all the unwanted stone.

All digging operations are done using the {{K|d}}esignations menu.

=== Digging Out Tunnels and Spaces ===
{| class="wikitable"
|-
| {{K|d}}-{{K|d}}
| [[Mining#Designating_the_area_to_be_mined|Designate area to mine]]
|}
This is what you use to dig out tunnels and larger spaces underground. See [[Mining#Designating_the_area_to_be_mined|designating an area to be mined]]. Note that you can not mine constructions. Instead you must remove them with {{K|d}}-{{K|n}}. (See below.)

=== Channeling ===
{| class="wikitable"
|-
| {{K|d}}-{{K|h}}
| Dig out a [[Channel]]
|}
A [[Channel]] is a hole dug in the floor which will mine out the [[z-level]] below too. Channeling an area will dig out the designated tile (if it hasn't been dug out already), the floor of that tile, and the tile below, possibly leaving a [[Ramp]] on the tile below. See [[Channel]] for more information.

=== Stairways and Ramps ===
{| class="wikitable"
|-
| {{K|d}}-{{K|u}}
| Designate an upward stairway
|-
| {{K|d}}-{{K|j}}
| Designate a downward stairway
|-
| {{K|d}}-{{K|i}}
| Designate an up and down stairway
|-
| {{K|d}}-{{K|r}}
| Designate an upward ramp
|}
See [[Stair]] and [[Ramp]]. Note that digging a stairway will not automatically create a stairway on the z-level above and/or below, but it will make it possible to dig another stairway immediately above and/or below.

=== Removing Things ===
{| class="wikitable"
|-
| {{K|d}}-{{K|z}}
| Remove upward stairs/ramps
|-
| {{K|d}}-{{K|n}}
| Remove a construction
|}
These allow you to dig away upward ramps and stairs, and demolish constructed walls and floors. See [[Remove]] for full details.

=== Water and Magma ===
While digging around you may encounter [[Water]] or [[Magma]], so be on the lookout for '''damp stone''' and '''warm stone'''. Digging into water or magma in the wrong place can completely flood your fort to the point where it is unrecoverable, so be careful where you dig.

== Stockpiles ==

:''Main article: [[Stockpile]]''
'''Stockpiles''' are where [[dwarf|dwarves]] will store items of various types. Dwarves with the corresponding "[[hauling]]" job on will seek out items that aren't already on a stockpile that accepts them and carry them to the appropriate stockpile. See the main [[Stockpile]] article for detailed information on setting up stockpiles.

== Rooms, Furniture, and Portals ==

To remove one of these, use the {{K|q}} command, place the cursor on the item to remove, and hit {{K|x}}. This will mark the item for removal and a hauling job will be queued. Eventually a dwarf will show up and haul the item off to a [[stockpile]] if one exists.

=== Furniture ===
{| class="wikitable"
|-
| {{K|b}}-{{K|a}}
| place Armor Stand
|-
| {{K|b}}-{{K|b}}
| place Bed
|-
| {{K|b}}-{{K|c}}
| place Chair or Throne (seat)
|-
| {{K|b}}-{{K|n}}
| place Burial Receptacle (coffin)
|-
| {{K|b}}-{{K|f}}
| place Cabinet
|-
| {{K|b}}-{{K|h}}
| place Container
|-
| {{K|b}}-{{K|r}}
| place Weapon Rack
|-
| {{K|b}}-{{K|s}}
| place Statue
|-
| {{K|b}}-{{K|Alt}}+{{K|s}}
| place memorial Slab
|-
| {{K|b}}-{{K|t}}
| place Table
|-
| {{K|b}}-{{K|R}}
| place Traction Bench
|}
Assuming that dwarves have already made a piece of [[Furniture]], they can install it somewhere using one of these commands.

=== Defining Rooms ===
:''Main article: [[Room]]''
Certain types of furniture placed in an area can allow the area to be defined as a [[Room]] using {{K|q}}. The {{K|q}} command can also be used to undefine rooms, with or without removing the associated furniture.

=== Doors and Hatches ===
{| class="wikitable"
|-
| {{K|b}}-{{K|d}}
| place Door
|-
| {{K|b}}-{{K|x}}
| place floodgate
|-
| {{K|b}}-{{K|H}}
| place floor Hatch
|}
These commands allow you to place already created [[Door]]s and [[Hatch cover]]s assuming that you have an adjacent wall.

=== Windows, Grates, and Bars ===
{| class="wikitable"
|-
| {{K|b}}-{{K|W}}
| place Wall grate
|-
| {{K|b}}-{{K|G}}
| place floor Grate
|-
| {{K|b}}-{{K|B}}
| place vertical Bars
|-
| {{K|b}}-{{K|Alt}}+{{K|b}}
| place floor Bars
|-
| {{K|b}}-{{K|y}}
| place glass window
|-
| {{K|b}}-{{K|Y}}
| place gem window
|}
These commands allow you to install [[Window]]s, [[Grate]]s, and [[Bars]] over openings, assuming that you have already created them.

== Constructions ==

Walls, Floors, and Stairs are removed with {{K|d}}-{{K|n}}. Bridges and roads are removed with {{K|q}}.

=== Walls, Floors, and Stairs ===
{| class="wikitable"
|-
| {{K|b}}-{{K|C}}
| build Constructions submenu
|-
| {{K|b}}-{{K|C}}-{{K|w}}
| build Constructed [[Wall]]
|-
| {{K|b}}-{{K|C}}-{{K|f}}
| build Constructed [[Floor]]
|-
| {{K|b}}-{{K|C}}-{{K|r}}
| build Constructed upward [[Ramp]]
|-
| {{K|b}}-{{K|C}}-{{K|u}}
| build Constructed Up [[Stair]]
|-
| {{K|b}}-{{K|C}}-{{K|d}}
| build Constructed Down [[Stair]]
|-
| {{K|b}}-{{K|C}}-{{K|x}}
| build Constructed up and down [[Stair]]
|-
| {{K|b}}-{{K|C}}-{{K|F}}
| build Constructed [[Fortification]]
|}
:''Main article: [[Construction]]''
[[Construction]]s are features that are built in place rather than created in a workshop and installed or carved out of existing rock. Constructions are how you build above-ground structures or structures in any other place where there's no rock or soil to carve them out of.

Constructions are usually built out of, and thus require, [[Stone]] or [[Wood]], but you can also use a variety of materials (such as metal) to build them. Possible constructions include [[Floor]]s, [[Wall]]s, [[Stair]]s, [[Ramp]]s, and [[Fortification]]s.

=== Bridges ===
{| class="wikitable"
|-
| {{K|b}}-{{K|g}}
| build a bridge
|}
A [[Bridge]] is not only used to cross rivers or chasms, but can also be used as a large door when built as a drawbridge. Such use requires that a [[Lever]] be linked to it in order for dwarves to control its open or closed state.

=== Roads ===
{| class="wikitable"
|-
| {{K|b}}-{{K|o}}
| build Paved road
|-
| {{K|b}}-{{K|O}}
| build Dirt road
|}
[[Road]]s are most commonly used to give [[caravan|caravans]] a reliable path to your fortress from the map's edge, though they don't really require one. A paved road is much like a [[floor]] except that it requires fewer raw materials per tile to build. A dirt road requires no materials to build, but deteriorates over time.

== Trading ==
:''Main article: [[Trading]]''

When you want to obtain things not available on your map, and you don't want to just kill people to get them, [[Trading]] is the way to go about it. See the main article for everything you ever wanted to know about legitimately and non-violently obtaining things from other creatures.

== Military and Combat ==

:''Main article: [[Military]]''
:''Also see: [[Military interface]] guide''

The '''military''' is one of the most important aspects of a successful fortress. Even with many [[trap]]s, [[bridge|drawbridges]] and [[magma|other defenses]], your military will still need to fend off [[goblin]] [[siege]]s, [[megabeast]]s, [[titan]]s, and fiendish [[Giant cave spider|underground]] [[Forgotten beast|beasties]]. Using a combination of [[squads|squad orders]] and [[scheduling]], you can set up an elaborate offensive, defensive, or balanced military structure for your [[equipment|well-equipped]] [[soldier]]s to follow. Turning your dwarves from [[immigration|useless migrants]] into bloodthirsty killing machines never hurts (unless you're the enemy).

Setting up a military is a huge subject in and of itself, so check out the [[Military|main article]] on it and the [[military interface]] guide.

== Hospitals and Healthcare ==

:''Main article: [[Healthcare]]''

Normally your dwarves do just fine assuming they get enough food and alcohol, but sometimes they get wounded. When this happens they can benefit from an efficient [[Healthcare]] system.

== Burrows ==

:''Main article: [[Burrow]]''

'''Burrows''' are optional user-defined areas in your fort where selected dwarves live and work. Dwarves will only use workshops, dig walls, use rooms, etc. in burrows they are assigned to, though dwarves not assigned to any burrow will still use workshops etc. even if they are located in a burrow assigned to some other dwarves.

Burrows are by no means required, but are useful when you want to restrict certain dwarves to certain areas of the map.

== Macros ==

:''Main article: [[Macros and Keymaps]]''

'''Macros''' allow recording sequences of keystrokes and "playing" them back into the user interface as desired. Since the game often requires using a lot of repetitive keystrokes, this can sometimes make life much easier. See the main article for full information.

== Reference Sheet ==

A quick reference guide on fortress mode in DF can be found [https://www.dropbox.com/sh/8akafeuqfsxth7t/U-zOsO7pNr here.] '''Credit to spongemandan on reddit.com'''

It includes a reference sheet on the military, stone, agriculture and a summary reference sheet.

{{Getting Started}}
{{Category|Fortress mode}}
{{Category|Guides}}
{{Category|Interface}}

Dwarf fortress mode

2015-12-06T13:32:54Z

FortressBuilder:

{{Quality|Exceptional|09:26, 7 May 2015 (UTC)}}
{{av}}
{{old}}
:''[[Modding guide|Modding]] is not covered on this page.''
:''For tutorials about fortress mode, see [[tutorials]].''

'''Fortress mode''' is the more popular of two modes of gameplay in Dwarf Fortress, with the other mode being [[Adventurer mode]]. It is often the mode implied when one talks about Dwarf Fortress. In fortress mode, you pick an embark [[location]], and then assign your seven initial [[dwarves]] some starting [[Skill | skills]], equipment, provisions, and [[animals]] to bring along. After preparations are complete and your hardy explorers [[embark]], they'll be faced with the fortress site you picked down to every little detail, from geologically appropriate stone types to roaring waterfalls to ornery [[Hippo | hippopotami]]. Rather than control individual dwarves, you design everything and your dwarves will go about implementing your designs on their own.

== Goals ==

Dwarf Fortress mode is considered a [http://en.wikipedia.org/wiki/Construction_and_management_simulation_games construction and management simulation game]. This entails that few goals are imposed upon the player by the game.

The most apparent goal is survival, as your endeavors at the chosen site will, [[Reclaim fortress mode|for the moment]], end if the last dwarf dies. With this comes the need to keep your dwarves happy, as unhappy dwarves will cultivate some very unhealthy (yet surprisingly [[Losing|Fun]]) habits like murdering their colleagues.

Another goal of sorts, programmed into the game, is creating a fortress that attracts the king of your civilization. Therefore players typically, but by no means necessarily, choose to expand into a thriving community with skilled [[Labor|workers]], [[military|battle-ready warriors]] and [[nobles]], creating ridiculous amounts of [[wealth|wealth]] like fine [[finished goods|crafts]], excellent armor, valuable [[furniture]], decorated with precious [[gem]]s, all the while protecting them from [[siege|foes]] with deadly [[trap]]s and a trained [[military]]. Avoiding imminent death also requires providing the dwarves with plenty of [[food]] and [[alcohol]], by way of [[farming|farms]] above and below ground, while [[clothing]] from [[leather]] or [[cloth]] will keep them happy.

Of course, every dwarf loves precious [[metal]]s, but the only way to find them is to [[mining|dig]]. Make sure you don't dig too greedily, or too deep, for many creatures dwell in the [[caverns]] below...

== The World ==

To play Dwarf Fortress in fortress mode you must generate a world that includes a dwarven civilization. See [[World generation]] for detailed instructions. After at least one world has been generated you will be able to start the game. Only one game may be going on in a world at the same time.

=== Geographic Features ===
The main features of a world are [[biome]]s on the surface and [[stone layer]]s under the surface, some of which may contain [[aquifer]]s. Other surface features that are significant, but which aren't biomes strictly speaking, are [[river]]s, [[volcano]]es, and [[cave]]s.

There are also [[cavern]]s and magma seas everywhere underground which your dwarves will most likely encounter, but you can't see these on the world map and won't see them on the local map until you dig into them. There may also be other [[Fun]] things underground that you can't see. You will have to find these on your own, if they exist.

=== Inhabitants ===
Every playable world will be inhabited by various [[creature]]s, [[civilization]]s, [[night creature]]s, and [[megabeast]]s (including [[titan]]s and [[forgotten beast]]s) in addition to your dwarves. Even if your dwarves are minding their own business they are practically guaranteed to encounter all of these types of inhabitants at some point in the form of wildlife, invaders, or rampaging forces of nature.

=== History ===
Given that your world includes creatures and civilizations capable of independent action, it also has a history that is viewable in [[legends mode]]. Historical events will show up in [[engraving]]s and other artwork created by your dwarves. Historical dates are expressed in terms of the [[Calendar|Dwarven Calendar]].

You will also be making history as events occur in your fortress and these events will be recorded for all time in the annals of your world, even if you'd rather that they not be. These events may later become the subject of various [[engraving]]s and [[decoration]]s created by your dwarves or those in a later fortress.

== Embarking ==
[[File:FlowchartDF.png|thumb|200px|right|[[::From Caravan to Happy Dwarves|From Caravan to Happy Dwarves]] – a flowchart showing approximately what sequence of actions most people will take after embarking.]]

:''Main article: [[Embark]]''
:''See also: [[Reclaim fortress mode]]''

Before starting to build a fortress you must pick a site, assign skill points to dwarves, and buy starting equipment. This is known as embarking and is a major subject in and of itself. See the [[Embark]] guide for all of the details. Also see [[Starting build]] for more information on outfitting your expedition.

After you embark, the real game begins.

== Gameplay User Interface ==
Your main view of the in-game world is a top-down view of a multi-layered environment. You can move your view in the four main cardinal directions as well as up and down [[Z-level]]s (elevation) to see different layers. There is also a command menu that lets you issue commands that your dutiful dwarves will attempt to follow.

This section covers most of the screens and user interface elements used after embarking, at least in brief. It does not necessarily tell you how to accomplish every task you might need to, but instead just describes what you see on the screen and what various keystrokes do.

Later sections in this document and ''many'' other articles on this wiki help you tie all of this together by describing the sequence of actions needed to accomplish various things in the game; see [[Menu]] for a more detailed reference for the UI itself.

=== Common UI Concepts ===
{{KeyConventions|4}}

=== Pausing and Resuming ===
{| class="wikitable"
|-
| {{K|Space}}
| Pause/Unpause the game
|}

Entering all menus (except the {{K|s}}quads menu) will automatically pause the game, but if you want to pause or unpause the game without entering a menu use {{K|Space}}. You will see {{DFtext|*PAUSED*|3:3:1}} appear in the upper left corner of the window when the game is paused. Certain [[announcement]]s will also pause the game automatically and you will have to unpause it manually to proceed.

=== Main Screen ===

{| class="wikitable"
|-
| [[Image:Mouse-wheeldown.png|20px|Scroll mouse wheel down.]][[Image:Mouse-wheelup.png|20px|Scroll mouse wheel up.]] or {{K|[}} {{K|]}}
| Zoom in and out
|-
| {{k|Tab}}
| Toggle mini-map and command menu.
|-
| {{k|F11}}
| Toggle fullscreen mode
|}

The screen at the top level of the user interface hierarchy consists of the '''main map''', a '''command window''', and an '''overview mini-map''' area along with a few '''status indicators''' around the edge. While the main map is always visible at the top level of the UI, you can use the {{K|Tab}} key to show and hide the command window and overview map areas, giving you more space to view the main map if desired.

=== Options Screen ===
{| class="wikitable"
|-
| {{K|Esc}}
|
* Enter options menu (if at top level)
* Move back up one UI level (if not at top level)
|}

Assuming you are at the top level of the user interface looking at the map, you can hit {{K|Esc}} to enter the options menu. This allows you to do things like save or abandon your game.

*{{DFtext|Return to Game}} – Exit the options menu. You can also just press {{K|Esc}}.
*{{DFtext|Save Game}} – Saves the game, unloads the fortress, and returns to the main menu screen. There is no "save and continue" option, but saves can be [[saved game folder|backed up and reloaded]].
*{{DFtext|Key Bindings}} – A UI for changing the [[Key bindings]].
*{{DFtext|Export Local Image}} – Use this to export each level of your map as .BMP files for use on such things as the [http://mkv25.net/dfma/ Dwarf Fortress Map Archive].
*{{DFtext|Music and Sound}} – Options related to the [[Music | Music]].
*{{DFtext|Abandon the Fortress}} (or {{DFtext|Succumb to Invasion}})   This permanently [[abandon]]s the fortress, saves the map to the world's data files for later use, and returns to the main menu. Once you abandon a fort, all of your dwarves cease to exist, all of your livestock dies, and all items including corpses will be scattered around the map before it is saved. This is how you "give up" on a fortress. You might later [[Reclaim fortress mode|reclaim]] the fortress with a new group of dwarves or visit it with an adventurer in [[Adventurer mode]].
*{{DFtext|Retire the Fortress}}  – This ends the game without destroying the fortress, with citizens, livestock, and items continuing to exist. You may start new games in any mode and can later [[Reclaim fortress mode|unretire]] the fortress.

Notably lacking is an "exit without save" option. Players who wish to quit and leave their previous save unchanged may manually kill the Dwarf Fortress process using the "die" command in DFHack, Windows Task Manager, or the Linux "kill" command.

=== Main Map ===
[[File:bentgirder-embark.png|thumb|300px|Main map on the left, command window on the right.]]
[[Image:3_dimensions.png|right|300px]]
{| class="wikitable"
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}} ( + {{k|Shift}})
| Move map view around
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}} (keypad)
| Move map view around
|-
| {{k|<}} {{k|>}}
| Move one [[Z-level]] up or down.
|-
| {{k|F1}}
| Zoom to starting location (default [[#Hotkeys|hotkey]])
|}
The main map window is what you will be looking at the majority of the time. This is where all of the action happens.

While the play area itself is three-dimensional, the window is not; you can only view one [[Z-level]] at a time. You can change which Z-Level is currently displayed using {{k|<}} and {{k|>}}.

On the far right side of the screen is the '''depth bar''' showing you the approximate depth, below or above ground, of the current [[Z-level]] that the map is displaying. This indicator is relative to the surface, so it will change if you move the map around an area with a non-flat surface, even if you don't press {{K|<}} or {{K|>}}.

==== Map Cursor ====
{| class="wikitable"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}} (keypad)
| Move map cursor 1 tile
|-
| {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Move map cursor 1 tile
|-
| {{k|Shift}} + direction key
| Move map cursor 10 tiles
|}

After entering a command that involves the map cursor ({{Raw Tile|X|6:0:1}}), you can use {{k|↑}} {{k|↓}} {{k|←}} {{k|→}} as well as the numeric keypad keys to move the cursor around in all eight directions. If you hold {{k|Shift}} while pressing one of these, the cursor will move 10 tiles instead of one, enabling you to move it more quickly.

=== Overview Map ===
The overview mini-map shows a compact version of the entire available map area. This can be useful especially if your embark zone is very large. After the fortress has settled into certain areas of the map, its utility decreases and it can be hidden with {{K|Tab}} to provide more space for the main map.

A cursor that looks like {{Raw Tile|X|6:0:1}} on the overview map shows approximately what part of the map you are viewing in the main map window. Parts of the map inhabited by dwarves will be highlighted in blue.

=== Status Indicators ===
In the upper left corner of the screen you may see some '''report flags''' indicating that new combat-related [[Reports]] have been generated. The flags are:

:{{Tile|C|4:7:1}}: new [[combat]] report available
:{{Tile|H|2:7:1}}: new [[Ambusher#Hunting|hunting]] report available
:{{Tile|S|3:7:1}}: new [[sparring]] report available

Press {{K|r}} to view the new reports in the [[#Combat Reports|reports screen]] and once you do the flags will be reset.

There is also an '''idle counter''', usually in the upper right, indicating how many dwarves are milling around uselessly, in need of something productive to do.

An '''[[FPS]] (Frames Per Second) counter''' may also be present on the screen if it has been enabled. It is disabled by default. See [[Frames per second]] for more information on what this counter means, as well as how to enable/disable it.

=== Command Window ===
[[File:MainMenu.png|The command window.|frame]]
This is where key menus and most of the textual information about tiles and buildings is displayed. You can toggle it between single width, double width, and hidden using {{K|Tab}}. The double-width option is particularly useful when lines of text are too long to fit. Once you become familiar with the UI you may want to hide it completely; it will reappear as needed when you activate a command.

The most important interfaces that use the command window are listed below. Many of these encompass a wide variety of functionality so they will not be fully described here. See the linked articles for more details on how they are used.

== Your Dwarves ==

Your [[Dwarf|dwarves]] are the creatures who implement your designs in between periods of drinking, eating, partying, drinking again, sleeping, and entertaining themselves. While you do not have full control of your dwarves, you have more control over them than any other creatures. Be aware that it is not necessarily always the case that a dwarf is friendly; [[Insanity|insane]] dwarves, [[Werebeast|weredwarves]] or [[Vampire|vampires]] are anything but.

=== Eating, Drinking, and Sleeping ===
Dwarves need [[food]] to eat, [[alcohol]] to drink (water is a poor substitute), and time to [[sleep]]. If only one of these is available, it better be [[alcohol]]; while water will keep dwarves alive, they will actually work more slowly and get unhappy thoughts (see below) if they don't get alcohol to drink.

Dwarves will also get unhappy thoughts if forced to eat a single type of food or drink a single type of alcohol all the time, so variety is also important. Dwarves will get unhappy thoughts if forced to sleep on the floor.

=== Happiness ===
While going about their day, dwarves will get happy and unhappy [[thought]]s depending on what sorts of things happen to them. This will nudge their happiness levels up or down each time one occurs to them. If they become too unhappy they may throw [[tantrum]]s or go completely [[Insanity|berserk]], killing and destroying things.

=== Children and Immigration ===
Periodically new dwarves from the outside world will [[Immigration|migrate]] to your fortress, drawn by tales of, and looking to share in, your wealth and success. Female dwarves will also get pregnant and have [[children]] if they are [[Marriage|married]].

=== Jobs, Labors and Skills ===
Any adult dwarf can perform any [[labor]] even if they have no [[skill]] in that area. Unskilled dwarves will simply be slow and not very good at what they are trying to do. With practice, dwarves will acquire skill, become faster and better at their jobs. A lack of practice for long periods leads to skill "rust".

=== Nobles ===
[[Noble]]s are dwarves who have special positions within your organization. Some of these are appointed such as your broker and bookkeeper, but others such as [[Mayor]] are essentially forced on you by conditions in the game. See the main article on [[Noble]]s for more information.

=== Death ===

Assuming they somehow manage to avoid starving, dehydrating, freezing, drowning, burning, falling, being crushed, or otherwise suffering fatal [[wound]]s or [[soap|infections]], your dwarves will inevitably [[Death|die]] of old age. Unfortunately they are a bit picky about how they are [[Coffin|buried]] or otherwise [[Memorial|memorialized]], and they will [[Ghost|cause trouble]] if they are unsatisfied with their remembrance. Corpses lying around also pose a hazard if there are [[Necromancer|necromancers]] in the area.

A [[Healthcare]] industry might help your wounded dwarves postpone death.

== Digging ==

:''Main article: [[Mining]]''
All of the '''digging''' operations are considered [[Mining]]. Even if your goal is simply to dig out a passage and you don't care about extracting ore, your miners will be generating [[stone]] as a byproduct unless they are digging through [[soil]]. See [[Stone management]] for ways to deal with all the unwanted stone.

All digging operations are done using the {{K|d}}esignations menu.

=== Digging Out Tunnels and Spaces ===
{| class="wikitable"
|-
| {{K|d}}-{{K|d}}
| [[Mining#Designating_the_area_to_be_mined|Designate area to mine]]
|}
This is what you use to dig out tunnels and larger spaces underground. See [[Mining#Designating_the_area_to_be_mined|designating an area to be mined]]. Note that you can not mine constructions. Instead you must remove them with {{K|d}}-{{K|n}}. (See below.)

=== Channeling ===
{| class="wikitable"
|-
| {{K|d}}-{{K|h}}
| Dig out a [[Channel]]
|}
A [[Channel]] is a hole dug in the floor which will mine out the [[z-level]] below too. Channeling an area will dig out the designated tile (if it hasn't been dug out already), the floor of that tile, and the tile below, possibly leaving a [[Ramp]] on the tile below. See [[Channel]] for more information.

=== Stairways and Ramps ===
{| class="wikitable"
|-
| {{K|d}}-{{K|u}}
| Designate an upward stairway
|-
| {{K|d}}-{{K|j}}
| Designate a downward stairway
|-
| {{K|d}}-{{K|i}}
| Designate an up and down stairway
|-
| {{K|d}}-{{K|r}}
| Designate an upward ramp
|}
See [[Stair]] and [[Ramp]]. Note that digging a stairway will not automatically create a stairway on the z-level above and/or below, but it will make it possible to dig another stairway immediately above and/or below.

=== Removing Things ===
{| class="wikitable"
|-
| {{K|d}}-{{K|z}}
| Remove upward stairs/ramps
|-
| {{K|d}}-{{K|n}}
| Remove a construction
|}
These allow you to dig away upward ramps and stairs, and demolish constructed walls and floors. See [[Remove]] for full details.

=== Water and Magma ===
While digging around you may encounter [[Water]] or [[Magma]], so be on the lookout for '''damp stone''' and '''warm stone'''. Digging into water or magma in the wrong place can completely flood your fort to the point where it is unrecoverable, so be careful where you dig.

== Stockpiles ==

:''Main article: [[Stockpile]]''
'''Stockpiles''' are where [[dwarf|dwarves]] will store items of various types. Dwarves with the corresponding "[[hauling]]" job on will seek out items that aren't already on a stockpile that accepts them and carry them to the appropriate stockpile. See the main [[Stockpile]] article for detailed information on setting up stockpiles.

== Rooms, Furniture, and Portals ==

To remove one of these, use the {{K|q}} command, place the cursor on the item to remove, and hit {{K|x}}. This will mark the item for removal and a hauling job will be queued. Eventually a dwarf will show up and haul the item off to a [[stockpile]] if one exists.

=== Furniture ===
{| class="wikitable"
|-
| {{K|b}}-{{K|a}}
| place Armor Stand
|-
| {{K|b}}-{{K|b}}
| place Bed
|-
| {{K|b}}-{{K|c}}
| place Chair or Throne (seat)
|-
| {{K|b}}-{{K|n}}
| place Burial Receptacle (coffin)
|-
| {{K|b}}-{{K|f}}
| place Cabinet
|-
| {{K|b}}-{{K|h}}
| place Container
|-
| {{K|b}}-{{K|r}}
| place Weapon Rack
|-
| {{K|b}}-{{K|s}}
| place Statue
|-
| {{K|b}}-{{K|Alt}}+{{K|s}}
| place memorial Slab
|-
| {{K|b}}-{{K|t}}
| place Table
|-
| {{K|b}}-{{K|R}}
| place Traction Bench
|}
Assuming that dwarves have already made a piece of [[Furniture]], they can install it somewhere using one of these commands.

=== Defining Rooms ===
:''Main article: [[Room]]''
Certain types of furniture placed in an area can allow the area to be defined as a [[Room]] using {{K|q}}. The {{K|q}} command can also be used to undefine rooms, with or without removing the associated furniture.

=== Doors and Hatches ===
{| class="wikitable"
|-
| {{K|b}}-{{K|d}}
| place Door
|-
| {{K|b}}-{{K|x}}
| place floodgate
|-
| {{K|b}}-{{K|H}}
| place floor Hatch
|}
These commands allow you to place already created [[Door]]s and [[Hatch cover]]s assuming that you have an adjacent wall.

=== Windows, Grates, and Bars ===
{| class="wikitable"
|-
| {{K|b}}-{{K|W}}
| place Wall grate
|-
| {{K|b}}-{{K|G}}
| place floor Grate
|-
| {{K|b}}-{{K|B}}
| place vertical Bars
|-
| {{K|b}}-{{K|Alt}}+{{K|b}}
| place floor Bars
|-
| {{K|b}}-{{K|y}}
| place glass window
|-
| {{K|b}}-{{K|Y}}
| place gem window
|}
These commands allow you to install [[Window]]s, [[Grate]]s, and [[Bars]] over openings, assuming that you have already created them.

== Constructions ==

Walls, Floors, and Stairs are removed with {{K|d}}-{{K|n}}. Bridges and roads are removed with {{K|q}}.

=== Walls, Floors, and Stairs ===
{| class="wikitable"
|-
| {{K|b}}-{{K|C}}
| build Constructions submenu
|-
| {{K|b}}-{{K|C}}-{{K|w}}
| build Constructed [[Wall]]
|-
| {{K|b}}-{{K|C}}-{{K|f}}
| build Constructed [[Floor]]
|-
| {{K|b}}-{{K|C}}-{{K|r}}
| build Constructed upward [[Ramp]]
|-
| {{K|b}}-{{K|C}}-{{K|u}}
| build Constructed Up [[Stair]]
|-
| {{K|b}}-{{K|C}}-{{K|d}}
| build Constructed Down [[Stair]]
|-
| {{K|b}}-{{K|C}}-{{K|x}}
| build Constructed up and down [[Stair]]
|-
| {{K|b}}-{{K|C}}-{{K|F}}
| build Constructed [[Fortification]]
|}
:''Main article: [[Construction]]''
[[Construction]]s are features that are built in place rather than created in a workshop and installed or carved out of existing rock. Constructions are how you build above-ground structures or structures in any other place where there's no rock or soil to carve them out of.

Constructions are usually built out of, and thus require, [[Stone]] or [[Wood]], but you can also use a variety of materials (such as metal) to build them. Possible constructions include [[Floor]]s, [[Wall]]s, [[Stair]]s, [[Ramp]]s, and [[Fortification]]s.

=== Bridges ===
{| class="wikitable"
|-
| {{K|b}}-{{K|g}}
| build a bridge
|}
A [[Bridge]] is not only used to cross rivers or chasms, but can also be used as a large door when built as a drawbridge. Such use requires that a [[Lever]] be linked to it in order for dwarves to control its open or closed state.

=== Roads ===
{| class="wikitable"
|-
| {{K|b}}-{{K|o}}
| build Paved road
|-
| {{K|b}}-{{K|O}}
| build Dirt road
|}
[[Road]]s are most commonly used to give [[caravan|caravans]] a reliable path to your fortress from the map's edge, though they don't really require one. A paved road is much like a [[floor]] except that it requires fewer raw materials per tile to build. A dirt road requires no materials to build, but deteriorates over time.

== Trading ==
:''Main article: [[Trading]]''

When you want to obtain things not available on your map, and you don't want to just kill people to get them, [[Trading]] is the way to go about it. See the main article for everything you ever wanted to know about legitimately and non-violently obtaining things from other creatures.

== Military and Combat ==

:''Main article: [[Military]]''
:''Also see: [[Military interface]] guide''

The '''military''' is one of the most important aspects of a successful fortress. Even with many [[trap]]s, [[bridge|drawbridges]] and [[magma|other defenses]], your military will still need to fend off [[goblin]] [[siege]]s, [[megabeast]]s, [[titan]]s, and fiendish [[Giant cave spider|underground]] [[Forgotten beast|beasties]]. Using a combination of [[squads|squad orders]] and [[scheduling]], you can set up an elaborate offensive, defensive, or balanced military structure for your [[equipment|well-equipped]] [[soldier]]s to follow. Turning your dwarves from [[immigration|useless migrants]] into bloodthirsty killing machines never hurts (unless you're the enemy).

Setting up a military is a huge subject in and of itself, so check out the [[Military|main article]] on it and the [[military interface]] guide.

== Hospitals and Healthcare ==

:''Main article: [[Healthcare]]''

Normally your dwarves do just fine assuming they get enough food and alcohol, but sometimes they get wounded. When this happens they can benefit from an efficient [[Healthcare]] system.

== Burrows ==

:''Main article: [[Burrow]]''

'''Burrows''' are optional user-defined areas in your fort where selected dwarves live and work. Dwarves will only use workshops, dig walls, use rooms, etc. in burrows they are assigned to, though dwarves not assigned to any burrow will still use workshops etc. even if they are located in a burrow assigned to some other dwarves.

Burrows are by no means required, but are useful when you want to restrict certain dwarves to certain areas of the map.

== Macros ==

:''Main article: [[Macros and Keymaps]]''

'''Macros''' allow recording sequences of keystrokes and "playing" them back into the user interface as desired. Since the game often requires using a lot of repetitive keystrokes, this can sometimes make life much easier. See the main article for full information.

== Reference Sheet ==

A quick reference guide on fortress mode in DF can be found [https://www.dropbox.com/sh/8akafeuqfsxth7t/U-zOsO7pNr here.] '''Credit to spongemandan on reddit.com'''

It includes a reference sheet on the military, stone, agriculture and a summary reference sheet.

{{Category|Fortress mode}}
{{Category|Guides}}
{{Category|Interface}}

Personality facet

2015-12-04T18:41:00Z

FortressBuilder: /* Beliefs */ Fill in more knowledge descriptions

{{Quality|Exceptional|16:12, 23 August 2014 (UTC)}}
{{av}}
{{old}}
__FORCETOC__
Dwarven '''personalities''' are determined by beliefs, goals, and facets. These are distinct from [[attributes]]. In general, personality traits do not have as important a gameplay effect as attributes, though many of the gameplay effects of personality traits are yet unknown.

Personality traits are shown in a dwarf's [[thoughts and preferences]] description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

==Beliefs==

Each belief has a range from −50 to 50. The value triggers a report in "thoughts and preferences" depending on where it falls in these seven levels:

{| class="wikitable"
! Value Range !! Values in Range !! Probability !! Effect
|-
| +41 to +50 || 10 || 0.4% || Highest
|-
| +26 to +40 || 15 || 2% || Very High
|-
| +11 to +25 || 15 || 8.5% || High
|-
| −10 to +10 || 21 || 78% || Neutral
|-
| −25 to −11 || 15 || 8.5% || Low
|-
| −40 to −26 || 15 || 2% || Very Low
|-
| −50 to −41 || 10 || 0.4% || Lowest
|}

Beliefs are also influenced by cultural values via the use of the VALUE [[entity token]]. For example, dwarven civilizations hold craftsdwarfship in the highest regard, whereas goblins hold the ideas of fairness and sacrifice in utter disdain. If an individual dwarf's belief differs significantly from the civilization's beliefs, then that belief gets highlighted in cyan in the thought and personality screen.

Certain beliefs can conflict with personality facets — see below.

{| class="wikitable"
! Topic
! style="width:7em" | Value
! Description
|- style="border-top: 3px solid #aaa"
! rowspan=7 | LAW
| +41 to +50 || is an absolute believer in the rule of law
|-
| +26 to +40 || has a great deal of respect for the law
|-
| +11 to +25 || respects the law
|-
| −10 to +10 || doesn't feel strongly about the law
|-
| −25 to −11 || does not respect the law
|-
| −40 to −26 || disdains the law
|-
| −50 to −41 || finds the idea of laws abhorent

|- style="border-top: 3px solid #aaa"
! rowspan=7 | LOYALTY
| +41 to +50 || has the highest regard for loyalty
|-
| +26 to +40 || greatly prizes loyalty
|-
| +11 to +25 || values loyalty
|-
| −10 to +10 || doesn't particularly value loyalty
|-
| −25 to −11 || views loyalty unfavorably
|-
| −40 to −26 || disdains loyalty
|-
| −50 to −41 || is disgusted by the idea of loyalty

|- style="border-top: 3px solid #aaa"
! rowspan=7 | FAMILY
| +41 to +50 || sees family as one of the most important things in life
|-
| +26 to +40 || values family greatly
|-
| +11 to +25 || values family
|-
| −10 to +10 || does not care about family one way or the other
|-
| −25 to −11 || is put off by family
|-
| −40 to −26 || lacks any respect for family
|-
| −50 to −41 || finds the idea of family loathsome

|- style="border-top: 3px solid #aaa"
! rowspan=7 | FRIENDSHIP
| +41 to +50 || believes friendship is a key to the ideal life
|-
| +26 to +40 || sees friendship as one of the finer things in life
|-
| +11 to +25 || thinks friendship is important
|-
| −10 to +10 || does not care about friendship
|-
| −25 to −11 || finds friendship burdensome
|-
| −40 to −26 || is completely put off by the idea of friends
|-
| −50 to −41 || finds the whole idea of friendship disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | POWER
| +41 to +50 || believes that the acquisition of power over others is the ideal goal in life and worthy of the highest respect
|-
| +26 to +40 || sees power over others as something to strive for
|-
| +11 to +25 || respects power
|-
| −10 to +10 || doesn't find power particularly praiseworthy
|-
| −25 to −11 || has a negative view of those who exercise power over others
|-
| −40 to −26 || hates those who wield power over others
|-
| −50 to −41 || finds the acquisition and use of power abhorent and would have all masters toppled

|- style="border-top: 3px solid #aaa"
! rowspan=7 | TRUTH
| +41 to +50 || believes the truth is inviolable regardless of the cost
|-
| +26 to +40 || believes that honesty is a high ideal
|-
| +11 to +25 || values honesty
|-
| −10 to +10 || does not particularly value the truth
|-
| −25 to −11 || finds blind honesty foolish
|-
| −40 to −26 || sees lying as an important means to an end
|-
| −50 to −41 || is repelled by the idea of honesty and lies without compunction

|- style="border-top: 3px solid #aaa"
! rowspan=7 | CUNNING
| +41 to +50 || holds well-laid plans and shrewd deceptions in the highest regard
|-
| +26 to +40 || greatly respects the shrewd and guileful
|-
| +11 to +25 || values cunning
|-
| −10 to +10 || does not really value cunning and guile
|-
| −25 to −11 || sees guile and cunning as indirect and somewhat worthless
|-
| −40 to −26 || holds shrewd and crafty individuals in the lowest esteem
|-
| −50 to −41 || is utterly disgusted by guile and cunning

|- style="border-top: 3px solid #aaa"
! rowspan=7 | ELOQUENCE
| +41 to +50 || believes that artful speech and eloquent expression are of the highest ideals
|-
| +26 to +40 || deeply respects eloquent speakers
|-
| +11 to +25 || values eloquence
|-
| −10 to +10 || doesn't value eloquence so much
|-
| −25 to −11 || finds eloquence and artful speech off-putting
|-
| −40 to −26 || finds [him/her]self somewhat disgusted with eloquent speakers
|-
| −50 to −41 || sees artful speech and eloquence as a wasteful form of deliberate deception and treats it as such

|- style="border-top: 3px solid #aaa"
! rowspan=7 | FAIRNESS
| +41 to +50 || holds fairness as one of the highest ideals and despises cheating of any kind
|-
| +26 to +40 || has great respect for fairness
|-
| +11 to +25 || respects fair-dealing and fair-play
|-
| −10 to +10 || does not care about fairness
|-
| −25 to −11 || sees life as unfair and doesn't mind it that way
|-
| −40 to −26 || finds the idea of fair-dealing foolish and cheats when [he/she] finds it profitable
|-
| −50 to −41 || is disgusted by the idea of fairness and will freely cheat anybody at any time

|- style="border-top: 3px solid #aaa"
! rowspan=7 | DECORUM
| +41 to +50 || views decorum as a high ideal and is deeply offended by those that fail to maintain it
|-
| +26 to +40 || greatly respects those that observe decorum and maintain their dignity
|-
| +11 to +25 || values decorum, dignity and proper behavior
|-
| −10 to +10 || doesn't care very much about decorum
|-
| −25 to −11 || finds maintaining decorum a silly, fumbling waste of time
|-
| −40 to −26 || sees those that attempt to maintain dignified and proper behavior as vain and offensive
|-
| −50 to −41 || is affronted by the whole notion of maintaining decorum and finds so-called dignified people disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | TRADITION
| +41 to +50 || holds the maintenance of tradition as one of the highest ideals
|-
| +26 to +40 || is a firm believer in the value of tradition
|-
| +11 to +25 || values tradition
|-
| −10 to +10 || doesn't have any strong feelings about tradition
|-
| −25 to −11 || disregards tradition
|-
| −40 to −26 || finds the following of tradition foolish and limiting
|-
| −50 to −41 || is disgusted by tradition and would flout any [he/she] encounters if given a chance

|- style="border-top: 3px solid #aaa"
! rowspan=7 | ARTWORK
| +41 to +50 || believes that the creation and appreciation of artwork is one of the highest ideals
|-
| +26 to +40 || greatly respects artists and their works
|-
| +11 to +25 || values artwork
|-
| −10 to +10 || doesn't care about art one way or another
|-
| −25 to −11 || finds artwork boring
|-
| −40 to −26 || sees the whole pursuit of art as silly
|-
| −50 to −41 || finds art offensive and would have it destroyed whenever possible

|- style="border-top: 3px solid #aaa"
! rowspan=7 | COOPERATION
| +41 to +50 || places cooperation as one of the highest ideals
|-
| +26 to +40 || sees cooperation as very important in life
|-
| +11 to +25 || values cooperation
|-
| −10 to +10 || doesn't see cooperation as valuable
|-
| −25 to −11 || dislikes cooperation
|-
| −40 to −26 || views cooperation as a low ideal not worthy of any respect
|-
| −50 to −41 || is thoroughly disgusted by cooperation

|- style="border-top: 3px solid #aaa"
! rowspan=7 | INDEPENDENCE
| +41 to +50 || believes that freedom and independence are completely non-negotiable and would fight to defend them
|-
| +26 to +40 || treasures independence
|-
| +11 to +25 || values independence
|-
| −10 to +10 || doesn't really value independence one way or another
|-
| −25 to −11 || finds the ideas of independence and freedom somewhat foolish
|-
| −40 to −26 || sees freedom and independence as completely worthless
|-
| −50 to −41 || hates freedom and would crush the independent spirit wherever it is found

|- style="border-top: 3px solid #aaa"
! rowspan=7 | STOICISM
| +41 to +50 || views any show of emotion as offensive
|-
| +26 to +40 || thinks it is of the utmost importance to present a bold face and never grouse, complain or even show emotion
|-
| +11 to +25 || believes it is important to conceal emotions and refrain from complaining
|-
| −10 to +10 || doesn't see much value in being stoic
|-
| −25 to −11 || sees no value in holding back complaints and concealing emotions
|-
| −40 to −26 || feels that those who attempt to conceal their emotions are vain and foolish
|-
| −50 to −41 || sees concealment of emotions as a betrayal and tries [his/her] best never to associate with such secretive fools

|- style="border-top: 3px solid #aaa"
! rowspan=7 | INTROSPECTION
| +41 to +50 || feels that introspection and all forms of self-examination are the keys to a good life and worthy of respect
|-
| +26 to +40 || deeply values introspection
|-
| +11 to +25 || sees introspection as important
|-
| −10 to +10 || doesn't really see the value in self-examination
|-
| −25 to −11 || finds introspection to be a waste of time
|-
| −40 to −26 || thinks that introspection is valueless and those that waste time in self-examination are deluded fools
|-
| −50 to −41 || finds the whole idea of introspection completely offensive and contrary to the ideals of a life well-lived

|- style="border-top: 3px solid #aaa"
! rowspan=7 | SELF_CONTROL
| +41 to +50 || believes that self-mastery and the denial of impulses are of the highest ideals
|-
| +26 to +40 || finds moderation and self-control to be very important
|-
| +11 to +25 || values self-control
|-
| −10 to +10 || doesn't particularly value self-control
|-
| −25 to −11 || finds those that deny their impulses somewhat stiff
|-
| −40 to −26 || sees the denial of impulses as a vain and foolish pursuit
|-
| −50 to −41 || has abandoned any attempt at self-control and finds the whole concept deeply offensive

|- style="border-top: 3px solid #aaa"
! rowspan=7 | TRANQUILITY
| +41 to +50 || views tranquility as one of the highest ideals
|-
| +26 to +40 || strongly values tranquility and quiet
|-
| +11 to +25 || values tranquility and a peaceful day
|-
| −10 to +10 || doesn't have a preference between tranquility and tumult
|-
| −25 to −11 || prefers a noisy, bustling life to boring days without activity
|-
| −40 to −26 || is greatly disturbed by quiet and a peaceful existence
|-
| −50 to −41 || is disgusted by tranquility and would that the world would constantly churn with noise and activity

|- style="border-top: 3px solid #aaa"
! rowspan=7 | HARMONY
| +41 to +50 || would have the world operate in complete harmony without the least bit of strife or disorder
|-
| +26 to +40 || strongly believes that a peaceful and ordered society without dissent is best
|-
| +11 to +25 || values a harmonious existence
|-
| −10 to +10 || sees equal parts of harmony and discord as part of life
|-
| −25 to −11 || doesn't respect a society that has settled into harmony without debate and strife
|-
| −40 to −26 || can't fathom why anyone would want to live in an orderly and harmonious society
|-
| −50 to −41 || believes deeply that chaos and disorder are the truest expressions of life and would disrupt harmony wherever it is found

|- style="border-top: 3px solid #aaa"
! rowspan=7 | MERRIMENT
| +41 to +50 || believes that little is better in life than a good party
|-
| +26 to +40 || truly values merrymaking and parties
|-
| +11 to +25 || finds merrymaking and partying worthwhile activities
|-
| −10 to +10 || doesn't really value merrymaking
|-
| −25 to −11 || sees merrymaking as a waste
|-
| −40 to −26 || is disgusted by merrymakers
|-
| −50 to −41 || is appalled by merrymaking, parties and other such worthless activities

|- style="border-top: 3px solid #aaa"
! rowspan=7 | CRAFTSMANSHIP
| +41 to +50 || holds crafts[man]ship to be of the highest ideals and celebrates talented artisans and their masterworks
|-
| +26 to +40 || has a great deal of respect for worthy crafts[man]ship
|-
| +11 to +25 || values good crafts[man]ship
|-
| −10 to +10 || doesn't particularly care about crafts[man]ship
|-
| −25 to −11 || considers crafts[man]ship to be relatively worthless
|-
| −40 to −26 || sees the pursuit of good crafts[man]ship as a total waste
|-
| −50 to −41 || views crafts[man]ship with disgust and would desecrate a so-called masterwork or two if [he/she] could get away with it

|- style="border-top: 3px solid #aaa"
! rowspan=7 | MARTIAL_PROWESS
| +41 to +50 || believes that martial prowess defines the good character of an individual
|-
| +26 to +40 || deeply respects skill at arms
|-
| +11 to +25 || values martial prowess
|-
| −10 to +10 || does not really value skills related to fighting
|-
| −25 to −11 || finds those that develop skill with weapons and fighting distasteful
|-
| −40 to −26 || thinks that the pursuit of the skills of warfare and fighting is a low pursuit indeed
|-
| −50 to −41 || abhors those that pursue the mastery of weapons and skill with fighting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | SKILL
| +41 to +50 || believes that the mastery of a skill is one of the highest pursuits
|-
| +26 to +40 || really respects those that take the time to master a skill
|-
| +11 to +25 || respects the development of skill
|-
| −10 to +10 || doesn't care if others take the time to master skills
|-
| −25 to −11 || finds the pursuit of skill mastery off-putting
|-
| −40 to −26 || believes that the time taken to master a skill is a horrible waste
|-
| −50 to −41 || sees the whole idea of taking time to master a skill as appalling

|- style="border-top: 3px solid #aaa"
! rowspan=7 | HARD_WORK
| +41 to +50 || believes that hard work is one of the highest ideals and a key to the good life
|-
| +26 to +40 || deeply respects those that work hard at their labors
|-
| +11 to +25 || values hard work
|-
| −10 to +10 || doesn't really see the point of working hard
|-
| −25 to −11 || sees working hard as a foolish waste of time
|-
| −40 to −26 || thinks working hard is an abject idiocy
|-
| −50 to −41 || finds the proposition that one should work hard in life utterly abhorent

|- style="border-top: 3px solid #aaa"
! rowspan=7 | SACRIFICE
| +41 to +50 || finds sacrifice to be one of the highest ideals
|-
| +26 to +40 || believes that those who sacrifice for others should be deeply respected
|-
| +11 to +25 || values sacrifice
|-
| −10 to +10 || doesn't particularly respect sacrifice as a virtue
|-
| −25 to −11 || sees sacrifice as wasteful and foolish
|-
| −40 to −26 || finds sacrifice to be the height of folly
|-
| −50 to −41 || thinks that the entire concept of sacrifice for others is truly disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | COMPETITION
| +41 to +50 || holds the idea of competition among the most important and would encourage it wherever possible
|-
| +26 to +40 || views competition as a crucial driving force in the world
|-
| +11 to +25 || sees competition as reasonably important
|-
| −10 to +10 || doesn't have strong views on competition
|-
| −25 to −11 || sees competition as wasteful and silly
|-
| −40 to −26 || deeply dislikes competition
|-
| −50 to −41 || finds the very idea of competition obscene

|- style="border-top: 3px solid #aaa"
! rowspan=7 | PERSEVERENCE
| +41 to +50 || believes that perseverence is one of the greatest qualities somebody can have
|-
| +26 to +40 || greatly respects individuals that persevere through their trials and labors
|-
| +11 to +25 || respects perseverence
|-
| −10 to +10 || doesn't think much about the idea of perseverence
|-
| −25 to −11 || sees perseverence in the face of adversity as bull-headed and foolish
|-
| −40 to −26 || thinks there is something deeply wrong with people that persevere through adversity
|-
| −50 to −41 || finds the notion that one would persevere through adversity completely abhorent

|- style="border-top: 3px solid #aaa"
! rowspan=7 | LEISURE_TIME
| +41 to +50 || believes that it would be a fine thing if all time were leisure time
|-
| +26 to +40 || treasures leisure time and thinks it is very important in life
|-
| +11 to +25 || values leisure time
|-
| −10 to +10 || doesn't think one way or the other about leisure time
|-
| −25 to −11 || finds leisure time wasteful
|-
| −40 to −26 || is offended by leisure time and leisurely living
|-
| −50 to −41 || believes that those that take leisure time are evil and finds the whole idea disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | COMMERCE
| +41 to +50 || sees engaging in commerce as a high ideal in life
|-
| +26 to +40 || really respects commerce and those that engage in trade
|-
| +11 to +25 || respects commerce
|-
| −10 to +10 || doesn't particularly respect commerce
|-
| −25 to −11 || is somewhat put off by trade and commerce
|-
| −40 to −26 || finds those that engage in trade and commerce to be fairly disgusting
|-
| −50 to −41 || holds the view that commerce is a vile obscenity

|- style="border-top: 3px solid #aaa"
! rowspan=7 | ROMANCE
| +41 to +50 || sees romance as one of the highest ideals
|-
| +26 to +40 || thinks romance is very important in life
|-
| +11 to +25 || values romance
|-
| −10 to +10 || doesn't care one way or the other about romance
|-
| −25 to −11 || finds romance distasteful
|-
| −40 to −26 || is somewhat disgusted by romance
|-
| −50 to −41 || finds even the abstract idea of romance repellent

|- style="border-top: 3px solid #aaa"
! rowspan=7 | NATURE
| +41 to +50 || holds nature to be of greater value than most aspects of civilization
|-
| +26 to +40 || has a deep respect for animals, plants and the natural world
|-
| +11 to +25 || values nature
|-
| −10 to +10 || doesn't care about nature one way or another
|-
| −25 to −11 || finds nature somewhat disturbing
|-
| −40 to −26 || has a deep dislike of the natural world
|-
| −50 to −41 || would just as soon have nature and the great outdoors burned to ashes and converted into a great mining pit

|- style="border-top: 3px solid #aaa"
! rowspan=7 | PEACE
| +41 to +50 || believes the idea of war is utterly repellent and would have peace at all costs
|-
| +26 to +40 || believes that peace is always preferable to war
|-
| +11 to +25 || values peace over war
|-
| −10 to +10 || doesn't particularly care between war and peace
|-
| −25 to −11 || sees war as a useful means to an end
|-
| −40 to −26 || believes war is preferable to peace in general
|-
| −50 to −41 || thinks that the world should be engaged in perpetual warfare

|- style="border-top: 3px solid #aaa"
! rowspan=7 | KNOWLEDGE{{version|0.42.01}}
| +41 to +50 || finds the quest for knowledge to be of the very highest value
|-
| +26 to +40 || views the pursuit of knowledge as deeply important
|-
| +11 to +25 || values knowledge
|-
| −10 to +10 || doesn't see the attainment of knowledge as important
|-
| −25 to −11 || finds the pursuit of knowledge to be a waste of effort
|-
| −40 to −26 || thinks the quest for knowledge is a delusional fantasy
|-
| −50 to −41 || sees the attainment and preservation of knowledge as an offensive enterprise engaged in by arrogant fools
|}

==Goals==
Some creatures dream of accomplishing certain goals in their life, and these goals can presumably affect their behavior. Dwarves will receive a happy thought upon completion of goals and receive the moniker of "and this goal was realized" in the personality description following their original goal. It is not certain yet whether goals are limited to one per entity.

If a creature has such dreams, they will be listed in the Thoughts and Preferences page.

{| class="wikitable"
! Token
! Description
! Gameplay effects
|- style="border-top: 3px solid #aaa"
! STAY_ALIVE
|
|- style="border-top: 3px solid #aaa"
! MAINTAIN_ENTITY_STATUS
|
|- style="border-top: 3px solid #aaa"
! START_A_FAMILY
| dreams of raising a family
| Goal completed upon giving birth/fathering an infant.
|- style="border-top: 3px solid #aaa"
! RULE_THE_WORLD
| dreams of ruling the world
|- style="border-top: 3px solid #aaa"
! CREATE_A_GREAT_WORK_OF_ART
| dreams of creating a great work of art
| Goal completed upon creation of Artifact or Masterpiece
|- style="border-top: 3px solid #aaa"
! CRAFT_A_MASTERWORK
| dreams of crafting a masterwork someday
| Goal completed upon creation of Artifact or Masterpiece
|- style="border-top: 3px solid #aaa"
! BRING_PEACE_TO_THE_WORLD
| dreams of bringing lasting peace to the world
|- style="border-top: 3px solid #aaa"
! BECOME_A_LEGENDARY_WARRIOR
| dreams of becoming a legendary warrior
|- style="border-top: 3px solid #aaa"
! MASTER_A_SKILL
| dreams of mastering a skill
| Goal completed upon reaching Legendary skill status.
|- style="border-top: 3px solid #aaa"
! FALL_IN_LOVE
| dreams of falling in love
|- style="border-top: 3px solid #aaa"
! SEE_THE_GREAT_NATURAL_SITES
| dreams of seeing the great natural places of the world
|- style="border-top: 3px solid #aaa"
! IMMORTALITY
|
| Leads to [[necromancer|necromancy]]
|}

If said goal has actually been fulfilled, the description will include "and this dream was realized".

==Facets==

Each personality facet has a value from 0 to 100. The value triggers a report in "thoughts and preferences" depending on where it falls in these seven levels:

{| class="wikitable"
! Value Range !! Values in Range !! Probability !! Effect
|-
| 91-100 || 10 || 0.4% || Highest
|-
| 76-90 || 15 || 2% || Very High
|-
| 61-75 || 15 || 8.5% || High
|-
| 40-60 || 21 || 78% || Neutral
|-
| 25-39 || 15 || 8.5% || Low
|-
| 10-24 || 15 || 2% || Very Low
|-
| 0-9 || 10 || 0.4% || Lowest
|}

The 40−60 range does not cause a report.

Facets are also influenced by species via the use of the PERSONALITY [[creature token]]. For example, dwarves are slightly more greedy than average with a median of 55 in that trait, whereas goblins aren't likely to help others out — their altruism median is a mere 25, and is capped at 50.

Facets also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad [[thought]]. Facets may have other, more subtle effects on creature behavior, which are currently not entirely understood.

Certain facets are capable of ''conflicting'' with the dwarf's beliefs. The effect of this is not yet known.

{| class="wikitable"
! Token
! style="width:7em" | Value
! Description
! Effects
|- style="border-top: 3px solid #aaa"
! rowspan=6 | LOVE_PROPENSITY<br />Conflicts with ROMANCE
| 91-100 || is always in love with somebody and easily develops positive feelings
|-
| 76-90 || very easily falls into love and develops positive feelings
|-
| 61-75 || can easily fall in love or develop positive sentiments
|-
| 25-39 || does not easily fall in love and rarely develops positive sentiments
|-
| 10-24 || is not the type to fall in love or even develop positive feelings
|-
| 0-9 || never falls in love or develops positive feelings toward anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | HATE_PROPENSITY
| 91-100 || is often inflamed by hatred and easily develops hatred toward things
|-
| 76-90 || is prone to hatreds and often develops negative feelings
|-
| 61-75 || is quick to form negative views about things
|-
| 25-39 || does not easily hate or develop negative feelings
|-
| 10-24 || very rarely develops negative feelings toward things
|-
| 0-9 || never feels hatred toward anyone or anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ENVY_PROPENSITY
| 91-100 || is consumed by overpowering feelings of jealousy
|-
| 76-90 || is prone to strong feelings of jealousy
|-
| 61-75 || often feels envious of others
|-
| 25-39 || doesn't often feel envious of others
|-
| 10-24 || is rarely jealous
|-
| 0-9 || never envies others their status, situation or possessions

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEER_PROPENSITY<br />Conflicts with MERRIMENT
| 91-100 || often feels filled with joy
|-
| 76-90 || can be very happy and optimistic
|-
| 61-75 || is often cheerful
|-
| 25-39 || is rarely happy or enthusiastic
|-
| 10-24 || is dour as a rule
|-
| 0-9 || is never the slightest bit cheerful about anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION_PROPENSITY
| 91-100 || is frequently depressed
| rowspan=3 | More likely to slip into [[depression]] and be [[Insane|stricken by melancholy]].
|-
| 76-90 || is often sad and dejected
|-
| 61-75 || often feels discouraged
|-
| 25-39 || rarely feels discouraged
|-
| 10-24 || almost never feels discouraged
|-
| 0-9 || never feels discouraged

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER_PROPENSITY
| 91-100 || is in a constant state of internal rage
| rowspan=3 | More likely to throw [[tantrum]]s and go [[Insane|berserk]].
|-
| 76-90 || is very quick to anger
|-
| 61-75 || is quick to anger
|-
| 25-39 || is slow to anger
|-
| 10-24 || is very slow to anger
|-
| 0-9 || never becomes angry

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY_PROPENSITY
| 91-100 || is a nervous wreck
| rowspan=3 | More likely to stumble [[oblivious]]ly and go [[Insane|stark raving mad]].
|-
| 76-90 || is always tense and jittery
|-
| 61-75 || is often nervous
|-
| 25-39 || has a calm demeanor
|-
| 10-24 || has a very calm demeanor
|-
| 0-9 || has an incredibly calm demeanor

|- style="border-top: 3px solid #aaa"
! rowspan=6 | LUST_PROPENSITY
| 91-100 || is constantly ablaze with feelings of lust
|-
| 76-90 || is prone to strong feelings of lust
|-
| 61-75 || often feels lustful
|-
| 25-39 || does not often feel lustful
|-
| 10-24 || rarely looks on others with lust
|-
| 0-9 || never feels lustful passions

|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRESS_VULNERABILITY
| 91-100 || becomes completely helpless in stressful situations
| 50% chance to become [[Insane|catatonic]]
|-
| 76-90 || cracks easily under pressure
|-
| 61-75 || doesn't handle stress well
|-
| 25-39 || can handle stress
|-
| 10-24 || is confident under pressure
|-
| 0-9 || is impervious to the effects of stress

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREED
| 91-100 || is as avaricious as they come, obsessed with acquiring wealth
|-
| 76-90 || is very greedy
|-
| 61-75 || has a greedy streak
|-
| 25-39 || doesn't focus on material goods
|-
| 10-24 || desires little for [him/her]self in the way of possessions
|-
| 0-9 || often neglects [his/her] own wellbeing, having no interest in material goods

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION<br />Conflicts with SELF_CONTROL
| 91-100 || is ruled by irresistible cravings and urges
|-
| 76-90 || feels strong urges and seeks short-term rewards
|-
| 61-75 || occasionally overindulges
|-
| 25-39 || doesn't often experience strong cravings or urges
|-
| 10-24 || only rarely feels strong cravings or urges
|-
| 0-9 || never feels tempted to overindulge in anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VIOLENT<br />Conflicts with TRANQUILITY<br />and MARTIAL_PROWESS
| 91-100 || is given to rough-and-tumble brawling, even to the point of starting fights for no reason
| rowspan=1 | This does not actually cause a dwarf to randomly start a fist fight.
|-
| 76-90 || would never pass up a chance for a good fistfight
|-
| 61-75 || likes to brawl
|-
| 25-39 || tends to avoid any physical confrontations
| rowspan=3 | This does not affect a soldier's will to fight, but will cause civilians to flee from danger.{{verify}}
|-
| 10-24 || does not enjoy participating in physical confrontations
|-
| 0-9 || would flee even the most necessary battle to avoid any form of physical confrontation

|- style="border-top: 3px solid #aaa"
! rowspan=6 | PERSEVERENCE<br />Conflicts with PERSEVERENCE
| 91-100 || is unbelievably stubborn and will stick with even the most futile action once [his/her] mind is made up
|-
| 76-90 || is very stubborn
|-
| 61-75 || is stubborn
|-
| 25-39 || has a noticeable lack of perseverence
|-
| 10-24 || doesn't stick with things if even minor difficulties arise
|-
| 0-9 || drops any activity at the slightest hint of difficulty or even the suggestion of effort being required

|- style="border-top: 3px solid #aaa"
! rowspan=6 | WASTEFULNESS
| 91-100 || is completely careless with resources when completing projects and invariable wastes a lot of time and effort
|-
| 76-90 || is not careful with resources when working on projects and often spends unnecessary effort
|-
| 61-75 || tends to be a little wasteful when working on projects
|-
| 25-39 || tends to be a little tight with resources when working on projects
|-
| 10-24 || is stingy with resources on projects and refuses to expend any extra effort
|-
| 0-9 || cuts any corners possible when working on a project, regardless of the consequences, rather than wasting effort or resources

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DISCORD<br />Conflicts with HARMONY
| 91-100 || revels in chaos and discord, and [he/she] encourages it whenever possible
|-
| 76-90 || finds a chaotic mess preferable to the boredom of harmonious living
|-
| 61-75 || doesn't mind a little tumult and discord in day-to-day living
|-
| 25-39 || prefers that everyone live as harmoniously as possible
|-
| 10-24 || feels best when everyone gets along without any strife or contention
|-
| 0-9 || would be deeply satisfied if everyone could live as one in complete harmony

|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS<br />Conflicts with HARMONY<br />and FRIENDSHIP
| 91-100 || is quite a bold flatterer, extremely friendly but just a little insufferable
|-
| 76-90 || is very friendly and always tries to say nice things to others
|-
| 61-75 || is a friendly individual
|-
| 25-39 || is somewhat quarrelsome
|-
| 10-24 || is unfriendly and disagreeable
|-
| 0-9 || is a dyed-in-the-wool quarreler, never missing a chance to lash out in verbal hostility

|- style="border-top: 3px solid #aaa"
! rowspan=6 | POLITENESS<br />Conflicts with DECORUM
| 91-100 || exhibits a refined politeness and is determined to keep the guiding rules of etiquette and decorum as if life itself depended on it
|-
| 76-90 || is very polite and observes appropriate rules of decorum when possible
|-
| 61-75 || is quite polite
|-
| 25-39 || could be considered rude
|-
| 10-24 || is very impolite and inconsiderate of propriety
|-
| 0-9 || is a vulgar being who does not care a lick for even the most basic rules of civilized living

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DISDAIN_ADVICE
| 91-100 || disdains even the best advice of associates and family, relying strictly on [his/her] own counsel
|-
| 76-90 || dislikes receiving advice, preferring to keep [his/her] own counsel
|-
| 61-75 || has a tendency to go it alone, without considering the advice of others
|-
| 25-39 || tends to ask others for help with difficult decisions
|-
| 10-24 || relies on the advice of others during decision making
|-
| 0-9 || is unable to make decisions without a great deal of input from others

|- style="border-top: 3px solid #aaa"
! rowspan=6 | BRAVERY
| 91-100 || is utterly fearless when confronted with danger, to the point of lacking common sense
|-
| 76-90 || is incredibly brave in the face of looming danger, perhaps a bit foolhardy
|-
| 61-75 || is brave in the face of imminent danger
|-
| 25-39 || is somewhat fearful in the face of imminent danger
|-
| 10-24 || has great trouble mastering fear when confronted by danger
|-
| 0-9 || is a coward, completely overwhelmed by fear when confronted with danger

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CONFIDENCE
| 91-100 || presupposes success in any venture requiring [his/her] skills with what could be called blind overconfidence
|-
| 76-90 || is extremely confident of [him/her]self in situations requiring [his/her] skills
|-
| 61-75 || is generally quite confident of [his/her] abilities when undertaking specific ventures
|-
| 25-39 || sometimes acts with little determination and confidence
|-
| 10-24 || lacks confidence in [his/her] abilities
|-
| 0-9 || has no confidence at all in [his/her] talent and abilities

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VANITY
| 91-100 || is completely wrapped up in [his/her] own appearance, abilities and other personal matters
|-
| 76-90 || is greatly pleased by [his/her] own looks and accomplishments
|-
| 61-75 || is pleased by [his/her] own appearance and talents
|-
| 25-39 || is not inherently proud of [his/her] talents and accomplishments
|-
| 10-24 || takes no pleasure in [his/her] talents and appearance
|-
| 0-9 || could not care less about [his/her] appearance, talents or other personal vanities

|- style="border-top: 3px solid #aaa"
! rowspan=6 | AMBITION
| 91-100 || has a relentless drive, completely consumed by ambition
|-
| 76-90 || is very ambitious, always looking for a way to better [his/her] situation
|-
| 61-75 || is quite ambitious
|-
| 25-39 || isn't particularly ambitious
|-
| 10-24 || is not driven and rarely feels the need to pursue even a modest success
|-
| 0-9 || has no ambition whatsoever

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GRATITUDE
| 91-100 || unerringly returns favors and has a profound sense of gratitude for the kind actions of others
|-
| 76-90 || feels a strong need to reciprocate any favor done for [him/her]
|-
| 61-75 || is grateful when others help [him/her] out and tries to return favors
|-
| 25-39 || takes offered help and gifts without feeling particularly grateful
|-
| 10-24 || accepts favors without developing a sense of obligation, preferring to act as the current situation demands
|-
| 0-9 || does not feel the slightest need to reciprocate favors that others do for [him/her], no matter how major the help or how much [he/she] needed it

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODESTY
| 91-100 || always presents [him/her]self as extravagantly as possible, displaying a magnificent image to the world
|-
| 76-90 || likes to present [him/her]self boldly, even if it would offend an average sense of modesty
|-
| 61-75 || doesn't mind wearing something special now and again
|-
| 25-39 || prefers to present [him/her]self modestly
|-
| 10-24 || presents [him/her]self modestly and frowns on any flashy accoutrements
|-
| 0-9 || cleaves to an austere lifestyle, disdaining even minor immodesties in appearance

|- style="border-top: 3px solid #aaa"
! rowspan=6 | HUMOR
| 91-100 || finds something humorous in everything, no matter how serious or inappropriate
|-
| 76-90 || finds the humor in most situations
|-
| 61-75 || has an active sense of humor
|-
| 25-39 || has little interest in joking around
|-
| 10-24 || does not find most jokes humorous
|-
| 0-9 || is utterly humorless

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VENGEFUL
| 91-100 || is vengeful and never forgets or forgives past grievances
|-
| 76-90 || has little time for forgiveness and will generally seek retribution
|-
| 61-75 || tends to hang on to grievances
|-
| 25-39 || doesn't tend to hold on to grievances
|-
| 10-24 || does not generally seek retribution for past wrongs
|-
| 0-9 || has no sense of vengeance or retribution

|- style="border-top: 3px solid #aaa"
! rowspan=6 | PRIDE
| 91-100 || is absorbed in delusions of self-importance
|-
| 76-90 || has an overinflated sense of self-worth
|-
| 61-75 || thinks [he/she] is fairly important in the grand scheme of things
|-
| 25-39 || is very humble
|-
| 10-24 || has a low sense of self-esteem
|-
| 0-9 || is completely convinced of [his/her] own worthlessness

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CRUELTY<br />Conflicts with POWER
| 91-100 || is deliberately cruel to those unfortunate enough to be subject to [his/her] sadism
|-
| 76-90 || is sometimes cruel
|-
| 61-75 || generally acts impartially and is rarely moved to mercy
|-
| 25-39 || often acts with compassion
|-
| 10-24 || is easily moved to mercy
|-
| 0-9 || always acts with mercy and compassion at the forefront of [his/her] considerations

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SINGLEMINDED
| 91-100 || pursues matters with a single-minded focus, often overlooking other matters
|-
| 76-90 || can be very single-minded
|-
| 61-75 || generally acts with a narrow focus on the current activity
|-
| 25-39 || can occasionally lose focus on the matter at hand
|-
| 10-24 || is somewhat scatterbrained
|-
| 0-9 || is a complete scatterbrain, unable to focus on a single matter for more than a passing moment

|- style="border-top: 3px solid #aaa"
! rowspan=6 | HOPEFUL
| 91-100 || has such a developed sense of optimism that [he/she] always assumes the best outcome will eventually occur, no matter what
|-
| 76-90 || is an optimist
|-
| 61-75 || generally finds [him/her]self quite hopeful about the future
|-
| 25-39 || tends to assume the worst of two outcomes will be the one that comes to pass
|-
| 10-24 || is a pessimist
|-
| 0-9 || despairs of anything positive happening in the future and lives without feelings of hope

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CURIOUS
| 91-100 || is implacably curious, without any respect for propriety or privacy
|-
| 76-90 || is very curious, sometimes to [his/her] detriment
|-
| 61-75 || is curious and eager to learn
|-
| 25-39 || isn't particularly curious about the world
|-
| 10-24 || is very rarely moved by curiosity
|-
| 0-9 || is incurious and never seeks out knowledge or information to satisfy [him/her]self

|- style="border-top: 3px solid #aaa"
! rowspan=6 | BASHFUL
| 91-100 || is gripped by a crippling shyness
|-
| 76-90 || is bashful
|-
| 61-75 || tends to consider what others think of [him/her]
|-
| 25-39 || is not particularly interested in what others think of [him/her]
|-
| 10-24 || is generally unhindered by the thoughts of others concerning [his/her] actions
|-
| 0-9 || is shameless, absolutely unfazed by the thoughts of others

|- style="border-top: 3px solid #aaa"
! rowspan=6 | PRIVACY<br />Conflicts with STOICISM
| 91-100 || shares intimate details of life without sparing a thought to repercussions or propriety
|-
| 76-90 || is not a private person and freely shares details of [his/her] life
|-
| 61-75 || tends to share [his/her] own experiences and thoughts with others
|-
| 25-39 || tends not to reveal personal information
|-
| 10-24 || has a strong tendency toward privacy
|-
| 0-9 || is private to the point of paranoia, unwilling to reveal even basic information about [him/her]self

|- style="border-top: 3px solid #aaa"
! rowspan=6 | PERFECTIONIST
| 91-100 || is obsessed with details and will often take a great deal of extra time to make sure things are done the right way
|-
| 76-90 || is a perfectionist
|-
| 61-75 || tries to do things correctly each time
|-
| 25-39 || doesn't try to get things done perfectly
|-
| 10-24 || is inattentive to detail in [his/her] own work
|-
| 0-9 || is frustratingly sloppy and careless with every task [he/she] sets to carry out

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CLOSEMINDED
| 91-100 || is completely closed-minded and never changes [his/her] mind after forming an initial idea
|-
| 76-90 || is intellectually stubborn, rarely changing [his/her] mind during a debate regardless of the merits
|-
| 61-75 || tends to be a bit stubborn in changing [his/her] mind about things
|-
| 25-39 || doesn't cling tightly to ideas and is open to changing [his/her] mind
|-
| 10-24 || often finds [him/her]self changing [his/her] mind to agree with somebody else
|-
| 0-9 || easily changes [his/her] mind and will generally go with the prevailing view on anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | TOLERANT
| 91-100 || is not bothered in the slightest by deviations from the norm or even extreme differences in lifestyle or appearance
|-
| 76-90 || is very comfortable around others that are different from [him/her]
|-
| 61-75 || is quite comfortable with others that have a different appearance or culture
|-
| 25-39 || is somewhat uncomfortable around those that appear unusual or live differently from [him/her]
|-
| 10-24 || is made deeply uncomfortable by differences in culture or appearance
|-
| 0-9 || cannot tolerate differences in culture, lifestyle or appearance

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALLY_OBSESSIVE
| 91-100 || is emotionally obsessive, forming life-long attachments even if they aren't reciprocated
|-
| 76-90 || forms strong emotional bonds with others, at times to [his/her] detriment
|-
| 61-75 || has a tendency toward forming deep emotional bonds with others
|-
| 25-39 || tends to form only tenuous emotional bonds with others
|-
| 10-24 || forms only fleeting and rare emotional bonds with others
|-
| 0-9 || does not have feelings of emotional attachment and has never felt even a moment's connection with another being

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SWAYED_BY_EMOTIONS
| 91-100 || is buffeted by others' emotions and can't help but to respond to them
|-
| 76-90 || is swayed by emotional appeals
|-
| 61-75 || tends to be swayed by the emotions of others
|-
| 25-39 || tends not to be swayed by emotional appeals
|-
| 10-24 || does not generally respond to emotional appeals
|-
| 0-9 || is never moved by the emotions of others

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM<br />Conflicts with SACRIFICE
| 91-100 || is truly fulfilled by assisting those in need
| rowspan=3 | Receives [[Happy Thought]] from recovering wounded.
|-
| 76-90 || finds helping others very emotionally rewarding
|-
| 61-75 || finds helping others emotionally rewarding
|-
| 25-39 || does not go out of [his/her] way to help others
|-
| 10-24 || dislikes helping others
| rowspan=2 | Receives [[Unhappy Thought]] from recovering wounded.
|-
| 0-9 || feels helping others is an imposition on [his/her] time

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS<br />Conflicts with LAW,<br />LOYALTY, and INDEPENDENCE
| 91-100 || has a profound sense of duty and obligation
|-
| 76-90 || has a strong sense of duty
|-
| 61-75 || has a sense of duty
|-
| 25-39 || finds obligations confining
|-
| 10-24 || dislikes obligations and will try to avoid being bound by them
|-
| 0-9 || hates vows, obligations, promises and other binding elements that could restrict [him/her]

|- style="border-top: 3px solid #aaa"
! rowspan=6 | THOUGHTLESSNESS
| 91-100 || never deliberates before acting, to the point of being considered thoughtless
|-
| 76-90 || doesn't generally think before acting
|-
| 61-75 || can sometimes act without deliberation
|-
| 25-39 || tends to think before acting
|-
| 10-24 || can get caught up in internal deliberations when action is necessary
|-
| 0-9 || never acts without prolonged deliberation, even to [his/her] own detriment and the harm of those around [him/her]

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91-100 || is obsessed with order and structure in [his/her] own life, with everything kept in its proper place
|-
| 76-90 || lives an orderly life, organized and neat
|-
| 61-75 || tries to keep [his/her] things orderly
|-
| 25-39 || tends to make a small mess with [his/her] own possessions
|-
| 10-24 || is sloppy with [his/her] living space
|-
| 0-9 || is completely oblivious to any conception of neatness and will just leave things strewn about without a care

|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91-100 || is naturally trustful of everybody
|-
| 76-90 || is very trusting
|-
| 61-75 || is trusting
|-
| 25-39 || is slow to trust others
|-
| 10-24 || does not trust others
|-
| 0-9 || sees others as selfish and conniving

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91-100 || truly treasures the company of others
|-
| 76-90 || enjoys being in crowds
|-
| 61-75 || enjoys the company of others
|-
| 25-39 || tends to avoid crowds
|-
| 10-24 || prefers to be alone
|-
| 0-9 || considers spending time alone much more important than associating with others

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91-100 || is assertive to the point of aggression, unwilling to let others get a word in edgewise when [he/she] has something to say
|-
| 76-90 || has an overbearing personality
|-
| 61-75 || is assertive
|-
| 25-39 || tends to be passive in discussions
|-
| 10-24 || only rarely tries to assert [him/her]self in conversation
|-
| 0-9 || would never under any circumstances speak up or otherwise put forth [his/her] point of view in a discussion

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| 91-100 || is driven by a bouncing frenetic energy
|-
| 76-90 || lives at a high-energy kinetic pace
|-
| 61-75 || lives a fast-paced life
|-
| 25-39 || likes to take it easy
|-
| 10-24 || lives at a slow-going and leisurely pace
|-
| 0-9 || has an utterly languid pace of easy living, calm and slow

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING<br />Conflicts with TRANQUILITY
| 91-100 || never fails to seek out the most stressful and even dangerous situations
|-
| 76-90 || seeks out exciting and adventurous situations
|-
| 61-75 || likes a little excitement now and then
|-
| 25-39 || doesn't seek out excitement
|-
| 10-24 || actively avoids exciting or stressful situations
|-
| 0-9 || does everything in [his/her] power to avoid excitement and stress

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91-100 || is bored by reality and would rather disappear utterly and forever into a world of made-up fantasy
|-
| 76-90 || is given to flights of fancy to the point of distraction
|-
| 61-75 || has an active imagination
|-
| 25-39 || isn't given to flights of fancy
|-
| 10-24 || is grounded in reality
|-
| 0-9 || is interested only in facts and the real world

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ABSTRACT_INCLINED
| 91-100 || eschews practical concerns for philosophical discussion, puzzles, riddles and the world of ideas
|-
| 76-90 || strongly prefers discussions of ideas and abstract concepts over handling specific practical issues
|-
| 61-75 || has a tendency to consider ideas and abstractions over practical applications
|-
| 25-39 || likes to keep things practical, without delving too deeply into the abstract
|-
| 10-24 || dislikes abstract discussions and would much rather focus on practical examples
|-
| 0-9 || is concerned only with matters practical to the situation at hand, with absolutely no inclination toward abstract discussion

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ART_INCLINED<br />Conflicts with ARTWORK<br />and NATURE
| 91-100 || can easily become absorbed in art and the beauty of the natural world
|-
| 76-90 || greatly moved by art and natural beauty
|-
| 61-75 || is moved by art and natural beauty
|-
| 25-39 || does not have a great aesthetic sensitivity
|-
| 10-24 || is not readily moved by art or natural beauty
|-
| 0-9 || is completely unmoved by art or the beauty of nature

|}

{{Category|Dwarves}}
{{Category|Modding}}
{{Category|Tokens}}

Creature token

2015-12-02T20:01:32Z

FortressBuilder: Add basic 0.42.01 tags

{{Quality|Fine|18:45, 26 August 2014 (UTC)}}
{{av}}

A full list of all known creature tokens.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants. It appears that the basic requirements for adoption are intact; for example, the creature is more likely to adopt an owner which likes creatures of that species.{{verify}}

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Creature needs alcohol to get through the working day, choosing to drink booze instead of water if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| {{text anchor|ALTTILE}}
| Creature
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Instead of charging relentlessly at prey, a creature with this tag will wait till the prey is within a few squares before charging.{{verify}}

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe with or without [[water]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Caste
|
*Range
| [http://www.bay12forums.com/smf/index.php?topic=60554.msg1766793#msg1766793 Forum post describing how description ranges work]

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Caste
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

|-
| {{text anchor|APP_MOD_IMPORTANCE}}
| Caste
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| {{text anchor|APP_MOD_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| {{text anchor|APP_MOD_RATE}}
| Caste
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Special
|
*CV TEMPLATE NAME
| Applies the specified [[creature variation token|creature variation]].

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending [[#CV_ADD_TAG|CV_ADD_TAG]] and [[#CV_REMOVE_TAG|CV_REMOVE_TAG]] tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Creature can breathe in water, but air-drowns on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Does not appear in arena mode list.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Can be kept in artificial hives by beekeepers.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Does not attack or frighten creatures with the NATURAL tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
| pop:exported wealth:created wealth
| Specifies when a [[megabeast]] will attack the fortress.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|BABY}}
| Caste
| integer
| Age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
| integer
| [[Whale]]s and [[Sea nettle jellyfish|jellyfish]] have this. Controls the beaching frequency of the creature.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default and will never automatically be engaged by companions or soldiers. It will run away from any creatures that are not friendly to it.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[Biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Seems to be required to make the creature denouncable as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a [[Purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
| PlanName, PlanName:type:type:type:etc.
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A [[Purring maggot|maggot]] would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
| years:days:size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a [[minotaur]]. His birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old he would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) he would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.

|-
| {{text anchor|BODYGLOSS}}
| Caste
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies CARNIVORE.

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
|

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains skills and can have professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can talk. Note that it is not necessary for a creature to gain social skills. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste {{Verify}}
|
| Creature cannot climb, even if it has free grasps.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot jump.

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts as NOT_LIVING, except that [OPPOSED_TO_LIFE] creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open doors that are set to be unpassable for pets.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a caste.

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific ALT_TILE. Requires CASTE_TILE.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific COLOR.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific GLOWCOLOR.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific GLOWTILE.

|-
| {{text anchor|CASTE_NAME}}
| Caste
| singular:plural:adjective
| Caste-specific NAME.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific PROFESSION_NAME.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
| 'character' or tile number
| Caste-specific SOLDIER_ALTTILE. Requires CASTE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
| 'character' or tile number
| Caste-specific CREATURE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
| speech file
| Caste-specific SPEECH.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific CREATURE_TILE.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
| Varies
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
| integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
| integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage.

|-
| {{text anchor|CHILDNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of eggs laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
| foreground:background:brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| Any civilization with USE_COMMON_DOMESTIC tag (humans, dwarves) has domesticated this creature by default and always has access to it, even without any wild populations. Useless without PET, PACK_ANIMAL, WAGON_PULLER or MOUNT tags and invalid on FANCIFUL creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used for mussels, for one.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is 'berserk' and will attack all other creatures, except members of its own species that ALSO have the CRAZED tag.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes) and EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens). A single creature can have multiple classes. Eligibility for certain entity positions can also be permitted or restricted by this tag.

|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets if the creature is active at twilight.

|-
| {{text anchor|CURIOUSBEAST_EATER}}
| Caste
|
| Allows a creature to steal and eat edible items from a site.

|-
| {{text anchor|CURIOUSBEAST_GUZZLER}}
| Caste
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to steal things (apparently the highest value it can find). If the creature goes on rampages in worldgen, it will often steal items instead of attacking. Kea birds are infamous for this.

|-
| {{text anchor|CV_ADD_TAG}}
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|DESCRIPTION}}
| Caste
| text
| A brief description of the creature type.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Dies upon attacking. Used for [[bee]] stings.

|-
| {{text anchor|DIFFICULTY}}
| Caste
| integer
| Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets if the creature is active in day.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| Found on [[peregrine falcon]]s. The creature hunts vermin by diving from the air. Does not seem to work on tame creatures.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Creature does not actually exist; used for a few [[fanciful]] creatures of myth.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|EBO_ITEM}}
| Caste
| [[item token]]:[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being butchered. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
| gem shape
| The shape of the extra item of the creature upon butchering. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of eggs.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Civilizations with USE_EVIL_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when butchered (typically a gizzard stone), defined by EBO_ITEM and EBO_SHAPE.

|-
| {{text anchor|EXTRACT}}
| Caste
|
* [[material token]]
| Defines a creature extract which can be obtained via [[small animal dissection]].

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with {{token|COMMON_DOMESTIC|c}}

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on subterranean animal-man tribals.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|FEMALE}}
| Caste
|
| The creature is female and can bear young. Usually determined inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| The creature is immune to FIREBALL and FIREJET attacks.

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| The creature is immune to DRAGONFIRE attacks. Implies {{token|FIREIMMUNE|c}}.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| Needs to be cleaned at a fishery

|-
| {{text anchor|FIXED_TEMP}}
| Caste
| temperature
| The natural heat generated by the creature.

|-
| {{text anchor|FLEEQUICK}}
| Caste
|
| Determines how soon a creature flees in a losing battle. Creatures with this tag will flee at the first sign of resistance.

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. The game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|GAIT}}
| Caste
|
* type (WALK, CLIMB, SWIM, CRAWL, or FLY)
* gait name
* full speed
* build up time:max turning speed:start speed (or NO_BUILD_UP for instant use)
* energy use
* Optional flags:
** LAYERS_SLOW - if gait is slowed by increased weight
** STRENGTH - if gait is affected by strength stat
** AGILITY - if gait is affected by agility stat
** STEALTH_SLOWS:penalty - if gait is slowed by being stealthed
| Defines a gait at which the creature can move. See [[Gait]] for more information.

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
| singular:plural
| BABYNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
| singular:plural
| CHILDNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
| A:B
| Attacks against the creature have their force modified by A/B. For example, 1:2 will halve the force of an attack made against the creature. {{verify}}

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) [[titan]]s, [[Demon]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Creature can get infections from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| This creature's wounds can become infected if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's GLOWTILE.

|-
| {{text anchor|GLOWTILE}}
| Creature
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| {{text anchor|GNAWER}}
| Caste
| verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
| class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
| creature:caste
| The creature eats a specified vermin.

|-
| {{text anchor|GO_TO_END}}
| Special
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

|-
| {{text anchor|GO_TO_START}}
| Special
|
| When using tags from an existing creature, inserts new tags at the beginning of the creature.

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags after the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes. [[unicorn]]s for example. Civilizations with USE_GOOD_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
| value
| The value determines how rapidly grass is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
| target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer. If tamed in Fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. See [[Pasture]] for details on its issues.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|HABIT}}
| Caste
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, GIANT_NEST, and COLLECT_WEALTH. These require the creature to have a lair to work properly, and also don't seem to work on creatures who are not (SEMI)MEGABEASTs or NIGHT_CREATURE_HUNTERs.

|-
| {{text anchor|HABIT_NUM}}
| Caste
| number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".<sup>[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]]</sup> All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

|-
| {{text anchor|HASSHELL}}
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

|-
| {{text anchor|HFID}}
| Creature
| Integer (generic token?)
| Found on generated [[angel]]s. Seemingly identifies a historical figure with said hist figure ID, possibly to associate it with hist figure.

|-
| {{text anchor|HIVE_PRODUCT}}
| Creature
|
*number
*[[time]]
*[[item token]]s
| What product is harvested from [[Beekeeping industry|beekeeping]].

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
| Default 'NONE'. The creature's normal body [[temperature]]

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby vermin.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in Fortress Mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen)

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates fire. It will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of certain materials.

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for [CAN_SPEAK] + [CAN_LEARN] but additionally keeps creatures from being butchered by the AI during World-Gen and Post-Gen. In Fortress Mode CAN_LEARN is enough.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc.).

|-
| {{text anchor|ITEMCORPSE_QUALITY}}
| Caste
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|LAIR}}
| Caste
| type:probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays eggs instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays a particular item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| Creature has ligaments in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| The creature will generate light, such as in adventurer mode at night.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves. Retired as of v0.40.14.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz.")

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the range of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| {{text anchor|LOCAL_POPS_CONTROLLABLE}}{{version|0.42.01}}
|
|
|

|-
| {{text anchor|LOCAL_POPS_PRODUCE_HEROES}}{{version|0.42.01}}
|
|
|

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| {{text anchor|LOOSE_CLUSTERS}}
| Creature
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
| number
| Determines how well a creature can see in the dark. Higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|MAGICAL}}
| Caste
|
| Unknown.

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| Creature's able to see while covered in magma.

|-
| {{text anchor|MALE}}
| Caste
|
| The creature is male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
See [[Creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new material.{{verify}}

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*A:B
| Set the force multiplier of a specific material against the creature to A/B. For example, 10:1 multiplies the force by 10. {{verify}}

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets if the creature is active in dawn.

|-
| {{text anchor|MAXAGE}}
| Caste
| min:max
| Range of time in years in which death from old age may occur. Once a creature reaches the min value, it has a random chance each season of dying from old age. Unknown if the chance increases with further age. Note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Gives a creature random movement.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creature are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in Fortress Mode, they will have a pop-up message announcing their arrival.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher:highest
| Sets up a mental attribute's range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Mental attribute gain/decay rates. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked in the farmer's workshop. The frequency is the amount of time units the creature needs to "recharge".

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for MISCHIEVOUS.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a mount. No use for the player, but enemy siegers may arrive with cavalry.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a mount, but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste {{Verify}}
|
| Allows the creature to have all-around vision as long as it has multiple heads(?) that can see. {{Verify}}

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets using typical real-world human probabilities. Requires [[Creature_token#FEMALE|FEMALE]]. Compare with [[Creature_token#LITTERSIZE|LITTERSIZE]]. If LITTERSIZE and MULTIPLE_LITTER_RARE are both absent, one offspring is guaranteed per birth.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|NAME}}
| Creature
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. Creatures with AT_PEACE_WITH_WILDLIFE will not fight with them.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of NATURAL.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
| [[Skill_token|Skill token]]:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. A value of 16 is legendary. Requires CAN_LEARN or INTELLIGENT to function in .25 or earlier.

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Found on bogeymen. Creatures with this tag will join other bogeymen in attacking adventurers at night, and will also adopt their other behaviors, such as vanishing in smoke upon being killed. This does not affect the creature's presence elsewhere, such as for generated megabeasts, normal creatures, entity members, etc. Setting the number of bogeyman types to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| A very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

This tag causes the usual behaviour of [[werebeast]]s in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| This creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become dizzy.

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to eat.

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer fevers.

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| Creature has no gender.

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The affected caste cannot gain any physical skills.

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The affected caste cannot lose any physical skills.

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| This creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| This creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the [THOUGHT] tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| This creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets if the creature is active in night.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| The creature has no emotions, and does not rage.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never run away from battle.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when butchered.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when butchered.

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butcher, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce miasma when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy.{{verify}} If this creature must eat and drink while playing, it WILL die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Cannot be butchered

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead.

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a [THOUGHT] body part to survive. If it does not have NO_THOUGHT_CENTER_FOR_MOVEMENT as well, it will be unable to use any attacks other than the default 'push'. Has the added effect of preventing speech.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==O==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
| number
| How easy the creature is to smell. The higher the number, the easier the creature can be smelled. Zero is odorless. Default is 50.

|-
| {{text anchor|ODOR_STRING}}
| Caste
| string
| What the creature smells like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones. Used for [[Undead]].

|-
| {{text anchor|ORIENTATION}}
| Caste
| MALE/FEMALE:disinterested chance:lover-possible chance:commitment-possible chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will become lovers but not marry, the third decides if the creature will marry this sex. The values themselves are simply ratios and do not need to add up to any particular value.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}{{version|0.42.01}}
|
|
|

|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Currently only used by merchants without wagons. Also prevents creature from dropping hauled items on its own -- do not use for player-controllable creatures!

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all paralyzing special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Unknown. No creatures currently have this token.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate pearls. Does nothing in the current version.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin Dwarf Therapist, which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen without certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin Dwarf Therapist, which is completely unaffected by the tag.

|-
| {{text anchor|PETVALUE}}
| Caste
| value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher:highest
| Sets up a physical attribute's range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Physical attribute gain/decay rates. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after SET_BP_GROUP.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after SELECT_MATERIAL.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
| min:max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized.

|-
| {{text anchor|PREFSTRING}}
| Creature
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
| Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes badgers so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| The creature has pus. Specifies the stuff secreted by infected wounds.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
| singular:plural
| What creature's remains are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color creature's remains are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with VERMIN_BITE and DIE_WHEN_VERMIN_BITE, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from a creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*material token
| Removes a tissue from a creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part.

|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
|
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at his feet. Requires HUNTS_VERMIN, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventure Mode, spawns vermin edible by this creature in Fortress Mode.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes.

|-
| {{text anchor|SECRETION}}
| Caste
|
* [[material token]]
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
*trigger
| creates a secreted material on given tissue on a given part of the body. Valid triggers are:
*CONTINUOUS
*EXTREME_EMOTION
*EXERTION

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used after SELECT_CASTE.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*caste name, or ALL
| selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*Material token
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as MEGABEAST, but more of them are created during worldgen.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* Creature class
* [[Tilesets|Tile]]
* [[Color|Color]]
| Allows creature to sense creatures with a certain creature class through walls, floors etc. Sense will be with tile and color specified.

|-
| {{text anchor|SET_BP_GROUP}}
| Caste
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| Begins a selection of body parts.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
| [[skill_token]]:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
| percentage
| The rate at which this creature learns all skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
| [[skill_token]]:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
| [[skill_token]]:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
| value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for [CAN_LEARN] + [SKILL_LEARN_RATES:50].{{verify}} Used for ogres and giants. Applicable to player races. Prevents a player from recruiting nobility, even basic ones.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves a "remains" instead of a corpse. Used for vermin.

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
| value
| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The capybara '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature can will only graze or eat the designated plant or creature parts.

|-
| {{text anchor|SPEECH}}
| Creature
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in data\speech.

|-
| {{text anchor|SPEECH_FEMALE}}
| Creature
| speech file
| Boasting speeches relating to killing females of this creature.

|-
| {{text anchor|SPEECH_MALE}}
| Creature
| speech file
| Boasting speeches relating to killing males of this creature.

|-
| {{text anchor|SPHERE}}
| Creature
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the NIGHT_CREATURE_HUNTER tag, it will kidnap SPOUSE_CONVERSION_TARGETs and transform them into the caste of its species with the CONVERTED_SPOUSE tag during worldgen. It may also start families this way.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste {{verify}}
|
| Caste does not require GRASP body parts to climb -- it can climb with STANCE parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as GRAZER but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used in all default creature RAWs for grazers.

|-
| {{text anchor|STRANGE_MOODS}}{{version|0.42.01}}
|
|
|

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}{{version|0.42.01}}
|
|
|
|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's webs can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
| name
| Begins defining a tissue in the creature file.

|-
| {{text anchor|TITAN}}
| Caste
|
| Found on [[titan]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
| COLOR:freq:COLOR:freq etc.
| Creates a list of color patterns, giving each a relative frequency.

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by stonesense for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be trained as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be trained as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into martial trances.

|-
| {{text anchor|TRAPAVOID}}
| Caste
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. A single argument may be used instead of min and max. Only magma creatures use 4 or 5 in the default raws. [[Demon]]s use only 5:5; user-defined creatures with both this depth and [FLIER] will take part in the initial wave from the HFS alongside generated demons. Without [FLIER], they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| Creature swims under the water and can't be seen. Seems to be a relic from the 2D era.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| Typically found on generated [[demon]]s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be specified in user-defined raws.

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a SKULKING civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|VEGETATION}}
| Caste
|
| The creature is made of swamp stuff. Used for [[grimeling]]s.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
| Vermin bites, and injects something.

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See PENETRATEPOWER. Distinct from VERMIN_ROTTER.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in water and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by fishing.

|-
| {{text anchor|VERMIN_NOROAM}}
| Caste
|
| The creature will not be observed randomly roaming about the map.

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Attracted to rotting stuff left in the open. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud.

|-
| {{text anchor|VERMIN_SOIL_COLONY}}
| Creature
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets if the creature is active in evening.

|-
| {{text anchor|VIEWRANGE}}
| Caste
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste {{Verify}}
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs. The first number is binocular vision, the second is non-binocular vision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create webs, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
| 2nd person:3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
| number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
| interaction
| When this attack lands successfully, an interaction with I_SOURCE:ATTACK will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying properties of previously defined tissues. (See also [[Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.
[SELECT_TISSUE_LAYER:SKIN:BY_TYPE:UPPERBODY]

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
| Sets a tissue layer to be made of a different tissue.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man:<br>
[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
| Seems to set new relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[Body detail plan token]]
*[[Body token]]
*[[Material definition token]]
*[[Syndrome]]
*[[Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

Entity token

2015-12-02T19:38:22Z

FortressBuilder: /* Available Resources */ INSTRUMENT can actually still be used (see "raw/objects/examples and notes/item_instrument_example.txt")

{{Quality|Exceptional|19:21, 13 October 2015 (UTC)}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom entity can have a tier of 3000 and still work even if it's the only custom entity.

[ADVENTURE_TIER:4]

Removed in [[:Category:Version 0.42.01|Version 0.42.01]].

|-
| {{text anchor|ALL_MAIN_POPS_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

|-
| {{text anchor|SITE_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, then in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|CREATURE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing of on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]].
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max historical population '''per entity'''. Multiply this by max starting civ to get the total maximum historical population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations appear to be drawn randomly from all translation files{{verify}}.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, BATTLE, BRIDGE, CIV, LIBRARY{{version|0.42.01}}, MILITARY_UNIT, RELIGION, ROAD, SIEGE, SITE, TEMPLE, TUNNEL, VESSEL, WALL, WAR
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be prefered as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1.
[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can be any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

== Leadership ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

== Behavior ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's [[personality trait|cultural values]]. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|VARIABLE_VALUE}}{{version|0.42.01}}
|
*value or ALL
*min
*max
|

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the the defenders.

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s, and (unlike older versions) only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a land holder.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|-
| {{text anchor|GENERATE_KEYBOARD_INSTRUMENTS}}, {{text anchor|GENERATE_PERCUSSION_INSTRUMENTS}}, {{text anchor|GENERATE_STRINGED_INSTRUMENTS}}, {{text anchor|GENERATE_WIND_INSTRUMENTS}}, {{text anchor|GENERATE_DANCE_FORMS}}, {{text anchor|GENERATE_MUSICAL_FORMS}}, {{text anchor|GENERATE_POETIC_FORMS}}{{version|0.42.01}}
|
| Makes civilizations generate the given instruments/forms.

|-
| {{text anchor|SCHOLAR}}{{version|0.42.01}}
| scholar type
| ALL, ASTRONOMER, CHEMIST, DOCTOR, ENGINEER, GEOGRAPHER, HISTORIAN, MATHEMATICIAN, NATURALIST, PHILOSOPHER

|-
| {{text anchor|SET_SCHOLARS_ON_VALUES_AND_JOBS}}{{version|0.42.01}}
|
|

|}

== Available Resources ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal. For those cases, listing the pick under the [WEAPON] token works just as well.
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows civ to use indoor tree growths in the goods it has available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTH}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}

Announcements.txt

2015-12-02T16:38:44Z

FortressBuilder: /* List of announcements */ Add 0.42.01 announcements

{{Quality|Fine|03:01, 6 November 2013 (UTC)}}
{{av}}
{{old|Missing several announcements added in 0.40.xx}}
{{File|DF/data/init/announcements.txt}}
The '''announcements.txt''' file can be used to control the types of announcements displayed in Dwarf Fortress and how they are displayed in various modes. This can often be useful to stop recentering on birth announcements, for example.

== Syntax ==
['''ANNOUNCEMENT NAME''''':option:option''...]
=== Available options ===
{| class="wikitable"
|-
! Option
! Description
! Notes
|-
| {{text anchor|D_D}} or {{text anchor|D_DISPLAY}}
| Causes the announcement to be displayed at the bottom of the screen in [[Fortress mode]] (and be viewable in the {{k|a}}nnouncements list).
| The default for [[Announcement#Minor announcements|minor announcements]] including profession changes, [[weather]], job cancellations, and striking new minerals while [[mining]].
|-
| {{text anchor|A_D}} or {{text anchor|A_DISPLAY}}
| Causes the announcement to be displayed at the bottom of the screen in [[Adventure mode]] (and be viewable in the {{k|a}}nnouncements list).
|
|-
| {{text anchor|P}} or {{text anchor|PAUSE}}
| Pauses the game when the announcement occurs.
|
|-
| {{text anchor|R}} or {{text anchor|RECENTER}}
| Recenters the game to the location of the announcement when the announcement occurs.
| Commonly used for [[baby|births]], [[caravan]] arrivals, and [[ambush]]es. Use of this without the [[#PAUSE|pause]] option is not recommended, since your screen will recenter without warning.
|-
| {{text anchor|BOX}} or {{text anchor|DO_MEGA}}
| Causes a box to appear in the middle of the screen, requiring {{k|Enter}} to close it.
| This is often used with [[Announcement#Game-changing announcements|game-changing announcements]].
|-
| {{text anchor|UCR}} or {{text anchor|UNIT_COMBAT_REPORT}}
| Causes the announcement to appear in all [[reports]]. A new report will be created if none are active.
| Commonly used for adventure mode combat moves.
|-
| {{text anchor|UCR_A}} or {{text anchor|UNIT_COMBAT_REPORT_ALL_ACTIVE}}
| Nearly identical to [[#UCR|UNIT_COMBAT_REPORT]], but does not create a new report if none are active.
|
|}

== List of announcements ==
{| class="wikitable sortable"
|-
! Announcement
! Description/Notes
|-
| {{text anchor|REACHED_PEAK}}
| rowspan=2 | See [[calendar]]
|-
| {{text anchor|ERA_CHANGE}}
|-
| {{text anchor|ENDGAME_EVENT_1}}
|
|-
| {{text anchor|ENDGAME_EVENT_2}}
|
|-
| {{text anchor|FEATURE_DISCOVERY}}
| Discovery of [[cavern]]s and their various features
|-
| {{text anchor|STRUCK_DEEP_METAL}}
| Striking [[adamantine]]
|-
| {{text anchor|STRUCK_MINERAL}}
| rowspan=2 | Striking a mineral while [[mining]]
|-
| {{text anchor|STRUCK_ECONOMIC_MINERAL}}
|-
| {{text anchor|COMBAT_TWIST_WEAPON}}
| rowspan=43 | Used in [[combat]], most often in [[adventure mode]] (also in the [[arena]])
|-
| {{text anchor|COMBAT_LET_ITEM_DROP}}
|-
| {{text anchor|COMBAT_START_CHARGE}}
|-
| {{text anchor|COMBAT_SURPRISE_CHARGE}}
|-
| {{text anchor|COMBAT_JUMP_DODGE_PROJ}}
|-
| {{text anchor|COMBAT_JUMP_DODGE_STRIKE}}
|-
| {{text anchor|COMBAT_DODGE}}
|-
| {{text anchor|COMBAT_COUNTERSTRIKE}}
|-
| {{text anchor|COMBAT_BLOCK}}
|-
| {{text anchor|COMBAT_PARRY}}
|-
| {{text anchor|COMBAT_CHARGE_COLLISION}}
|-
| {{text anchor|COMBAT_CHARGE_DEFENDER_TUMBLES}}
|-
| {{text anchor|COMBAT_CHARGE_DEFENDER_KNOCKED_OVER}}
|-
| {{text anchor|COMBAT_CHARGE_ATTACKER_TUMBLES}}
|-
| {{text anchor|COMBAT_CHARGE_ATTACKER_BOUNCE_BACK}}
|-
| {{text anchor|COMBAT_CHARGE_TANGLE_TOGETHER}}
|-
| {{text anchor|COMBAT_CHARGE_TANGLE_TUMBLE}}
|-
| {{text anchor|COMBAT_CHARGE_RUSH_BY}}
|-
| {{text anchor|COMBAT_CHARGE_MANAGE_STOP}}
|-
| {{text anchor|COMBAT_CHARGE_OBSTACLE_SLAM}}
|-
| {{text anchor|COMBAT_WRESTLE_LOCK}}
|-
| {{text anchor|COMBAT_WRESTLE_CHOKEHOLD}}
|-
| {{text anchor|COMBAT_WRESTLE_TAKEDOWN}}
|-
| {{text anchor|COMBAT_WRESTLE_THROW}}
|-
| {{text anchor|COMBAT_WRESTLE_RELEASE_LOCK}}
|-
| {{text anchor|COMBAT_WRESTLE_RELEASE_CHOKE}}
|-
| {{text anchor|COMBAT_WRESTLE_RELEASE_GRIP}}
|-
| {{text anchor|COMBAT_WRESTLE_STRUGGLE}}
|-
| {{text anchor|COMBAT_WRESTLE_RELEASE_LATCH}}
|-
| {{text anchor|COMBAT_WRESTLE_STRANGLE_KO}}
|-
| {{text anchor|COMBAT_WRESTLE_ADJUST_GRIP}}
|-
| {{text anchor|COMBAT_GRAB_TEAR}}
|-
| {{text anchor|COMBAT_STRIKE_DETAILS}}
|-
| {{text anchor|COMBAT_STRIKE_DETAILS_2}}
|-
| {{text anchor|COMBAT_EVENT_ENRAGED}}
|-
| {{text anchor|COMBAT_EVENT_STUCKIN}}
|-
| {{text anchor|COMBAT_EVENT_LATCH_BP}}
|-
| {{text anchor|COMBAT_EVENT_LATCH_GENERAL}}
|-
| {{text anchor|COMBAT_EVENT_PROPELLED_AWAY}}
|-
| {{text anchor|COMBAT_EVENT_KNOCKED_OUT}}
|-
| {{text anchor|COMBAT_EVENT_STUNNED}}
|-
| {{text anchor|COMBAT_EVENT_WINDED}}
|-
| {{text anchor|COMBAT_EVENT_NAUSEATED}}
|-
| {{text anchor|MIGRANT_ARRIVAL_NAMED}}
|
|-
| {{text anchor|MIGRANT_ARRIVAL}}
| The arrival of [[migrants]]
|-
| {{text anchor|DIG_CANCEL_WARM}}
| rowspan=2 | The [[Main:Digging designation canceled|cancellation]] of a mining task due to potentially dangerous stone.
|-
| {{text anchor|DIG_CANCEL_DAMP}}
|-
| {{text anchor|AMBUSH_DEFENDER}}
|
|-
| {{text anchor|AMBUSH_RESIDENT}}
|
|-
| {{text anchor|AMBUSH_THIEF}}
|
|-
| {{text anchor|AMBUSH_THIEF_SUPPORT_SKULKING}}
|
|-
| {{text anchor|AMBUSH_THIEF_SUPPORT_NATURE}}
|
|-
| {{text anchor|AMBUSH_THIEF_SUPPORT}}
|
|-
| {{text anchor|AMBUSH_MISCHIEVOUS}}
|
|-
| {{text anchor|AMBUSH_SNATCHER}}
|
|-
| {{text anchor|AMBUSH_SNATCHER_SUPPORT}}
|
|-
| {{text anchor|AMBUSH_AMBUSHER_NATURE}}
|
|-
| {{text anchor|AMBUSH_AMBUSHER}}
|
|-
| {{text anchor|AMBUSH_INJURED}}
|
|-
| {{text anchor|AMBUSH_OTHER}}
|
|-
| {{text anchor|AMBUSH_INCAPACITATED}}
|
|-
| {{text anchor|CARAVAN_ARRIVAL}}
|
|-
| {{text anchor|NOBLE_ARRIVAL}}
|
|-
| {{text anchor|D_MIGRANTS_ARRIVAL}}
|
|-
| {{text anchor|D_MIGRANT_ARRIVAL}}
|
|-
| {{text anchor|D_MIGRANT_ARRIVAL_DISCOURAGED}}
|
|-
| {{text anchor|D_NO_MIGRANT_ARRIVAL}}
| The failure of [[migrants]] to show up in Fortress mode
|-
| {{text anchor|ANIMAL_TRAP_CATCH}}
|
|-
| {{text anchor|ANIMAL_TRAP_ROBBED}}
|
|-
| {{text anchor|MISCHIEF_LEVER}}
|
|-
| {{text anchor|MISCHIEF_PLATE}}
|
|-
| {{text anchor|MISCHIEF_CAGE}}
|
|-
| {{text anchor|MISCHIEF_CHAIN}}
|
|-
| {{text anchor|DIPLOMAT_ARRIVAL}}
|
|-
| {{text anchor|LIAISON_ARRIVAL}}
|
|-
| {{text anchor|TRADE_DIPLOMAT_ARRIVAL}}
|
|-
| {{text anchor|CAVE_COLLAPSE}}
|
|-
| {{text anchor|BIRTH_CITIZEN}}
|
|-
| {{text anchor|BIRTH_ANIMAL}}
|
|-
| {{text anchor|STRANGE_MOOD}}
|
|-
| {{text anchor|MADE_ARTIFACT}}
|
|-
| {{text anchor|NAMED_ARTIFACT}}
|
|-
| {{text anchor|ITEM_ATTACHMENT}}
|
|-
| {{text anchor|VERMIN_CAGE_ESCAPE}}
|
|-
| {{text anchor|TRIGGER_WEB}}
|
|-
| {{text anchor|MOOD_BUILDING_CLAIMED}}
|
|-
| {{text anchor|ARTIFACT_BEGUN}}
|
|-
| {{text anchor|MEGABEAST_ARRIVAL}}
|
|-
| {{text anchor|BERSERK_CITIZEN}}
|
|-
| {{text anchor|MAGMA_DEFACES_ENGRAVING}}
|
|-
| {{text anchor|ENGRAVING_MELTS}}
|
|-
| {{text anchor|MASTERPIECE_ARCHITECTURE}}
|
|-
| {{text anchor|MASTERPIECE_CONSTRUCTION}}
|
|-
| {{text anchor|MASTER_ARCHITECTURE_LOST}}
|
|-
| {{text anchor|MASTER_CONSTRUCTION_LOST}}
|
|-
| {{text anchor|ADV_AWAKEN}}
|
|-
| {{text anchor|ADV_SLEEP_INTERRUPTED}}
|
|-
| {{text anchor|ADV_REACTION_PRODUCTS}}
|
|-
| {{text anchor|CANCEL_JOB}}
| [[Job]] cancellations
|-
| {{text anchor|ADV_CREATURE_DEATH}}
|
|-
| {{text anchor|CITIZEN_DEATH}}
|
|-
| {{text anchor|PET_DEATH}}
| The death of a [[pet]], causing a negative [[thought]] for its owner
|-
| {{text anchor|FALL_OVER}}
|
|-
| {{text anchor|CAUGHT_IN_FLAMES}}
|
|-
| {{text anchor|CAUGHT_IN_WEB}}
|
|-
| {{text anchor|UNIT_PROJECTILE_SLAM_BLOW_APART}}
|
|-
| {{text anchor|UNIT_PROJECTILE_SLAM}}
|
|-
| {{text anchor|UNIT_PROJECTILE_SLAM_INTO_UNIT}}
|
|-
| {{text anchor|VOMIT}}
| [[Vomit]]
|-
| {{text anchor|LOSE_HOLD_OF_ITEM}}
|
|-
| {{text anchor|REGAIN_CONSCIOUSNESS}}
|
|-
| {{text anchor|FREE_FROM_WEB}}
|
|-
| {{text anchor|PARALYZED}}
|
|-
| {{text anchor|OVERCOME_PARALYSIS}}
|
|-
| {{text anchor|NOT_STUNNED}}
|
|-
| {{text anchor|EXHAUSTION}}
|
|-
| {{text anchor|PAIN_KO}}
|
|-
| {{text anchor|BREAK_GRIP}}
|
|-
| {{text anchor|NO_BREAK_GRIP}}
|
|-
| {{text anchor|BLOCK_FIRE}}
|
|-
| {{text anchor|BREATHE_FIRE}}
|
|-
| {{text anchor|SHOOT_WEB}}
|
|-
| {{text anchor|PULL_OUT_DROP}}
|
|-
| {{text anchor|STAND_UP}}
|
|-
| {{text anchor|MARTIAL_TRANCE}}
|
|-
| {{text anchor|MAT_BREATH}}
|
|-
| {{text anchor|NIGHT_ATTACK_STARTS}}
|
|-
| {{text anchor|NIGHT_ATTACK_ENDS}}
|
|-
| {{text anchor|NIGHT_ATTACK_TRAVEL}}
|
|-
| {{text anchor|GHOST_ATTACK}}
|
|-
| {{text anchor|LAIR_HUNTER}}
|
|-
| {{text anchor|TRAVEL_SITE_DISCOVERY}}
|
|-
| {{text anchor|TRAVEL_SITE_BUMP}}
|
|-
| {{text anchor|ADVENTURE_INTRO}}
|
|-
| {{text anchor|CREATURE_SOUND}}
|
|-
| {{text anchor|CREATURE_STEALS_OBJECT}}
|
|-
| {{text anchor|FOUND_TRAP}}
|
|-
| {{text anchor|BODY_TRANSFORMATION}}
|
|-
| {{text anchor|INTERACTION_ACTOR}}
|
|-
| {{text anchor|INTERACTION_TARGET}}
|
|-
| {{text anchor|UNDEAD_ATTACK}}
|
|-
| {{text anchor|CITIZEN_MISSING}}
|
|-
| {{text anchor|PET_MISSING}}
|
|-
| {{text anchor|MARKET_CHATTER}}
|
|-
| {{text anchor|STRANGE_RAIN_SNOW}}
| rowspan=2 | The appearance of unusual [[weather]]
|-
| {{text anchor|STRANGE_CLOUD}}
|-
| {{text anchor|SIMPLE_ANIMAL_ACTION}}
|
|-
| {{text anchor|FLOUNDER_IN_LIQUID}}
|
|-
| {{text anchor|TRAINING_DOWN_TO_SEMI_WILD}}
| A trained animal has reverted to a semi-wild state (Fortress mode). If the animal is not [[animal trainer|trained]] properly, it will become wild and possibly attack your dwarves.
|-
| {{text anchor|TRAINING_FULL_REVERSION}}
| An animal has reverted to a wild state (follows the previous announcement)
|-
| {{text anchor|ANIMAL_TRAINING_KNOWLEDGE}}
| See [[Animal trainer#Taming|Animal trainer]]
|-
| {{text anchor|SKIP_ON_LIQUID}}
|
|-
| {{text anchor|DODGE_FLYING_OBJECT}}
|
|-
| {{text anchor|REGULAR_CONVERSATION}}
|
|-
| {{text anchor|CONFLICT_CONVERSATION}}
|
|-
| {{text anchor|FLAME_HIT}}
|
|-
| {{text anchor|EMBRACE}}
|
|-
| {{text anchor|BANDIT_EMPTY_CONTAINER}}
|
|-
| {{text anchor|BANDIT_GRAB_ITEM}}
|
|-
| {{text anchor|COMBAT_EVENT_ATTACK_INTERRUPTED}}
|
|-
| {{text anchor|COMBAT_WRESTLE_CATCH_ATTACK}}
|
|-
| {{text anchor|FAIL_TO_GRAB_SURFACE}}
|
|-
| {{text anchor|LOSE_HOLD_OF_SURFACE}}
|
|-
| {{text anchor|TRAVEL_COMPLAINT}}
|
|-
| {{text anchor|LOSE_EMOTION}}
|
|-
| {{text anchor|REORGANIZE_POSSESSIONS}}
|
|-
| {{text anchor|PUSH_ITEM}}
|
|-
| {{text anchor|DRAW_ITEM}}
|
|-
| {{text anchor|STRAP_ITEM}}
|
|-
| {{text anchor|GAIN_SITE_CONTROL}}
|
|-
| {{text anchor|FORT_POSITION_SUCCESSION}}
|
|-
| {{text anchor|STRESSED_CITIZEN}}
|
|-
| {{text anchor|CITIZEN_LOST_TO_STRESS}}
|
|-
| {{text anchor|CITIZEN_TANTRUM}}
|
|-
| {{text anchor|MOVED_OUT_OF_RANGE}}
|
|-
| {{text anchor|CANNOT_JUMP}}
|
|-
| {{text anchor|NO_TRACKS}}
|
|-
| {{text anchor|ALREADY_SEARCHED_AREA}}
|
|-
| {{text anchor|SEARCH_FOUND_SOMETHING}}
|
|-
| {{text anchor|SEARCH_FOUND_NOTHING}}
|
|-
| {{text anchor|NOTHING_TO_INTERACT}}
|
|-
| {{text anchor|NOTHING_TO_EXAMINE}}
|
|-
| {{text anchor|YOU_YIELDED}}
|
|-
| {{text anchor|YOU_UNYIELDED}}
|
|-
| {{text anchor|YOU_STRAP_ITEM}}
|
|-
| {{text anchor|YOU_DRAW_ITEM}}
|
|-
| {{text anchor|NO_GRASP_TO_DRAW_ITEM}}
|
|-
| {{text anchor|NO_ITEM_TO_STRAP}}
|
|-
| {{text anchor|NO_INV_TO_REMOVE}}
|
|-
| {{text anchor|NO_INV_TO_WEAR}}
|
|-
| {{text anchor|NO_INV_TO_EAT}}
|
|-
| {{text anchor|NO_INV_TO_CONTAIN}}
|
|-
| {{text anchor|NO_INV_TO_DROP}}
|
|-
| {{text anchor|NOTHING_TO_PICK_UP}}
|
|-
| {{text anchor|NO_INV_TO_THROW}}
|
|-
| {{text anchor|NO_INV_TO_FIRE}}
|
|-
| {{text anchor|CURRENT_SMELL}}
|
|-
| {{text anchor|CURRENT_WEATHER}}
|
|-
| {{text anchor|CURRENT_TEMPERATURE}}
|
|-
| {{text anchor|CURRENT_DATE}}
|
|-
| {{text anchor|NO_GRASP_FOR_PICKUP}}
|
|-
| {{text anchor|TRAVEL_ADVISORY}}
|
|-
| {{text anchor|CANNOT_CLIMB}}
|
|-
| {{text anchor|CANNOT_STAND}}
|
|-
| {{text anchor|MUST_UNRETRACT_FIRST}}
|
|-
| {{text anchor|CANNOT_REST}}
|
|-
| {{text anchor|CANNOT_MAKE_CAMPFIRE}}
|
|-
| {{text anchor|MADE_CAMPFIRE}}
|
|-
| {{text anchor|CANNOT_SET_FIRE}}
|
|-
| {{text anchor|SET_FIRE}}
|
|-
| {{text anchor|DAWN_BREAKS}}
|
|-
| {{text anchor|NOON}}
|
|-
| {{text anchor|NIGHTFALL}}
|
|-
| {{text anchor|NO_INV_INTERACTION}}
|
|-
| {{text anchor|EMPTY_CONTAINER}}
|
|-
| {{text anchor|TAKE_OUT_OF_CONTAINER}}
|
|-
| {{text anchor|NO_CONTAINER_FOR_ITEM}}
|
|-
| {{text anchor|PUT_INTO_CONTAINER}}
|
|-
| {{text anchor|EAT_ITEM}}
|
|-
| {{text anchor|DRINK_ITEM}}
|
|-
| {{text anchor|CONSUME_FAILURE}}
|
|-
| {{text anchor|DROP_ITEM}}
|
|-
| {{text anchor|PICK_UP_ITEM}}
|
|-
| {{text anchor|YOU_BUILDING_INTERACTION}}
|
|-
| {{text anchor|YOU_ITEM_INTERACTION}}
|
|-
| {{text anchor|YOU_TEMPERATURE_EFFECTS}}
|
|-
| {{text anchor|RESOLVE_SHARED_ITEMS}}
|
|-
| {{text anchor|COUGH_BLOOD}}
|
|-
| {{text anchor|VOMIT_BLOOD}}
|
|-
| {{text anchor|POWER_LEARNED}}
|
|-
| {{text anchor|YOU_FEED_ON_SUCKEE}}
|
|-
| {{text anchor|PROFESSION_CHANGES}}
|
|-
| {{text anchor|RECRUIT_PROMOTED}}
|
|-
| {{text anchor|SOLDIER_BECOMES_MASTER}}
|
|-
| {{text anchor|MERCHANTS_UNLOADING}}
|
|-
| {{text anchor|MERCHANTS_NEED_DEPOT}}
|
|-
| {{text anchor|MERCHANT_WAGONS_BYPASSED}}
|
|-
| {{text anchor|MERCHANTS_LEAVING_SOON}}
|
|-
| {{text anchor|MERCHANTS_EMBARKED}}
|
|-
| {{text anchor|PET_LOSES_DEAD_OWNER}}
|
|-
| {{text anchor|PET_ADOPTS_OWNER}}
|
|-
| {{text anchor|VERMIN_BITE}}
|
|-
| {{text anchor|UNABLE_TO_COMPLETE_BUILDING}}
|
|-
| {{text anchor|JOBS_REMOVED_FROM_UNPOWERED_BUILDING}}
|
|-
| {{text anchor|CITIZEN_SNATCHED}}
|
|-
| {{text anchor|VERMIN_DISTURBED}}
|
|-
| {{text anchor|LAND_GAINS_STATUS}}
|
|-
| {{text anchor|LAND_ELEVATED_STATUS}}
|
|-
| {{text anchor|MASTERPIECE_CRAFTED}}
|
|-
| {{text anchor|ARTWORK_DEFACED}}
|
|-
| {{text anchor|ANIMAL_TRAINED}}
|
|-
| {{text anchor|DYED_MASTERPIECE}}
|
|-
| {{text anchor|COOKED_MASTERPIECE}}
|
|-
| {{text anchor|MANDATE_ENDS}}
|
|-
| {{text anchor|SLOWDOWN_ENDS}}
|
|-
| {{text anchor|FAREWELL_HELPER}}
|
|-
| {{text anchor|ELECTION_RESULTS}}
|
|-
| {{text anchor|SITE_PRESENT}}
|
|-
| {{text anchor|CONSTRUCTION_SUSPENDED}}
|
|-
| {{text anchor|LINKAGE_SUSPENDED}}
|
|-
| {{text anchor|QUOTA_FILLED}}
|
|-
| {{text anchor|JOB_OVERWRITTEN}}
|
|-
| {{text anchor|NOTHING_TO_CATCH_IN_WATER}}
|
|-
| {{text anchor|DEMAND_FORGOTTEN}}
|
|-
| {{text anchor|NEW_DEMAND}}
|
|-
| {{text anchor|NEW_MANDATE}}
|
|-
| {{text anchor|PRICES_ALTERED}}
|
|-
| {{text anchor|NAMED_RESIDENT_CREATURE}}
|
|-
| {{text anchor|SOMEBODY_GROWS_UP}}
|
|-
| {{text anchor|GUILD_REQUEST_TAKEN}}
|
|-
| {{text anchor|GUILD_WAGES_CHANGED}}
|
|-
| {{text anchor|NEW_WORK_MANDATE}}
|
|-
| {{text anchor|CITIZEN_BECOMES_SOLDIER}}
|
|-
| {{text anchor|CITIZEN_BECOMES_NONSOLDIER}}
|
|-
| {{text anchor|PARTY_ORGANIZED}}
|
|-
| {{text anchor|POSSESSED_TANTRUM}}
|
|-
| {{text anchor|BUILDING_TOPPLED_BY_GHOST}}
|
|-
| {{text anchor|MASTERFUL_IMPROVEMENT}}
|
|-
| {{text anchor|MASTERPIECE_ENGRAVING}}
|
|-
| {{text anchor|MARRIAGE}}
|
|-
| {{text anchor|NO_MARRIAGE_CELEBRATION}}
|
|-
| {{text anchor|CURIOUS_GUZZLER}}
|
|-
| {{text anchor|WEATHER_BECOMES_CLEAR}}
|
|-
| {{text anchor|WEATHER_BECOMES_SNOW}}
|
|-
| {{text anchor|WEATHER_BECOMES_RAIN}}
|
|-
| {{text anchor|SEASON_WET}}
|
|-
| {{text anchor|SEASON_DRY}}
|
|-
| {{text anchor|SEASON_SPRING}}
|
|-
| {{text anchor|SEASON_SUMMER}}
|
|-
| {{text anchor|SEASON_AUTUMN}}
|
|-
| {{text anchor|SEASON_WINTER}}
|
|-
| {{text anchor|GUEST_ARRIVAL}}{{version|0.42.01}}
|
|-
| {{text anchor|CANNOT_SPEAK}}{{version|0.42.01}}
|
|-
| {{text anchor|RESEARCH_BREAKTHROUGH}}{{version|0.42.01}}
|
|-
| {{text anchor|SERVICE_ORDER_DELIVERY}}{{version|0.42.01}}
|
|-
| {{text anchor|PERFORMANCE_START_FAILURE}}{{version|0.42.01}}
|
|-
| {{text anchor|BEGIN_ACTIVITY}}{{version|0.42.01}}
|
|-
| {{text anchor|MIDDLE_OF_ACTIVITY}}{{version|0.42.01}}
|
|-
| {{text anchor|ACTIVITY_SECTION_CHANGE}}{{version|0.42.01}}
|
|-
| {{text anchor|CONCLUDE_ACTIVITY}}{{version|0.42.01}}
|
|-
| {{text anchor|LEARNED_WRITTEN_CONTENT}}{{version|0.42.01}}
|
|-
| {{text anchor|LEARNED_ART_FORM}}{{version|0.42.01}}
|
|-
| {{text anchor|PERFORMER_UPDATE}}{{version|0.42.01}}
|
|-
| {{text anchor|BUILDING_DESTROYED_OR_TOPPLED}}{{version|0.42.01}}
|
|-
| {{text anchor|DEITY_CURSE}}{{version|0.42.01}}
|
|-
| {{text anchor|COMPOSITION_COMPLETE}}{{version|0.42.01}}
|
|-
| {{text anchor|COMPOSITION_FAILED}}{{version|0.42.01}}
|
|-
| {{text anchor|NEW_APPRENTICESHIP}}{{version|0.42.01}}
|
|-
| {{text anchor|PETITION_IGNORED}}{{version|0.42.01}}
|
|}

{{gamedata}}
{{files}}

Entity token

2015-12-02T16:31:37Z

FortressBuilder: /* Behavior */ VARIABLE_VALUE parameters

{{Quality|Exceptional|19:21, 13 October 2015 (UTC)}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom entity can have a tier of 3000 and still work even if it's the only custom entity.

[ADVENTURE_TIER:4]

Removed in [[:Category:Version 0.42.01|Version 0.42.01]].

|-
| {{text anchor|ALL_MAIN_POPS_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

|-
| {{text anchor|SITE_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, then in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|CREATURE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing of on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]].
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max historical population '''per entity'''. Multiply this by max starting civ to get the total maximum historical population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations appear to be drawn randomly from all translation files{{verify}}.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, BATTLE, BRIDGE, CIV, LIBRARY{{version|0.42.01}}, MILITARY_UNIT, RELIGION, ROAD, SIEGE, SITE, TEMPLE, TUNNEL, VESSEL, WALL, WAR
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be prefered as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1.
[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can be any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

== Leadership ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

== Behavior ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's [[personality trait|cultural values]]. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|VARIABLE_VALUE}}{{version|0.42.01}}
|
*value or ALL
*min
*max
|

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the the defenders.

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s, and (unlike older versions) only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a land holder.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|-
| {{text anchor|GENERATE_KEYBOARD_INSTRUMENTS}}, {{text anchor|GENERATE_PERCUSSION_INSTRUMENTS}}, {{text anchor|GENERATE_STRINGED_INSTRUMENTS}}, {{text anchor|GENERATE_WIND_INSTRUMENTS}}, {{text anchor|GENERATE_DANCE_FORMS}}, {{text anchor|GENERATE_MUSICAL_FORMS}}, {{text anchor|GENERATE_POETIC_FORMS}}{{version|0.42.01}}
|
| Makes civilizations generate the given instruments/forms.

|-
| {{text anchor|SCHOLAR}}{{version|0.42.01}}
| scholar type
| ALL, ASTRONOMER, CHEMIST, DOCTOR, ENGINEER, GEOGRAPHER, HISTORIAN, MATHEMATICIAN, NATURALIST, PHILOSOPHER

|-
| {{text anchor|SET_SCHOLARS_ON_VALUES_AND_JOBS}}{{version|0.42.01}}
|
|

|}

== Available Resources ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal. For those cases, listing the pick under the [WEAPON] token works just as well.
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

Removed in [[:Category:Version 0.42.01|Version 0.42.01]].

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows civ to use indoor tree growths in the goods it has available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTH}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}

Personality facet

2015-12-02T16:29:57Z

FortressBuilder: /* Beliefs */ Add new KNOWLEDGE value

{{Quality|Exceptional|16:12, 23 August 2014 (UTC)}}
{{av}}
__FORCETOC__
Dwarven '''personalities''' are determined by beliefs, goals, and facets. These are distinct from [[attributes]]. In general, personality traits do not have as important a gameplay effect as attributes, though many of the gameplay effects of personality traits are yet unknown.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

==Beliefs==

Each belief has a range from −50 to 50. The value triggers a report in "thoughts and preferences" depending on where it falls in these seven levels:

{| class="wikitable"
! Value Range !! Values in Range !! Probability !! Effect
|-
| +41 to +50 || 10 || 0.4% || Highest
|-
| +26 to +40 || 15 || 2% || Very High
|-
| +11 to +25 || 15 || 8.5% || High
|-
| −10 to +10 || 21 || 78% || Neutral
|-
| −25 to −11 || 15 || 8.5% || Low
|-
| −40 to −26 || 15 || 2% || Very Low
|-
| −50 to −41 || 10 || 0.4% || Lowest
|}

Beliefs are also influenced by cultural values via the use of the VALUE [[entity token]]. For example, dwarven civilizations hold craftsdwarfship in the highest regard, whereas goblins hold the ideas of fairness and sacrifice in utter disdain. If an individual dwarf's belief differs significantly from the civilization's beliefs, then that belief gets highlighted in cyan in the thought and personality screen.

Certain beliefs can conflict with personality facets — see below.

{| class="wikitable"
! Topic
! style="width:7em" | Value
! Description
|- style="border-top: 3px solid #aaa"
! rowspan=7 | LAW
| +41 to +50 || is an absolute believer in the rule of law
|-
| +26 to +40 || has a great deal of respect for the law
|-
| +11 to +25 || respects the law
|-
| −10 to +10 || doesn't feel strongly about the law
|-
| −25 to −11 || does not respect the law
|-
| −40 to −26 || disdains the law
|-
| −50 to −41 || finds the idea of laws abhorent

|- style="border-top: 3px solid #aaa"
! rowspan=7 | LOYALTY
| +41 to +50 || has the highest regard for loyalty
|-
| +26 to +40 || greatly prizes loyalty
|-
| +11 to +25 || values loyalty
|-
| −10 to +10 || doesn't particularly value loyalty
|-
| −25 to −11 || views loyalty unfavorably
|-
| −40 to −26 || disdains loyalty
|-
| −50 to −41 || is disgusted by the idea of loyalty

|- style="border-top: 3px solid #aaa"
! rowspan=7 | FAMILY
| +41 to +50 || sees family as one of the most important things in life
|-
| +26 to +40 || values family greatly
|-
| +11 to +25 || values family
|-
| −10 to +10 || does not care about family one way or the other
|-
| −25 to −11 || is put off by family
|-
| −40 to −26 || lacks any respect for family
|-
| −50 to −41 || finds the idea of family loathsome

|- style="border-top: 3px solid #aaa"
! rowspan=7 | FRIENDSHIP
| +41 to +50 || believes friendship is a key to the ideal life
|-
| +26 to +40 || sees friendship as one of the finer things in life
|-
| +11 to +25 || thinks friendship is important
|-
| −10 to +10 || does not care about friendship
|-
| −25 to −11 || finds friendship burdensome
|-
| −40 to −26 || is completely put off by the idea of friends
|-
| −50 to −41 || finds the whole idea of friendship disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | POWER
| +41 to +50 || believes that the acquisition of power over others is the ideal goal in life and worthy of the highest respect
|-
| +26 to +40 || sees power over others as something to strive for
|-
| +11 to +25 || respects power
|-
| −10 to +10 || doesn't find power particularly praiseworthy
|-
| −25 to −11 || has a negative view of those who exercise power over others
|-
| −40 to −26 || hates those who wield power over others
|-
| −50 to −41 || finds the acquisition and use of power abhorent and would have all masters toppled

|- style="border-top: 3px solid #aaa"
! rowspan=7 | TRUTH
| +41 to +50 || believes the truth is inviolable regardless of the cost
|-
| +26 to +40 || believes that honesty is a high ideal
|-
| +11 to +25 || values honesty
|-
| −10 to +10 || does not particularly value the truth
|-
| −25 to −11 || finds blind honesty foolish
|-
| −40 to −26 || sees lying as an important means to an end
|-
| −50 to −41 || is repelled by the idea of honesty and lies without compunction

|- style="border-top: 3px solid #aaa"
! rowspan=7 | CUNNING
| +41 to +50 || holds well-laid plans and shrewd deceptions in the highest regard
|-
| +26 to +40 || greatly respects the shrewd and guileful
|-
| +11 to +25 || values cunning
|-
| −10 to +10 || does not really value cunning and guile
|-
| −25 to −11 || sees guile and cunning as indirect and somewhat worthless
|-
| −40 to −26 || holds shrewd and crafty individuals in the lowest esteem
|-
| −50 to −41 || is utterly disgusted by guile and cunning

|- style="border-top: 3px solid #aaa"
! rowspan=7 | ELOQUENCE
| +41 to +50 || believes that artful speech and eloquent expression are of the highest ideals
|-
| +26 to +40 || deeply respects eloquent speakers
|-
| +11 to +25 || values eloquence
|-
| −10 to +10 || doesn't value eloquence so much
|-
| −25 to −11 || finds eloquence and artful speech off-putting
|-
| −40 to −26 || finds [him/her]self somewhat disgusted with eloquent speakers
|-
| −50 to −41 || sees artful speech and eloquence as a wasteful form of deliberate deception and treats it as such

|- style="border-top: 3px solid #aaa"
! rowspan=7 | FAIRNESS
| +41 to +50 || holds fairness as one of the highest ideals and despises cheating of any kind
|-
| +26 to +40 || has great respect for fairness
|-
| +11 to +25 || respects fair-dealing and fair-play
|-
| −10 to +10 || does not care about fairness
|-
| −25 to −11 || sees life as unfair and doesn't mind it that way
|-
| −40 to −26 || finds the idea of fair-dealing foolish and cheats when [he/she] finds it profitable
|-
| −50 to −41 || is disgusted by the idea of fairness and will freely cheat anybody at any time

|- style="border-top: 3px solid #aaa"
! rowspan=7 | DECORUM
| +41 to +50 || views decorum as a high ideal and is deeply offended by those that fail to maintain it
|-
| +26 to +40 || greatly respects those that observe decorum and maintain their dignity
|-
| +11 to +25 || values decorum, dignity and proper behavior
|-
| −10 to +10 || doesn't care very much about decorum
|-
| −25 to −11 || finds maintaining decorum a silly, fumbling waste of time
|-
| −40 to −26 || sees those that attempt to maintain dignified and proper behavior as vain and offensive
|-
| −50 to −41 || is affronted by the whole notion of maintaining decorum and finds so-called dignified people disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | TRADITION
| +41 to +50 || holds the maintenance of tradition as one of the highest ideals
|-
| +26 to +40 || is a firm believer in the value of tradition
|-
| +11 to +25 || values tradition
|-
| −10 to +10 || doesn't have any strong feelings about tradition
|-
| −25 to −11 || disregards tradition
|-
| −40 to −26 || finds the following of tradition foolish and limiting
|-
| −50 to −41 || is disgusted by tradition and would flout any [he/she] encounters if given a chance

|- style="border-top: 3px solid #aaa"
! rowspan=7 | ARTWORK
| +41 to +50 || believes that the creation and appreciation of artwork is one of the highest ideals
|-
| +26 to +40 || greatly respects artists and their works
|-
| +11 to +25 || values artwork
|-
| −10 to +10 || doesn't care about art one way or another
|-
| −25 to −11 || finds artwork boring
|-
| −40 to −26 || sees the whole pursuit of art as silly
|-
| −50 to −41 || finds art offensive and would have it destroyed whenever possible

|- style="border-top: 3px solid #aaa"
! rowspan=7 | COOPERATION
| +41 to +50 || places cooperation as one of the highest ideals
|-
| +26 to +40 || sees cooperation as very important in life
|-
| +11 to +25 || values cooperation
|-
| −10 to +10 || doesn't see cooperation as valuable
|-
| −25 to −11 || dislikes cooperation
|-
| −40 to −26 || views cooperation as a low ideal not worthy of any respect
|-
| −50 to −41 || is thoroughly disgusted by cooperation

|- style="border-top: 3px solid #aaa"
! rowspan=7 | INDEPENDENCE
| +41 to +50 || believes that freedom and independence are completely non-negotiable and would fight to defend them
|-
| +26 to +40 || treasures independence
|-
| +11 to +25 || values independence
|-
| −10 to +10 || doesn't really value independence one way or another
|-
| −25 to −11 || finds the ideas of independence and freedom somewhat foolish
|-
| −40 to −26 || sees freedom and independence as completely worthless
|-
| −50 to −41 || hates freedom and would crush the independent spirit wherever it is found

|- style="border-top: 3px solid #aaa"
! rowspan=7 | STOICISM
| +41 to +50 || views any show of emotion as offensive
|-
| +26 to +40 || thinks it is of the utmost importance to present a bold face and never grouse, complain or even show emotion
|-
| +11 to +25 || believes it is important to conceal emotions and refrain from complaining
|-
| −10 to +10 || doesn't see much value in being stoic
|-
| −25 to −11 || sees no value in holding back complaints and concealing emotions
|-
| −40 to −26 || feels that those who attempt to conceal their emotions are vain and foolish
|-
| −50 to −41 || sees concealment of emotions as a betrayal and tries [his/her] best never to associate with such secretive fools

|- style="border-top: 3px solid #aaa"
! rowspan=7 | INTROSPECTION
| +41 to +50 || feels that introspection and all forms of self-examination are the keys to a good life and worthy of respect
|-
| +26 to +40 || deeply values introspection
|-
| +11 to +25 || sees introspection as important
|-
| −10 to +10 || doesn't really see the value in self-examination
|-
| −25 to −11 || finds introspection to be a waste of time
|-
| −40 to −26 || thinks that introspection is valueless and those that waste time in self-examination are deluded fools
|-
| −50 to −41 || finds the whole idea of introspection completely offensive and contrary to the ideals of a life well-lived

|- style="border-top: 3px solid #aaa"
! rowspan=7 | SELF_CONTROL
| +41 to +50 || believes that self-mastery and the denial of impulses are of the highest ideals
|-
| +26 to +40 || finds moderation and self-control to be very important
|-
| +11 to +25 || values self-control
|-
| −10 to +10 || doesn't particularly value self-control
|-
| −25 to −11 || finds those that deny their impulses somewhat stiff
|-
| −40 to −26 || sees the denial of impulses as a vain and foolish pursuit
|-
| −50 to −41 || has abandoned any attempt at self-control and finds the whole concept deeply offensive

|- style="border-top: 3px solid #aaa"
! rowspan=7 | TRANQUILITY
| +41 to +50 || views tranquility as one of the highest ideals
|-
| +26 to +40 || strongly values tranquility and quiet
|-
| +11 to +25 || values tranquility and a peaceful day
|-
| −10 to +10 || doesn't have a preference between tranquility and tumult
|-
| −25 to −11 || prefers a noisy, bustling life to boring days without activity
|-
| −40 to −26 || is greatly disturbed by quiet and a peaceful existence
|-
| −50 to −41 || is disgusted by tranquility and would that the world would constantly churn with noise and activity

|- style="border-top: 3px solid #aaa"
! rowspan=7 | HARMONY
| +41 to +50 || would have the world operate in complete harmony without the least bit of strife or disorder
|-
| +26 to +40 || strongly believes that a peaceful and ordered society without dissent is best
|-
| +11 to +25 || values a harmonious existence
|-
| −10 to +10 || sees equal parts of harmony and discord as part of life
|-
| −25 to −11 || doesn't respect a society that has settled into harmony without debate and strife
|-
| −40 to −26 || can't fathom why anyone would want to live in an orderly and harmonious society
|-
| −50 to −41 || believes deeply that chaos and disorder are the truest expressions of life and would disrupt harmony wherever it is found

|- style="border-top: 3px solid #aaa"
! rowspan=7 | MERRIMENT
| +41 to +50 || believes that little is better in life than a good party
|-
| +26 to +40 || truly values merrymaking and parties
|-
| +11 to +25 || finds merrymaking and partying worthwhile activities
|-
| −10 to +10 || doesn't really value merrymaking
|-
| −25 to −11 || sees merrymaking as a waste
|-
| −40 to −26 || is disgusted by merrymakers
|-
| −50 to −41 || is appalled by merrymaking, parties and other such worthless activities

|- style="border-top: 3px solid #aaa"
! rowspan=7 | CRAFTSMANSHIP
| +41 to +50 || holds crafts[man]ship to be of the highest ideals and celebrates talented artisans and their masterworks
|-
| +26 to +40 || has a great deal of respect for worthy crafts[man]ship
|-
| +11 to +25 || values good crafts[man]ship
|-
| −10 to +10 || doesn't particularly care about crafts[man]ship
|-
| −25 to −11 || considers crafts[man]ship to be relatively worthless
|-
| −40 to −26 || sees the pursuit of good crafts[man]ship as a total waste
|-
| −50 to −41 || views crafts[man]ship with disgust and would desecrate a so-called masterwork or two if [he/she] could get away with it

|- style="border-top: 3px solid #aaa"
! rowspan=7 | MARTIAL_PROWESS
| +41 to +50 || believes that martial prowess defines the good character of an individual
|-
| +26 to +40 || deeply respects skill at arms
|-
| +11 to +25 || values martial prowess
|-
| −10 to +10 || does not really value skills related to fighting
|-
| −25 to −11 || finds those that develop skill with weapons and fighting distasteful
|-
| −40 to −26 || thinks that the pursuit of the skills of warfare and fighting is a low pursuit indeed
|-
| −50 to −41 || abhors those that pursue the mastery of weapons and skill with fighting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | SKILL
| +41 to +50 || believes that the mastery of a skill is one of the highest pursuits
|-
| +26 to +40 || really respects those that take the time to master a skill
|-
| +11 to +25 || respects the development of skill
|-
| −10 to +10 || doesn't care if others take the time to master skills
|-
| −25 to −11 || finds the pursuit of skill mastery off-putting
|-
| −40 to −26 || believes that the time taken to master a skill is a horrible waste
|-
| −50 to −41 || sees the whole idea of taking time to master a skill as appalling

|- style="border-top: 3px solid #aaa"
! rowspan=7 | HARD_WORK
| +41 to +50 || believes that hard work is one of the highest ideals and a key to the good life
|-
| +26 to +40 || deeply respects those that work hard at their labors
|-
| +11 to +25 || values hard work
|-
| −10 to +10 || doesn't really see the point of working hard
|-
| −25 to −11 || sees working hard as a foolish waste of time
|-
| −40 to −26 || thinks working hard is an abject idiocy
|-
| −50 to −41 || finds the proposition that one should work hard in life utterly abhorent

|- style="border-top: 3px solid #aaa"
! rowspan=7 | SACRIFICE
| +41 to +50 || finds sacrifice to be one of the highest ideals
|-
| +26 to +40 || believes that those who sacrifice for others should be deeply respected
|-
| +11 to +25 || values sacrifice
|-
| −10 to +10 || doesn't particularly respect sacrifice as a virtue
|-
| −25 to −11 || sees sacrifice as wasteful and foolish
|-
| −40 to −26 || finds sacrifice to be the height of folly
|-
| −50 to −41 || thinks that the entire concept of sacrifice for others is truly disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | COMPETITION
| +41 to +50 || holds the idea of competition among the most important and would encourage it wherever possible
|-
| +26 to +40 || views competition as a crucial driving force in the world
|-
| +11 to +25 || sees competition as reasonably important
|-
| −10 to +10 || doesn't have strong views on competition
|-
| −25 to −11 || sees competition as wasteful and silly
|-
| −40 to −26 || deeply dislikes competition
|-
| −50 to −41 || finds the very idea of competition obscene

|- style="border-top: 3px solid #aaa"
! rowspan=7 | PERSEVERENCE
| +41 to +50 || believes that perseverence is one of the greatest qualities somebody can have
|-
| +26 to +40 || greatly respects individuals that persevere through their trials and labors
|-
| +11 to +25 || respects perseverence
|-
| −10 to +10 || doesn't think much about the idea of perseverence
|-
| −25 to −11 || sees perseverence in the face of adversity as bull-headed and foolish
|-
| −40 to −26 || thinks there is something deeply wrong with people that persevere through adversity
|-
| −50 to −41 || finds the notion that one would persevere through adversity completely abhorent

|- style="border-top: 3px solid #aaa"
! rowspan=7 | LEISURE_TIME
| +41 to +50 || believes that it would be a fine thing if all time were leisure time
|-
| +26 to +40 || treasures leisure time and thinks it is very important in life
|-
| +11 to +25 || values leisure time
|-
| −10 to +10 || doesn't think one way or the other about leisure time
|-
| −25 to −11 || finds leisure time wasteful
|-
| −40 to −26 || is offended by leisure time and leisurely living
|-
| −50 to −41 || believes that those that take leisure time are evil and finds the whole idea disgusting

|- style="border-top: 3px solid #aaa"
! rowspan=7 | COMMERCE
| +41 to +50 || sees engaging in commerce as a high ideal in life
|-
| +26 to +40 || really respects commerce and those that engage in trade
|-
| +11 to +25 || respects commerce
|-
| −10 to +10 || doesn't particularly respect commerce
|-
| −25 to −11 || is somewhat put off by trade and commerce
|-
| −40 to −26 || finds those that engage in trade and commerce to be fairly disgusting
|-
| −50 to −41 || holds the view that commerce is a vile obscenity

|- style="border-top: 3px solid #aaa"
! rowspan=7 | ROMANCE
| +41 to +50 || sees romance as one of the highest ideals
|-
| +26 to +40 || thinks romance is very important in life
|-
| +11 to +25 || values romance
|-
| −10 to +10 || doesn't care one way or the other about romance
|-
| −25 to −11 || finds romance distasteful
|-
| −40 to −26 || is somewhat disgusted by romance
|-
| −50 to −41 || finds even the abstract idea of romance repellent

|- style="border-top: 3px solid #aaa"
! rowspan=7 | NATURE
| +41 to +50 || holds nature to be of greater value than most aspects of civilization
|-
| +26 to +40 || has a deep respect for animals, plants and the natural world
|-
| +11 to +25 || values nature
|-
| −10 to +10 || doesn't care about nature one way or another
|-
| −25 to −11 || finds nature somewhat disturbing
|-
| −40 to −26 || has a deep dislike of the natural world
|-
| −50 to −41 || would just as soon have nature and the great outdoors burned to ashes and converted into a great mining pit

|- style="border-top: 3px solid #aaa"
! rowspan=7 | PEACE
| +41 to +50 || believes the idea of war is utterly repellent and would have peace at all costs
|-
| +26 to +40 || believes that peace is always preferable to war
|-
| +11 to +25 || values peace over war
|-
| −10 to +10 || doesn't particularly care between war and peace
|-
| −25 to −11 || sees war as a useful means to an end
|-
| −40 to −26 || believes war is preferable to peace in general
|-
| −50 to −41 || thinks that the world should be engaged in perpetual warfare

|- style="border-top: 3px solid #aaa"
! rowspan=7 | KNOWLEDGE{{version|0.42.01}}
| +41 to +50 ||
|-
| +26 to +40 ||
|-
| +11 to +25 ||
|-
| −10 to +10 ||
|-
| −25 to −11 ||
|-
| −40 to −26 ||
|-
| −50 to −41 ||
|}

==Goals==
Some creatures dream of accomplishing certain goals in their life, and these goals can presumably affect their behavior. Dwarves will receive a happy thought upon completion of goals and receive the moniker of "and this goal was realized" in the personality description following their original goal. It is not certain yet whether goals are limited to one per entity.

If a creature has such dreams, they will be listed in the Thoughts and Preferences page.

{| class="wikitable"
! Token
! Description
! Gameplay effects
|- style="border-top: 3px solid #aaa"
! STAY_ALIVE
|
|- style="border-top: 3px solid #aaa"
! MAINTAIN_ENTITY_STATUS
|
|- style="border-top: 3px solid #aaa"
! START_A_FAMILY
| dreams of raising a family
| Goal completed upon giving birth/fathering an infant.
|- style="border-top: 3px solid #aaa"
! RULE_THE_WORLD
| dreams of ruling the world
|- style="border-top: 3px solid #aaa"
! CREATE_A_GREAT_WORK_OF_ART
| dreams of creating a great work of art
| Goal completed upon creation of Artifact or Masterpiece
|- style="border-top: 3px solid #aaa"
! CRAFT_A_MASTERWORK
| dreams of crafting a masterwork someday
| Goal completed upon creation of Artifact or Masterpiece
|- style="border-top: 3px solid #aaa"
! BRING_PEACE_TO_THE_WORLD
| dreams of bringing lasting peace to the world
|- style="border-top: 3px solid #aaa"
! BECOME_A_LEGENDARY_WARRIOR
| dreams of becoming a legendary warrior
|- style="border-top: 3px solid #aaa"
! MASTER_A_SKILL
| dreams of mastering a skill
| Goal completed upon reaching Legendary skill status.
|- style="border-top: 3px solid #aaa"
! FALL_IN_LOVE
| dreams of falling in love
|- style="border-top: 3px solid #aaa"
! SEE_THE_GREAT_NATURAL_SITES
| dreams of seeing the great natural places of the world
|- style="border-top: 3px solid #aaa"
! IMMORTALITY
|
| Leads to [[necromancer|necromancy]]
|}

If said goal has actually been fulfilled, the description will include "and this dream was realized".

==Facets==

Each personality facet has a value from 0 to 100. The value triggers a report in "thoughts and preferences" depending on where it falls in these seven levels:

{| class="wikitable"
! Value Range !! Values in Range !! Probability !! Effect
|-
| 91-100 || 10 || 0.4% || Highest
|-
| 76-90 || 15 || 2% || Very High
|-
| 61-75 || 15 || 8.5% || High
|-
| 40-60 || 21 || 78% || Neutral
|-
| 25-39 || 15 || 8.5% || Low
|-
| 10-24 || 15 || 2% || Very Low
|-
| 0-9 || 10 || 0.4% || Lowest
|}

The 40−60 range does not cause a report.

Facets are also influenced by species via the use of the PERSONALITY [[creature token]]. For example, dwarves are slightly more greedy than average with a median of 55 in that trait, whereas goblins aren't likely to help others out — their altruism median is a mere 25, and is capped at 50.

Facets also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad [[thought]]. Facets may have other, more subtle effects on creature behavior, which are currently not entirely understood.

Certain facets are capable of ''conflicting'' with the dwarf's beliefs. The effect of this is not yet known.

{| class="wikitable"
! Token
! style="width:7em" | Value
! Description
! Effects
|- style="border-top: 3px solid #aaa"
! rowspan=6 | LOVE_PROPENSITY<br />Conflicts with ROMANCE
| 91-100 || is always in love with somebody and easily develops positive feelings
|-
| 76-90 || very easily falls into love and develops positive feelings
|-
| 61-75 || can easily fall in love or develop positive sentiments
|-
| 25-39 || does not easily fall in love and rarely develops positive sentiments
|-
| 10-24 || is not the type to fall in love or even develop positive feelings
|-
| 0-9 || never falls in love or develops positive feelings toward anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | HATE_PROPENSITY
| 91-100 || is often inflamed by hatred and easily develops hatred toward things
|-
| 76-90 || is prone to hatreds and often develops negative feelings
|-
| 61-75 || is quick to form negative views about things
|-
| 25-39 || does not easily hate or develop negative feelings
|-
| 10-24 || very rarely develops negative feelings toward things
|-
| 0-9 || never feels hatred toward anyone or anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ENVY_PROPENSITY
| 91-100 || is consumed by overpowering feelings of jealousy
|-
| 76-90 || is prone to strong feelings of jealousy
|-
| 61-75 || often feels envious of others
|-
| 25-39 || doesn't often feel envious of others
|-
| 10-24 || is rarely jealous
|-
| 0-9 || never envies others their status, situation or possessions

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEER_PROPENSITY<br />Conflicts with MERRIMENT
| 91-100 || often feels filled with joy
|-
| 76-90 || can be very happy and optimistic
|-
| 61-75 || is often cheerful
|-
| 25-39 || is rarely happy or enthusiastic
|-
| 10-24 || is dour as a rule
|-
| 0-9 || is never the slightest bit cheerful about anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION_PROPENSITY
| 91-100 || is frequently depressed
| rowspan=3 | More likely to slip into [[depression]] and be [[Insane|stricken by melancholy]].
|-
| 76-90 || is often sad and dejected
|-
| 61-75 || often feels discouraged
|-
| 25-39 || rarely feels discouraged
|-
| 10-24 || almost never feels discouraged
|-
| 0-9 || never feels discouraged

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER_PROPENSITY
| 91-100 || is in a constant state of internal rage
| rowspan=3 | More likely to throw [[tantrum]]s and go [[Insane|berserk]].
|-
| 76-90 || is very quick to anger
|-
| 61-75 || is quick to anger
|-
| 25-39 || is slow to anger
|-
| 10-24 || is very slow to anger
|-
| 0-9 || never becomes angry

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY_PROPENSITY
| 91-100 || is a nervous wreck
| rowspan=3 | More likely to stumble [[oblivious]]ly and go [[Insane|stark raving mad]].
|-
| 76-90 || is always tense and jittery
|-
| 61-75 || is often nervous
|-
| 25-39 || has a calm demeanor
|-
| 10-24 || has a very calm demeanor
|-
| 0-9 || has an incredibly calm demeanor

|- style="border-top: 3px solid #aaa"
! rowspan=6 | LUST_PROPENSITY
| 91-100 || is constantly ablaze with feelings of lust
|-
| 76-90 || is prone to strong feelings of lust
|-
| 61-75 || often feels lustful
|-
| 25-39 || does not often feel lustful
|-
| 10-24 || rarely looks on others with lust
|-
| 0-9 || never feels lustful passions

|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRESS_VULNERABILITY
| 91-100 || becomes completely helpless in stressful situations
| 50% chance to become [[Insane|catatonic]]
|-
| 76-90 || cracks easily under pressure
|-
| 61-75 || doesn't handle stress well
|-
| 25-39 || can handle stress
|-
| 10-24 || is confident under pressure
|-
| 0-9 || is impervious to the effects of stress

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREED
| 91-100 || is as avaricious as they come, obsessed with acquiring wealth
|-
| 76-90 || is very greedy
|-
| 61-75 || has a greedy streak
|-
| 25-39 || doesn't focus on material goods
|-
| 10-24 || desires little for [him/her]self in the way of possessions
|-
| 0-9 || often neglects [his/her] own wellbeing, having no interest in material goods

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION<br />Conflicts with SELF_CONTROL
| 91-100 || is ruled by irresistible cravings and urges
|-
| 76-90 || feels strong urges and seeks short-term rewards
|-
| 61-75 || occasionally overindulges
|-
| 25-39 || doesn't often experience strong cravings or urges
|-
| 10-24 || only rarely feels strong cravings or urges
|-
| 0-9 || never feels tempted to overindulge in anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VIOLENT<br />Conflicts with TRANQUILITY<br />and MARTIAL_PROWESS
| 91-100 || is given to rough-and-tumble brawling, even to the point of starting fights for no reason
| rowspan=1 | This does not actually cause a dwarf to randomly start a fist fight.
|-
| 76-90 || would never pass up a chance for a good fistfight
|-
| 61-75 || likes to brawl
|-
| 25-39 || tends to avoid any physical confrontations
| rowspan=3 | This does not affect a soldier's will to fight, but will cause civilians to flee from danger.{{verify}}
|-
| 10-24 || does not enjoy participating in physical confrontations
|-
| 0-9 || would flee even the most necessary battle to avoid any form of physical confrontation

|- style="border-top: 3px solid #aaa"
! rowspan=6 | PERSEVERENCE<br />Conflicts with PERSEVERENCE
| 91-100 || is unbelievably stubborn and will stick with even the most futile action once [his/her] mind is made up
|-
| 76-90 || is very stubborn
|-
| 61-75 || is stubborn
|-
| 25-39 || has a noticeable lack of perseverence
|-
| 10-24 || doesn't stick with things if even minor difficulties arise
|-
| 0-9 || drops any activity at the slightest hint of difficulty or even the suggestion of effort being required

|- style="border-top: 3px solid #aaa"
! rowspan=6 | WASTEFULNESS
| 91-100 || is completely careless with resources when completing projects and invariable wastes a lot of time and effort
|-
| 76-90 || is not careful with resources when working on projects and often spends unnecessary effort
|-
| 61-75 || tends to be a little wasteful when working on projects
|-
| 25-39 || tends to be a little tight with resources when working on projects
|-
| 10-24 || is stingy with resources on projects and refuses to expend any extra effort
|-
| 0-9 || cuts any corners possible when working on a project, regardless of the consequences, rather than wasting effort or resources

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DISCORD<br />Conflicts with HARMONY
| 91-100 || revels in chaos and discord, and [he/she] encourages it whenever possible
|-
| 76-90 || finds a chaotic mess preferable to the boredom of harmonious living
|-
| 61-75 || doesn't mind a little tumult and discord in day-to-day living
|-
| 25-39 || prefers that everyone live as harmoniously as possible
|-
| 10-24 || feels best when everyone gets along without any strife or contention
|-
| 0-9 || would be deeply satisfied if everyone could live as one in complete harmony

|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS<br />Conflicts with HARMONY<br />and FRIENDSHIP
| 91-100 || is quite a bold flatterer, extremely friendly but just a little insufferable
|-
| 76-90 || is very friendly and always tries to say nice things to others
|-
| 61-75 || is a friendly individual
|-
| 25-39 || is somewhat quarrelsome
|-
| 10-24 || is unfriendly and disagreeable
|-
| 0-9 || is a dyed-in-the-wool quarreler, never missing a chance to lash out in verbal hostility

|- style="border-top: 3px solid #aaa"
! rowspan=6 | POLITENESS<br />Conflicts with DECORUM
| 91-100 || exhibits a refined politeness and is determined to keep the guiding rules of etiquette and decorum as if life itself depended on it
|-
| 76-90 || is very polite and observes appropriate rules of decorum when possible
|-
| 61-75 || is quite polite
|-
| 25-39 || could be considered rude
|-
| 10-24 || is very impolite and inconsiderate of propriety
|-
| 0-9 || is a vulgar being who does not care a lick for even the most basic rules of civilized living

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DISDAIN_ADVICE
| 91-100 || disdains even the best advice of associates and family, relying strictly on [his/her] own counsel
|-
| 76-90 || dislikes receiving advice, preferring to keep [his/her] own counsel
|-
| 61-75 || has a tendency to go it alone, without considering the advice of others
|-
| 25-39 || tends to ask others for help with difficult decisions
|-
| 10-24 || relies on the advice of others during decision making
|-
| 0-9 || is unable to make decisions without a great deal of input from others

|- style="border-top: 3px solid #aaa"
! rowspan=6 | BRAVERY
| 91-100 || is utterly fearless when confronted with danger, to the point of lacking common sense
|-
| 76-90 || is incredibly brave in the face of looming danger, perhaps a bit foolhardy
|-
| 61-75 || is brave in the face of imminent danger
|-
| 25-39 || is somewhat fearful in the face of imminent danger
|-
| 10-24 || has great trouble mastering fear when confronted by danger
|-
| 0-9 || is a coward, completely overwhelmed by fear when confronted with danger

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CONFIDENCE
| 91-100 || presupposes success in any venture requiring [his/her] skills with what could be called blind overconfidence
|-
| 76-90 || is extremely confident of [him/her]self in situations requiring [his/her] skills
|-
| 61-75 || is generally quite confident of [his/her] abilities when undertaking specific ventures
|-
| 25-39 || sometimes acts with little determination and confidence
|-
| 10-24 || lacks confidence in [his/her] abilities
|-
| 0-9 || has no confidence at all in [his/her] talent and abilities

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VANITY
| 91-100 || is completely wrapped up in [his/her] own appearance, abilities and other personal matters
|-
| 76-90 || is greatly pleased by [his/her] own looks and accomplishments
|-
| 61-75 || is pleased by [his/her] own appearance and talents
|-
| 25-39 || is not inherently proud of [his/her] talents and accomplishments
|-
| 10-24 || takes no pleasure in [his/her] talents and appearance
|-
| 0-9 || could not care less about [his/her] appearance, talents or other personal vanities

|- style="border-top: 3px solid #aaa"
! rowspan=6 | AMBITION
| 91-100 || has a relentless drive, completely consumed by ambition
|-
| 76-90 || is very ambitious, always looking for a way to better [his/her] situation
|-
| 61-75 || is quite ambitious
|-
| 25-39 || isn't particularly ambitious
|-
| 10-24 || is not driven and rarely feels the need to pursue even a modest success
|-
| 0-9 || has no ambition whatsoever

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GRATITUDE
| 91-100 || unerringly returns favors and has a profound sense of gratitude for the kind actions of others
|-
| 76-90 || feels a strong need to reciprocate any favor done for [him/her]
|-
| 61-75 || is grateful when others help [him/her] out and tries to return favors
|-
| 25-39 || takes offered help and gifts without feeling particularly grateful
|-
| 10-24 || accepts favors without developing a sense of obligation, preferring to act as the current situation demands
|-
| 0-9 || does not feel the slightest need to reciprocate favors that others do for [him/her], no matter how major the help or how much [he/she] needed it

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODESTY
| 91-100 || always presents [him/her]self as extravagantly as possible, displaying a magnificent image to the world
|-
| 76-90 || likes to present [him/her]self boldly, even if it would offend an average sense of modesty
|-
| 61-75 || doesn't mind wearing something special now and again
|-
| 25-39 || prefers to present [him/her]self modestly
|-
| 10-24 || presents [him/her]self modestly and frowns on any flashy accoutrements
|-
| 0-9 || cleaves to an austere lifestyle, disdaining even minor immodesties in appearance

|- style="border-top: 3px solid #aaa"
! rowspan=6 | HUMOR
| 91-100 || finds something humorous in everything, no matter how serious or inappropriate
|-
| 76-90 || finds the humor in most situations
|-
| 61-75 || has an active sense of humor
|-
| 25-39 || has little interest in joking around
|-
| 10-24 || does not find most jokes humorous
|-
| 0-9 || is utterly humorless

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VENGEFUL
| 91-100 || is vengeful and never forgets or forgives past grievances
|-
| 76-90 || has little time for forgiveness and will generally seek retribution
|-
| 61-75 || tends to hang on to grievances
|-
| 25-39 || doesn't tend to hold on to grievances
|-
| 10-24 || does not generally seek retribution for past wrongs
|-
| 0-9 || has no sense of vengeance or retribution

|- style="border-top: 3px solid #aaa"
! rowspan=6 | PRIDE
| 91-100 || is absorbed in delusions of self-importance
|-
| 76-90 || has an overinflated sense of self-worth
|-
| 61-75 || thinks [he/she] is fairly important in the grand scheme of things
|-
| 25-39 || is very humble
|-
| 10-24 || has a low sense of self-esteem
|-
| 0-9 || is completely convinced of [his/her] own worthlessness

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CRUELTY<br />Conflicts with POWER
| 91-100 || is deliberately cruel to those unfortunate enough to be subject to [his/her] sadism
|-
| 76-90 || is sometimes cruel
|-
| 61-75 || generally acts impartially and is rarely moved to mercy
|-
| 25-39 || often acts with compassion
|-
| 10-24 || is easily moved to mercy
|-
| 0-9 || always acts with mercy and compassion at the forefront of [his/her] considerations

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SINGLEMINDED
| 91-100 || pursues matters with a single-minded focus, often overlooking other matters
|-
| 76-90 || can be very single-minded
|-
| 61-75 || generally acts with a narrow focus on the current activity
|-
| 25-39 || can occasionally lose focus on the matter at hand
|-
| 10-24 || is somewhat scatterbrained
|-
| 0-9 || is a complete scatterbrain, unable to focus on a single matter for more than a passing moment

|- style="border-top: 3px solid #aaa"
! rowspan=6 | HOPEFUL
| 91-100 || has such a developed sense of optimism that [he/she] always assumes the best outcome will eventually occur, no matter what
|-
| 76-90 || is an optimist
|-
| 61-75 || generally finds [him/her]self quite hopeful about the future
|-
| 25-39 || tends to assume the worst of two outcomes will be the one that comes to pass
|-
| 10-24 || is a pessimist
|-
| 0-9 || despairs of anything positive happening in the future and lives without feelings of hope

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CURIOUS
| 91-100 || is implacably curious, without any respect for propriety or privacy
|-
| 76-90 || is very curious, sometimes to [his/her] detriment
|-
| 61-75 || is curious and eager to learn
|-
| 25-39 || isn't particularly curious about the world
|-
| 10-24 || is very rarely moved by curiosity
|-
| 0-9 || is incurious and never seeks out knowledge or information to satisfy [him/her]self

|- style="border-top: 3px solid #aaa"
! rowspan=6 | BASHFUL
| 91-100 || is gripped by a crippling shyness
|-
| 76-90 || is bashful
|-
| 61-75 || tends to consider what others think of [him/her]
|-
| 25-39 || is not particularly interested in what others think of [him/her]
|-
| 10-24 || is generally unhindered by the thoughts of others concerning [his/her] actions
|-
| 0-9 || is shameless, absolutely unfazed by the thoughts of others

|- style="border-top: 3px solid #aaa"
! rowspan=6 | PRIVACY<br />Conflicts with STOICISM
| 91-100 || shares intimate details of life without sparing a thought to repercussions or propriety
|-
| 76-90 || is not a private person and freely shares details of [his/her] life
|-
| 61-75 || tends to share [his/her] own experiences and thoughts with others
|-
| 25-39 || tends not to reveal personal information
|-
| 10-24 || has a strong tendency toward privacy
|-
| 0-9 || is private to the point of paranoia, unwilling to reveal even basic information about [him/her]self

|- style="border-top: 3px solid #aaa"
! rowspan=6 | PERFECTIONIST
| 91-100 || is obsessed with details and will often take a great deal of extra time to make sure things are done the right way
|-
| 76-90 || is a perfectionist
|-
| 61-75 || tries to do things correctly each time
|-
| 25-39 || doesn't try to get things done perfectly
|-
| 10-24 || is inattentive to detail in [his/her] own work
|-
| 0-9 || is frustratingly sloppy and careless with every task [he/she] sets to carry out

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CLOSEMINDED
| 91-100 || is completely closed-minded and never changes [his/her] mind after forming an initial idea
|-
| 76-90 || is intellectually stubborn, rarely changing [his/her] mind during a debate regardless of the merits
|-
| 61-75 || tends to be a bit stubborn in changing [his/her] mind about things
|-
| 25-39 || doesn't cling tightly to ideas and is open to changing [his/her] mind
|-
| 10-24 || often finds [him/her]self changing [his/her] mind to agree with somebody else
|-
| 0-9 || easily changes [his/her] mind and will generally go with the prevailing view on anything

|- style="border-top: 3px solid #aaa"
! rowspan=6 | TOLERANT
| 91-100 || is not bothered in the slightest by deviations from the norm or even extreme differences in lifestyle or appearance
|-
| 76-90 || is very comfortable around others that are different from [him/her]
|-
| 61-75 || is quite comfortable with others that have a different appearance or culture
|-
| 25-39 || is somewhat uncomfortable around those that appear unusual or live differently from [him/her]
|-
| 10-24 || is made deeply uncomfortable by differences in culture or appearance
|-
| 0-9 || cannot tolerate differences in culture, lifestyle or appearance

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALLY_OBSESSIVE
| 91-100 || is emotionally obsessive, forming life-long attachments even if they aren't reciprocated
|-
| 76-90 || forms strong emotional bonds with others, at times to [his/her] detriment
|-
| 61-75 || has a tendency toward forming deep emotional bonds with others
|-
| 25-39 || tends to form only tenuous emotional bonds with others
|-
| 10-24 || forms only fleeting and rare emotional bonds with others
|-
| 0-9 || does not have feelings of emotional attachment and has never felt even a moment's connection with another being

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SWAYED_BY_EMOTIONS
| 91-100 || is buffeted by others' emotions and can't help but to respond to them
|-
| 76-90 || is swayed by emotional appeals
|-
| 61-75 || tends to be swayed by the emotions of others
|-
| 25-39 || tends not to be swayed by emotional appeals
|-
| 10-24 || does not generally respond to emotional appeals
|-
| 0-9 || is never moved by the emotions of others

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM<br />Conflicts with SACRIFICE
| 91-100 || is truly fulfilled by assisting those in need
| rowspan=3 | Receives [[Happy Thought]] from recovering wounded.
|-
| 76-90 || finds helping others very emotionally rewarding
|-
| 61-75 || finds helping others emotionally rewarding
|-
| 25-39 || does not go out of [his/her] way to help others
|-
| 10-24 || dislikes helping others
| rowspan=2 | Receives [[Unhappy Thought]] from recovering wounded.
|-
| 0-9 || feels helping others is an imposition on [his/her] time

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS<br />Conflicts with LAW,<br />LOYALTY, and INDEPENDENCE
| 91-100 || has a profound sense of duty and obligation
|-
| 76-90 || has a strong sense of duty
|-
| 61-75 || has a sense of duty
|-
| 25-39 || finds obligations confining
|-
| 10-24 || dislikes obligations and will try to avoid being bound by them
|-
| 0-9 || hates vows, obligations, promises and other binding elements that could restrict [him/her]

|- style="border-top: 3px solid #aaa"
! rowspan=6 | THOUGHTLESSNESS
| 91-100 || never deliberates before acting, to the point of being considered thoughtless
|-
| 76-90 || doesn't generally think before acting
|-
| 61-75 || can sometimes act without deliberation
|-
| 25-39 || tends to think before acting
|-
| 10-24 || can get caught up in internal deliberations when action is necessary
|-
| 0-9 || never acts without prolonged deliberation, even to [his/her] own detriment and the harm of those around [him/her]

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91-100 || is obsessed with order and structure in [his/her] own life, with everything kept in its proper place
|-
| 76-90 || lives an orderly life, organized and neat
|-
| 61-75 || tries to keep [his/her] things orderly
|-
| 25-39 || tends to make a small mess with [his/her] own possessions
|-
| 10-24 || is sloppy with [his/her] living space
|-
| 0-9 || is completely oblivious to any conception of neatness and will just leave things strewn about without a care

|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91-100 || is naturally trustful of everybody
|-
| 76-90 || is very trusting
|-
| 61-75 || is trusting
|-
| 25-39 || is slow to trust others
|-
| 10-24 || does not trust others
|-
| 0-9 || sees others as selfish and conniving

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91-100 || truly treasures the company of others
|-
| 76-90 || enjoys being in crowds
|-
| 61-75 || enjoys the company of others
|-
| 25-39 || tends to avoid crowds
|-
| 10-24 || prefers to be alone
|-
| 0-9 || considers spending time alone much more important than associating with others

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91-100 || is assertive to the point of aggression, unwilling to let others get a word in edgewise when [he/she] has something to say
|-
| 76-90 || has an overbearing personality
|-
| 61-75 || is assertive
|-
| 25-39 || tends to be passive in discussions
|-
| 10-24 || only rarely tries to assert [him/her]self in conversation
|-
| 0-9 || would never under any circumstances speak up or otherwise put forth [his/her] point of view in a discussion

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| 91-100 || is driven by a bouncing frenetic energy
|-
| 76-90 || lives at a high-energy kinetic pace
|-
| 61-75 || lives a fast-paced life
|-
| 25-39 || likes to take it easy
|-
| 10-24 || lives at a slow-going and leisurely pace
|-
| 0-9 || has an utterly languid pace of easy living, calm and slow

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING<br />Conflicts with TRANQUILITY
| 91-100 || never fails to seek out the most stressful and even dangerous situations
|-
| 76-90 || seeks out exciting and adventurous situations
|-
| 61-75 || likes a little excitement now and then
|-
| 25-39 || doesn't seek out excitement
|-
| 10-24 || actively avoids exciting or stressful situations
|-
| 0-9 || does everything in [his/her] power to avoid excitement and stress

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91-100 || is bored by reality and would rather disappear utterly and forever into a world of made-up fantasy
|-
| 76-90 || is given to flights of fancy to the point of distraction
|-
| 61-75 || has an active imagination
|-
| 25-39 || isn't given to flights of fancy
|-
| 10-24 || is grounded in reality
|-
| 0-9 || is interested only in facts and the real world

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ABSTRACT_INCLINED
| 91-100 || eschews practical concerns for philosophical discussion, puzzles, riddles and the world of ideas
|-
| 76-90 || strongly prefers discussions of ideas and abstract concepts over handling specific practical issues
|-
| 61-75 || has a tendency to consider ideas and abstractions over practical applications
|-
| 25-39 || likes to keep things practical, without delving too deeply into the abstract
|-
| 10-24 || dislikes abstract discussions and would much rather focus on practical examples
|-
| 0-9 || is concerned only with matters practical to the situation at hand, with absolutely no inclination toward abstract discussion

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ART_INCLINED<br />Conflicts with ARTWORK<br />and NATURE
| 91-100 || can easily become absorbed in art and the beauty of the natural world
|-
| 76-90 || greatly moved by art and natural beauty
|-
| 61-75 || is moved by art and natural beauty
|-
| 25-39 || does not have a great aesthetic sensitivity
|-
| 10-24 || is not readily moved by art or natural beauty
|-
| 0-9 || is completely unmoved by art or the beauty of nature

|}

{{Category|Dwarves}}
{{Category|Modding}}
{{Category|Tokens}}

Entity token

2015-12-02T16:24:15Z

FortressBuilder: 0.42.01 changes

{{Quality|Exceptional|19:21, 13 October 2015 (UTC)}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom entity can have a tier of 3000 and still work even if it's the only custom entity.

[ADVENTURE_TIER:4]

Removed in [[:Category:Version 0.42.01|Version 0.42.01]].

|-
| {{text anchor|ALL_MAIN_POPS_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

|-
| {{text anchor|SITE_CONTROLLABLE}}{{version|0.42.01}} / {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, then in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|CREATURE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing of on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]].
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max historical population '''per entity'''. Multiply this by max starting civ to get the total maximum historical population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations appear to be drawn randomly from all translation files{{verify}}.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, BATTLE, BRIDGE, CIV, LIBRARY{{version|0.42.01}}, MILITARY_UNIT, RELIGION, ROAD, SIEGE, SITE, TEMPLE, TUNNEL, VESSEL, WALL, WAR
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be prefered as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1.
[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can be any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

== Leadership ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

== Behavior ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's [[personality trait|cultural values]]. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|VARIABLE_VALUE}}{{version|0.42.01}}
|
|

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the the defenders.

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s, and (unlike older versions) only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a land holder.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|-
| {{text anchor|GENERATE_KEYBOARD_INSTRUMENTS}}, {{text anchor|GENERATE_PERCUSSION_INSTRUMENTS}}, {{text anchor|GENERATE_STRINGED_INSTRUMENTS}}, {{text anchor|GENERATE_WIND_INSTRUMENTS}}, {{text anchor|GENERATE_DANCE_FORMS}}, {{text anchor|GENERATE_MUSICAL_FORMS}}, {{text anchor|GENERATE_POETIC_FORMS}}{{version|0.42.01}}
|
| Makes civilizations generate the given instruments/forms.

|-
| {{text anchor|SCHOLAR}}{{version|0.42.01}}
| scholar type
| ALL, ASTRONOMER, CHEMIST, DOCTOR, ENGINEER, GEOGRAPHER, HISTORIAN, MATHEMATICIAN, NATURALIST, PHILOSOPHER

|-
| {{text anchor|SET_SCHOLARS_ON_VALUES_AND_JOBS}}{{version|0.42.01}}
|
|

|}

== Available Resources ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal. For those cases, listing the pick under the [WEAPON] token works just as well.
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

Removed in [[:Category:Version 0.42.01|Version 0.42.01]].

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows civ to use indoor tree growths in the goods it has available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTH}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}

Entity token

2015-12-02T15:49:55Z

FortressBuilder: /* Behavior */ Typo

{{Quality|Exceptional|19:21, 13 October 2015 (UTC)}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom entity can have a tier of 3000 and still work even if it's the only custom entity.
[ADVENTURE_TIER:4]

|-
| {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

|-
| {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, then in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|CREATURE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing of on the "neighbors" section of the site selection screen. Selecting DARK_FORTRESS also allows generation of [[underworld spire|certain other structures]].
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max historical population '''per entity'''. Multiply this by max starting civ to get the total maximum historical population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max historical population per individual site. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations appear to be drawn randomly from all translation files{{verify}}.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, CIV, SITE, VESSEL, RELIGION, MILITARY_UNIT, TEMPLE, WAR, BATTLE, SIEGE, ROAD, BRIDGE, TUNNEL, WALL
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be prefered as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1.
[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with the terrain of their initial biome.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can be any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

== Leadership ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (lords, hearthpersons, etc). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility. Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker). Any defined positions holding a given responsibility will take precedence over generated positions for that responsibility.

|}

== Behavior ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's [[personality trait|cultural values]]. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}, {{text anchor|MERCENARY}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill. These types of adventurers will sometimes be seen leading a battle (instead of war leaders or generals) in remote locations during world-gen, in charge of the the defenders.

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots. If the civilization also has the SIEGER token, they will eventually ramp it up to less subtle means of warfare.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Without this tag (or AMBUSHER, or ITEM_THIEF), enemy civs will only siege (if capable), and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will be friendly to you.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles from [[mead hall]]s, and (unlike older versions) only functions when the type of site built is a hamlet/town. This, combined with the correct type of [[position token|position]] associated with a site, is why adventurers can only lay claim to human sites. {{bug|8001}}

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers.
|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home. Also causes that civ to be hostile to any entity without this token. Without this tag (or AMBUSHER, or BABYSNATCHER), enemy civs will only siege (if capable), and will siege as early as they would otherwise steal.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Said patrols will be hostile to any adventurers they encounter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack. This will occur when the progress triggers for sieging are reached. If the civ lacks smaller methods of conflict (AMBUSHER, BABYSNATCHER, ITEM_THIEF), they will instead send smaller-scale sieges when their triggers for "first contact" are reached.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Designed to go with ITEM_THIEF, may or may not work with BABYSNATCHER.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a land holder.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|}

== Available Resources ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
| Causes the selected weapon to fall under the "digging tools" section of the embark screen. Also forces the weapon to be made out of metal, which can cause issues if a modded entity has access to picks without access to metal. For those cases, listing the pick under the [WEAPON] token works just as well.
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|INDOOR_ORCHARDS}}
|
| Allows civ to use indoor tree growths in the goods it has available for trade. Not used in vanilla entities, as vanilla underground trees do not grow fruit.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTH}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}

Speech file

2015-11-01T11:11:42Z

FortressBuilder: Add some context tokens

'''Speech files''' are text files that define sentences which can be spoken by people in [[adventure mode]]. They are found in the <code>data/speech</code> folder.

== List of files ==

{| class="wikitable"
! File !! Uses !! Example
|-
| {{text anchor|ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|animal_slayer}}
|
| I have taken down [CONTEXT:NUMBER] [CONTEXT:RACE:NUMBERED_NAME] while stalking [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|arch_info_justification}}
|
| It is said that the [CONTEXT:ARCH_ELEMENT] of [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] [CONTEXT:JUSTIFICATION] [CONTEXT:DEF_SPHERE] for the glory of [CONTEXT:HIST_FIG:TRANS_NAME].

|-
| {{text anchor|child_age_proclamation}}
|
| I'm [CONTEXT:NUMBER]!

|-
| {{text anchor|current_profession_no_year}}
|
| I am a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|current_profession_year}}
|
| This is my [CONTEXT:ORDINAL] year as a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|curse}}
|
| Who dares to enter my house? I curse you!

|-
| {{text anchor|dwarf}}
| Used when boasting about killing a [[dwarf]]. See also [[Creature token#SPEECH]].
| whose hammer shattered on the anvil of my power

|-
| {{text anchor|elf}}
| Used when boasting about killing an [[elf]]. See also [[Creature token#SPEECH]].
| whose fragile bones shattered before the power of my contempt

|-
| {{text anchor|family_relationship_additional}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] is also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_additional_dead}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] was also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_no_spec}}
|
| I have [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_no_spec_dead}}
|
| I had [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] is named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec_dead}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] was named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|general}}
|
| who lies dead, now only an embarrassing memory

|-
| {{text anchor|goodbye_worship_1}}
|
| upon arising in the mornings,

|-
| {{text anchor|goodbye_worship_2}}
|
| always remember to

|-
| {{text anchor|goodbye_worship_3}}
|
| speak the praises of [SPEAKER:HF_LINK:DEITY:RANDOM_DEF_SPHERE]

|-
| {{text anchor|greet}}
| Used when greeting another person.
| Greetings. My name is [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_baby}}
| Used when greeting a [[baby]].
| A baby! How adorable!

|-
| {{text anchor|greet_reply}}
| Used when replying to another person's greeting.
| Ah, hello. I'm [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_after_hero}}
| Used by NPCs when replying to the player character's greeting after becoming a [[hero]].
| I am [SPEAKER:TRANS_NAME]. How can I be of service?

|-
| {{text anchor|greet_reply_diff_language}}
| Used when replying to the greeting of a person which is of another [[race]].
| Hello, [AUDIENCE:RACE]. I am [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_unusual_first}}
| Used when replying to the greeting of a person whose first name is unusual.{{verify|June 2015}}
| You know, you don't meet many people with the name [AUDIENCE:FIRST_NAME]

|-
| {{text anchor|greet_worship}}
| Used for greetings by [[priest]]s and faithful people.{{verify|June 2015}}
| This servant of [SPEAKER:HF_LINK:DEITY:TRANS_NAME] greets you.

|-
| {{text anchor|guard_profession}}
| Used by [[guard]]s when you ask them about their profession. See also [[#soldier_profession|soldier_profession]].
| I am a guard.

|-
| {{text anchor|guard_warning}}
|
| Don't start any trouble.

|-
| {{text anchor|hist_fig_slayer}}
|
| It is I that felled [CONTEXT:HIST_FIG:TRANS_NAME] the [CONTEXT:HIST_FIG:RACE].

|-
| {{text anchor|hunting_profession}}
|
| I hunt great beasts in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|hunting_profession_year}}
|
| I have hunted great beasts in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|justification_antithetical}}
|
| can be thought of as the antithesis of

|-
| {{text anchor|justification_experience}}
|
| can allow one to experience

|-
| {{text anchor|justification_proximity}}
|
| can bring one near to

|-
| {{text anchor|justification_reminder}}
|
| can remind one of

|-
| {{text anchor|justification_representation}}
|
| can be thought of as a representation of

|-
| {{text anchor|lair_hunter_minotaur}}
| Used by [[minotaur]]s while hunting adventures in their lairs. See also [[Creature token#LAIR_HUNTER_SPEECH]].
| I'll eat you whole!

|-
| {{text anchor|mercenary_profession}}
|
| I seek fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|mercenary_profession_year}}
|
| I have sought fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|no_family}}
| Used by NPCs when you ask them about their [[family]], but they don't have any.
| I have no family to speak of.

|-
| {{text anchor|past_hunting_profession}}
|
| In the past, I hunted great beasts.

|-
| {{text anchor|past_mercenary_profession}}
|
| In the past, I sought fortune and glory by offering my skill at arms.

|-
| {{text anchor|past_profession_no_year}}
|
| I was once a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|past_profession_year}}
|
| I was a [CONTEXT:UNIT_NAME] for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|past_scouting_profession}}
|
| At one time, I was a scout.

|-
| {{text anchor|past_snatcher_profession}}
|
| Once it was my calling to rescue lost children.

|-
| {{text anchor|past_thief_profession}}
|
| I once sought great treasures.

|-
| {{text anchor|past_wandering_profession}}
|
| I once wandered the wilds.

|-
| {{text anchor|positive}}
| Used to express positive [[feeling]]s.
| wonderful!<br/>fantastic!<br/>very good

|-
| {{text anchor|same_site_ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME]

|-
| {{text anchor|same_site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|scouting_profession}}
|
| It is my duty to scout the area around [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|scouting_profession_year}}
|
| I have been scouting the area around [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|slayer}}
|
| bane<br/>death<br/>nemesis<br/>vanquisher

|-
| {{text anchor|snatcher_profession}}
|
| I rescue lost children and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|snatcher_profession_year}}
|
| For [CONTEXT:NUMBER] of my years, I have been rescuing lost children and bringing them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|soldier_profession}}
| Used by [[soldier]]s when you ask them about their profession. See also [[#guard_profession|guard_profession]].
| I am a soldier.

|-
| {{text anchor|task_recommendation}}
|
| [CONTEXT:ANY:TRANS_NAME] might have a task for you

|-
| {{text anchor|temple_already_member}}
|
| your task is simple;<br/>all you need is to

|-
| {{text anchor|temple_become_member}}
|
| Welcome to [CONTEXT:ENTITY:TRANS_NAME]. Praise be to [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME]!<br/>As a member of [CONTEXT:ENTITY:TRANS_NAME], you can now seek the higher mysteries of [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME].

|-
| {{text anchor|thief_profession}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|thief_profession_year}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME] and have done so for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|threat}}
| Used by NPC [[bandit]]s{{verify|June 2015}} before attacking you.
| Prepare to die!

|-
| {{text anchor|unknown_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME], wherever [CONTEXT:HIST_FIG:PRO_SUB] might be

|-
| {{text anchor|wandering_profession}}
|
| I wander [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|wandering_profession_year}}
|
| I have wandered [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.
|}

== Adding custom files ==

While any of the hardcoded speech files can be edited to customize the used phrases, it is also possible to add new files and associate them with custom creatures.

{| class="wikitable"
|+ [[Creature token]]s
! Token !! Example uses

|-
| [[Creature token#CASTE_SPEECH|CASTE_SPEECH]]
|

|-
| [[Creature token#LAIR_HUNTER_SPEECH|LAIR_HUNTER_SPEECH]]
| [[minotaur]] ([[#lair_hunter_minotaur|lair_hunter_minotaur.txt]])

|-
| [[Creature token#SPEECH|SPEECH]]
| [[dwarf]] ([[#dwarf|dwarf.txt]]), [[elf]] ([[#elf|elf.txt]])

|-
| [[Creature token#SPEECH_FEMALE|SPEECH_FEMALE]]
|

|-
| [[Creature token#SPEECH_MALE|SPEECH_MALE]]
|
|}

== Special tokens ==

Speech files can contain tokens in square brackets (<code>[]</code>), which are replaced with context-specific strings before the speech is displayed.

=== Context tokens ===

These give special information about the background of the conversation.

{| class="wikitable"
! Token !! Type !! Meaning

|-
| [CONTEXT:ABSTRACT_BUILDING]
| building
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the building in which the historical figure the speaker wants you to seek is

|-
| [CONTEXT:HIST_FIG]
| creature
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the historical figure the speaker wants you to seek

|-
| [CONTEXT:NUMBER]
| number
|
* [[#animal_slayer|animal_slayer]]: number of animals slain
* [[#child_age_proclamation|child_age_proclamation]]: age in years of the child

|-
| [CONTEXT:ORDINAL]
| number
|
* [[#current_profession_year|current_profession_year]]: the number of years the speaker has had their profession

|-
| [CONTEXT:PLACE]
| site
|
* [[#animal_slayer|animal_slayer]]: the place where the speaker slayed the animals

|-
| [CONTEXT:RACE]
| race
|
* [[#animal_slayer|animal_slayer]]: the race of the animals the speaker has slain

|-
| [CONTEXT:SITE]
| site
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the site where the historical figure the speaker wants you to seek is

|-
| [CONTEXT:UNIT_NAME]
| text
|
* [[#current_profession_no_year|current_profession_no_year]]: the name of the speaker's profession
|}

[[Category:DF2014:Files]]
[[Category:DF2014:Modding]]

Hemp

2015-10-25T09:19:34Z

FortressBuilder: Undo revision 220742 by 86.152.174.232 (talk)

{{Quality|Superior|15:36, 29 January 2015 (UTC)}}
{{plantlookup|uses=
* [[Thread]]
* [[Oil]]
}}
{{av}}

'''Hemp''' is an [[aboveground]] [[crop]] that supports both the [[food]] and [[textile industry|textile industries]]. The plants [[plant processing|processable]] at a [[farmer's workshop]] to produce hemp plant fiber [[thread]], and can also be [[millstone|milled]] into [[flour]].

'''Hemp seeds''' can be milled into paste at a [[quern]] or [[millstone]], which in turn can be pressed into hempseed [[oil]] and a [[press cake]] at a [[screw press]].

Hemp and [[flax]] are the only millable plants that can be stored in containers made from their own fibers.

Currently there are no other uses for hemp plants in Dwarf Fortress.
{{gamedata}}
{{Plants}}

Template:Buggy

2015-10-25T09:18:16Z

FortressBuilder: Undo revision 220755 by GoblinCamp (talk)

{{colored notice box|image=[[Image:Roach.png|link=:Category:Bugs|50px]]|type=xred|bg=#fcc|text=
This feature has one or more outstanding '''bugs'''. {{#if:{{{withoutbugsection|}}}||Please view the [[#{{{bugsection|Bugs}}}|{{{bugsection|Bugs}}}]] section for details.}}
}}<includeonly>{{#ifeq:{{{cat|}}}|nocat||{{Category|Bugs}}}}</includeonly><noinclude>
{{/doc}}
</noinclude>

Speech file

2015-09-20T13:05:16Z

FortressBuilder: /* Adding custom files */

'''Speech files''' are text files that define sentences which can be spoken by people in [[adventure mode]]. They are found in the <code>data/speech</code> folder.

== List of files ==

{| class="wikitable"
! File !! Uses !! Example
|-
| {{text anchor|ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|animal_slayer}}
|
| I have taken down [CONTEXT:NUMBER] [CONTEXT:RACE:NUMBERED_NAME] while stalking [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|arch_info_justification}}
|
| It is said that the [CONTEXT:ARCH_ELEMENT] of [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] [CONTEXT:JUSTIFICATION] [CONTEXT:DEF_SPHERE] for the glory of [CONTEXT:HIST_FIG:TRANS_NAME].

|-
| {{text anchor|child_age_proclamation}}
|
| I'm [CONTEXT:NUMBER]!

|-
| {{text anchor|current_profession_no_year}}
|
| I am a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|current_profession_year}}
|
| This is my [CONTEXT:ORDINAL] year as a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|curse}}
|
| Who dares to enter my house? I curse you!

|-
| {{text anchor|dwarf}}
| Used when boasting about killing a [[dwarf]]. See also [[Creature token#SPEECH]].
| whose hammer shattered on the anvil of my power

|-
| {{text anchor|elf}}
| Used when boasting about killing an [[elf]]. See also [[Creature token#SPEECH]].
| whose fragile bones shattered before the power of my contempt

|-
| {{text anchor|family_relationship_additional}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] is also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_additional_dead}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] was also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_no_spec}}
|
| I have [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_no_spec_dead}}
|
| I had [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] is named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec_dead}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] was named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|general}}
|
| who lies dead, now only an embarrassing memory

|-
| {{text anchor|goodbye_worship_1}}
|
| upon arising in the mornings,

|-
| {{text anchor|goodbye_worship_2}}
|
| always remember to

|-
| {{text anchor|goodbye_worship_3}}
|
| speak the praises of [SPEAKER:HF_LINK:DEITY:RANDOM_DEF_SPHERE]

|-
| {{text anchor|greet}}
| Used when greeting another person.
| Greetings. My name is [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_baby}}
| Used when greeting a [[baby]].
| A baby! How adorable!

|-
| {{text anchor|greet_reply}}
| Used when replying to another person's greeting.
| Ah, hello. I'm [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_after_hero}}
| Used by NPCs when replying to the player character's greeting after becoming a [[hero]].
| I am [SPEAKER:TRANS_NAME]. How can I be of service?

|-
| {{text anchor|greet_reply_diff_language}}
| Used when replying to the greeting of a person which is of another [[race]].
| Hello, [AUDIENCE:RACE]. I am [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_unusual_first}}
| Used when replying to the greeting of a person whose first name is unusual.{{verify|June 2015}}
| You know, you don't meet many people with the name [AUDIENCE:FIRST_NAME]

|-
| {{text anchor|greet_worship}}
| Used for greetings by [[priest]]s and faithful people.{{verify|June 2015}}
| This servant of [SPEAKER:HF_LINK:DEITY:TRANS_NAME] greets you.

|-
| {{text anchor|guard_profession}}
| Used by [[guard]]s when you ask them about their profession. See also [[#soldier_profession|soldier_profession]].
| I am a guard.

|-
| {{text anchor|guard_warning}}
|
| Don't start any trouble.

|-
| {{text anchor|hist_fig_slayer}}
|
| It is I that felled [CONTEXT:HIST_FIG:TRANS_NAME] the [CONTEXT:HIST_FIG:RACE].

|-
| {{text anchor|hunting_profession}}
|
| I hunt great beasts in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|hunting_profession_year}}
|
| I have hunted great beasts in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|justification_antithetical}}
|
| can be thought of as the antithesis of

|-
| {{text anchor|justification_experience}}
|
| can allow one to experience

|-
| {{text anchor|justification_proximity}}
|
| can bring one near to

|-
| {{text anchor|justification_reminder}}
|
| can remind one of

|-
| {{text anchor|justification_representation}}
|
| can be thought of as a representation of

|-
| {{text anchor|lair_hunter_minotaur}}
| Used by [[minotaur]]s while hunting adventures in their lairs. See also [[Creature token#LAIR_HUNTER_SPEECH]].
| I'll eat you whole!

|-
| {{text anchor|mercenary_profession}}
|
| I seek fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|mercenary_profession_year}}
|
| I have sought fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|no_family}}
| Used by NPCs when you ask them about their [[family]], but they don't have any.
| I have no family to speak of.

|-
| {{text anchor|past_hunting_profession}}
|
| In the past, I hunted great beasts.

|-
| {{text anchor|past_mercenary_profession}}
|
| In the past, I sought fortune and glory by offering my skill at arms.

|-
| {{text anchor|past_profession_no_year}}
|
| I was once a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|past_profession_year}}
|
| I was a [CONTEXT:UNIT_NAME] for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|past_scouting_profession}}
|
| At one time, I was a scout.

|-
| {{text anchor|past_snatcher_profession}}
|
| Once it was my calling to rescue lost children.

|-
| {{text anchor|past_thief_profession}}
|
| I once sought great treasures.

|-
| {{text anchor|past_wandering_profession}}
|
| I once wandered the wilds.

|-
| {{text anchor|positive}}
| Used to express positive [[feeling]]s.
| wonderful!<br/>fantastic!<br/>very good

|-
| {{text anchor|same_site_ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME]

|-
| {{text anchor|same_site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|scouting_profession}}
|
| It is my duty to scout the area around [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|scouting_profession_year}}
|
| I have been scouting the area around [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|slayer}}
|
| bane<br/>death<br/>nemesis<br/>vanquisher

|-
| {{text anchor|snatcher_profession}}
|
| I rescue lost children and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|snatcher_profession_year}}
|
| For [CONTEXT:NUMBER] of my years, I have been rescuing lost children and bringing them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|soldier_profession}}
| Used by [[soldier]]s when you ask them about their profession. See also [[#guard_profession|guard_profession]].
| I am a soldier.

|-
| {{text anchor|task_recommendation}}
|
| [CONTEXT:ANY:TRANS_NAME] might have a task for you

|-
| {{text anchor|temple_already_member}}
|
| your task is simple;<br/>all you need is to

|-
| {{text anchor|temple_become_member}}
|
| Welcome to [CONTEXT:ENTITY:TRANS_NAME]. Praise be to [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME]!<br/>As a member of [CONTEXT:ENTITY:TRANS_NAME], you can now seek the higher mysteries of [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME].

|-
| {{text anchor|thief_profession}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|thief_profession_year}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME] and have done so for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|threat}}
| Used by NPC [[bandit]]s{{verify|June 2015}} before attacking you.
| Prepare to die!

|-
| {{text anchor|unknown_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME], wherever [CONTEXT:HIST_FIG:PRO_SUB] might be

|-
| {{text anchor|wandering_profession}}
|
| I wander [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|wandering_profession_year}}
|
| I have wandered [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.
|}

== Adding custom files ==

While any of the hardcoded speech files can be edited to customize the used phrases, it is also possible to add new files and associate them with custom creatures.

{| class="wikitable"
|+ [[Creature token]]s
! Token !! Example uses

|-
| [[Creature token#CASTE_SPEECH|CASTE_SPEECH]]
|

|-
| [[Creature token#LAIR_HUNTER_SPEECH|LAIR_HUNTER_SPEECH]]
| [[minotaur]] ([[#lair_hunter_minotaur|lair_hunter_minotaur.txt]])

|-
| [[Creature token#SPEECH|SPEECH]]
| [[dwarf]] ([[#dwarf|dwarf.txt]]), [[elf]] ([[#elf|elf.txt]])

|-
| [[Creature token#SPEECH_FEMALE|SPEECH_FEMALE]]
|

|-
| [[Creature token#SPEECH_MALE|SPEECH_MALE]]
|
|}

== Special tokens ==

Speech files can contain tokens in square brackets (<code>[]</code>), which are replaced with context-specific strings before the speech is displayed.

{| class="wikitable"
! Token !! Meaning
|}

[[Category:DF2014:Files]]
[[Category:DF2014:Modding]]

Speech file

2015-09-20T12:53:34Z

FortressBuilder: Add information about creature tokens

'''Speech files''' are text files that define sentences which can be spoken by people in [[adventure mode]]. They are found in the <code>data/speech</code> folder.

== List of files ==

{| class="wikitable"
! File !! Uses !! Example
|-
| {{text anchor|ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|animal_slayer}}
|
| I have taken down [CONTEXT:NUMBER] [CONTEXT:RACE:NUMBERED_NAME] while stalking [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|arch_info_justification}}
|
| It is said that the [CONTEXT:ARCH_ELEMENT] of [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] [CONTEXT:JUSTIFICATION] [CONTEXT:DEF_SPHERE] for the glory of [CONTEXT:HIST_FIG:TRANS_NAME].

|-
| {{text anchor|child_age_proclamation}}
|
| I'm [CONTEXT:NUMBER]!

|-
| {{text anchor|current_profession_no_year}}
|
| I am a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|current_profession_year}}
|
| This is my [CONTEXT:ORDINAL] year as a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|curse}}
|
| Who dares to enter my house? I curse you!

|-
| {{text anchor|dwarf}}
| Used when boasting about killing a [[dwarf]]. See also [[Creature token#SPEECH]].
| whose hammer shattered on the anvil of my power

|-
| {{text anchor|elf}}
| Used when boasting about killing an [[elf]]. See also [[Creature token#SPEECH]].
| whose fragile bones shattered before the power of my contempt

|-
| {{text anchor|family_relationship_additional}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] is also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_additional_dead}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] was also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_no_spec}}
|
| I have [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_no_spec_dead}}
|
| I had [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] is named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec_dead}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] was named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|general}}
|
| who lies dead, now only an embarrassing memory

|-
| {{text anchor|goodbye_worship_1}}
|
| upon arising in the mornings,

|-
| {{text anchor|goodbye_worship_2}}
|
| always remember to

|-
| {{text anchor|goodbye_worship_3}}
|
| speak the praises of [SPEAKER:HF_LINK:DEITY:RANDOM_DEF_SPHERE]

|-
| {{text anchor|greet}}
| Used when greeting another person.
| Greetings. My name is [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_baby}}
| Used when greeting a [[baby]].
| A baby! How adorable!

|-
| {{text anchor|greet_reply}}
| Used when replying to another person's greeting.
| Ah, hello. I'm [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_after_hero}}
| Used by NPCs when replying to the player character's greeting after becoming a [[hero]].
| I am [SPEAKER:TRANS_NAME]. How can I be of service?

|-
| {{text anchor|greet_reply_diff_language}}
| Used when replying to the greeting of a person which is of another [[race]].
| Hello, [AUDIENCE:RACE]. I am [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_unusual_first}}
| Used when replying to the greeting of a person whose first name is unusual.{{verify|June 2015}}
| You know, you don't meet many people with the name [AUDIENCE:FIRST_NAME]

|-
| {{text anchor|greet_worship}}
| Used for greetings by [[priest]]s and faithful people.{{verify|June 2015}}
| This servant of [SPEAKER:HF_LINK:DEITY:TRANS_NAME] greets you.

|-
| {{text anchor|guard_profession}}
| Used by [[guard]]s when you ask them about their profession. See also [[#soldier_profession|soldier_profession]].
| I am a guard.

|-
| {{text anchor|guard_warning}}
|
| Don't start any trouble.

|-
| {{text anchor|hist_fig_slayer}}
|
| It is I that felled [CONTEXT:HIST_FIG:TRANS_NAME] the [CONTEXT:HIST_FIG:RACE].

|-
| {{text anchor|hunting_profession}}
|
| I hunt great beasts in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|hunting_profession_year}}
|
| I have hunted great beasts in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|justification_antithetical}}
|
| can be thought of as the antithesis of

|-
| {{text anchor|justification_experience}}
|
| can allow one to experience

|-
| {{text anchor|justification_proximity}}
|
| can bring one near to

|-
| {{text anchor|justification_reminder}}
|
| can remind one of

|-
| {{text anchor|justification_representation}}
|
| can be thought of as a representation of

|-
| {{text anchor|lair_hunter_minotaur}}
| Used by [[minotaur]]s while hunting adventures in their lairs. See also [[Creature token#LAIR_HUNTER_SPEECH]].
| I'll eat you whole!

|-
| {{text anchor|mercenary_profession}}
|
| I seek fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|mercenary_profession_year}}
|
| I have sought fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|no_family}}
| Used by NPCs when you ask them about their [[family]], but they don't have any.
| I have no family to speak of.

|-
| {{text anchor|past_hunting_profession}}
|
| In the past, I hunted great beasts.

|-
| {{text anchor|past_mercenary_profession}}
|
| In the past, I sought fortune and glory by offering my skill at arms.

|-
| {{text anchor|past_profession_no_year}}
|
| I was once a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|past_profession_year}}
|
| I was a [CONTEXT:UNIT_NAME] for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|past_scouting_profession}}
|
| At one time, I was a scout.

|-
| {{text anchor|past_snatcher_profession}}
|
| Once it was my calling to rescue lost children.

|-
| {{text anchor|past_thief_profession}}
|
| I once sought great treasures.

|-
| {{text anchor|past_wandering_profession}}
|
| I once wandered the wilds.

|-
| {{text anchor|positive}}
| Used to express positive [[feeling]]s.
| wonderful!<br/>fantastic!<br/>very good

|-
| {{text anchor|same_site_ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME]

|-
| {{text anchor|same_site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|scouting_profession}}
|
| It is my duty to scout the area around [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|scouting_profession_year}}
|
| I have been scouting the area around [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|slayer}}
|
| bane<br/>death<br/>nemesis<br/>vanquisher

|-
| {{text anchor|snatcher_profession}}
|
| I rescue lost children and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|snatcher_profession_year}}
|
| For [CONTEXT:NUMBER] of my years, I have been rescuing lost children and bringing them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|soldier_profession}}
| Used by [[soldier]]s when you ask them about their profession. See also [[#guard_profession|guard_profession]].
| I am a soldier.

|-
| {{text anchor|task_recommendation}}
|
| [CONTEXT:ANY:TRANS_NAME] might have a task for you

|-
| {{text anchor|temple_already_member}}
|
| your task is simple;<br/>all you need is to

|-
| {{text anchor|temple_become_member}}
|
| Welcome to [CONTEXT:ENTITY:TRANS_NAME]. Praise be to [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME]!<br/>As a member of [CONTEXT:ENTITY:TRANS_NAME], you can now seek the higher mysteries of [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME].

|-
| {{text anchor|thief_profession}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|thief_profession_year}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME] and have done so for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|threat}}
| Used by NPC [[bandit]]s{{verify|June 2015}} before attacking you.
| Prepare to die!

|-
| {{text anchor|unknown_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME], wherever [CONTEXT:HIST_FIG:PRO_SUB] might be

|-
| {{text anchor|wandering_profession}}
|
| I wander [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|wandering_profession_year}}
|
| I have wandered [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.
|}

== Adding custom files ==

While any of the hardcoded speech files can be edited to customize the used phrases, it is also possible to add new files and associate them with custom creatures.

{| class="wikitable"
|+ [[Creature token]]s
! Token !! Examples

|-
| [[Creature token#LAIR_HUNTER_SPEECH|LAIR_HUNTER_SPEECH]]
| [[minotaur]]
|}

== Special tokens ==

Speech files can contain tokens in square brackets (<code>[]</code>), which are replaced with context-specific strings before the speech is displayed.

{| class="wikitable"
! Token !! Meaning
|}

[[Category:DF2014:Files]]
[[Category:DF2014:Modding]]

Speech file

2015-09-11T06:49:53Z

FortressBuilder: /* List of files */ Fill in more examples

'''Speech files''' are text files that define sentences which can be spoken by people in [[adventure mode]]. They are found in the <code>data/speech</code> folder.

== List of files ==

{| class="wikitable"
! File !! Uses !! Example
|-
| {{text anchor|ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|animal_slayer}}
|
| I have taken down [CONTEXT:NUMBER] [CONTEXT:RACE:NUMBERED_NAME] while stalking [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|arch_info_justification}}
|
| It is said that the [CONTEXT:ARCH_ELEMENT] of [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] [CONTEXT:JUSTIFICATION] [CONTEXT:DEF_SPHERE] for the glory of [CONTEXT:HIST_FIG:TRANS_NAME].

|-
| {{text anchor|child_age_proclamation}}
|
| I'm [CONTEXT:NUMBER]!

|-
| {{text anchor|current_profession_no_year}}
|
| I am a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|current_profession_year}}
|
| This is my [CONTEXT:ORDINAL] year as a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|curse}}
|
| Who dares to enter my house? I curse you!

|-
| {{text anchor|dwarf}}
| Used when boasting about killing a [[dwarf]].
| whose hammer shattered on the anvil of my power

|-
| {{text anchor|elf}}
| Used when boasting about killing an [[elf]].
| whose fragile bones shattered before the power of my contempt

|-
| {{text anchor|family_relationship_additional}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] is also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_additional_dead}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] was also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|family_relationship_no_spec}}
|
| I have [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_no_spec_dead}}
|
| I had [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] is named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|family_relationship_spec_dead}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] was named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|general}}
|
| who lies dead, now only an embarrassing memory

|-
| {{text anchor|goodbye_worship_1}}
|
| upon arising in the mornings,

|-
| {{text anchor|goodbye_worship_2}}
|
| always remember to

|-
| {{text anchor|goodbye_worship_3}}
|
| speak the praises of [SPEAKER:HF_LINK:DEITY:RANDOM_DEF_SPHERE]

|-
| {{text anchor|greet}}
| Used when greeting another person.
| Greetings. My name is [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_baby}}
| Used when greeting a [[baby]].
| A baby! How adorable!

|-
| {{text anchor|greet_reply}}
| Used when replying to another person's greeting.
| Ah, hello. I'm [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_after_hero}}
| Used by NPCs when replying to the player character's greeting after becoming a [[hero]].
| I am [SPEAKER:TRANS_NAME]. How can I be of service?

|-
| {{text anchor|greet_reply_diff_language}}
| Used when replying to the greeting of a person which is of another [[race]].
| Hello, [AUDIENCE:RACE]. I am [SPEAKER:TRANS_NAME].

|-
| {{text anchor|greet_reply_unusual_first}}
| Used when replying to the greeting of a person whose first name is unusual.{{verify|June 2015}}
| You know, you don't meet many people with the name [AUDIENCE:FIRST_NAME]

|-
| {{text anchor|greet_worship}}
| Used for greetings by [[priest]]s and faithful people.{{verify|June 2015}}
| This servant of [SPEAKER:HF_LINK:DEITY:TRANS_NAME] greets you.

|-
| {{text anchor|guard_profession}}
| Used by [[guard]]s when you ask them about their profession. See also [[#soldier_profession|soldier_profession]].
| I am a guard.

|-
| {{text anchor|guard_warning}}
|
| Don't start any trouble.

|-
| {{text anchor|hist_fig_slayer}}
|
| It is I that felled [CONTEXT:HIST_FIG:TRANS_NAME] the [CONTEXT:HIST_FIG:RACE].

|-
| {{text anchor|hunting_profession}}
|
| I hunt great beasts in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|hunting_profession_year}}
|
| I have hunted great beasts in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|justification_antithetical}}
|
| can be thought of as the antithesis of

|-
| {{text anchor|justification_experience}}
|
| can allow one to experience

|-
| {{text anchor|justification_proximity}}
|
| can bring one near to

|-
| {{text anchor|justification_reminder}}
|
| can remind one of

|-
| {{text anchor|justification_representation}}
|
| can be thought of as a representation of

|-
| {{text anchor|lair_hunter_minotaur}}
|
| I'll eat you whole!

|-
| {{text anchor|mercenary_profession}}
|
| I seek fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|mercenary_profession_year}}
|
| I have sought fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|no_family}}
| Used by NPCs when you ask them about their [[family]], but they don't have any.
| I have no family to speak of.

|-
| {{text anchor|past_hunting_profession}}
|
| In the past, I hunted great beasts.

|-
| {{text anchor|past_mercenary_profession}}
|
| In the past, I sought fortune and glory by offering my skill at arms.

|-
| {{text anchor|past_profession_no_year}}
|
| I was once a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|past_profession_year}}
|
| I was a [CONTEXT:UNIT_NAME] for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|past_scouting_profession}}
|
| At one time, I was a scout.

|-
| {{text anchor|past_snatcher_profession}}
|
| Once it was my calling to rescue lost children.

|-
| {{text anchor|past_thief_profession}}
|
| I once sought great treasures.

|-
| {{text anchor|past_wandering_profession}}
|
| I once wandered the wilds.

|-
| {{text anchor|positive}}
| Used to express positive [[feeling]]s.
| wonderful!<br/>fantastic!<br/>very good

|-
| {{text anchor|same_site_ab_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME]

|-
| {{text anchor|same_site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|scouting_profession}}
|
| It is my duty to scout the area around [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|scouting_profession_year}}
|
| I have been scouting the area around [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|site_specific_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|slayer}}
|
| bane<br/>death<br/>nemesis<br/>vanquisher

|-
| {{text anchor|snatcher_profession}}
|
| I rescue lost children and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|snatcher_profession_year}}
|
| For [CONTEXT:NUMBER] of my years, I have been rescuing lost children and bringing them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|soldier_profession}}
| Used by [[soldier]]s when you ask them about their profession. See also [[#guard_profession|guard_profession]].
| I am a soldier.

|-
| {{text anchor|task_recommendation}}
|
| [CONTEXT:ANY:TRANS_NAME] might have a task for you

|-
| {{text anchor|temple_already_member}}
|
| your task is simple;<br/>all you need is to

|-
| {{text anchor|temple_become_member}}
|
| Welcome to [CONTEXT:ENTITY:TRANS_NAME]. Praise be to [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME]!<br/>As a member of [CONTEXT:ENTITY:TRANS_NAME], you can now seek the higher mysteries of [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME].

|-
| {{text anchor|thief_profession}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|thief_profession_year}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME] and have done so for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|threat}}
| Used by NPC [[bandit]]s{{verify|June 2015}} before attacking you.
| Prepare to die!

|-
| {{text anchor|unknown_hf_seeker}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME], wherever [CONTEXT:HIST_FIG:PRO_SUB] might be

|-
| {{text anchor|wandering_profession}}
|
| I wander [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|wandering_profession_year}}
|
| I have wandered [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.
|}

== Special tokens ==

Speech files can contain tokens in square brackets (<code>[]</code>), which are replaced with context-specific strings before the speech is displayed.

{| class="wikitable"
! Token !! Meaning
|}

[[Category:DF2014:Files]]
[[Category:DF2014:Modding]]