Dwarf Fortress Wiki - User contributions [en]

Marlin

2017-09-21T15:30:53Z

TheCrazyHamsteR:

{{Quality|Superior|07:34, 10 November 2013 (UTC)}}

{{Creaturelookup/0
|contrib=no
|eye=2
|heart=1
|intestine=5-6
|liver=2
|tripe=2
|sweetbread=1
|spleen=1
|kidney=2
|fat=8
|brain=2
|skull=1
|meat=24-38
|bone=12
|skin=scale
|wiki=yes
}}
{{av}}
{{creaturedesc}}

'''Marlins''' are a species of large [[Creature|fish]] who can be found in [[temperate]] and [[tropical]] [[ocean]]s. They are quite large, over 13 times heavier than a [[dwarf]], and as such provide a great amount of returns when [[butcher]]ed. As non-[[vermin]] fish, marlins can't be fished by [[Fisherdwarf|fisherdwarves]], but can be caught with the use of a [[drowning chamber]]. Infant marlins are called ''marlin fry''.

Some dwarves [[Preferences|like]] marlins for their ''sharp snout''.

[[File:Atlantic blue marlin.jpg|thumb|400px|center|Admired for its ''sharp snout''.]]

{{gamedata}}
{{Creatures}}
{{Category|Animals}}

Interaction token

2017-09-20T11:37:12Z

TheCrazyHamsteR: /* Interaction Definitions */

{{av}}

The following tokens can be used to define and use interactions.

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

|-
| {{text anchor|I_SOURCE}}
| Global
| type
| Defines what things are capable of triggering this interaction. Can be specified multiple times. Valid values:
* REGION - The interaction takes place in particular types of regions in the world.
* SECRET - The interaction is a secret that can be learned by particular individuals.
* DISTURBANCE - The interaction is triggered when disturbing a [[tomb]].
* DEITY - The interaction is inflicted upon mortals by the gods.
* ATTACK - The interaction is triggered by an attack during combat.
* INGESTION - The interaction is triggered by eating or drinking something.
* CREATURE_ACTION - The interaction is triggered by an explicit action.
* UNDERGROUND_SPECIAL - The interaction takes place in [[Demonic fortress|curious underground structure]]s.

|-
| {{text anchor|IS_HIST_STRING_1}}
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure. Displayed after the name of the historical figure that performed the interaction.

[IS_HIST_STRING_1: cursed ]

|-
| {{text anchor|IS_HIST_STRING_2}}
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure. Displayed after the name of the historical figure that was targeted by the interaction.

[IS_HIST_STRING_2: to assume the form of a lizard-like monster every full moon]

|-
| {{text anchor|IS_FREQUENCY}}
| Within I_SOURCE
| Number
| Presumably, the probability of biome specified by [IS_REGION] to have this interaction.

|-
| {{text anchor|IS_NAME}}
| Within I_SOURCE
| string
| Generally used with secrets, describes what the secret is about.

|-
| {{text anchor|IS_REGION}}
| Within I_SOURCE:REGION
| Region type
| Indicates what types regions are capable of performing this interaction. Can be specified multiple times. Valid values:
* ANY
* ANY_TERRAIN
* NORMAL_ALLOWED
* EVIL_ALLOWED
* GOOD_ALLOWED
* SAVAGE_ALLOWED
* EVIL_ONLY
* GOOD_ONLY
* SAVAGE_ONLY
* Region type - SWAMP, DESERT, FOREST, MOUNTAINS, OCEAN, LAKE, GLACIER, TUNDRA, GRASSLAND, HILLS

|-
| {{text anchor|IS_SPHERE}}
| Within I_SOURCE:SECRET
| [[Sphere]]
| Indicates the sphere to which this secret pertains. Only one sphere can be defined for each [I_SOURCE:SECRET] token, thus several [I_SOURCE:SECRET] tokens required to create a valid custom secret, which belongs to several different spheres

|-
| {{text anchor|IS_SECRET_GOAL}}
| Within I_SOURCE:SECRET
| Secret Goal token
| Indicates why somebody would want to learn the secret. Valid values:
* STAY_ALIVE
* MAINTAIN_ENTITY_STATUS
* START_A_FAMILY
* RULE_THE_WORLD
* CREATE_A_GREAT_WORK_OF_ART
* CRAFT_A_MASTERWORK
* BRING_PEACE_TO_THE_WORLD
* BECOME_A_LEGENDARY_WARRIOR
* MASTER_A_SKILL
* FALL_IN_LOVE
* SEE_THE_GREAT_NATURAL_SITES
* IMMORTALITY
However, currently only immortality will result in a secret being pursued during world-gen.

|-
| {{text anchor|IS_SECRET}}
| Within I_SOURCE:SECRET
| Secret Flag
| Indicates how the secret can be learned. Valid values:
* SUPERNATURAL_LEARNING_POSSIBLE - the secret can be learned by supernatural means
* MUNDANE_RESEARCH_POSSIBLE - the secret can be researched by mundane means
* MUNDANE_TEACHING_POSSIBLE - the secret can be taught to apprentices
* MUNDANE_RECORDING_POSSIBLE:objects/text/(book_title).txt:objects/text/(book_topic).txt - the secret can be written in books with the specified title. If this tag is present, a slab will be created upon learning the secret by supernatural means.
|-
| {{text anchor|IS_USAGE_HINT}}
| Within I_SOURCE:DEITY
| Usage Hint token
| Indicates why a deity would choose to perform this interaction. See CDI:USAGE_HINT below for valid values - in this context, MAJOR_CURSE is the only value that makes sense.

|-
| {{text anchor|I_TARGET}}
| Global
| id, type
| Specifies what things this interaction acts upon. Can be specified multiple times. Valid values:
* CORPSE - Also includes pieces of corpses
* CREATURE
* MATERIAL
* LOCATION

|-
| {{text anchor|IT_LOCATION}}
| Within I_TARGET
| Location
| Narrows down exactly what the interaction targets. Valid values:
* CONTEXT_REGION - Can only be used by IS_REGION interactions.
* CONTEXT_CREATURE
* CONTEXT_CREATURE_OR_LOCATION - Lets projectiles be aimed at specific creatures.
* CONTEXT_ITEM - Used when the target is a CORPSE.
* CONTEXT_BP - Use body part from CDI:BP_REQUIRED token (below).
* CONTEXT_LOCATION
* CONTEXT_MATERIAL
|-
| {{text anchor|IT_MANUAL_INPUT}}
| Within I_TARGET
| text
| Tells the player what they should be selecting. If not specified, the player will only be able to target himself.

|-
| {{text anchor|IT_AFFECTED_CREATURE}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| CREATURE:CASTE
| Specifies specific creatures the interaction can target.

|-
| {{text anchor|IT_AFFECTED_CLASS}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature class
| Specifies creature classes the interaction can target.

|-
| {{text anchor|IT_IMMUNE_CREATURE}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| CREATURE:CASTE
| Specifies specific creatures the interaction cannot target.

|-
| {{text anchor|IT_IMMUNE_CLASS}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature class
| Specifies creature classes the interaction cannot target.

|-
| {{text anchor|IT_REQUIRES}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature token or property
| Indicates that the target must have the specified property. Valid values:
* FIT_FOR_ANIMATION - Any corpse or body part that can become a zombie (heads, hands, etc.)
* FIT_FOR_RESURRECTION - The target corpse's UPPERBODY must be attached.
* HAS_BLOOD
* MORTAL
* NO_AGING
* STERILE
* Creature token: BLOODSUCKER, CAN_LEARN, CAN_SPEAK, CRAZED, EXTRAVISION, LIKES_FIGHTING (or LIKESFIGHTING), MISCHIEVOUS (or MISCHIEVIOUS), NO_CONNECTIONS_FOR_MOVEMENT, NO_DIZZINESS, NO_DRINK, NO_EAT, NO_FEVERS, NO_PHYS_ATT_GAIN, NO_PHYS_ATT_RUST, NO_SLEEP, NO_THOUGHT_CENTER_FOR_MOVEMENT, NOBREATHE, NOEMOTION, NOEXERT, NOFEAR, NONAUSEA, NOPAIN, NOSTUN, NOT_LIVING, NOTHOUGHT, OPPOSED_TO_LIFE, PARALYZEIMMUNE, SUPERNATURAL, TRANCES, UTTERANCES

|-
| {{text anchor|IT_FORBIDDEN}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature token or property
| Indicates that the target must not have the specified property. Valid values are the same as for IT_REQUIRES.

|-
| {{text anchor|IT_CANNOT_TARGET_IF_ALREADY_AFFECTED}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
|
| Prevents the interaction from targeting a creature that's already under the effect of the same interaction.

|-
| {{text anchor|IT_CANNOT_HAVE_SYNDROME_CLASS}}
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| [[Syndrome]] class
| Prevents the interaction from targeting a creature under the effects of a syndrome having the specified SYN_CLASS value.

|-
| {{text anchor|IT_MATERIAL}}
| Within I_TARGET:MATERIAL
| Type
| Specifies the type of material the interaction targets. Valid values:
* FLOW:Breath attack token - Specifies an attack not made of any material.
* MATERIAL:[[Material token]]:Breath attack token - Specifies an attack made of a specific material.
* CONTEXT_MATERIAL - Use material from CDI:MATERIAL token (below).

|-
| {{text anchor|I_EFFECT}}
| Global
| type
| Specifies what the interaction does to the targets. Can be specified multiple times. Valid values:
* ANIMATE - Raises the target corpse/bodypart as a zombie. The zombie will always be hostile to life and will retain no information about its original personality/loyalties. Syndromes can also be specified within this tag. If present on a regional interaction, the region will have undead wildlife.
* ADD_SYNDROME - Adds one or more syndromes. The actual syndrome is specified with the [SYNDROME] tag.
* RESURRECT - Returns the creature to life. This can be used on parts that are not FIT_FOR_RESURRECTION, but only the main part (with an UPPERBODY attached) will remain loyal to its original faction. Syndromes can also be specified within this tag.
* CLEAN - Cleans off most liquids/dust covering the creature.
* CONTACT - Causes the creatures to touch.
* MATERIAL_EMISSION - Causes a particular material to be emitted. Used by [[evil weather]] and the MATERIAL_EMISSION interaction.
* HIDE - Allows the creature to hide even if another creature can see it.

|-
| {{text anchor|IE_TARGET}}
| Within I_EFFECT
| ID
| Specifies which I_TARGET this effect will be applied to

|-
| {{text anchor|IE_INTERMITTENT}}
| Within I_EFFECT
| Frequency
| Indicates that the effect happens intermittently and specifies roughly how often. Valid values:
* WEEKLY
* MONTHLY
note:
DAILY and YEARLY also exist in the string dump but haven't been tested fully.
|-
| {{text anchor|IE_IMMEDIATE}}
| Within I_EFFECT
|
| Indicates that the effect happens immediately.

|-
| {{text anchor|IE_LOCATION}}
| Within I_EFFECT
| Location Hint
| Indicates where the effect can take place. Valid values:
* IN_WATER
* IN_MAGMA
* NO_WATER
* NO_MAGMA

|-
| {{text anchor|IE_ARENA_NAME}}
| Within I_EFFECT
| text
| Allows the interaction to be applied to newly spawned creatures in Arena mode.

|-
| {{text anchor|IE_GRIME_LEVEL}}
| Within I_EFFECT:CLEAN
| amount?
| [IE_GRIME_LEVEL:2] appears in the default cleaning interaction, and may indicate amount of grime cleaned.

|-
| {{text anchor|IE_SYNDROME_TAG}}
| Within I_EFFECT:CLEAN
| Syndrome flag
| Indicates that cleaning off materials will activate their syndromes if they have this flag.

|-
| {{text anchor|GENERATED}}
| Global
|
| Indicates that this is a generated interaction. Cannot be specified in user-defined raws.

|}

==Interaction Usage==
In order to actually use an interaction, add the [[creature token]] [CAN_DO_INTERACTION:NAME] followed by a series of [CDI:...] tokens. Interactions can also be granted through [[syndrome]]s using the token [CE_CAN_DO_INTERACTION] (plus the same series of CDI tokens).

The following CDI tokens can be specified:
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| {{text anchor|INTERACTION}}
| id
| Specifies which interaction can be performed. Only to be used with syndromes, since CE_CAN_DO_INTERACTION does not allow specifying the interaction ID directly.

|-
| {{text anchor|TARGET}}
| target ID, target types
| Specifies how the creature chooses what to target. Target ID refers to an I_TARGET defined in the interaction itself. Multiple target types can be specified. If no target is specified, creature will target any available target within range, even through walls. Valid target types:
* LINE_OF_SIGHT - the source needs to be able to see the target
* TOUCHABLE - the source needs to be able to touch the target
* DISTURBER_ONLY - the target must be whoever disturbed the source
* SELF_ALLOWED - the target can be the source
* SELF_ONLY - the target '''must''' be the source

|-
| {{text anchor|TARGET_RANGE}}
| target ID, range
| Specifies how far away the target can be, in tiles. For SOLID_GLOB, LIQUID_GLOB and FIREBALL breath attacks also determines how far the projectiles will fly before falling to the ground.

|-
| {{text anchor|LOCATION_HINT}}
| Location Hint (see above)
| ?

|-
| {{text anchor|USAGE_HINT}}
| Usage hint token
| Indicates when and how CPU-controlled creatures will use the interaction. If no hint is specified, the interaction will be used whenever a valid target is available. Valid values:
* MAJOR_CURSE - Used in disturbance curses and deity curses. Targets the tomb disturber/temple defiler.
* GREETING - Creatures will target 'friendly' creatures, usually at random.
* CLEAN_SELF - Creature targets itself when covered in liquids or dust.
* CLEAN_FRIEND - Same, but targets other friendly units.
* ATTACK - Targets enemy creatures in combat. If the interaction specifies SELF_ONLY, CPU-controlled creatures will never use it.
* FLEEING - Used when fleeing an enemy. Creature will target itself.
* NEGATIVE_SOCIAL_RESPONSE - Used when a creature is expressing contempt (for example, to a murderer). Used for spitting by civilised races.
* TORMENT

|-
| {{text anchor|ADV_NAME}}
| text
| Specifies the interaction's name when used in Adventurer mode.

|-
| {{text anchor|MAX_TARGET_NUMBER}}
| ID, number
| Specifies the maximum number of things that can be selected for a particular I_TARGET.

|-
| {{text anchor|WAIT_PERIOD}}
| number
| Controls how often the interaction can be used.

|-
| {{text anchor|VERBAL}}
|
| Only creatures that can speak will be able to use the interaction. Might also be needed for VERBAL_SPEECH.

|-
| {{text anchor|VERBAL_SPEECH}}
| filename
| Specifies what the creature says when they perform the interaction. Filename path is relative to /data/speech.

|-
| {{text anchor|CAN_BE_MUTUAL}}
|
| Presumably, allows two creatures with this same interaction to use it on each other simultaneously, for example cats cleaning each other.

|-
| {{text anchor|FREE_ACTION}}
|
| Indicates that performing the interaction doesn't take any time.

|-
| {{text anchor|VERB}}
| self:other:mutual
| When a creature uses the interaction, a message will display, describing the source as doing this.

|-
| {{text anchor|VERB_REVERSE}}
| ?
| ?

|-
| {{text anchor|TARGET_VERB}}
| self:other
| When a creature uses the interaction, a message will display, describing the target as doing this.

|-
| {{text anchor|BP_REQUIRED}}
| Body part criteria
| Indicates that a particular body part must be present in order to perform the interaction. Criteria are BY_CATEGORY:category, BY_TYPE:type, or BY_TOKEN:token.

|-
| {{text anchor|FLOW}}
| [[#Breath Attack Types|Breath attack token]]
| Causes the interaction to create an effect not made of any material. Only makes sense for FIREBALL, FIREJET, or DRAGONFIRE.

|-
| {{text anchor|MATERIAL}}
| [[Material token]]:Breath attack token
| Causes the interaction to create an effect made of a specific material. Doesn't make sense for FIREBALL, FIREJET, or DRAGONFIRE.

|}

==Breath attacks==
Breath attacks are controlled by the MATERIAL_EMISSION interaction, like so:

[CAN_DO_INTERACTION:MATERIAL_EMISSION]
[CDI:ADV_NAME:Breath custom material]
[CDI:USAGE_HINT:ATTACK]
[CDI:BP_REQUIRED:BY_CATEGORY:MOUTH]
[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]
[CDI:TARGET:C:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:C:15]
[CDI:MAX_TARGET_NUMBER:C:1]
[CDI:WAIT_PERIOD:50]

The most important part is this line:

[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]

The CDI refers to CAN_DO_INTERACTION; the MATERIAL states that this line shows what the material is. LOCAL_CREATURE_MAT:CUSTOMMATERIAL is your material, and TRAILING_VAPOR_FLOW refers to the breath attack type. Other types are seen below. Also important is this line:

[CDI:TARGET:C:LINE_OF_SIGHT]

LINE_OF_SIGHT refers to where the target C may be; others include SELF_ALLOWED (presumably like LINE_OF_SIGHT, but with the creature allowed to target itself), SELF_ONLY (preferable for undirected attacks and TOUCHABLE (for up-close attacks, as trailing flows tend to be).

===Breath Attack Types===

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Description
|-
| TRAILING_DUST_FLOW
| Lets out a cloud of solid dust. Appears to use cave-in dust physics, causing this to fling around anything it comes in contact with, making it capable of smashing creatures into the ground and flinging them over walls. Creature will attack as normal.
|-
| TRAILING_VAPOR_FLOW
| Shoots a trail of liquid mist at the target which can condense and trigger contact syndromes. Creature will attack as normal.
|-
| TRAILING_GAS_FLOW
| Shoots a trail of gas substance at the creature which can be inhaled. Creature will attack as normal.
|-
| TRAILING_ITEM_FLOW:[[item token]]
| Shoots a "cloud" of items at the target, leaving piles of this item on the floor. Note that this does ''not'' create the actual items or use falling item mechanics (meaning no flying daggers or Touhou-style barrages, unfortunately). Instead, this token acts as TRAILING_GAS_FLOW, except that the material will use its ''normal'' temperature - for example, a breath attack of steel anvils will envelop the target in a "burst of steel". Creature will attack as normal.
|-
| SOLID_GLOB
| Shoots a solid glob of spinning substance at the creature, leaving symbols similar to broken arrows. Essentially a projectile weapon. If the cooldown rate is short enough, some creatures with this breath attack will not move, preferring instead to stay and shoot globs at you, even when you are literally right next to them.
|-
| LIQUID_GLOB
| Shoots a liquid glob of substance at the creature. Contact syndromes will take effect if the glob hits the target's exposed skin.
|-
| SPATTER_POWDER
| Creates a pile of powder at the specified location.
|-
| SPATTER_LIQUID
| Creates a pool of liquid at the specified location.
|-
| UNDIRECTED_GAS
| Creature occasionally releases a cloud of gas substance. Similar to TRAILING_GAS_FLOW, but undirected, thus affecting a larger area but losing the distance. Creature will attack as normal.
|-
| UNDIRECTED_VAPOR
| Creature occasionally releases a cloud of liquid mist. Similar to TRAILING_VAPOR_FLOW, but undirected, thus affecting a larger area but losing the distance. Creature will attack as normal.
|-
| UNDIRECTED_DUST
| Creature occasionally releases a cloud of solid dust, which will spread and dissipate. Similar to TRAILING_DUST_FLOW, but undirected, thus affecting a larger area but losing the distance - range is roughly the same as that of a cave-in. Creature will attack as normal. <s>DO NOT USE THIS TAG UNLESS YOU WANT TO KILL THE CREATURE AND EVERYTHING NEAR IT AND SEND PEOPLE FLYING.</s> You know you want to.
|-
| UNDIRECTED_ITEM_CLOUD:[[item token]]
| Creature occasionally releases a "cloud" of items at the target, leaving piles of this item on the floor. The same comments apply as TRAILING_ITEM_FLOW. Creature will attack as normal.
|-
| WEB_SPRAY
| Emits a burst of [[web]]s that entangle target creatures.
|-
| DRAGONFIRE
| Emits a wide cone of [[dragon]] [[fire]] that burns target creatures at a scorching {{ct|50000}}. For this you want FLOW instead of a material.
|-
| FIREJET
| Emits a narrow cone of [[fire]] that burns target creatures at {{ct|11000}}. For this you want FLOW instead of a material.
|-
| FIREBALL
| Emits a fireball that burns the target creature. For this you want FLOW instead of a material.
|-
| WEATHER_CREEPING_GAS
| Creates a cloud of gas that appears at the edge of the map and slowly creeps across the map. Not usable by creatures.
|-
| WEATHER_CREEPING_VAPOR
| Creates a cloud of creeping vapor. Not usable by creatures.
|-
| WEATHER_CREEPING_DUST
| Creates a cloud of creeping dust. Not usable by creatures.
|-
| WEATHER_FALLING_MATERIAL
| Causes it to start raining a particular material. If the material is solid at the outdoor temperatures, it will snow the material instead. Regardless of the nature of the material, being caught in it will give dwarves the bad thought of being 'caught in freakish weather lately'. Not usable by creatures.
|}

Keep in mind that you can use multiple breath attacks, which appears to make the creature choose between them at random. Creatures cannot use the WEATHER effects, these being reserved for regional interactions.

One major difference between GAS, VAPOR, and DUST is that if the material cannot exist in the specified state at the current temperature, it will automatically be created at a temperature allowing it to exist. So if you create a vapor spray that uses rock or metal as a material, that spray will be created at the material's melting point, setting everything it touches on fire. You can also create a freezing spray by using a custom material that has extremely low melting and/or boiling points.

If you give a creature a material breath attack, be aware that it will be caught in the attack more frequently than its own targets. Make sure to make your creatures immune to their own breath weapons!

==See Also==
* [[Syndrome]]

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

23a:Mandrill

2017-09-20T01:51:07Z

TheCrazyHamsteR:

{{Quality|Fine}}
{{23a creaturelookup/0}}
{{av}}

The '''mandrill''' is a large monkey. Like their cousins, the [[rhesus macaque]]s, they will attempt to raid your fortress' exterior for [[food]] and [[craft]]s. Unfortunately, the mandrill's bloodlust is only quenched by tearing off the limbs of nearby dwarves, and the only known survivors of the constant attacks by dismembering monkeys were the villagers of [[Main:Boatmurdered|Boatmurdered]]. According to reports, these beasts were easily capable of overwhelming a solitary [[dwarf]]. They attack in packs of five to ten. They can be [[tame]]d and made a [[pet]] if caught.

{{gamedata}}
{{Creatures}}
{{Category|Animals}}

File:MostlyJustDrink.PNG

2017-09-20T01:44:09Z

TheCrazyHamsteR: TheCrazyHamsteR uploaded a new version of "File:MostlyJustDrink.PNG": cropped

Hes a drunk, but moistly he just likes to drink

Unit type token

2017-09-20T01:30:38Z

TheCrazyHamsteR: info about numeration obtained through DFHack's gui/gm-editor

{{quality|Fine}}{{av}}
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}}||[[Armorsmith|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}}||[[Craftsdwarf|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}}||[[Fisherdwarf|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}}||[[Grower|Planter]]
|-
|49||{{text anchor|HERBALIST}}||[[Herbalist]]
|-
|50||{{text anchor|BREWER}}||[[Brewer]]
|-
|51||{{text anchor|SOAP_MAKER}}||[[Soaper|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}}||[[Diagnostician|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]]
|-
|111||{{text anchor|GELDER}}||[[Gelder]]
|-
|112||{{text anchor|PERFORMER}}{{version|0.42.01}}||[[Performer]]
|-
|113||{{text anchor|POET}}{{version|0.42.01}}||[[Poet]]
|-
|114||{{text anchor|BARD}}{{version|0.42.01}}||[[Bard]]
|-
|115||{{text anchor|DANCER}}{{version|0.42.01}}||[[Dancer]]
|-
|116||{{text anchor|SAGE}}{{version|0.42.01}}||[[Sage]]
|-
|117||{{text anchor|SCHOLAR}}{{version|0.42.01}}||[[Scholar]]
|-
|118||{{text anchor|PHILOSOPHER}}{{version|0.42.01}}||[[Philosopher]]
|-
|119||{{text anchor|MATHEMATICIAN}}{{version|0.42.01}}||[[Mathematician]]
|-
|120||{{text anchor|HISTORIAN}}{{version|0.42.01}}||[[Historian]]
|-
|121||{{text anchor|ASTRONOMER}}{{version|0.42.01}}||[[Astronomer]]
|-
|122||{{text anchor|NATURALIST}}{{version|0.42.01}}||[[Naturalist]]
|-
|123||{{text anchor|CHEMIST}}{{version|0.42.01}}||[[Chemist]]
|-
|124||{{text anchor|GEOGRAPHER}}{{version|0.42.01}}||[[Geographer]]
|-
|125||{{text anchor|SCRIBE}}{{version|0.42.01}}||[[Scribe]]
|-
|126||{{text anchor|PAPERMAKER}}{{version|0.42.01}}||[[Papermaker]]
|-
|127||{{text anchor|BOOKBINDER}}{{version|0.42.01}}||[[Bookbinder]]
|-
|128||{{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}}

Position token

2017-09-20T01:06:55Z

TheCrazyHamsteR: /* Position Tokens */ added info for [MENIAL_WORK_EXEMPTION] and [PUNISHMENT_EXEMPTION]

{{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 economy. Less than relevant right now.

|-
| {{text anchor|ALLOWED_CLASS}}
| CREATURE_CLASS 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 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 can not 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|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|COLLECT_TAXES}}
| Currently unused - was originally assigned to the Tax Collector

|-
| {{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|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|HEALTH_MANAGEMENT}}
| Found on chief medical dwarf. Position will use Diagnostician skill to enable the {{key|z}}-menu health screen.

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

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

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

Demon

2017-09-16T14:06:18Z

TheCrazyHamsteR:

{{Quality|Exceptional|07:11, 17 May 2015 (UTC)}}
{{av}}
{{spoiler}}[[File:Assdemon.png|thumb|center|600px|"Etar Patternedtombs was a mint green demon. It was the only one of its kind. A gigantic feathered ass twisted into humanoid form. It undulates rhythmically. Its mint green feathers are patchy. Beware its deadly gas!" ([http://www.bay12forums.com/smf/index.php?topic=76346.msg2667300#msg2667300 post]).]]

'''Demons''' {{Tile|&|7:0}} are procedurally-generated [[creature]]s who inhabit [[Hell]]. These immense, malicious and formidably powerful beasts are among the most powerful enemies in the game in both [[fortress mode]] and [[adventurer mode]].

==Demons==

Demons inhabit Hell. They are randomly generated at worldgen, creating unique [[fun]] for every player. Examples of possible demons include giant centipedes made of ash that hunger for blood, eyeless mosquitoes that spit toxins, and emaciated fruitbats with giant clicking mandibles. The amount of different types of demon created during world generation is closely related with world size, and it can be directly controlled with [[advanced world generation]] - a world generated with "{{tt|Number of Demon Types}}" set to {{tt|0}} in advanced world generation will not have any demons in it.

All demons share certain traits. They are [[Creature token#SUPERNATURAL|supernatural]], [[fanciful]], evil-aligned creatures represented by an ampersand with a randomized [[color]]. They are all able to swim in and [[Amphibious|breathe]] water and magma, and [[Building destroyer|destroy buildings]]. Furthermore, they are [[Trapavoid|immune to traps]], [[No Pain|pain]], fear, nausea, [[No Stun|stunning]], [[No Exert|exertion]], dizziness, fevers, fire, any sort of poison, and have fixed body temperature, thus are unaffected by extremes of heat and cold (even if made of materials that would suggest otherwise). They are very large (size 10,000,000, smaller than a [[megabeast]], but larger than a [[giant]] and 167 times the size of a [[dwarf]]). They don't require sleep, food, or drink. All non-unique demons start out at Accomplished [[skill]] level in the following combat skills: wrestling, biting, striking, kicking, fighting, archery, dodging, and observing. Unique demons start out at Grand Master in the same skills. All unique demons and roughly a half of non-unique ones possess intelligence ([[Creature token#CAN_LEARN|<code>[CAN_LEARN]</code>]] + [[Creature token#CAN_SPEAK|<code>[CAN_SPEAK]</code>]]), so demons you face may well have developed their skills to a higher level than they began with; however, their skills cannot rust to a lower level. The initial wave spawns exactly one frame after you open Hell; the amount spawned can range from 10 to over 100. Demons inhabiting Hell spawn in groups of 1-5 individuals. The size of their population, specified as 5-10 in the raws, appears to be irrelevant, as the game makes all inhabitants of Hell spawn in limitless numbers. As long as Hell is unsealed, demons will continue to wander in from the edges of the map indefinitely, due to having populations that are (functionally) infinite.

Demons receive large bonuses to every physical [[attribute]] except agility, and to the mental attributes of focus and willpower (also analytical ability, memory, linguistic ability, and social awareness, but those are less relevant). Many, but not all demons, are capable of flight. They may possess a wide variety of special attacks, including webbing, firebreath, poisonous appendages, toxic spittle or poison breath. Inorganic or zombie demons are especially difficult to kill; they can be killed by bisection, decapitation, or pulping via blunt weapons (inorganic blobs can only be killed in this manner), but this is far beyond the capacities of an ordinary dwarf.

Demons of each species can be all genderless, all male or all female, or have both male and female castes. The latter can breed if given enough time. All demons are born adults, and immediately reach their full size after being born. They have a [[pet|pet value]] of 2000☼, but cannot be tamed and you are rather unlikely to capture one. If you have deactivated compressed saves, the raws for given world's demons (as well as [[forgotten beast]]s, [[titan]]s, [[werebeast]]s, etc.) can be found in the [[Saved game folder|world.dat]] of its save folder.

Dwarves may [[Preferences|like]] a species of demon for their ''horrifying features'', their ''rhythmic undulations'' or their ''bloated appearance''.

== Their interaction with the world ==

[[File:Demon_banish.png|thumb|400px|Banishing a demon back to the Underworld]]
[[File:Demon_compel_service.png|thumb|400px|Compelling service from demon]]

Certain types of demons, those described as "being twisted into humanoid form" and marked with {{token|UNIQUE_DEMON|c}} instead of {{token|DEMON|c}} in world.dat, will occasionally escape the underworld. This happens by the aid of a [[deity]] matching that particular demon's [[sphere]] through a ritual conducted with an [[artifact]] [[slab]]. Once they are in the mortal world, they will gain rule over a [[goblin]] [[civilization]] - each goblin faction in the world will be led by a unique demon, and attempting to create a world without demons in it through [[advanced world generation]] will lead to goblin-less worlds. As noted in [[Legends|legends mode]], these demons will occasionally make journeys to the [[Cavern|depths of the world]] and tame the creatures that dwell in them - most specifically, species with the {{token|PET_EXOTIC}} token - going from [[giant rat]]s to [[voracious cave crawler]]s and [[cave dragon]]s. Presumably, this is how goblin civilizations gain access to these creatures to use them in [[siege]]s.

Found within the goblins' [[dark fortress]]es are demonic [[Underworld spire|spires]] made of [[slade]], whose lowermost levels lead directly into [[Hell]]. They will also create slade [[vault]]s, whose treasure is guarded by incredibly powerful and dangerous [[angel]]s. If you can manage to fight off those freakishly strong beings ([[Fun|don't expect to by the way]]), you can find in the vault's centre the slab that contains the demon's true name. Learning this name allows your adventurer to either banish it back to Hell or bind it to your servitude. Although you will have a next to unkillable super soldier on your side, should you opt for the latter, it's more of a bragging-rights reward if anything. Getting past the angels is already enough to make you a god among men.

Escaped demons can also take over human civilization by impersonating [[deities]] and having humans worship them. As with conventional lords you can encounter them as normal in adventure mode and they won't be hostile to you and they will behave as any other member of the civilization they rule. They can also arrive as non-hostile diplomats from human civilizations in fortress mode. Depending on the type of demon this can be mildly amusing or inadvertently deadly to your fort or adventurer.

In [[fortress mode]], goblin law-giver demons may arrive on a goblin siege and are most of the time very dangerous. {{verify}}

==Demon Generation==

Although the exact algorithm used to produce demons is unknown, something of the algorithm can be gathered from the string dump and analysis of demons. When generating a demon, the game begins by picking a creature from a predefined list, which is fixed and includes creatures not found in vanilla DF (such as anteater, ankylosaurid) and more general shapes (blob, quadruped, and humanoid). It is granted spheres, with a preference for "negative" spheres like misery, death, and torture. If inorganic, a material will be chosen, either one of the hardcoded (such as salt, ash, ice, or vomit), flames, or a randomly chosen raw-defined inorganic (any type of stone, soil, gem, metal, or other, such as gypsum plaster). If organic, it will get some sort of randomly-colored covering (such as feathers or hair) and/or have some feature (such as its eyes, nose or skin) removed. It will be granted a few "extra" features, like a tail, a trunk, or a shell, and a flavorful descriptor (such as "it knows and intones the names of all it encounters"). It may get some sort of special attack (such as a poisonous sting, toxic breath, fire breath). It will finally be given a name consisting of an adjective and a noun. The adjective will be based on the creature's color, its material (such as "inferno" or "snow"), what animal it's shaped like, or a descriptor (such as "winged" or "skinless"), and the noun chosen from the following list: demon, devil, fiend, brute, monster, spirit, ghost, banshee, haunt, phantom, specter, or wraith.

==Strategy==
[[File:Demon_Size.png|thumb|right|200px|Estimated size comparison between a typical demon, and a dwarf.]]
Of all of the challenges facing a player, defeating a demon horde is probably the most difficult, unless you are using certain [[trap]] schemes -- and even then, you will need to take special precautions.

===Containment===

Containment is the simplest strategy for dealing with demons. A simple constructed wall will block any demon. Because of their building destroyer status, demons cannot be contained via locked doors. However, indestructible artifact-quality portals can stop them, as can some bridges. As building destroyers can only destroy objects on the same z-level, a [[floor grate]] or forbidden [[hatch cover]] on a staircase/channel will also block movement. It may be difficult to lure demons away from artifact furniture, should the area need to be accessed to reset a trap. If using [[bridge]]s, be aware that any raising bridge that lands on a demon will deconstruct, and that demons can easily have internal temperatures greatly exceeding the melting points of [[steel]] or [[iron]], leading to deconstruction as they pass over them. Because of their vast numbers, containment is an important part of any attempt to defeat them -- fighting two groups of 25 demons is much easier than fighting one group of 50.

One particular gentleman, AussieGuy on the Bay12 forums, has found an ingenious method for disposing of an entire demonic invasion at once: a [[Megaprojects|stupid dwarven trick]] known as "the dwarven checkerboard".([http://www.bay12forums.com/smf/index.php?topic=94140.0 Source])

===Traps===

Because all demons avoid traps, trapping demons can be very difficult -- but not impossible. Demons become vulnerable to traps when they are webbed, so if you can find a way to get web onto your traps, the demons will be affected as any other creature (including your own dwarves!) would be.

Alternatively, advanced triggered traps may be used. Demons do not set off [[pressure plate]]s, but if you can contain them, retracting upright spikes, casting them into [[obsidian]], or caving a portion of mountain onto them are all effective. Any plan involving these kind of traps must involve both a way to bait the demons to where you want them and a way to keep the demons where you want them. Tame animals appear to work well as bait, but need to be replaced as they're killed. Bridges can be used to contain the demons, but be wary of the risks of deconstruction as described above.

Many traps need to be designed with the potential for extreme temperatures in mind. Obsidian trappers may find water used as the casting process boiling into steam before it contacts magma. Frequently, demons made of fire or steam explode on death, broiling nearby creatures and furniture. This effect can destroy upright spikes, leaving you with a trap chamber full of demons that you have no way to deal with. Demons do not destroy supports directly, but a hot enough demon may cause the destruction of nearby supports, just by virtue of the heat damage.

===Ranged Combat===

Ranged combat sounds appealing, especially in the face of demons that explode with unimaginable heat upon death, but should be considered carefully. Most demons have vastly more powerful ranged attacks than marksdwarves have. Demons made of weak materials can be easily killed or dismembered by bolts but inorganic demons composed of stronger stuff will only suffer chipped bones.

[[Fortification]]s are appealing, as they can be dug directly into [[adamantine]] without ever exposing your fortress to a path to the demons. Even demons made out of steam cannot pass through a fortification unless it is submerged in 7/7 water or magma. Demons with syndrome attacks may attack through fortifications even without a path, although they appear to do so less frequently than if they have a path.

Still, should you contain a group of demons composed of weaker materials, marksdwarves can be very effective.

===Melee Combat===

Demons can be very frightening melee opponents, as each one alone is nearly the size of a megabeast, extremely fast, and have tremendous natural combat skills. That would be bad enough, but there tends to be pages of them rather than individuals. However, demons can still be defeated in melee combat.

Despite their powerful attacks, many demons are made up of very flimsy materials, such as salt, snow, steam, or filth. A strong punch can decapitate creatures like this. Some demons, however, can be made of much harder materials, and it can be very difficult to bring down a demon composed of mineral or armor-quality metal. Blunt weapons can be reasonably effective against weaker material demons by severing limbs and body parts despite blunt status, but are not nearly as effective against demons as they are against earthly foes that suffer from pain and blood loss; without internal organs or blood loss, piercing weapons are relatively ineffective. Good slashing weapons can reliably take down demons of any material type.

The challenge of melee combat is how to deal with an enormous number of strong combatants while protecting against area of effect syndrome attacks and death explosions. Restraining visibility via a labyrinthine battle ground is a good start. The area effects suggest meeting them with successive small waves of melee dwarves, but if the dwarves are too few, they'll be butchered by hundreds of angry demons before making a dent.

In all cases, your demon-fighting melee dwarves should be very well armed and armored (steel and adamantine) and Legendary in some, if not all, of the relevant combat skills.

===Clean-up===

Unfortunately, once the wave of demons has been dealt with, it's not yet over. [[Syndrome]]-bearing dust and blood may litter the battlefield and your survivors, and can be very difficult to isolate and contain. Some dwarves may carry burning items back from their encounters with very hot demons. Survivors should all pass through a shallow pool of water to wash them and their equipment of anything dangerous and to douse any flames. Any path used for the fight is best abandoned and walled up. Demons will continue to enter Hell from its map edges, as wildlife do on the surface, but path differently from the initial wave, content to wander through hell even should a simple unobstructed path exist into your fortress.

==Killed demons==

Only unintelligent demons can be butchered in unmodded games, and butcheing them yields products similar to those from [[forgotten beast]]s, including copious amounts of [[meat]] and [[bone]]s, vividly-colored [[hair]], [[feather]]s, [[scale]]s or [[chitin]], and [[shell]]s, if the demon had one. All materials obtained from demons have a value multiplier of 1, and aren't appreciably better than their mundane counterparts.

Inorganic demons cannot be butchered, and after killing them you obtain only a massive demonic corpse to use in your [[stupid dwarf trick]].

{{D for Dwarf}}
Little do demons know that though their claws and fire cannot pierce the [[adamantine]] sealing them away, a simple [[copper]] [[pick]] can dig right through it with ease. Armok forbid these unholy creatures ever get their hands on one.

{{Translation
| dwarven = uthgúr
| elvish = slevina
| goblin = arstruk
| human = rohir
}}

{{Creatures}}
{{Category|Amphibious}}
{{Category|Building destroyer}}
{{Category|HFS}}
{{Category|Fanciful}}
{{Category|Fire immune}}
{{Category|Learns}}
{{Category|No Exert}}
{{Category|No Pain}}
{{Category|No Stun}}
[[ru:Demon]]

Skill token

2017-09-16T00:00:35Z

TheCrazyHamsteR: /* Skills By Type */

{{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
| [[Beekeeper]]

|-
| BONECARVE
| [[Bone carver]]

|-
| BOOKBINDING{{version|0.42.01}}
| [[Bookbinder]]

|-
| 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
| [[Blacksmith]]

|-
| FORGE_WEAPON
| [[Weaponsmith]]

|-
| GELD
| [[Gelder]]

|-
| GLASSMAKER
| [[Glassmaker]]

|-
| GLAZING
| [[Glazer]]

|-
| HERBALISM
| [[Herbalist]]

|-
| LEATHERWORK
| [[Leatherworker]]

|-
| LYE_MAKING
| [[Lye maker]]

|-
| MASONRY
| [[Mason]]

|-
| MECHANICS
| [[Mechanic]]

|-
| METALCRAFT
| [[Metalcrafter]]

|-
| MILLING
| [[Miller]]

|-
| MILK
| [[Milker]]

|-
| MINING
| [[Miner]]

|-
| OPERATE_PUMP
| [[Pump operator]]

|-
| PAPERMAKING{{version|0.42.01}}
| [[Papermaker]]

|-
| 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
| [[Stonecrafter]]

|-
| TANNER
| [[Tanner]]

|-
| TRAPPING
| [[Trapper]]

|-
| WAX_WORKING
| [[Wax worker]]

|-
| WEAVING
| [[Weaver]]

|-
| WOOD_BURNING
| [[Wood burner]]

|-
| WOODCRAFT
| [[Woodcrafter]]

|-
| WOODCUTTING
| [[Woodcutter]]

|}

===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}}
| [[Dancer]]

|-
| MAKE_MUSIC{{version|0.42.01}}
| [[Musician]]

|-
| PLAY_KEYBOARD_INSTRUMENT{{version|0.42.01}}
| [[Keyboardist]]

|-
| PLAY_PERCUSSION_INSTRUMENT{{version|0.42.01}}
| [[Percussionist]]

|-
| PLAY_STRINGED_INSTRUMENT{{version|0.42.01}}
| [[Stringed instrumentalist]]

|-
| PLAY_WIND_INSTRUMENT{{version|0.42.01}}
| [[Wind instrumentalist]]

|-
| SING{{version|0.42.01}}
| [[Singer]]

|}

===Knowledge Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| ASTRONOMY{{version|0.42.01}}
| [[Astronomer]]

|-
| CHEMISTRY{{version|0.42.01}}
| [[Chemist]]

|-
| CRITICAL_THINKING{{version|0.42.01}}
| [[Critical thinker]]

|-
| FLUID_ENGINEER{{version|0.42.01}}
| [[Fluid engineer]]

|-
| GEOGRAPHY{{version|0.42.01}}
| [[Geographer]]

|-
| LOGIC{{version|0.42.01}}
| [[Logician]]

|-
| MATHEMATICS{{version|0.42.01}}
| [[Mathematician]]

|-
| OPTICS_ENGINEER{{version|0.42.01}}
| [[Optics engineer]]

|}

===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
| [[Climber]]

|-
| 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}}

Dye

2017-09-15T22:16:26Z

TheCrazyHamsteR:

{{Quality|Superior|22:46, 20 September 2016 (UTC)}}
{{av}}

'''Dye''' can be used at the [[Dyer's shop]] to change the [[Color#Color_tokens|color]] of [[cloth]] or [[cloth|thread]].
Dye is made by milling certain [[crop|plants]] at a [[Millstone]] or [[Quern]]. Usually all [[trading|caravans]] will bring dye for [[trade]] too. Importing dye however is only useful if you have a somewhat skilled [[dyer]], otherwise little value is added and the work wasted. It is better to buy or grow the 'source' plants if available and mill them yourself. Of course, the nice colours are a value in themselves, if you don't stuff it all in bins.

Dyes are [[stockpile]]d as "Food/Milled Plants", along with [[flour]]s. On the [[stocks]] screen, dyes are listed under [[powder]].

In theory, dyed objects can be [[color#Color tokens|colors]] other than the basic 16. However, the game displays them using the basic color that is the nearest match (dimple dye is (dark) blue, and emerald dye is light green).

{| {{prettytable|style=margin-left:auto;margin-right:auto}}
|- style="background:#ddd"
!Plant
!Dye
!colspan=2|Color
!Value
|-
|[[Dimple cup]]
|Dimple Dye
|Midnight Blue
| bgcolor="#003366" |    
|20[[Currency|☼]]
|-
|[[Blade weed]]
|Emerald Dye
|Emerald
| bgcolor="#50c878" |    
|20[[Currency|☼]]
|-
|[[Hide root]]
|Redroot Dye
|Red
| bgcolor="#ff0000" |    
|10[[Currency|☼]]
|-
|[[Sliver barb]]
|Sliver Dye
|Black
| bgcolor="#000000" |    
|20[[Currency|☼]]
|}

Dyes can be applied either to woven cloth or to the raw thread. Dyed items have their [[value]] increased by value of the dye (see table above), multiplied by [[quality]] with which the dye was applied. There is not known to be any difference in the end product based on when the dye was applied during the production process. Dyes can't be applied to finished goods made from cloth, such as clothing, bags, or crafts.

==See also==
*[[Textile industry]]

{{Translation
| dwarven = atír
| elvish = afithi
| goblin = osmu
| human = asseg
}}

{{Category|Materials}}

Material definition token

2017-09-15T22:01:43Z

TheCrazyHamsteR:

{{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 are used the following:
* FAT, TALLOW, SOAP, PARCHMENT, 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}}

Creature token

2017-09-15T20:05:56Z

TheCrazyHamsteR: /* M */ [MEGABEAST]s without a valid biome specified will not spawn

{{Quality|Exceptional|22:04, 20 September 2016 (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
| 'character' or tile number
| If set, the creature will blink between its TILE and its ALTTILE.

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Found on LARGE_PREDATORs who ambush their prey. Instead of charging relentlessly at prey, the predator will wait till the prey is within a few squares before charging. May or may not work on other creatures. {{verify}}

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe with or without [[water]]. Does not prevent from drowning in [[magma]].

|-
| {{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}}
| Caste
|
*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
| population:exported wealth:created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occuring when at least one of the requirements is met. Setting a value to 0 disables the trigger.

|}

<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
| Creature may be subject to [[beaching]], becoming stranded in shores where they will eventually air-drown. The number indicates the frequency of it occurring. Presumably requires the creature to be aquatic. Used for [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]].

|-
| {{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, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

|-
| {{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
|
| Adds a type to a body part. Used with SET_BP_GROUP.
In vanilla DF this is used for adding the type 'GELDABLE' to the lower body of certain [[cat|creatures]].

|-
| {{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. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. 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.

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| 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 ALTTILE. 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. If available to animal trainers, allows the creature's offspring to be rendered fully tame if trained during their childhood.

|-
| {{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. Defaults to 1:1 if not specified.

|-
| {{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. It will show {{DFtext|Berserk|4:1}} at the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Spec
|
*CREATURE NAME
| Copies Creature, but not Caste tags from another specified creature. Used when making creature variations (i.e. giants and animal people). Often used in combination with [[#APPLY_CREATURE_VARIATION]] to import standard variations from a file. Variations are documented in c_variation_default.txt, which also contains the code for giants and animal people.

|-
| {{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 [[Steals food|steal and eat edible items]] from a site. It will attempt to grab a food item and immediately make its way to the map's edge, where it will disappear with it. If the creature goes on rampages during worldgen, it will often steal food instead of attacking. Trained and tame instances of the creature will no longer display this behavior.

|-
| {{text anchor|CURIOUSBEAST_GUZZLER}}
| Caste
|
| Allows a creature to (very quickly) [[Steals drink|drink your alcohol]]. Or spill the barrel to the ground. Also affects undead versions of the creature. Unlike food or item thieves, drink thieves will consume your alcohol on the spot rather than run away with one piece of it. Trained and tame instances of the creature will no longer display this behavior.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to [[Steals items|steal things]] (apparently the highest value it can find). It will attempt to grab an item of value and immediately make its way to the map's edge, where it will disappear with it. If the creature goes on rampages in worldgen, it will often steal items instead of attacking. [[Kea]] birds are infamous for this. Trained and tame instances of the creature will no longer display this behavior. Also, makes the creature unable to drop hauled items until it enters combat.

|-
| {{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 physically exist, but is known by civilizations and can be used for artistic purposes such as engravings; used for [[centaur]]s, [[chimera]]s and [[griffon]]s. Adding this token to a creature causes it to not appear in generated worlds, i.e. adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list.
|}

<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. Doesn't affect hatching or cooking, but bigger eggs will be heavier and may take longer to be hauled depending of the hauler's strength.

|-
| {{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 a [[Fanciful|number of 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. Does not, by itself, make the creature immune to the damaging effects of burning in fire or high temperatures.

|-
| {{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 creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjectent tiles, [[Temperature|with all the effects that it implies]]. May trigger wildfires on high enough values. Also makes the creature immune to extreme heat or cold.

Note that temperatures 12000 and higher may cause pathfinding issues in fortress mode.

|-
| {{text anchor|FLEEQUICK}}
| Caste
|
| If engaged in combat, the creature will flee at the first sign of resistance. Used for [[kobold]]s.

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. 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. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly.

|-
| {{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. Also affects the chance of a creature being brought in a caravan for trading. 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
| number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{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, stone, pool of liquid, etc.).

|-
| {{text anchor|ITEMCORPSE_QUALITY}}
| Caste
|
* number
| The [[quality]] of an item-type corpse left behind. Valid values are: 0 for ordinary, 1 for well-crafted, 2 for finely-crafted, 3 for superior, 4 for exceptional, 5 for masterpiece.
|}

<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
|
| Creature can spawn as a wild animal in the appropriate biomes.

|-
| {{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."). Used for [[Serpent man|serpent men]] and [[Reptile man|reptile men]].

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth.

|-
| {{text anchor|LOCAL_POPS_CONTROLLABLE}}{{version|0.42.01}}
|
|
| Allows you to play as a wild animal of this species in adventurer mode. Prevents trading of (tame) instances of this creature in caravans.

|-
| {{text anchor|LOCAL_POPS_PRODUCE_HEROES}}{{version|0.42.01}}
|
|
| Wild animals of this species may occasionally join a civilization. Prevents trading of (tame) instances of this creature in caravans.

|-
| {{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. The chance does not increases with further age [http://i.imgur.com/A1A4aA9.png]. Note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with CAN_LEARN, will severely impact their pathfinding and lead the creature to move extremely slowly when not performing any task.

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

Requires specifying a [[#BIOME|BIOME]] in which the creature will live.

|-
| {{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. Used for [[gremlin]]s. "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]].

|-
| {{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 15 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
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will ruthlessly kill anybody it comes across. Also removes the creature's materials from stockpile settings list.

This tag causes the usual behaviour of werebeasts 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.

When paired with SPOUSE_CONVERTER, 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. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{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. Can still be rendered unconscious by other means.

|-
| {{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. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets if the creature is active in night.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. It is immune to the effects of [[stress]], and unable to 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. Additionally, it causes [[bogeyman|bogeymen]] to become friendly towards the creature.

|-
| {{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 and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it <b>will</b> die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Cannot be butchered.

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead by necromancers or evil clouds. Implies the creature is not a normal living being. Used by vampires, [[Mummy|mummies]] and inorganic creatures like the [[amethyst man]] and [[bronze colossus]]. Creatures who are OPPOSED_TO_LIFE (undead) will be docile towards creatures with this token.

|-
| {{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 and will show {{DFtext|Opposed to life|0:1}} at the [[unit list]]. Used for [[undead]]. Functions without the NOT_LIVING token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token, living creatures given this token will attack living creatures that lack this token, while ignoring living creatures that also have this token.

|-
| {{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}}
|
|
| Lets you play as an outsider of this species in adventure mode.

|}

<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
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{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
|
*number
| 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. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. 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. Beings with this token behave like civilized leaders and will sometimes make journeys to the wilds and tame creatures for their civilization to use; above-ground beings domesticate above-ground animals, while demons domesticate subterranean wildlife.

|-
| {{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
|
*tissue token
| Removes a tissue from a creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body category, type, 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. (eg. Turtle, Snail)

|-
| {{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. Has no effect on cavern creatures. Cannot be combined with <code>[GOOD]</code> or <code>[EVIL]</code>.

|-
| {{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 'primitive' creatures like [[ogre]]s, [[giant]]s and [[troglodyte]]s. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with [EVIL] will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{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 will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

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

|-
| {{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}}
|
|
| The creature will get strange moods in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres and prevents it from becoming a vampire or a werebeast. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use swimmer skill, 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 swims only as well as their present swimming skill allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}{{version|0.42.01}}
| Syndrome name:Amount
|
| Dilutes the effects of a syndrome. 100 is normal effect, higher numbers reduce the effects of the syndrome more.
|}

<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 when the color change begins and ends.

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| 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 trance]]s.

|-
| {{text anchor|TRAPAVOID}}
| Caste
|
| The creature will never trigger [[trap]]s it steps on. Used by a [[Trapavoid|number of creatures]]. Doesn't make the creature immune to remotely activated traps (like retractable spikes being triggered while the creature is standing over them). TRAPAVOID creatures lose this power if they're immobilized while standing in a trap, be it by stepping on thick web, being paralyzed or being knocked unconscious.

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
| min:max
| A large swarm of vermin can be disturbed, usually in adventurer 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. Values from 1 to 3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[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
|
| The creature is displayed as blue when in 7/7 water. Used on fish and amphibious creatures which swim under the water.

|-
| {{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. Doesn't appear to do anything in particular.

|-
| {{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. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{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
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. 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, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision.

Binocular vision has a minimum of about 10 degrees. Monocular vision has a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively.
|}

<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
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{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. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, GAS)
*min:max
| Attack type addition that injects a material into the victim's blood. If the attack is blunt or the injected material lacks [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the material will splatter over attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
| interaction
| When this attack lands successfully, a specified interaction 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
|
*value
| 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
|
*value
| Seems to set new number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Seems to set new relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| 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}}

23a:Cage

2017-09-14T19:16:45Z

TheCrazyHamsteR: caged hostiles can be used for unfortunate accidents

{{quality|Exceptional|20:52, 20 April 2011 (UTC)}}{{av}}
A '''cage''' is a holding device that can hold one or more creatures.

Both empty and occupied cages are stockpiled in an Animal [[stockpile]] - use the {{k|u}} key to toggle them on/off (lower right corner of that screen).

Cages can be made of [[wood]], [[metal]] or [[glass]] (called a '''terrarium'''), but not stone. Cages can hold an unlimited number of [[animals]] and captured [[vermin]] at once. Placing animals in a cage can reduce lag and traffic in your hallways. A cage takes 1 [[wood]] log if made by a [[carpenter]] at a [[carpenter's workshop]], 3 [[bar]]s to build if made by a [[metalsmith]] at a [[forge]], or 1 sand bag (or rough [[rock crystal]]) if made of [[glass]].

The cage can be used in a few ways:

:* A [[Trap#Cage_Trap|cage trap]] needs a cage as one of its components.
:* As animal restraining devices, where you simply plant it and allocate any animals (except [[pet]]s) you want in it. Females that are caged '''will not''' get pregnant, but animals can bear children when caged.
::*This is also how you go about making a "'''zoo'''".
::*A glass cage (Terrarium) can be designated an [[aquarium]] for holding captured [[fish]]. (see [[captured live fish]])
:* If the cage is made of metal, as a [[jail]], where you designate its location to be used for [[justice]], and a [[sheriff]] will detain any unruly (or [[justice|unjustly accused]]) dwarves.
:* Animals kept in cages will still age, which makes cages a great tool for keeping young animals restrained en masse.

==Moving and Releasing Caged Creatures==

If you buy your first animals via the traders, you may be unsure how to extract them. To remove an animal from a cage, it first needs to be placed via the Build menu ({{K|b}}-{{K|j}}). Once it's placed, use {{k|q}} to examine it, {{k|a}} to assign, and then use {{K|Enter}} to toggle the animal(s) currently inside (animals assigned to the cage will have a green " + " next to them). A dwarf will come along and let the animal out of the cage, after which it can be butchered, moved, et cetera. Attempting to release a wild animal or hostile creature using this method will simply cause a dwarf to grab an empty cage, transfer the creature into it, then carry it back to an animal stockpile.

If you already have a cage placed somewhere, a faster way to release bought animals is to examine this cage and assign the animals to it. A dwarf will fetch the animals from the stockpile after which you can release them by again examining the cage. This can also be done with a [[restraint]] if you simply wish to tie the animal up somewhere. Assigning a creature to a cage when it is already in another built cage will generate 2 jobs - one to release the creature from its old cage (which will trigger the above behavior for wild animals), and one to place the creature into its new cage.

Moving untamable and/or untamed occupants utilizes the Animal Training labor, which allows you to assign stronger, more capable dwarves to the task, which (may) reduce the chance of escape. It is unconfirmed whether this is the case with untamed, tamable creatures.

Remember that some creatures ([[megabeast]]s) are too powerful for your dwarves to safely lead around by the nose, and some others such as invaders may also escape while being transferred.

==== How to disarm hostiles in cages ====
The only way to effectively disarm a caged hostile creature is to enter the Stocks screen (provided you have a [[Bookkeeper]]), locate its equipment in the proper category (it will be listed in red) and mark it for [[chasm]]ing. While it is easy to identify goblin/kobold clothes because they will always be described as "narrow"/"small", it is difficult to make sure you have found the right weapons; you can verify that you are targeting the right items by using the {{K|z}}oom function; it should point you to the cage. Since this will normally result in the equipment being destroyed, you may wish to lock all available paths to the chasm once the items are picked up so that the chasm jobs will be cancelled, allowing the items to be retrieved (after going into the Stocks screen and unmarking them).

==Uses of caged creatures==

You can find a list of imaginative uses for captured creatures [[captured creatures|here]].

===Zoo===
A [[cage]] can be defined as a {{K|r}}[[room|oom]], and is then commonly called a '''zoo'''. (More than one cage can be so defined, but overlapping such [[room]]s reduces their value, so there is no need except for style points.) [[Dwarves]] like to hang out at a room made from a built cage (without an owner) and will be comforted by any animals in the cage they like ("she was comforted by a wonderful creature in a cage recently"). They will also throw [[party|parties]] there. Take care not to cage animals inside which one of your dwarves finds disgusting!

The happy thought will also be triggered if no room is made from the cage.

A [[restraint]], while holding only one creature, works much the same, except not giving the happy thought from seeing a favored creature.{{verify}}

===Arena===

If you link a [[lever]] to a (built) cage with trapped hostiles, you can release them by pulling the lever and let animals or your soldiers have fun with them. Make sure you have disarmed them first. The design of this "arena" is really up to you but a somewhat contained area or room is advisable. This is also a creative way to get rid of unwanted pets, if you can manage to trap them in the arena. Make sure your dwarves won't [[tantrum]] from unhappy thoughts! Dwarves attempting to move certain creatures between cages (goblin champion, colossus, skeletons, etc) will merely result in freeing the creature.

===[[Unfortunate accident]]===

Caged beasts are a reliable way to relieve the [[noble]]s of their duties. Install a cage with a wild [[lion]] in the noble's quarters and pull the [[lever]] to let the king of the beasts <s>consume</s> attend meeting with the [[king]] of the dwarves. The noble will surely <s>die</s> have [[fun]]. Just make sure to seal off the entrance. You want the meeting to be private, don't you?

{{Military FAQ}}
{{buildings}}
{{Category|Rooms}}

23a:Peasant

2017-09-14T18:34:30Z

TheCrazyHamsteR: Created page for 23a

{{Quality}}
{{av}}

<div style="float:right; margin-left:10px">
{{Skill Box|Peasant|3:0|3:0|}}
</div>
In [[fortress mode]], a dwarf who has no [[skill]]s above [[Skill#Skills|dabbling]] level (no skills at [[Skill#Skills|Novice]] or better, military and social skills excluded) has no [[profession]], and is listed as a "peasant" on the screen listing all creatures on the game map ( {{key|u}} ) and the status screen ( {{key|z}} ). By default they are shown as teal.

Peasants commonly arrive with new [[immigrant]]s. All [[children]] (even children of [[noble]]s) become peasants when they reach adulthood. If you have "All Dwarves Harvest" set on the {{k|o}}rders menu, it is possible that when a child becomes an adult, they will already have advanced skills (even [[legendary]]) as a [[Grower]] (see [[Farming#Harvesting|harvesting]]). However, they will still be a peasant until any one skill granting job is done. Then their title will change to reflect their highest skill (planting).

Peasants have default [[Labor#Default_labors|labor]]s enabled when they arrive or become adults. By turning on different [[labor]]s*, peasants can accomplish any task (at an untrained level of competence) and eventually be trained in any skill, or used as-is as an unskilled, no-[[attribute]] [[hauling|hauler]]. They are often chosen to be trained for [[military]] purposes, or dragooned into the [[Fortress guard]] to make up the numbers.

''(* This can be done a variety of ways, "{{key|v}}iew, {{key|p}}references, {{key|l}}abor" being one of the more common.)''

Unlike other civilians, when a hostile creature comes in range of a peasant, they will attack it head on rather than running away, giving more valuable dwarves time to escape and holding the enemy off until the military arrives. They can often kill kobold thieves and goblin snatchers without the military ever having to step in, but can be severely wounded and often killed if encountered by a larger force.

Peasants are also invaluable as sacrificial lambs. They are largely useless and, unless applied to a practice, will eat and drink away the other dwarves' rations while [[noble|contributing nothing to society themselves]]. It is thus a good idea to draft them to jobs that will likely result in the death of the dwarf. A good example of this would be experiments involving [[magma]], heavily flowing [[water]], or just about anything deadly. Just make sure they don't have a lot of friends (which may be the case if they are left to idle for extended periods of time), or you may end up with a [[tantrum]] spiral on your hands.

==See also==
:* [[profession]]
:* [[immigrant]]
:* [[cross-training]]
:* [[mood|moodable skills]]
:* [[attribute]]s

{{Skills}}

Platinum

2017-09-13T18:09:33Z

TheCrazyHamsteR:

{{Quality|Superior|23:33, 27 April 2013 (UTC)}}
{{Metal|name=Platinum|color=7:7:1
|uses=
* [[Metalsmith's forge|Metal crafting]]
|ore=
* [[Native platinum|Platinum nuggets]]
|properties=
* [[Material value]] 40
{{firemagmasafe|yes|yes}}
* [[Melting point]] {{ct|13182}}
* [[Boiling point]] {{ct|16885}}
* [[Solid density]] 21400
* Liquid [[density]] 19770
* [[Specific heat]] 130
}}{{av}}

'''Platinum''' is a rare and extremely valuable [[metal]], second only to [[adamantine]] (and tied with [[aluminum]]). Platinum is [[magma-safe]] and is significant for being the heaviest metal, making it the best material for [[artifact]] impact [[weapon]]s.

{{gamedata}}
{{metals}}

23a:Token

2017-09-13T18:00:13Z

TheCrazyHamsteR: List of token types for 23a

{{Quality}}
{{av}}

In Dwarf Fortress, a '''token''' is a piece of text that defines the properties of an object. An "object" could be a material, a piece of armor, a creature, a biome, a civilisation, or anything else in the game. A "property" could be how large something is, what it is made from, its name, its biome preference (for civilisations) or anything that makes it unique. All information associated with the properties of an object in the game is defined using tokens. Tokens are found in the [[Raw file|raws]], and can be easily [[modding|modified]], allowing users to create (and distribute) new content.

:* [[Ammo token]]s define ammunitions, such as arrows and bolts.
:* [[Armor token]]s define armor.
:* [[Biome token]]s define environments for creatures, plants and entities (entities being civilisations).
:* [[Body token]]s determine bodily structure.
:* [[Bodygloss]] tokens perform a single-word substitution of a creature's body parts.
:* [[Creature token]]s determine the properties of creatures.
:* [[Entity token]]s define entities, or [[civilization]]s.
:* [[Gem token]]s define gems.
:* [[Item token]]s define the most basic form of items (made specific by material tokens).
:* [[Item definition token]]s are used for actual definitions of items.
:* [[Language token]]s define a language's vocabulary. Since fictional languages in Dwarf Fortress are only used in names, language tokens do not define grammar.
:* [[Material token]]s are used to refer to materials, similar to item tokens.
:* [[Plant token]]s define plants.
:* [[Skill token]]s reference skills.
:* [[Stone token]]s define stones. Unlike in later versions, [[ore]]s are hardcoded and cannot be modified.
:* [[Tree token]]s define trees.
:* [[Trap component token]]s define trap components.
:* [[Unit type token]]s are referred to by tilesets, and entities for purposes of nobility and the like.
:* [[Weapon token]]s define weapons.

This [http://www.bay12games.com/forum/index.php?board=13.0 forum] is the official DF subforum dedicated to discussions about modding.

----

'''See Also:'''
* [[Raw file]]
* [[Modding]]
[[category:Modding]]

Token

2017-09-13T17:42:22Z

TheCrazyHamsteR:

{{Quality}}
{{av}}

In Dwarf Fortress, a '''token''' is a piece of text that defines the properties of an object. An "object" could be a material, a type of tissue, an organ, a piece of armor, a creature, a biome, a civilisation, or anything else in the game. A "property" could be how large something is, what it is made from, its melting temperature, its name, its biome preference (for civilisations) or anything that makes it unique. All information associated with the properties of an object in the game is defined using tokens. Tokens are found in the [[raws]], and can be easily [[modding|modified]], allowing users to create (and distribute) new content.

:* [[Ammo token]]s define ammunitions, such as arrows and bolts.
:* [[Armor token]]s define armor.
:* [[Biome token]]s define environments for creatures, plants and entities (entities being civilisations).
:* [[Building token]]s define buildings.
:* [[Body token]]s determine bodily structure and materials.
:* [[Body detail plan token]]s define some details of a body, similar to body tokens.
:* [[Bodygloss]] tokens perform a single-word substitution of a creature's body parts.
:* [[Creature token]]s determine the properties of creatures.
:* [[Creature variation token]]s are used to create creatures which are derived from other already-existing creatures without duplicating every single token.
:* [[Entity token]]s define entities, or [[civilization]]s.
:* [[Item token]]s define the most basic form of items (made specific by material tokens). Item tokens are mainly used in [[reactions]].
:* [[Item definition token]]s are used for actual definitions of items.
:* [[Interaction token]]s define interactions.
:* [[Labor token]]s define labors.
:* [[Language token]]s define a language's vocabulary. Since fictional languages in Dwarf Fortress are only used in names, language tokens do not define grammar.
:* [[Material token]]s are used to refer to materials, similar to item tokens.
:* [[Material definition token]]s are used to define materials, similar to item definition tokens.
:* [[Plant token]]s define plants.
:* [[Position token]]s define positions in entities.
:* [[Skill token]]s reference skills.
:* [[Syndrome token]]s define syndromes.
:* [[Tissue definition token]]s define tissues.
:* [[Tool token]]s define tools, similar to weapons tokens.
:* [[Trap component token]]s define traps.
:* [[Unit type token]]s are referred to by tilesets, and entities for purposes of nobility and the like.
:* [[Weapon token]]s define weapons.
:* [[World token]]s are used in custom world generation.

Also note [[reactions]], which are a little more complicated than simple tokens.

This [http://www.bay12games.com/forum/index.php?board=13.0 forum] is the official DF subforum dedicated to discussions about modding.

----

'''See Also:'''
* [[Raw file]]
* [[Modding]]
[[category:Modding]]

Token

2017-09-13T17:41:14Z

TheCrazyHamsteR: TheCrazyHamsteR moved page Token to DF2014:Token: This is about the current version. In older versions (such as 23a) token types were different.

In Dwarf Fortress, a '''token''' is a piece of text that defines the properties of an object. An "object" could be a material, a type of tissue, an organ, a piece of armor, a creature, a biome, a civilisation, or anything else in the game. A "property" could be how large something is, what it is made from, its melting temperature, its name, its biome preference (for civilisations) or anything that makes it unique. All information associated with the properties of an object in the game is defined using tokens. Tokens are found in the [[raws]], and can be easily [[modding|modified]], allowing users to create (and distribute) new content.

:* [[Ammo token]]s define ammunitions, such as arrows and bolts.
:* [[Armor token]]s define armor.
:* [[Biome token]]s define environments for creatures, plants and entities (entities being civilisations).
:* [[Building token]]s define buildings.
:* [[Body token]]s determine bodily structure and materials.
:* [[Body detail plan token]]s define some details of a body, similar to body tokens.
:* [[Bodygloss]] tokens perform a single-word substitution of a creature's body parts.
:* [[Creature token]]s determine the properties of creatures.
:* [[Creature variation token]]s are used to create creatures which are derived from other already-existing creatures without duplicating every single token.
:* [[Entity token]]s define entities, or [[civilizations]].
:* [[Item token]]s define the most basic form of items (made specific by material tokens). Item tokens are mainly used in [[reactions]].
:* [[Item definition token]]s are used for actual definitions of items.
:* [[Interaction token]]s define interactions.
:* [[Labor token]]s define labors.
:* [[Language token]]s define a language's vocabulary. Since fictional languages in Dwarf Fortress are only used in names, language tokens do not define grammar.
:* [[Material token]]s are used to refer to materials, similar to item tokens.
:* [[Material definition token]]s are used to define materials, similar to item definition tokens.
:* [[Plant token]]s define plants.
:* [[Position token]]s define positions in entities.
:* [[Skill token]]s reference skills.
:* [[Syndrome token]]s define syndromes.
:* [[Tissue definition token]]s define tissues.
:* [[Tool token]]s define tools, similar to weapons tokens.
:* [[Trap component token]]s define traps.
:* [[Unit type token]]s are referred to by tilesets, and entities for purposes of nobility and the like.
:* [[Weapon token]]s define weapons.
:* [[World token]]s are used in custom world generation.

Also note [[reactions]], which are a little more complicated than simple tokens.

This [http://www.bay12games.com/forum/index.php?board=13.0 forum] is the official DF subforum dedicated to discussions about modding.

----

'''See Also:'''
* [[Raw file]]
* [[Modding]]
[[category:Modding]]

23a:Ore

2017-09-13T16:57:38Z

TheCrazyHamsteR:

{{quality|Exceptional|21:00, 26 April 2011 (UTC)}}{{av}}
'''Ores''' are a type of [[stone]] that can be used to create [[bar]]s of [[metal]] at a [[smelter]]. All unmined ores are represented by the {{Raw Tile|£|7:7:1}} symbol (except for bituminous coal, which appears as {{Raw Tile|☼|0:7:1}}).

Every embark region contains exactly 100 veins of ore, with types distributed predictably between the various types.

{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
|-
! Ore
! Location
! Amount
! Metal created
! Metal value
|-
|{{Raw tile|£|3:7:1}} [[Raw adamantine]]||The depths||Special||[[Adamantine]]<sup>1</sup>||300
|-
|{{Raw tile|£|6:7:0}} [[Cassiterite]]||Anywhere||19 veins||[[Tin]]||2
|-
|{{Raw tile|£|0:7:1}} [[Galena]]||Anywhere||20 veins||[[Silver]]||10
|-
|{{Raw tile|£|6:7:1}} [[Native gold|Gold, native]]||Beyond the [[chasm]]||6 veins||[[Gold]]||30
|-
|{{Raw tile|£|4:7:0}} [[Hematite]]||Beyond the [[chasm]]||6 veins||[[Iron]]||10
|-
|{{Raw tile|£|2:7:0}} [[Malachite]]||Anywhere||27 veins||[[Copper]]||2
|-
|{{Raw tile|£|7:7:1}} [[Native platinum|Platinum, native]]||Beyond the [[chasm]]||5 veins||[[Platinum]]||40
|-
|{{Raw tile|£|0:7:0}} [[Sphalerite]]||Anywhere||12 veins||[[Zinc]]<sup>2</sup>||2
|-
|{{Raw tile|☼|0:7:1}} [[Bituminous coal]]<sup>3</sup>||Beyond the [[chasm]]||5 veins||[[Coke]]||N/A
|}
:''1 - Note that [[raw adamantine]]/[[adamantine]] does not follow all the usual rules for an ore/metal in several respects - see article for full discussion.''
:''2 - Though it is an ore of zinc, sphalerite cannot be smelted directly into zinc - it can only be combined with malachite to make [[brass]].''
:''3 - While it is found in the same manner as other ores, bituminous coal is not strictly an ore.''

===See Also===
:* [[Smelting]]
:* [[Metal]]s
:* [[Stone]]
:* [[Gem]]

{{Category|Ore| }}
{{Category|Materials}}

23a:Chasm

2017-09-13T01:54:44Z

TheCrazyHamsteR:

{{av}}{{Quality|Exceptional}}
:{{DFtext|A miner has found a large chasm cleft through the mountain.|7:0:0}}

The '''chasm''' is the second major landmark encountered within the mountain (the first being the [[cave river]]). Like the river, you must build a [[bridge]] over it to get past it. This obstacle is between 3 and 5 spaces wide, and angles between 148 to 200 spaces from the cliff face. The chasm tends to make sharper turns than the river, and its offshoots are always straight and between 1 and 2 spaces wide.

The chasm is home to several aggressive [[creature]]s – primarily ratmen, batmen, and antmen. These monsters usually mount assaults of 5 to 20 or more creatures at a time. If you pour enough [[magma]] (water will not work) into the chasm, it will eventually get a red line running down its center, meaning all the creatures have been killed.

The chasm can be used as an unlimited refuse dump. From the {{K|o}}rders menu, select {{K|r}}efuse to specify which types of refuse should be chasmed. Chasming refuse is hazardous, however, as it incites attacks from the chasm-dwellers. If you then chasm the carnage of the battle, more attacks will occur, which can lead to almost constant assaults.

If you wish to expediently clear the refuse left over from such battles without chasming it, it can be a good idea to construct a large, enclosed refuse [[stockpile]] right near the chasm. Building a [[craftsdwarf's workshop]] near this stockpile can allow you to turn out thousands of [[bone]] [[bolts]] or [[crafts]] and keep the stockpile from completely filling up.

Once you have a [[bookkeeper]], you can select specific items to be chasmed (not just refuse) from the [[stocks]] menu.

==Chasm monsters==
Once the chasm has been discovered, there is a 25% chance per season of monsters emerging to attack your dwarves regardless of their activity. Chasming refuse or dumping water/magma into the chasm will trigger up to 3 additional attacks per season. If you have built any [[well]]s beyond 130 tiles of the cliff face, certain monsters have a chance to emerge from them instead of from the chasm itself (1% chance per valid well, minimum 10% and maximum 50%); wells closer to the surface will be used by [[cave river]] creatures instead.

The monsters from the depths are:

* [[Gremlin]]s*
* [[Ratman|Ratmen]]*
* [[Batman|Batmen]]*
* [[Antman|Antmen]]*
* [[Troll]]s*
* [[Giant bat]]s
* [[Giant rat]]s*
* [[Large rat]]s*
* [[Naked mole dog]]s*
* [[Troglodyte]]s
* [[Giant mole]]s*
* [[Giant cave spider]]s*
* [[Iron man|Iron men]]

Up to 6 of the above creatures can be found in any given chasm. Creatures marked with a "*" are capable of emerging from [[well]]s.

Attacks from trolls are very rare, but can be dangerous. Trolls are strong and are capable of destroying buildings (including [[door]]s and [[floodgate]]s). Gremlins can throw levers, which can lead to all sorts of havoc, so hide your levers behind a door and a trap or two. But be warned, Gremlins themselves do not set off traps.

==Chasm defense strategies==

===Dust off and nuke 'em from orbit===
It's the only way to be sure.

Of course, Dwarves haven't quite figured out the art of enriching uranium--or, for that matter, shaping explosives--so we'll have to come up with alternative method of making a parking lot out of the chasm.

Fortunately, [[magma]], being as utterly destructive as it is, makes for a GREAT surrogate thermonuclear weapon, as alluded to in the introductory paragraph of this article. What you do is more or less what you do with your farm, with some small differences. The steps are more or less as follows:

#Dig an entrance to the [[magma flow]]. It doesn't matter what size.
#Place a floodgate there, adjacent to the magma.
#Build a channel from the floodgate to your chasm-flood area. It is simple enough to bridge a magma-filled channel with stone or any metal bridge, so you need not worry about impairing the movement of your dwarves.
#Dig a ''wide'' entrance to the chasm that meets your channel. This is important - the rate at which magma flows into the chasm depends on the number of adjacent tiles from which it can flow.
#Place a floodgate at the other end, making sure your miner has a way out (or not). (Alternatively, just dig out your entire chasm-flood room as a channel. A filled channel next to the chasm will flood the chasm.)
#Link up the floodgates to a lever.
#Pull the lever.

The magma should flow from the river to the other floodgate, and expand into your entrance area, deluging the chasm in magma. Should your stupid novice miner install a floodgate while he's on the *wrong* side of it, you can either opt to leave him there, allowing the magma to instakill and save him from another death in the future (likely to be far worse than being covered with liquid rock) or you could have him dig back to your main tunnel, and block off the magma with a *rock* door, as it will be sufficient to halt the flood of molten death.

For a while, this will increase attacks from the chasm. Eventually, though, a red line will appear up and down the middle of the chasm. Congratulations, you've made a parking lot out of the thing.

To avoid all retaliatory attacks while you nuke the chasm, you can seal it off by digging a channel which covers every exposed portion on the west side of the chasm. Build an aqueduct to bring magma across the chasm and pipe it into this channel. (You can also build a floodgate pointed at your existing bridge(s); the flow will cross the bridge, but be stopped by the channels.)

Most chasm-dwellers cannot cross a magma-filled channel, and will die without ever being seen. However, the occasional troll might be able get across it, so line the channel with some traps just to be extra safe.



====To nuke or not to nuke====
Nuking the chasm will clear it of all life forms, including any potentially valuable [[purring maggot]]s. However, ratman raids are one of the game's best source of [[bone]]s, and bone [[bolts]] are indispensible for training [[Marksdwarf|marksdwarves]]. Additionally, you will eliminate the possibility of capturing a [[giant cave spider]] and harvesting its incredibly valuable silk. If you take the precautions listed below, you can render the chasm quite harmless, without needing to destroy it altogether.

==="Safety net" bridges===
The greatest danger from chasm attacks is the risk of falling into the chasm. Totally healthy dwarves, even elite [[soldier]]s, can be shoved (or simply ''dodge'') off the edge during combat with depressing ease. The greatest defense against this is to erect several bridges covering the chasm above and below your main "crossing" bridge(s). This does not require a tremendous amount of material, as the chasm itself is usually quite narrow (3-5 squares in width). If you're a really competent bridge builder, make drawbridges that lift to form walls north and south of your main bridge.

===Traps===
The chasm's monsters are numerous but weak, and can usually be killed by a single stone-fall [[trap]]. A phalanx of traps 2-4 squares deep on either side of your bridges can kill just about anything that emerges from the chasm. These might not save an unlucky dwarf stranded in the center of a bridge during an ambush, although if he or she can survive long enough to get across the bridge, the traps will kill all pursuers.

Weapon traps require more resources to build than stone-fall traps, although they do not need to be reloaded once triggered (just [[clean]]ed). They are also much more effective against magma creatures that may wander as far into your fortress as the chasm.

===War dogs===
[[Restraint|Restraining]] a few war [[dog]]s beside your bridges will further bolster their safety. A single dog can usually kill several chasm creatures, and take the heat off any unfortunate dwarves that may be on the bridges during an ambush. Even better, a war dog that attacks a batman while it is over the chasm will usually cause the batman to plummet to his doom.

===Barracks placement===
Building a [[barracks]] right next to the chasm just off your main corridor will make it likely that at least a few of your soldiers will be in its vicinity at all times. Off-duty soldiers spar and practice on [[archery target]]s in the barracks quite often, and others will sleep there. If you place the barracks on the opposite side of your main [[dining room]], your soldiers will cross the chasm bridges often en route to getting [[alcohol|drink]] or [[food]].

It may also be useful to mine a narrow corridor leading from the barracks directly to the chasm. Attackers from the chasm will often attack on multiple fronts (if there are any available). Connecting your barracks directly to the chasm will often cause the attackers to split their forces between the bridges and your barracks, where there are likely to be soldiers waiting in ambush.

===Trapped accessways===
Since monsters will often appear at multiple points along the chasm when given the chance, you can create short trap-lined accessways from your main corridor to the chasm. These should not connect to any bridges so that your dwarves will not use them, but they will draw attackers away from your bridges into deadly passageways. You can also trap the corridor connected to your barracks, if you have built one.

===Fortified positions===
Engraving [[fortification]]s which face your bridges and stationing soldiers in these positions can provide an additional layer of defense. Your fortified position can be the barracks itself, which will spare you the need to constantly assign and relieve soldiers -- at least a few off-duty marksdwarves are likely to be in your barracks at any given time, especially if you do not group them into [[squad]]s.

===Doors===
As a last line of defense, you can enclose the areas leading to your bridges with [[door]]s. These can be locked instantly, at will, to keep attackers from penetrating further into your fortress. You can then direct your soldiers to head for the chasm, and reopen the doors when they are in position. It is also recommended you put doors on any side accessways in case the attackers get past the traps. These doors should normally remain unlocked so that the attackers will be lured into the passageways.

If the corridor leading to the chasm is quite wide, you can still fully span it with doors by temporarily locking the door you are building off of, then unlocking it after the new door is built. Another way to build lines of doors works by placing statues, then attaching doors to them. You can either place the statues in line with the doors (door-door-statue-door-door-statue, etc.), or place them behind the doors, then remove them once the doors are built -- allowing you to span a passageway of any width with an uninterrupted line of doors.

==See also==
* [[Cave river]]
* [[Magma flow]]

{{World}}

Dragonfire

2017-09-13T00:42:21Z

TheCrazyHamsteR:

{{Quality|Superior|21:12, 20 April 2014 (UTC)}}
{{av}}
[[File:dragonfire1.png|thumb|right|335x255px|Dragonfire. The goblin survived nearly a year before finally failing a shield block; the [[tin]] goblet, however, remained undamaged.]]

'''Dragonfire''' is a very powerful form of [[fire]] that is produced by [[dragon]]s. Dragonfire forms a rough cone shape, with a range of approximately 20 tiles and a spread of 10 tiles{{cite talk|DF2012:fire#Dragonfire}}. Notably, dragonfire does not spread vertically through additional [[z-level]]s (although dragons will target visible creatures on other z-levels). Despite its powerfully destructive nature, dragonfire can effectively be blocked by a simple [[shield]] better than 99% of the time.

Legends claim that dragonfire can reach temperatures up to {{ct|50000}}. At that temperature, almost all materials should be destroyed (the [[dragon]]'s own body and its butchering products are exceptions). However, research has shown that dragonfire is quite particular about which objects it affects. When in a tile with dragonfire, organic materials will ignite, even including [[nether-cap]] wood with its fixed temperature. Non-flammable common [[stone]], [[glass]], and [[ceramic]] items will melt and boil away. Prior to v0.43.03, metal objects and metal buildings were immune to dragonfire, even non-fire-safe metals like [[tin]].{{bug|6517}} Dragonfire is similarly ineffective against [[water]], producing no [[steam]] or evaporation. [[Building]]s (but not [[construction]]s) are affected by dragonfire on their tile, making non-dragonfire-safe doors immune as long as they remain closed. Objects and buildings (and creatures) made out of [[slade]] are also immune to dragonfire since the raws do not define a specific heat for slade.

Objects ignited by dragonfire drop to and continue to burn at their standard combustion temperature, however repeated blasts of dragonfire can sustain much higher combustion temperatures, sufficient even to eventually melt nearby [[adamantine]].

==Dragonfire-safe materials==
There are very few materials which can withstand the immense heat of dragonfire. Here is the full list:

{| {{prettytable}}
|- bgcolor="#ddd"
! width="8%" | Type
! width="15%" | Material
! width="5%" | Appearance
! width="10%" | [[Melting point]]
! width="10%" | [[Solid density]]
! width="10%" | [[Specific heat]]
! width="8%" | [[Value multiplier]]
! width="34%" | Notes

|-
| Stone
| [[Slade]]
| {{Raw Tile|░|0:0:1}} {{Raw Tile|*|0:1}}
| None
| 200000
| Unknown
| 1
| Intended to be undiggable

|-
| Metal
| [[Divine metal]]
| Varies
| None
| 1000
| 7500
| 300
| Found only in [[vault]]s

|-
| Leather
| [[Fire imp]] leather
| {{Raw Tile|ß|6:0:0}}
| None
| 500
| 420
| 3
|

|-
| Bone
| [[Fire imp]] bone
| {{Raw Tile|²|7:0:1}}
| None
| 500
| 1000
| 3
|

|-
| Bone
| [[Dragon]] bone
| {{Raw Tile|²|7:0:1}}
| None
| 500
| 30000
| 15
|

|-
| Soap
| [[Dragon]] soap
| {{Raw Tile|≡|7:0:1}}
| {{ct|55000}}
| 500
| 30000
| 15
|

|-
| Ash
| [[Ash]]
| {{Raw Tile|≡|7:0:0}}
| None
| 1200
| 800
| 1
|

|-
| Ash
| [[Potash]]
| {{Raw Tile|≡|7:0:1}}
| None
| 1200
| 800
| 3
|

|-
| Ash
| [[Pearlash]]
| {{Raw Tile|≡|7:0:1}}
| None
| 1200
| 800
| 4
|

|}

{{Translation| dwarven = måmgoz-ziril | elvish = vutheni-inira | goblin = kusnath-zedan | human = tamun-usmok}}

{{Category|Creature attributes}}

Dragonfire

2017-09-13T00:34:23Z

TheCrazyHamsteR: added a table of dragonfire-safe materials

{{Quality|Superior|21:12, 20 April 2014 (UTC)}}
{{av}}
[[File:dragonfire1.png|thumb|right|335x255px|Dragonfire. The goblin survived nearly a year before finally failing a shield block; the [[tin]] goblet, however, remained undamaged.]]

'''Dragonfire''' is a very powerful form of [[fire]] that is produced by [[dragon]]s. Dragonfire forms a rough cone shape, with a range of approximately 20 tiles and a spread of 10 tiles{{cite talk|DF2012:fire#Dragonfire}}. Notably, dragonfire does not spread vertically through additional [[z-level]]s (although dragons will target visible creatures on other z-levels). Despite its powerfully destructive nature, dragonfire can effectively be blocked by a simple [[shield]] better than 99% of the time.

Legends claim that dragonfire can reach temperatures up to {{ct|50000}}. At that temperature, almost all materials should be destroyed (the [[dragon]]'s own body and its butchering products are exceptions). However, research has shown that dragonfire is quite particular about which objects it affects. When in a tile with dragonfire, organic materials will ignite, even including [[nether-cap]] wood with its fixed temperature. Non-flammable common [[stone]], [[glass]], and [[ceramic]] items will melt and boil away. Prior to v0.43.03, metal objects and metal buildings were immune to dragonfire, even non-fire-safe metals like [[tin]].{{bug|6517}} Dragonfire is similarly ineffective against [[water]], producing no [[steam]] or evaporation. [[Building]]s (but not [[construction]]s) are affected by dragonfire on their tile, making non-dragonfire-safe doors immune as long as they remain closed. Objects and buildings (and creatures) made out of [[slade]] are also immune to dragonfire since the raws do not define a specific heat for slade.

Objects ignited by dragonfire drop to and continue to burn at their standard combustion temperature, however repeated blasts of dragonfire can sustain much higher combustion temperatures, sufficient even to eventually melt nearby [[adamantine]].

==Dragonfire-safe materials==
There are very few materials can withstand the immense heat of dragonfire. Here is the full list:

{| {{prettytable}}
|- bgcolor="#ddd"
! width="8%" | Type
! width="15%" | Material
! width="5%" | Appearance
! width="10%" | [[Melting point]]
! width="10%" | [[Solid density]]
! width="10%" | [[Specific heat]]
! width="8%" | [[Value multiplier]]
! width="34%" | Notes

|-
| Stone
| [[Slade]]
| {{Raw Tile|░|0:0:1}} {{Raw Tile|*|0:1}}
| None
| 200000
| Unknown
| 1
| Intended to be undiggable

|-
| Metal
| [[Divine metal]]
| Varies
| None
| 1000
| 7500
| 300
| Found only in [[vault]]s

|-
| Leather
| [[Fire imp]] leather
| {{Raw Tile|ß|6:0:0}}
| None
| 500
| 420
| 3
|

|-
| Bone
| [[Fire imp]] bone
| {{Raw Tile|²|7:0:1}}
| None
| 500
| 1000
| 3
|

|-
| Bone
| [[Dragon]] bone
| {{Raw Tile|²|7:0:1}}
| None
| 500
| 30000
| 15
|

|-
| Soap
| [[Dragon]] soap
| {{Raw Tile|≡|7:0:1}}
| {{ct|55000}}
| 500
| 30000
| 15
|

|-
| Ash
| [[Ash]]
| {{Raw Tile|≡|7:0:0}}
| None
| 1200
| 800
| 1
|

|-
| Ash
| [[Potash]]
| {{Raw Tile|≡|7:0:1}}
| None
| 1200
| 800
| 3
|

|-
| Ash
| [[Pearlash]]
| {{Raw Tile|≡|7:0:1}}
| None
| 1200
| 800
| 4
|

|}

{{Translation| dwarven = måmgoz-ziril | elvish = vutheni-inira | goblin = kusnath-zedan | human = tamun-usmok}}

{{Category|Creature attributes}}

Divine fabric

2017-09-12T23:26:35Z

TheCrazyHamsteR:

{{Quality|Fine|01:53, 29 July 2014 (UTC)}}
{{av}}
{{spoiler}}

{{infostart|}}
{{infoheader|Properties}}
{{infocell|
* [[Material value]] 300
{{firemagmasafe|no|no}}
* [[Melting point]] None
* [[Boiling point]] None
* [[Ignition point]] None
* [[Temperature|Heat damage point]] {{ct|10250}}
* [[Temperature|Cold damage point]] {{ct|9900}}
* [[Solid density]] 1
* [[Specific heat]] 420
}}
{{infoend}}

'''Divine fabrics''' are special, procedurally generated [[cloth|fabrics]] that can be found in [[vault]]s. Divine fabrics are used as material for items and [[clothing]] used by [[angel]]s, who ruthlessly protect the vault's priceless treasures. Unlike [[divine metal]]s, divine fabrics cannot be modified into other items, nor are they appreciably better than their mundane counterparts.

As a quirk, Human and Elven caravans may bring [[instrument]]s and instrument parts made out of divine fabric for trade.{{bug|9275}}

== Traits ==

Divine fabrics appear to have identical [[Material definition token|material properties]] to standard [[silk]] [[cloth]], with the addition of [[fire-safe|fire immunity]]. The various types of cloth have procedurally generated names for association with specific [[deity|deities]]. They are granted [[sphere]]s matching the associated [[deity]] that has created the fabric (and the guardians who wear it).



== List ==
* dancing wisps (beauty)
* rotted fabric (blight)
* never-still cloth (chaos)
* liquid darkness (darkness)
* shining cloth (dawn)
* bright cloth (day)
* pale fabric (death)
* twisted fabric (deformity)
* patchy cloth (disease)
* wispy cloth (dreams)
* translucent cloth (dusk)
* flickering cloth (fire)
* faceted cloth (jewels)
* still blue fabric (lakes)
* heavy cloth (lies)
* glowing cloth (light)
* flashing sparks (lightning)
* misty cloth (mist)
* white cloth (moon)
* dirty fabric (muck)
* sonorous lines (music)
* pitch-black fabric (night)
* screaming mouths (nightmares)
* undulating cloth (oceans)
* moist fabric (rain)
* multicolored cloth (rainbows)
* flowing fabric (rivers)
* clear blue cloth (sky)
* motes of light (stars)
* flowing cloth (storms)
* blazing cloth (sun)
* shimmering cloth (trickery)
* shining cloth (thunder)
* shadow stuff (twilight)
* molten liquid (volcanos)
* liquid cloth (water)
* rustling fabric (wind)

{{Category|Fabrics}}{{Category|Materials}}

Yarn

2017-09-12T20:17:16Z

TheCrazyHamsteR:

{{quality|Fine|23:01, 17 February 2013 (UTC)}}{{av}}

'''Yarn''' is a type of thread that is [[spinner|spun]] from [[animal]] [[wool]]. Only a {{catlink|Shearable|select group of animals}} have hair of a quality to be considered wool; these animals may be [[butcher]]ed or [[shear]]ed to produce wool. [[Yarn]] can be [[weaver|woven]] into [[cloth]] at a [[loom]]. Yarn cloth can then be used to create a variety of textile products such as [[bag]]s, [[clothing]], [[rope]] or [[crafts]].

A [[dwarf]] with the [[spinner]] [[labor]] enabled can process wool into yarn at a [[farmer's workshop]] with the "Spin Thread" job order. With a [[loom]], any dwarf with the [[weaver]] labor enabled will automatically turn any yarn into cloth.

==See Also==
* [[Silk]]
* [[Plant fiber]]
* [[Textile industry]]

{{Translation
| dwarven = ethír
| elvish = ire
| goblin = nasê
| human = áto
}}

{{Category|Materials}}

Plant fiber

2017-09-12T20:14:37Z

TheCrazyHamsteR: added raws

{{av}}
{{Quality|Fine|13:04, 22 June 2010 (UTC)}}

'''Plant fiber''' is a type of [[thread]], created from harvested plants by a [[thresher]] at a farmer's workshop. It can then be [[dyeing|dyed]], used to create [[cloth]], or used by a [[suturer]] in a [[hospital]]. Producing plant fiber threads will also create seeds for the corresponding crop.

There are currently eight crops which can be used for textile production: [[rope reed|rope reeds]], [[pig tail|pig tails]], [[hemp]], [[cotton]], [[ramie]], [[flax]], [[jute]] and [[kenaf]]. Pig tails are the only fiber-producing crop which can be grown [[underground]]; the others are all above-ground crops. The value of the plant fiber does not change depending on the crop used.

When used to create cloth, all plant fibres have a material value of 12☼, twice as much as [[wool]] and low-value [[silk]], but half as much as the precious [[giant cave spider]] silk.

==See Also==
* [[Silk]]
* [[Yarn]]
* [[Textile industry]]

{{gamedata}}
{{Category|Materials}}

DF2014:Plant fiber/raw

2017-09-12T20:14:14Z

TheCrazyHamsteR: raws for plant fiber

[MATERIAL_TEMPLATE:THREAD_PLANT_TEMPLATE]
[STATE_COLOR:ALL_SOLID:GRAY]
[STATE_NAME:ALL_SOLID:fiber]
[STATE_ADJ:ALL_SOLID:fiber]
[STATE_COLOR:LIQUID:BLACK]
[STATE_NAME:LIQUID:none]
[STATE_ADJ:LIQUID:none]
[STATE_COLOR:GAS:BLACK]
[STATE_NAME:GAS:none]
[STATE_ADJ:GAS:none]
[DISPLAY_COLOR:7:0:0]
[MATERIAL_VALUE:1]
[SPEC_HEAT:420]
[IGNITE_POINT:10508]
[MELTING_POINT:NONE]
[BOILING_POINT:NONE]
[HEATDAM_POINT:10250]
[COLDDAM_POINT:9900]
[MAT_FIXED_TEMP:NONE]
[SOLID_DENSITY:1520]
[LIQUID_DENSITY:NONE]
[MOLAR_MASS:NONE]
[IMPACT_YIELD:10000]
[IMPACT_FRACTURE:10000]
[IMPACT_STRAIN_AT_YIELD:100000]
[COMPRESSIVE_YIELD:10000]
[COMPRESSIVE_FRACTURE:10000]
[COMPRESSIVE_STRAIN_AT_YIELD:100000]
[TENSILE_YIELD:10000]
[TENSILE_FRACTURE:10000]
[TENSILE_STRAIN_AT_YIELD:100000]
[TORSION_YIELD:10000]
[TORSION_FRACTURE:10000]
[TORSION_STRAIN_AT_YIELD:100000]
[SHEAR_YIELD:600000] used cotton
[SHEAR_FRACTURE:600000] used cotton
[SHEAR_STRAIN_AT_YIELD:100000]
[BENDING_YIELD:10000]
[BENDING_FRACTURE:10000]
[BENDING_STRAIN_AT_YIELD:100000]
[MAX_EDGE:0]
[ABSORPTION:100]
[THREAD_PLANT]
[ITEMS_SOFT]

Silk

2017-09-12T20:11:31Z

TheCrazyHamsteR: added raws

{{av}}
{{Quality|Fine}}
'''Silk''' [[cloth]] is made from silk [[thread]]. Silk [[thread]] can be gathered from the [[web]]s of [[brown recluse spider]]s, [[brown recluse spider man|brown recluse spider men]], [[cave spider]]s, [[giant cave spider]]s, and [[phantom spider]]s (as well as any web-spinning [[forgotten beast]]s, [[titan]]s, or [[demon|clowns]]), which is then woven into cloth at a [[loom]]. Webs are automatically collected by any worker who has the [[weaver|weaving]] labor activated and access to a [[loom]], which automatically produces the work task "collect webs" and turns collected [[web]]s directly into silk thread. No [[stockpile]] is necessary for this collection.

Automatic collection of webs can be disabled from the [[Standing orders|orders menu]] ({{key|o}} -> {{key|W}}) - this is useful if the accessible [[web]]s are located in a dangerous area or if you want to temporarily free up your [[weaver]]s for other tasks.

Silk is generally a superior material for clothing as it is a [[weight|lighter]] material than [[leather]] and far more protective than other cloth materials in the event of animal attacks on civilians.

==See also==
{{Translation
| dwarven = nesteth
| elvish = yarare
| goblin = egod
| human = sushsath
}}
* [[Yarn]]
* [[Plant fiber]]
* [[Textile industry]]
* [[Silk farming]]

{{gamedata}}
{{Category|Materials}}

DF2014:Silk/raw

2017-09-12T20:11:06Z

TheCrazyHamsteR: raws for silk

[MATERIAL_TEMPLATE:SILK_TEMPLATE]
[STATE_COLOR:ALL_SOLID:WHITE]
[STATE_NAME:ALL_SOLID:silk]
[STATE_ADJ:ALL_SOLID:silk]
[STATE_COLOR:LIQUID:WHITE]
[STATE_NAME:LIQUID:n/a]
[STATE_ADJ:LIQUID:n/a]
[STATE_COLOR:GAS:WHITE]
[STATE_NAME:GAS:n/a]
[STATE_ADJ:GAS:n/a]
[DISPLAY_COLOR:7:0:1]
[MATERIAL_VALUE:1]
[SPEC_HEAT:420]
[IGNITE_POINT:10508]
[MELTING_POINT:NONE]
[BOILING_POINT:NONE]
[HEATDAM_POINT:10250]
[COLDDAM_POINT:9900]
[MAT_FIXED_TEMP:NONE]
[SOLID_DENSITY:500]
[LIQUID_DENSITY:NONE]
[MOLAR_MASS:NONE]
[IMPACT_YIELD:10000]
[IMPACT_FRACTURE:10000]
[IMPACT_STRAIN_AT_YIELD:100000]
[COMPRESSIVE_YIELD:10000]
[COMPRESSIVE_FRACTURE:10000]
[COMPRESSIVE_STRAIN_AT_YIELD:100000]
[TENSILE_YIELD:10000]
[TENSILE_FRACTURE:10000]
[TENSILE_STRAIN_AT_YIELD:100000]
[TORSION_YIELD:10000]
[TORSION_FRACTURE:10000]
[TORSION_STRAIN_AT_YIELD:100000]
[SHEAR_YIELD:1150000] used spider silk from wikipedia
[SHEAR_FRACTURE:1200000]
[SHEAR_STRAIN_AT_YIELD:100000]
[BENDING_YIELD:10000]
[BENDING_FRACTURE:10000]
[BENDING_STRAIN_AT_YIELD:100000]
[MAX_EDGE:0]
[ABSORPTION:100]
[SILK]
[ITEMS_SOFT]

Divine metal

2017-09-12T20:06:06Z

TheCrazyHamsteR:

{{Quality|Exceptional|22:40, 20 September 2016 (UTC)}}
{{av}}
{{spoiler}}
{{Metal|name=Divine metal|color=0:0:1
|ore=
* N/A
|properties=
* [[Material value]] 300
{{firemagmasafe|yes|yes}}
* [[Melting point]] None
* [[Boiling point]] None
* [[Ignition point]] None
* [[Solid density]] 1000
* Liquid [[density]] 1000
* Molar mass 20000
* [[Specific heat]] 7500
|uses=
* [[Weapon|Melee Weapons]]
* [[Crossbow]]s
* [[Bolt]]s
* [[Pick]]s
* [[Armor]]
* [[Anvil]]s
* [[Metalsmith's forge|Metal crafting]]
|wiki=List of fictional elements, materials, isotopes and atomic particles}}
'''Divine metals''' are special, procedurally generated [[metal]]s that can be found in [[vault]]s. Divine metals are used as material for items, [[weapon]]s and [[armor]] used by [[angel]]s, who ruthlessly protect the vault's priceless treasures. (Similar [[divine fabric]]s are used by vault guardians for clothing and soft items.)

== Traits ==

Divine metals appear to have identical [[Material definition token|material properties]] and list of items craftable from them; the only difference between them are the name and [[deity]] association. All divine metals have high yield values of 1000000 and fracture values of 2000000, and perfect strain-at-yield values of 0. They are extremely light, at only a solid density of 1000, and have a superior max edge of 12000. They are granted [[sphere]]s matching the associated [[deity]] that has created the metal (and the guardians who wield it), and a descriptive name with the formula of "(adjective) metal" — examples of such are "multicoloured metal", "pale metal", and "twisting metal".

Overall, their material properties are much better than the corresponding values of [[steel]] and mostly worse to those of [[adamantine]]. They are terrifyingly potent when used for edged weapons, due to their ultra-sharpness, but despite their light weight, even blunt weapons tend to be highly effective (unlike adamantine, which is worthless for blunt weapons).

Weapons and armour made of divine metals may be tested in the [[object testing arena|Arena]].
{{Translation
| dwarven = Nabaskel
| elvish = Mecalalethi
| goblin = Ngungdubsnusm
| human = Nirnorigu
}}


== List ==
* rusted metal (blight)
* twisting metal (chaos)
* dark metal (darkness)
* glowing metal (dawn)
* bright metal (day)
* pale metal (death)
* pock-marked metal (deformity)
* blistered metal (disease)
* ruddy metal (earth)
* flickering metal (fire)
* faceted metal (jewels)
* shining metal (light)
* flashing metal (lightning)
* translucent metal (moon)
* frosty metal (mountains)
* slick metal (muck)
* singing metal (music)
* black metal (night)
* multicolored metal (rainbows)
* clear blue metal (sky)
* twinkling metal (stars)
* crashing metal (storms)
* blazing metal (sun)
* booming metal (thunder)
* searing metal (torture)
* flowing metal (volcanos)

{{Category|Metals}}{{Category|Materials}}

Divine fabric

2017-09-12T20:01:58Z

TheCrazyHamsteR: properties

{{Quality|Fine|01:53, 29 July 2014 (UTC)}}
{{av}}
{{spoiler}}

{{infostart|}}
{{infoheader|Properties}}
{{infocell|
* [[Material value]] 300
{{firemagmasafe|no|no}}
* [[Melting point]] None
* [[Boiling point]] None
* [[Ignition point]] None
* [[Temperature|Heat damage point]] {{ct|10250}}
* [[Temperature|Cold damage point]] {{ct|9900}}
* [[Solid density]] 1
* [[Specific heat]] 420
}}
{{infoend}}

'''Divine fabrics''' are special, procedurally generated [[cloth|fabrics]] that can be found in [[vault]]s. Divine fabrics are used as material for items and [[clothing]] used by [[angel]]s, who ruthlessly protect the vault's priceless treasures. Unlike [[divine metal]]s, divine fabrics cannot be modified into other items, nor are they appreciably better than their mundane counterparts.

As a quirk, Human and Elven caravans may bring [[instrument]]s and instrument parts made out of divine fabric for trade.{{bug|9275}}

== Traits ==

Divine fabrics appear to have identical [[Material definition token|material properties]] to standard [[silk]] [[cloth]], with the addition of [[fire-safe|fire immunity]]. The various types of cloth have procedurally generated names for association with specific [[deity|deities]]. They are granted [[sphere]]s matching the associated [[deity]] that has created the fabric (and the guardians who wear it).



== List ==
* dancing wisps (beauty)
* rotted fabric (blight)
* never-still cloth (chaos)
* liquid darkness (darkness)
* shining cloth (dawn)
* bright cloth (day)
* pale fabric (death)
* twisted fabric (deformity)
* patchy cloth (disease)
* wispy cloth (dreams)
* translucent cloth (dusk)
* flickering cloth (fire)
* faceted cloth (jewels)
* still blue fabric (lakes)
* heavy cloth (lies)
* glowing cloth (light)
* flashing sparks (lightning)
* misty cloth (mist)
* white cloth (moon)
* dirty fabric (muck)
* sonorous lines (music)
* pitch-black fabric (night)
* screaming mouths (nightmares)
* undulating cloth (oceans)
* moist fabric (rain)
* multicolored cloth (rainbows)
* flowing fabric (rivers)
* clear blue cloth (sky)
* motes of light (stars)
* flowing cloth (storms)
* blazing cloth (sun)
* shimmering cloth (trickery)
* shadow stuff (twilight)
* molten liquid (volcanos)
* liquid cloth (water)
* rustling fabric (wind)

{{Category|Fabrics}}{{Category|Materials}}

Magma-safe

2017-09-12T19:47:31Z

TheCrazyHamsteR:

{{Quality|Exceptional|01:12, 4 February 2015 (UTC)}}
{{av}}
{{Material properties}}
'''Magma-safe materials''' are materials which will not melt, burn, evaporate, or otherwise take damage when in close contact with [[magma]]. Most frequently, this comes into play when using [[floodgate]]s operated by [[mechanism]]s, or when operating a [[screw pump|magma pump]].

For [[reaction]]s and custom buildings using the [MAGMA_BUILD_SAFE] token, only a material which is solid and stable at the temperature {{ct|12000}} (i.e. MELTING_POINT/BOILING_POINT/IGNITE_POINT/HEATDAM_POINT greater than 12000 and COLDDAM_POINT less than 12000) is considered magma-safe.

In order to construct mechanisms, blocks or other pump components from a magma-safe material, you have several choices:
# You can specify a magma-safe rock for your [[mechanisms]] and other components at the workshops by highlighting a listed job and selecting {{k|d}}etail.{{version|0.42.06}}
# Build your mechanisms out of [[iron]] or [[steel]].
# Build your pump components out of iron, steel, [[glass]], or [[nether-cap]].
# Place a [[stockpile]] with the desired stones around your [[mechanic's workshop]] and set it to "Give To a Pile/Workshop".
# Use a [[burrow]] that contains only the workshop and the desired materials.
# Simply ensure that the desired materials are the closest available to your worker. This does not always work, but is usually good enough if you request several jobs, hoping that at least one uses the correct material.

When linking a trigger to an object, the ''first'' mechanism selected is attached to the object, and the ''second'' is attached to the trigger. Unless the trigger itself will be submerged in magma (as could be the case with a [[pressure plate]]), only the first mechanism (attached to the object that will be submerged) needs to be magma-safe. If you do not have any magma-safe stones available, you can also work around floodgate-based flow control by using [[screw pump]]s to pump the magma over [[wall]]-barriers, or using water to form [[obsidian]] to plug flows and channel through them to reopen them (necessity and invention and all that).

This property is also relevant when choosing the appropriate method for disposing of unneeded items, which can impact [[FPS]] when in large numbers. Items made of non magma-safe materials can be simply dumped into magma, which is the easiest disposal method; however, magma-safe items will need more [[Dwarven atom smasher|drastic]] measures.

Constructions that resist magma are:

* Constructions ([[Wall]], [[Floor]], [[Ramp]], and [[Stairs]]) of any material can never melt or burn - there is nothing wrong with a [[wood]]en magma reservoir. Natural (i.e. non-constructed) [[ice]] walls/floors/ramps/stairs will melt if exposed to sufficient heat.
* [[Fortification]]s will allow the passage of [[magma]]; however, if fortifications fill up to 7/7 depth, magma creatures will be able to swim freely through them.
* If not submerged (that is, not opened to let magma flow over/past/around them), [[door]]s, [[floodgate]]s, and raised [[bridge]]s (provided that there is no magma on the space the bridge would occupy when lowered) of non-magma-safe stone or metal are safe. So long as they are just in contact with magma, only acting as a passive "wall", they are fine. If opened, they will melt.
** Raised drawbridges have a notable exception, in that allowing magma to flow over the center of the area that the bridge would normally occupy when lowered ''will'' cause the bridge's components to heat up and potentially melt.
* A [[pump]] made with magma-safe material for pipes, screws and blocks is fully magma-safe, and will not melt even when submerged in magma. Pumps containing any item that is not magma safe will be destroyed after prolonged operation.

== Game calculations ==
In the game, magma's temperature is exactly {{ct|12000}}.

The chance of striking a magma-safe stone is roughly around 32%, not including the natural abundance of certain stone. It is important to note whether or not your fortress may already have access to magma-safe resources before attempting to deliberately find some.

==Magma-safe material==

The following materials will not melt when submerged in magma. Although true for any item/construction, it's worth specifically mentioning that this includes [[door]]s, [[floor hatch]]es, [[floodgate]]s, [[bridge]]s, [[screw pump]]s, [[pipe section]]s, and [[mechanism]]s.


{{MS table head}}

{{MS table row|Type=Stone|Matl=[[Alunite]]|Appear={{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}|Temp=13,690°U (3722°F/2051°C)|Where=All [[Igneous extrusive layer|Igneous extrusive]]'''(L)''', [[Kaolinite]]'''(L)'''}}

{{MS table row|Type=Stone|Matl=[[Anhydrite]]|Appear={{Raw Tile|v|7:7:1}} {{Raw Tile|•|7:0}}|Temp=12,610°U (2642°F/1450°C)|Where=[[Gypsum]]'''(S)''', [[Satinspar]]'''(1)''', [[Alabaster]]'''(1)''', [[Selenite]]'''(1)'''}}

{{MS table row|Type=Stone|Matl=[[Basalt]]|Appear={{Raw Tile|#|0:7:1}} {{Raw Tile|•|0:1}}|Temp=12,160°U (2192°F/1200°C)|Where=[[Igneous extrusive layer|Igneous extrusive]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Bauxite]]|Appear={{Raw Tile|+|4:7:0}} {{Raw Tile|•|4:0}}|Temp=13,600°U (3632°F/2000°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(L)'''|Notes=dark red}}

{{MS table row|Type=Stone|Matl=[[Calcite]]|Appear={{Raw Tile|"|7:7:1}} {{Raw Tile|•|7:1}}|Temp=12,902°U (2934°F/1613°C)|Where=[[Limestone]]'''(S)''', [[Marble]]'''(S)'''|Notes=[[flux]] stone}}

{{MS table row|Type=Stone|Matl=[[Chert]]|Appear={{Raw Tile|=|6:7:0}} {{Raw Tile|•|6:0}}|Temp=13,101°U (3133°F/1723°C)|Where=[[Sedimentary layer|Sedimentary]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Chromite]]|Appear={{Raw Tile|=|0:7:1}} {{Raw Tile|•|0:1}}|Temp=13,645°U (3677°F/2026°C)|Where=[[Olivine]]'''(V)'''}}

{{MS table row|Type=Stone|Matl=[[Dolomite]]|Appear={{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}|Temp=16,507°U (6539°F/3619°C)|Where=[[Sedimentary layer|Sedimentary]] layer stone|Notes=[[Flux]], Highest melting point of any common stone.}}

{{MS table row|Type=Stone|Matl=[[Gabbro]]|Appear={{Raw Tile|▒|0:7:1}} {{Raw Tile|•|0:1}}|Temp=12,160°U (2192°F/1200°C)|Where=[[Igneous intrusive layer|Igneous intrusive]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Ilmenite]]|Appear={{Raw Tile|.|0:7:1}} {{Raw Tile|•|0:1}}|Temp=12,457°U (2489°F/1365°C)|Where=[[Gabbro]]'''(S)'''}}

{{MS table row|Type=Stone|Matl=[[Kaolinite]]|Appear={{Raw Tile|=|4:7:0}} {{Raw Tile|•|4:0}}|Temp=13,150°U (3182°F/1751°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(L)'''|Notes=dark red, [[porcelain]]}}

{{MS table row|Type=Stone|Matl=[[Mica]]|Appear={{Raw Tile|v|0:7:1}} {{Raw Tile|•|0:1}}|Temp=12,295°U (2327°F/1275°C)|Where=All [[Metamorphic]]'''(L)''', [[Granite]]'''(L)'''}}

{{MS table row|Type=Stone|Matl=[[Obsidian]]|Appear={{Raw Tile|▒|0:7:1}} {{Raw Tile|•|0:1}}|Temp=13,600°U (3632°F/2001°C)|Where=[[Igneous extrusive layer|Igneous extrusive]] layer stone|Notes=value 3, can be "[[obsidian farming|manufactured]]"}}

{{MS table row|Type=Stone|Matl=[[Olivine]]|Appear={{Raw Tile|%|2:7:0}} {{Raw Tile|•|2:0}}|Temp=13,168°U (3200°F/1761°C)|Where=[[Gabbro]]'''(L)'''|Notes=green}}

{{MS table row|Type=Stone|Matl=[[Orthoclase]]|Appear={{Raw Tile|%|6:7:1}} {{Raw Tile|•|6:1}}|Temp=12,250°U (2282°F/1250°C)|Where=All [[Igneous intrusive layer|Igneous intrusive]]'''(L)''', All [[Metamorphic]]'''(L)'''|Notes=yellow}}

{{MS table row|Type=Stone|Matl=[[Periclase]]|Appear={{Raw Tile|,|7:7:1}} {{Raw Tile|•|7:1}}|Temp=15,040°U (5072°F/2803°C)|Where=[[Marble]]'''(S)'''}}

{{MS table row|Type=Stone|Matl=[[Petrified wood]]|Appear={{Raw Tile|%|4:7:1}} {{Raw Tile|•|4:1}}|Temp=12,970°U (3002°F/1650°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(S)'''|Notes=bright red, least dense magma-safe non-economic stone}}

{{MS table row|Type=Stone|Matl=[[Pitchblende]]|Appear={{Raw Tile|*|5:7:0}} {{Raw Tile|•|5:0}}|Temp=12,070°U (2102°F/1149°C)|Where=[[Granite]]'''(S)'''|Notes=purple}}

{{MS table row|Type=Stone|Matl=[[Quartzite]]|Appear={{Raw Tile|-|7:7:1}} {{Raw Tile|•|7:1}}|Temp=12,970°U (3002°F/1650°C)|Where=[[Metamorphic]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Rutile]]|Appear={{Raw Tile|`|5:7:0}} {{Raw Tile|•|5:0}}|Temp=13,285°U (3214°F/1826°C)|Where=All [[Metamorphic]]'''(S)''', [[Granite]]'''(S)'''|Notes=purple}}

{{MS table row|Type=Stone|Matl=[[Sandstone]]|Appear={{Raw Tile|#|6:7:0}} {{Raw Tile|•|6:0}}|Temp=12,070°U (2102°F/1149°C)|Where=[[Sedimentary layer|Sedimentary]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Talc]]|Appear={{Raw Tile|||7:7:1}} {{Raw Tile|•|7:1}}|Temp=12,700°U (2732°F/1500°C)|Where=[[Dolomite]]'''(L)'''}}

{{MS table row|Type=Metal|Matl=[[Adamantine]]|Appear={{Raw Tile|X|3:3:1}} {{Raw Tile|≡|3:1}}|Temp=25,000°U (15,032°F/8333°C)|Notes=Highest value/utility material in game}}

{{MS table row|Type=Metal|Matl=[[Iron]]|Appear={{Raw Tile|X|0:7:1}} {{Raw Tile|≡|0:1}}|Temp=12,768°U (2800°F/1538°C)|Notes=Armor/weapons}}

{{MS table row|Type=Metal|Matl=[[Nickel]]|Appear={{Raw Tile|X|7:3:0}} {{Raw Tile|≡|7:0}}|Temp=12,619°U (2651°F/1455°C)}}

{{MS table row|Type=Metal|Matl=[[Pig iron]]|Appear={{Raw Tile|X|0:7:1}} {{Raw Tile|≡|0:1}}|Temp=12,106°U (2138°F/1170°C)|Notes=used in steel making process}}

{{MS table row|Type=Metal|Matl=[[Platinum]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|≡|7:1}}|Temp=13,182°U (3214°F/1768°C)|Notes=High value metal}}

{{MS table row|Type=Metal|Matl=[[Steel]]|Appear={{Raw Tile|X|0:7:1}} {{Raw Tile|≡|0:1}}|Temp=12,718°U (2750°F/1510°C)|Notes=Armor/weapons}}

{{MS table row|Type=Metal|Matl=[[Divine metal]]|Appear={{Raw Tile|X|7:0:0}} {{Raw Tile|≡|7:0}}|Temp=None|Notes=Found only in [[vault]]s}}

{{MS table row|Type=Ore|Matl=[[Cassiterite]]|Appear={{Raw Tile|£|6:7:0}} {{Raw Tile|*|6:0}}|Temp=12,025°U (2057°F/1124°C)|Where=[[Granite]]'''(V)'''|Notes=Ore of [[tin]]}}

{{MS table row|Type=Ore|Matl=[[Galena]]|Appear={{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}|Temp=12,005°U (2037°F/1113°C)|Where=All [[Igneous extrusive layer|Igneous extrusive]]'''(V)''', All [[Metamorphic]]'''(V)''', [[Granite]]'''(V)''', [[Limestone]]'''(V)'''|Notes=Ore of [[lead]] and [[silver]]}}

{{MS table row|Type=Ore|Matl=[[Hematite]]<sup>3</sup>|Appear={{Raw Tile|£|4:7:0}} {{Raw Tile|*|4:0}}|Temp=12,736°U (2768°F/1520°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(V)''', All [[Igneous extrusive layer|Igneous extrusive]]'''(V)'''|Notes=Ore of [[iron]]<sup>3</sup>}}

{{MS table row|Type=Ore|Matl=[[Magnetite]]<sup>3</sup>|Appear={{Raw Tile|~|0:7:1}} {{Raw Tile|*|0:1}}|Temp=12,768°U (2800°F/1538°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(L)'''|Notes=Ore of [[iron]]<sup>3</sup>}}

{{MS table row|Type=Ore|Matl=[[Native platinum]]|Appear={{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}|Temp=13,182°U (3214°F/1768°C)|Where=[[Olivine]]'''(V)''', [[Magnetite]]'''(V)''', [[Chromite]]'''(S)'''|Notes=Ore of [[platinum]]}}

{{MS table row|Type=Ore|Matl=''[[Sphalerite]]''<sup>4</sup>|Appear={{Raw Tile|£|0:7:1}} {{Raw Tile|*|0:1}}|Temp=''12,133°U (2165°F/1185°C)''|Where=All [[Metamorphic]]'''(V)'''|Notes=Ore of [[zinc]]<sup>4</sup>}}

{{MS table row|Type=Wood|Matl=[[Nether-cap]]<sup>5</sup>|Appear={{Raw Tile|♠|1:0:0}} {{Raw Tile|▬|1:0:0}}|Temp=N/A|Where=[[Cavern]] (depth 3)|Notes=Naturally cold<sup>5</sup>}}

{{MS table row|Type=Special|Matl=[[Raw adamantine]]|Appear={{Raw Tile|£|3:7:1}} {{Raw Tile|*|3:1}}|Temp=25,000°U (15,032°F/8333°C)|Where=The depths|Notes=Ore of [[adamantine]]}}
{{MS table row|Type=Special|Matl=[[Slade]]|Appear={{Raw Tile|░|0:0:1}} {{Raw Tile|*|0:1}}|Temp=None|Where=The depths|Notes=Intended to be unmineable}}

{{MS table row|Type=Leather|Matl=[[Fire imp]]|Appear={{Raw Tile|ß|6:0:0}}|Temp=None|Notes=}}

{{MS table row|Type=Bone|Matl=[[Fire imp]]|Appear={{Raw Tile|²|7:1}}|Temp=None|Notes=}}
{{MS table row|Type=Bone|Matl=[[Dragon]]|Appear={{Raw Tile|²|7:1}}|Temp=None|Notes=}}

{{MS table row|Type=Soap|Matl=[[Fire imp]]|Appear={{Raw Tile|≡|7:1}}|Temp=15,000°U (5032°F/2780°C)|Notes=}}
{{MS table row|Type=Soap|Matl=[[Dragon]]|Appear={{Raw Tile|≡|7:1}}|Temp=55,000°U (45032°F/25,044°C)|Notes=}}

{{MS table row|Type=Glass|Matl=[[Glass|Green glass]]|Appear={{Raw Tile|X|2:2:1}} {{Raw Tile|■|2:0}}|Temp=13,600°U (3632°F/2001°C)|Notes=}}
{{MS table row|Type=Glass|Matl=[[Glass|Clear glass]]|Appear={{Raw Tile|X|3:3:1}} {{Raw Tile|■|3:0}}|Temp=13,600°U (3632°F/2001°C)|Notes=}}
{{MS table row|Type=Glass|Matl=[[Glass|Crystal glass]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|■|7:1}}|Temp=13,600°U (3632°F/2001°C)|Notes=}}

{{MS table row|Type=Ash|Matl=[[Ash]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|≡|7:0:0}}|Temp=None|Notes=}}
{{MS table row|Type=Ash|Matl=[[Potash]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|≡|7:0:1}}|Temp=None|Notes=}}
{{MS table row|Type=Ash|Matl=[[Pearlash]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|≡|7:0:1}}|Temp=None|Notes=}}
|}

'''Notes:'''
:1. Each stone is one of 16 [[color scheme|colors]] in the game. Different un-mined stone of the same color have a different symbol to distinguish between them. Once mined, the individual stones themselves can sometimes look identical if the color is the same. Use {{k|k}} to loo{{k|k}} at items or the terrain for specific information.
:2. '''°U''' = degrees in [[Main:Urist|Urist]], the measure of temperature within the Dwarf Fortress world. As far as is known, there is no functional difference between a material that melts at {{ct|12005}} or {{ct|55000}} — they are both equally "magma safe".
:3. There are three iron ores in the game (four if you count [[Goblinite]]). Of these, only [[hematite]] and [[magnetite]] are magma safe.
:4. Sphalerite has ''no'' melting point, but ''sublimates'' at {{ct|12133}}. This still qualifies as being magma-safe.
:5. [[Nether-cap]] logs have a fixed temperature of {{ct|10000}}, rendering them fully magma safe, except that nether-cap products [[dump]]ed into magma are destroyed.

{{Magma FAQ}}
{{Category|Physics}}
{{Category|Magma safe materials}}

Bone

2017-09-12T19:17:23Z

TheCrazyHamsteR: added raws

{{Quality|Superior|20:54, 31 July 2013 (UTC)}}
{{av}}
{{buggy}}
'''Bones''' are obtained when butchering [[animals]] or taking apart skeletons. Some severed body parts also decay into usable bones, the same way a corpse rots into a skeleton.

Skeletons are the last step of the [[wear|rotting]] procedure. After a [[corpse]] begins to rot, no [[food]] can be created from it, and it will eventually rot into a skeleton. The skeleton has to be taken to the [[butcher's shop]] and "butchered" to be torn apart into [[skull]]s and bones afterwards. Bone does not rot further or produce [[miasma]]. Note that many civilizations (like dwarves) consider it unethical to butcher certain skeletons {{bug|1180}}. An exception is the stack of bone that can form after a severed part decays. This appears to happen when the part in question has bone as its only non-rotting material.

==Stockpiles==
While bones are counted as "[[body parts]]" in the [[stocks]] menu, they have their own subcategory in the [[stockpile|refuse stockpile]] menu.

Be aware, stockpiles with refuse enabled automatically degrade some items (clothes and armor) quite quickly; refuse should not be enabled in a multi-purpose stockpile. Refuse stockpiles also cause the degradation of stored body parts (such as bones and shells), though at a much slower pace. Bones stored in a refuse stockpile may eventually disappear due to [[vermin]] such as [[rat]]s, it is therefore advisable to have a pasture with [[cat|cats]] overlaying the stockpile.

==Uses for Bone==

Bones are processed as follows:

At a [[craftsdwarf's workshop]], using the [[bone carving]] labor:

* Bone [[craft]]s, for sale to visiting merchants.
* Bone [[armor]], namely [[leggings]], [[greaves]], [[gauntlet]]s, and [[helm]]. Bone armor uses bones individually, but may require one bone from several stacks. The first stack determines the material of the resulting armor. Note that [[armor]] made out of bone can be used by dwarves assigned a [[uniform]] of [[metal]] armor.
* Bone [[decoration]]s. Any decoratable item can be decorated with bone, which adds to the items' value.
* Bone [[bolt]]s. These bolts are fired from crossbows. Each bone will produce 5 bolts. Each bone must be crafted individually (a stack of Yak Cow bone [7] becomes a stack of Yak Cow bone [6] plus a stack of yak bone bolts [5]). This renders the process for carving bone bolts very slow. Despite this, some players still use bone bolts for hunting animals for a long time, mainly because the remnants of animals killed become bones, allowing more bone bolts to be made. Bone bolts are an excellent substitute for wood bolts if there is a shortage of wood. Like wooden bolts, they are mostly good for hunting and archery training, not so much for actual combat use against invading armies.
* Some [[instruments]] or instrument parts can be made from bone.

At a [[bowyer's workshop]], using the [[crossbow-making]] labor:
* Bone [[crossbow]]s. They are one of the few weapons available without access to [[wood]] or [[metal]].

Apart from the manufacture of leggings and greaves, each bone-using job consumes only one bone from a stack. Greaves will consume 3 bones per job. This means it's ideal to make greaves out of lower value bones and weapons out of higher value bones if you plan to export the non-masterworks. The difference is only about 25% in value, but it adds up after making hundreds of items.

Bone greaves are among the best items to make because metal gauntlets and high boots give a positive return for melting while greaves do not. Metal greaves are also very heavy. Bone greaves can be combined with a metal helm, gauntlets, high boots, and leather armor with optional mail shirt, to make a relatively light-weight, full-coverage, uniform for an all-civilian military.

==Moods==

Dwarves in [[strange mood|strange moods]] will occasionally require bones, sometimes even multiple stacks of them. These dwarves will always take an entire stack independent of the amount of bones in it.

As the amount of bones per stack has no influence on the value of the resulting artifact it is recommended to ''guide'' your moody dwarf to use smaller stacks. This may be achieved by creating stacks of single bones '''before''' a strange mood happens and forbidding all other stacks of bones when you get the notice of the dwarf having claimed a workshop.

(Note that while it is not directly possible to ''unstack'' bones, it is possible to use bigger stacks to craft goods until only one bone remains.)

== Bugs ==
{{Translation
| dwarven = osod
| elvish = one
| goblin = mudo
| human = sut
}}

* Dwarves will not butcher corpses or skeletons of tame creatures that died to causes other than hunting and workshop slaughtering {{bug|1180}}; this can be partly fixed by changing their ethics.

* Butchered bone stacks from hostile creatures cause "seeing a _ die" thoughts.{{bug|8813}}

* Limbless torsos can rot to bonestacks which cannot be used for bone decorations, returning a misleading "needs improvable item" error.{{bug|2540}}

{{gamedata}}

{{Category|Materials}}
{{Category|Body parts}}

DF2014:Bone/raw

2017-09-12T19:16:22Z

TheCrazyHamsteR: raws for bone

[MATERIAL_TEMPLATE:BONE_TEMPLATE]
[STATE_COLOR:ALL_SOLID:WHITE]
[STATE_NAME:SOLID:bone]
[STATE_ADJ:SOLID:bone]
[STATE_NAME:POWDER:bone meal]
[STATE_ADJ:POWDER:bone meal]
[STATE_COLOR:LIQUID:WHITE]
[STATE_NAME:LIQUID:n/a]
[STATE_ADJ:LIQUID:n/a]
[STATE_COLOR:GAS:WHITE]
[STATE_NAME:GAS:n/a]
[STATE_ADJ:GAS:n/a]
[DISPLAY_COLOR:7:0:1]
[MATERIAL_VALUE:1]
[SPEC_HEAT:1000]
[IGNITE_POINT:10508]
[MELTING_POINT:NONE]
[BOILING_POINT:NONE]
[HEATDAM_POINT:10250]
[COLDDAM_POINT:9900]
[MAT_FIXED_TEMP:NONE]
[SOLID_DENSITY:500]
[LIQUID_DENSITY:NONE]
[MOLAR_MASS:NONE]
[IMPACT_YIELD:200000]
[IMPACT_FRACTURE:200000]
[IMPACT_STRAIN_AT_YIELD:100]
[COMPRESSIVE_YIELD:200000] cortical bone
[COMPRESSIVE_FRACTURE:200000]
[COMPRESSIVE_STRAIN_AT_YIELD:100]
[TENSILE_YIELD:115000]
[TENSILE_FRACTURE:130000]
[TENSILE_STRAIN_AT_YIELD:100]
[TORSION_YIELD:115000]
[TORSION_FRACTURE:130000]
[TORSION_STRAIN_AT_YIELD:100]
[SHEAR_YIELD:115000] used 'bone (limb)' from wikipedia tensile strength
[SHEAR_FRACTURE:130000]
[SHEAR_STRAIN_AT_YIELD:100]
[BENDING_YIELD:115000]
[BENDING_FRACTURE:130000]
[BENDING_STRAIN_AT_YIELD:100]
[MAX_EDGE:1000]
[ABSORPTION:100]
[IMPLIES_ANIMAL_KILL]
[BONE]
[ITEMS_HARD]
[ITEMS_BARRED]

Fuel

2017-09-11T23:15:49Z

TheCrazyHamsteR: properties

{{Quality|Exceptional|07:04, 17 May 2015 (UTC)}}
{{av}}

:''In Dwarf Fortress, '''[[bituminous coal]]''' is not the same as "coal" - see that article if desired.''

{{infostart|}}
{{infoheader|Properties}}
{{infocell|
* [[Material value]] 2
{{firemagmasafe|yes|no}}
* [[Ignition point]] {{ct|11440}}
* [[Melting point]] None
* [[Boiling point]] None
* [[Solid density]] 1346
* [[Specific heat]] 409
}}
{{infoend}}

'''Fuel''', '''coal''', and '''refined coal''' are three in-game terms that refer to the same thing, any unit of '''charcoal''' or '''coke''', the two fuels used to power high-temperature industries, namely metalworking, glassworking, and pottery. One unit of either of these fuels is required for every task at a conventional (non-magma) [[smelter]], [[forge]], [[kiln]], or [[glass furnace]]. Magma versions of these facilities do not need fuel, and in fact cannot use conventional fuel to power them if their magma sources fail. Fuel is also used as a reactant in the pig iron and steel creation process ''(see [[#Pig iron and steel production|below]])''.

Both "charcoal" and "coke" are considered [[bar]]s; they are found under the "bars" section of the [[stocks|z-stocks]] menu, stored in Bar/Block [[stockpile]]s, and can be used to build [[vertical bars]]. To place bars of fuel in a stockpile, create a Bars/Blocks stockpile, or a [[Stockpile#Custom_stockpiles|custom stockpile]] with "coal" (found in the "Bars" sub-category) {{k|e}}nabled and {{k|p}}ermitted. To allow ''only'' coal in a stockpile, {{k|e}}nable "Bars/Blocks", {{k|b}}lock everything, and enable "Bars: Other Materials → Coal" (with {{k|Enter}}). There is currently no way to distinguish between "charcoal" and "coke" when designating stockpiles.

== Fuel: charcoal and coke ==
The two types of fuel are '''''charcoal''''' and '''''coke''''', and they are ''nearly identical'' for in-game purposes, even though they come from different sources and have different in-game names. Whenever you see "fuel", "refined coal" or "coal" in-game, those refer to ''either'' charcoal or coke - they are interchangeable, and either one will serve as fuel for any workshop activity. Since some understandable confusion can arise over the usage of the various terms for fuel, the simple umbrella term "fuel" will be used in the explanations in this article.

At the risk of repetition, but to be perfectly clear - ''despite the different names, there is no distinction between charcoal and coke for any workshop-related activities.'' Both are "refined coal" or "coal", or just "fuel". The only actual difference between charcoal and coke has to do with [[Elf|Elven]] traders - trading them charcoal will offend them, but coke will not.

== Creating fuel ==
[[Wood]] does not burn hot enough for use as fuel, and (in Dwarf Fortress) raw [[bituminous coal]] and [[lignite]], though flammable, are not directly usable as fuel. Both can, however, be converted to fuel using different processes:

=== Charcoal, from wood===
Charcoal is created at a [[wood furnace]] from [[wood]] logs by a [[dwarf]] with the [[Wood burner|Wood burning]] [[labor]] enabled. One log produces one bar of charcoal; [[Skill|skill levels]] in [[Wood burner]] reduce the time required for this activity, but do not affect the results.

:* Required Building - [[Wood furnace]]
:* Required Labor enabled - [[Wood burning]]
:* Required Material - [[Wood]]

===Coke, from bituminous coal or lignite===
Coke is a type of refined coal created at a [[smelter]] from a flammable stone by a [[dwarf]] with the [[Furnace operating|Furnace Operating]] labor enabled. [[skill|Skill levels]] in [[furnace operator]] reduce the time required for this activity, but do not affect the result.

Coke can be created from [[bituminous coal]], producing 9 coke, or [[lignite]], producing 5 coke. At a conventional smelter one bar of fuel is required to perform this reaction, effectively reducing the net yield by one bar.

:*Required Building - [[Smelter]] or [[Magma smelter]]
:*Required Labor enabled - [[Furnace operating]]
:*Required Material - [[Bituminous coal]] or [[lignite]]
:*Required Fuel - one unit of fuel per job at a conventional smelter

Bituminous coal and lignite [[block]]s (sometimes offered by [[trader]]s) can neither be used as fuel nor converted into fuel in any way. They can only be used for standard block purposes -- though they are of course ''not'' [[fire-safe]]!

Because you need fuel in order to refine coke at a standard smelter, you may need to create at least one unit of charcoal at a Wood Burner first, [[trade|import]] a bar of fuel, or skip directly to [[#Magma facilities|magma power]].

==Error messages==
At a conventional (non-magma) [[smelter]], if you try to add a smelting task and have no fuel, you will see the message:

<diagram fg="white">
No tasks available
Check for raw material access
and fuel if necessary
</diagram>
:''(Note that this message will also be seen if there is no [[path]] to your workshop or needed materials, including fuel, or if the necessary materials aren't in any linked [[stockpile]]s.)''

You will not be allowed to add any tasks to any conventional smelter until that workshop has access to at least one unit of either charcoal or coke. (However, if you have just one bar of un-used fuel, you can queue up as many jobs as you want - see next...)

If you have queued up multiple tasks and then run out of fuel, you will get an [[announcement]] similar to:

<blockquote>"'''[[Main:Urist|Urist McFuelUser]] cancels job: needs refined coal.'''"</blockquote>

Note that a forge or glass furnace ''will'' let you add tasks if you have no fuel, and only once a dwarf arrives and finds they cannot complete that task will you get the announcement to that effect. You will get one announcement for each un-fueled task that is unable to be completed. Jobs are canceled when there is no fuel.

When you get either of these messages, you need more fuel - either charcoal or coke will serve equally well.

== Magma facilities ==
Magma replaces conventional fuel for [[magma smelter]]s, [[magma forge]]s, [[magma kiln]]s and [[magma glass furnace]]s. No fuel is needed, nor can it be used, for activities at these facilities. Note that you will still need charcoal or coke as a reactant for smelting bars of [[pig iron]] and [[steel]]. (And see next section.)

== Pig iron and steel production ==
When [[smelting]] [[pig iron]] or [[steel]] at any location, one unit of either charcoal or coke is required in the reaction as a source of carbon. Again, there is no distinction - both charcoal and coke serve equally well in the production of [[bar]]s of either. This is in addition to the unit of fuel that is needed to power the furnace at conventional (non-magma) smelters.

==Bugs==
* Both charcoal and coke are considered [[fire-safe]] building materials.{{bug|5011}}
* If a piece of charcoal or coke (or an item made of these materials) happens to fall in lava, it can generate smoke for several months {{bug|5536}} (related: {{bug|3437}}), causing unhappy [[thought]]s to dwarves that happen to pass by.

==See also==
:* [[Smelting]]
:* [[Fuel industry]]

{{gamedata|{{raw|DF2014:hardcoded_materials.txt|MATERIAL|COAL}}}}

{{Category|Materials}}

Pearlash

2017-09-11T23:09:49Z

TheCrazyHamsteR: properties

{{av}}
{{Quality|Fine|09:38, 9 June 2010 (UTC)}}

{{infostart|}}
{{infoheader|Properties}}
{{infocell|
* [[Material value]] 4
{{firemagmasafe|yes|yes}}
* [[Melting point]] None
* [[Boiling point]] None
* [[Ignition point]] None
* [[Solid density]] 1200
* [[Specific heat]] 800
}}
{{infoend}}

'''Pearlash''' is baked from [[potash]] at a [[kiln]] (uses 1 [[fuel]]) or [[magma kiln]] by a dwarf with the [[furnace operator]] labor enabled. Its primary use is in the manufacture of [[clear glass]] and [[crystal glass]] items. [http://en.wikipedia.org/wiki/Pearlash Pearlash in real life]

Pearlash comes in [[bar]]s, stored in a bar stockpile and viewable in the stocks screen under "bars". Since it is a bar it can also be used to make constructions and workshops.

{{Translation| dwarven = kovest-ibruk | elvish = amayi-imeri | goblin = obasp-usmdas | human = kima-cish}}

{{gamedata|{{raw|DF2014:hardcoded_materials.txt|MATERIAL|PEARLASH}}}}

{{Category|Materials}}

Potash

2017-09-11T23:08:52Z

TheCrazyHamsteR: properties

{{av}}
{{Quality|Fine|09:38, 9 June 2010 (UTC)}}

{{infostart|}}
{{infoheader|Properties}}
{{infocell|
* [[Material value]] 3
{{firemagmasafe|yes|yes}}
* [[Melting point]] None
* [[Boiling point]] None
* [[Ignition point]] None
* [[Solid density]] 1200
* [[Specific heat]] 800
}}
{{infoend}}

'''[[Wikipedia:Potash|Potash]]''' is created from [[ash]] or [[lye]] at an [[ashery]] by a dwarf with the [[potash maker|potash making]] labor enabled. Potash can be used to [[Farming#Yield and Fertilization|fertilize a farm plot]], to increase stack size of harvested plants, or be refined into [[pearlash]].

Potash comes in [[bar]]s, stored in a bar stockpile and viewable in the stocks screen under "bars".

{{Translation| dwarven = tezad-ibruk | elvish = momo-imeri | goblin = ag-usmdas | human = utag-cish}}

{{gamedata|{{raw|DF2014:hardcoded_materials.txt|MATERIAL|POTASH}}}}

{{Category|Materials}}
{{category|Agriculture}}

Ash

2017-09-11T23:07:36Z

TheCrazyHamsteR: properties

{{Quality|Exceptional|22:17, 6 July 2013 (UTC)}}
{{av}}

{{infostart|}}
{{infoheader|Properties}}
{{infocell|
* [[Material value]] 1
{{firemagmasafe|yes|yes}}
* [[Melting point]] None
* [[Boiling point]] None
* [[Ignition point]] None
* [[Solid density]] 1200
* [[Specific heat]] 800
}}
{{infoend}}

:''For the tree, see [[Ash (tree)]]''

'''Ash''' is an intermediate good used to make [[potash]], [[lye]], or for [[Glazer|glazing]] [[ceramic industry|ceramics]]. Ash is produced by burning [[wood]] at a [[wood furnace]], and comes in [[bar]]s, stored in a [[Stockpile#Bar/Block|bar/block stockpile]] and viewable in the [[stocks]] screen under "bars". Ash bars are a surprisingly sound structural material, usable for building [[construction]]s, [[workshop]]s and [[furnace]]s of equal parity to, say, [[granite]]. Although the precise [[material science|material properties]] of ash are unknown, it is [[fire-safe]] and (somehow) [[magma-safe]] as well, making it a usable material when working with [[magma]].

Procedurally generated creatures (such as [[titan]]s and [[forgotten beast]]s) may occasionally be composed of ash, though killing them will just result in a useless pile of ash for your dwarves to clean up. A killed [[fire man]] will leave behind a usable bar of ash, though these creatures are rare.

{{Translation
| dwarven = ibruk
| elvish = imeri
| goblin = usmdas
| human = cish
}}

{{gamedata|{{raw|DF2014:hardcoded_materials.txt|MATERIAL|ASH}}}}

{{Category|Materials}}
{{category|Agriculture}}

Magma-safe

2017-09-11T22:04:00Z

TheCrazyHamsteR: !!SCIENCE!!: heated ash, potash and pearlash to 50000°U and nothing happened. Metal bars melted and boiled, for comparison

{{Quality|Exceptional|01:12, 4 February 2015 (UTC)}}
{{av}}
{{Material properties}}
'''Magma-safe materials''' are materials which will not melt, burn, evaporate, or otherwise take damage when in close contact with [[magma]]. Most frequently, this comes into play when using [[floodgate]]s operated by [[mechanism]]s, or when operating a [[screw pump|magma pump]].

For [[reaction]]s and custom buildings using the [MAGMA_BUILD_SAFE] token, only a material which is solid and stable at the temperature {{ct|12000}} (i.e. MELTING_POINT/BOILING_POINT/IGNITE_POINT/HEATDAM_POINT greater than 12000 and COLDDAM_POINT less than 12000) is considered magma-safe.

In order to construct mechanisms, blocks or other pump components from a magma-safe material, you have several choices:
# You can specify a magma-safe rock for your [[mechanisms]] and other components at the workshops by highlighting a listed job and selecting {{k|d}}etail.{{version|0.42.06}}
# Build your mechanisms out of [[iron]] or [[steel]].
# Build your pump components out of iron, steel, [[glass]], or [[nether-cap]].
# Place a [[stockpile]] with the desired stones around your [[mechanic's workshop]] and set it to "Give To a Pile/Workshop".
# Use a [[burrow]] that contains only the workshop and the desired materials.
# Simply ensure that the desired materials are the closest available to your worker. This does not always work, but is usually good enough if you request several jobs, hoping that at least one uses the correct material.

When linking a trigger to an object, the ''first'' mechanism selected is attached to the object, and the ''second'' is attached to the trigger. Unless the trigger itself will be submerged in magma (as could be the case with a [[pressure plate]]), only the first mechanism (attached to the object that will be submerged) needs to be magma-safe. If you do not have any magma-safe stones available, you can also work around floodgate-based flow control by using [[screw pump]]s to pump the magma over [[wall]]-barriers, or using water to form [[obsidian]] to plug flows and channel through them to reopen them (necessity and invention and all that).

This property is also relevant when choosing the appropriate method for disposing of unneeded items, which can impact [[FPS]] when in large numbers. Items made of non magma-safe materials can be simply dumped into magma, which is the easiest disposal method; however, magma-safe items will need more [[Dwarven atom smasher|drastic]] measures.

Constructions that resist magma are:

* Constructions ([[Wall]], [[Floor]], [[Ramp]], and [[Stairs]]) of any material can never melt or burn - there is nothing wrong with a [[wood]]en magma reservoir. Natural (i.e. non-constructed) [[ice]] walls/floors/ramps/stairs will melt if exposed to sufficient heat.
* [[Fortification]]s will allow the passage of [[magma]]; however, if fortifications fill up to 7/7 depth, magma creatures will be able to swim freely through them.
* If not submerged (that is, not opened to let magma flow over/past/around them), [[door]]s, [[floodgate]]s, and raised [[bridge]]s (provided that there is no magma on the space the bridge would occupy when lowered) of non-magma-safe stone or metal are safe. So long as they are just in contact with magma, only acting as a passive "wall", they are fine. If opened, they will melt.
** Raised drawbridges have a notable exception, in that allowing magma to flow over the center of the area that the bridge would normally occupy when lowered ''will'' cause the bridge's components to heat up and potentially melt.
* A [[pump]] made with magma-safe material for pipes, screws and blocks is fully magma-safe, and will not melt even when submerged in magma. Pumps containing any item that is not magma safe will be destroyed after prolonged operation.

== Game calculations ==
In the game, magma's temperature is exactly {{ct|12000}}.

The chance of striking a magma-safe stone is roughly around 32%, not including the natural abundance of certain stone. It is important to note whether or not your fortress may already have access to magma-safe resources before attempting to deliberately find some.

==Magma-safe material==

The following materials will not melt when submerged in magma. Although true for any item/construction, it's worth specifically mentioning that this includes [[door]]s, [[floor hatch]]es, [[floodgate]]s, [[bridge]]s, [[screw pump]]s, [[pipe section]]s, and [[mechanism]]s.


{{MS table head}}

{{MS table row|Type=Stone|Matl=[[Alunite]]|Appear={{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}|Temp=13,690°U (3722°F/2051°C)|Where=All [[Igneous extrusive layer|Igneous extrusive]]'''(L)''', [[Kaolinite]]'''(L)'''}}

{{MS table row|Type=Stone|Matl=[[Anhydrite]]|Appear={{Raw Tile|v|7:7:1}} {{Raw Tile|•|7:0}}|Temp=12,610°U (2642°F/1450°C)|Where=[[Gypsum]]'''(S)''', [[Satinspar]]'''(1)''', [[Alabaster]]'''(1)''', [[Selenite]]'''(1)'''}}

{{MS table row|Type=Stone|Matl=[[Basalt]]|Appear={{Raw Tile|#|0:7:1}} {{Raw Tile|•|0:1}}|Temp=12,160°U (2192°F/1200°C)|Where=[[Igneous extrusive layer|Igneous extrusive]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Bauxite]]|Appear={{Raw Tile|+|4:7:0}} {{Raw Tile|•|4:0}}|Temp=13,600°U (3632°F/2000°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(L)'''|Notes=dark red}}

{{MS table row|Type=Stone|Matl=[[Calcite]]|Appear={{Raw Tile|"|7:7:1}} {{Raw Tile|•|7:1}}|Temp=12,902°U (2934°F/1613°C)|Where=[[Limestone]]'''(S)''', [[Marble]]'''(S)'''|Notes=[[flux]] stone}}

{{MS table row|Type=Stone|Matl=[[Chert]]|Appear={{Raw Tile|=|6:7:0}} {{Raw Tile|•|6:0}}|Temp=13,101°U (3133°F/1723°C)|Where=[[Sedimentary layer|Sedimentary]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Chromite]]|Appear={{Raw Tile|=|0:7:1}} {{Raw Tile|•|0:1}}|Temp=13,645°U (3677°F/2026°C)|Where=[[Olivine]]'''(V)'''}}

{{MS table row|Type=Stone|Matl=[[Dolomite]]|Appear={{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}|Temp=16,507°U (6539°F/3619°C)|Where=[[Sedimentary layer|Sedimentary]] layer stone|Notes=[[Flux]], Highest melting point of any common stone.}}

{{MS table row|Type=Stone|Matl=[[Gabbro]]|Appear={{Raw Tile|▒|0:7:1}} {{Raw Tile|•|0:1}}|Temp=12,160°U (2192°F/1200°C)|Where=[[Igneous intrusive layer|Igneous intrusive]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Ilmenite]]|Appear={{Raw Tile|.|0:7:1}} {{Raw Tile|•|0:1}}|Temp=12,457°U (2489°F/1365°C)|Where=[[Gabbro]]'''(S)'''}}

{{MS table row|Type=Stone|Matl=[[Kaolinite]]|Appear={{Raw Tile|=|4:7:0}} {{Raw Tile|•|4:0}}|Temp=13,150°U (3182°F/1751°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(L)'''|Notes=dark red, [[porcelain]]}}

{{MS table row|Type=Stone|Matl=[[Mica]]|Appear={{Raw Tile|v|0:7:1}} {{Raw Tile|•|0:1}}|Temp=12,295°U (2327°F/1275°C)|Where=All [[Metamorphic]]'''(L)''', [[Granite]]'''(L)'''}}

{{MS table row|Type=Stone|Matl=[[Obsidian]]|Appear={{Raw Tile|▒|0:7:1}} {{Raw Tile|•|0:1}}|Temp=13,600°U (3632°F/2001°C)|Where=[[Igneous extrusive layer|Igneous extrusive]] layer stone|Notes=value 3, can be "[[obsidian farming|manufactured]]"}}

{{MS table row|Type=Stone|Matl=[[Olivine]]|Appear={{Raw Tile|%|2:7:0}} {{Raw Tile|•|2:0}}|Temp=13,168°U (3200°F/1761°C)|Where=[[Gabbro]]'''(L)'''|Notes=green}}

{{MS table row|Type=Stone|Matl=[[Orthoclase]]|Appear={{Raw Tile|%|6:7:1}} {{Raw Tile|•|6:1}}|Temp=12,250°U (2282°F/1250°C)|Where=All [[Igneous intrusive layer|Igneous intrusive]]'''(L)''', All [[Metamorphic]]'''(L)'''|Notes=yellow}}

{{MS table row|Type=Stone|Matl=[[Periclase]]|Appear={{Raw Tile|,|7:7:1}} {{Raw Tile|•|7:1}}|Temp=15,040°U (5072°F/2803°C)|Where=[[Marble]]'''(S)'''}}

{{MS table row|Type=Stone|Matl=[[Petrified wood]]|Appear={{Raw Tile|%|4:7:1}} {{Raw Tile|•|4:1}}|Temp=12,970°U (3002°F/1650°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(S)'''|Notes=bright red, least dense magma-safe non-economic stone}}

{{MS table row|Type=Stone|Matl=[[Pitchblende]]|Appear={{Raw Tile|*|5:7:0}} {{Raw Tile|•|5:0}}|Temp=12,070°U (2102°F/1149°C)|Where=[[Granite]]'''(S)'''|Notes=purple}}

{{MS table row|Type=Stone|Matl=[[Quartzite]]|Appear={{Raw Tile|-|7:7:1}} {{Raw Tile|•|7:1}}|Temp=12,970°U (3002°F/1650°C)|Where=[[Metamorphic]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Rutile]]|Appear={{Raw Tile|`|5:7:0}} {{Raw Tile|•|5:0}}|Temp=13,285°U (3214°F/1826°C)|Where=All [[Metamorphic]]'''(S)''', [[Granite]]'''(S)'''|Notes=purple}}

{{MS table row|Type=Stone|Matl=[[Sandstone]]|Appear={{Raw Tile|#|6:7:0}} {{Raw Tile|•|6:0}}|Temp=12,070°U (2102°F/1149°C)|Where=[[Sedimentary layer|Sedimentary]] layer stone}}

{{MS table row|Type=Stone|Matl=[[Talc]]|Appear={{Raw Tile|||7:7:1}} {{Raw Tile|•|7:1}}|Temp=12,700°U (2732°F/1500°C)|Where=[[Dolomite]]'''(L)'''}}

{{MS table row|Type=Metal|Matl=[[Adamantine]]|Appear={{Raw Tile|X|3:3:1}} {{Raw Tile|≡|3:1}}|Temp=25,000°U (15,032°F/8333°C)|Notes=Highest value/utility material in game}}

{{MS table row|Type=Metal|Matl=[[Iron]]|Appear={{Raw Tile|X|0:7:1}} {{Raw Tile|≡|0:1}}|Temp=12,768°U (2800°F/1538°C)|Notes=Armor/weapons}}

{{MS table row|Type=Metal|Matl=[[Nickel]]|Appear={{Raw Tile|X|7:3:0}} {{Raw Tile|≡|7:0}}|Temp=12,619°U (2651°F/1455°C)}}

{{MS table row|Type=Metal|Matl=[[Pig iron]]|Appear={{Raw Tile|X|0:7:1}} {{Raw Tile|≡|0:1}}|Temp=12,106°U (2138°F/1170°C)|Notes=used in steel making process}}

{{MS table row|Type=Metal|Matl=[[Platinum]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|≡|7:1}}|Temp=13,182°U (3214°F/1768°C)|Notes=High value metal}}

{{MS table row|Type=Metal|Matl=[[Steel]]|Appear={{Raw Tile|X|0:7:1}} {{Raw Tile|≡|0:1}}|Temp=12,718°U (2750°F/1510°C)|Notes=Armor/weapons}}

{{MS table row|Type=Metal|Matl=[[Divine metal]]|Appear={{Raw Tile|X|7:0:0}} {{Raw Tile|≡|7:0}}|Temp=None|Notes=Found only in [[vault]]s}}

{{MS table row|Type=Ore|Matl=[[Cassiterite]]|Appear={{Raw Tile|£|6:7:0}} {{Raw Tile|*|6:0}}|Temp=12,025°U (2057°F/1124°C)|Where=[[Granite]]'''(V)'''|Notes=Ore of [[tin]]}}

{{MS table row|Type=Ore|Matl=[[Galena]]|Appear={{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}|Temp=12,005°U (2037°F/1113°C)|Where=All [[Igneous extrusive layer|Igneous extrusive]]'''(V)''', All [[Metamorphic]]'''(V)''', [[Granite]]'''(V)''', [[Limestone]]'''(V)'''|Notes=Ore of [[lead]] and [[silver]]}}

{{MS table row|Type=Ore|Matl=[[Hematite]]<sup>3</sup>|Appear={{Raw Tile|£|4:7:0}} {{Raw Tile|*|4:0}}|Temp=12,736°U (2768°F/1520°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(V)''', All [[Igneous extrusive layer|Igneous extrusive]]'''(V)'''|Notes=Ore of [[iron]]<sup>3</sup>}}

{{MS table row|Type=Ore|Matl=[[Magnetite]]<sup>3</sup>|Appear={{Raw Tile|~|0:7:1}} {{Raw Tile|*|0:1}}|Temp=12,768°U (2800°F/1538°C)|Where=All [[Sedimentary layer|Sedimentary]]'''(L)'''|Notes=Ore of [[iron]]<sup>3</sup>}}

{{MS table row|Type=Ore|Matl=[[Native platinum]]|Appear={{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}|Temp=13,182°U (3214°F/1768°C)|Where=[[Olivine]]'''(V)''', [[Magnetite]]'''(V)''', [[Chromite]]'''(S)'''|Notes=Ore of [[platinum]]}}

{{MS table row|Type=Ore|Matl=''[[Sphalerite]]''<sup>4</sup>|Appear={{Raw Tile|£|0:7:1}} {{Raw Tile|*|0:1}}|Temp=''12,133°U (2165°F/1185°C)''|Where=All [[Metamorphic]]'''(V)'''|Notes=Ore of [[zinc]]<sup>4</sup>}}

{{MS table row|Type=Wood|Matl=[[Nether-cap]]<sup>5</sup>|Appear={{Raw Tile|♠|1:0:0}} {{Raw Tile|▬|1:0:0}}|Temp=N/A|Where=[[Cavern]] (depth 3)|Notes=Naturally cold<sup>5</sup>}}

{{MS table row|Type=Special|Matl=[[Raw adamantine]]|Appear={{Raw Tile|£|3:7:1}} {{Raw Tile|*|3:1}}|Temp=25,000°U (15,032°F/8333°C)|Where=The depths|Notes=Ore of [[adamantine]]}}
{{MS table row|Type=Special|Matl=[[Slade]]|Appear={{Raw Tile|░|0:0:1}} {{Raw Tile|*|0:1}}|Temp=None|Where=The depths|Notes=Intended to be unmineable}}

{{MS table row|Type=Leather|Matl=[[Fire imp]]|Appear=|Temp=15,000°U (5032°F/2780°C)|Notes=}}
{{MS table row|Type=Leather|Matl=[[Dragon]]|Appear=|Temp=55,000°U (45032°F/25,044°C)|Notes=Dragon scales actually cannot be tanned}}

{{MS table row|Type=Bone|Matl=[[Fire imp]]|Appear=|Temp=15,000°U (5032°F/2780°C)|Notes=}}
{{MS table row|Type=Bone|Matl=[[Dragon]]|Appear=|Temp=55,000°U (45032°F/25,044°C)|Notes=}}

{{MS table row|Type=Glass|Matl=[[Glass|Green glass]]|Appear={{Raw Tile|X|2:2:1}} {{Raw Tile|■|2:0}}|Temp=13,600°U (3632°F/2001°C)|Notes=}}
{{MS table row|Type=Glass|Matl=[[Glass|Clear glass]]|Appear={{Raw Tile|X|3:3:1}} {{Raw Tile|■|3:0}}|Temp=13,600°U (3632°F/2001°C)|Notes=}}
{{MS table row|Type=Glass|Matl=[[Glass|Crystal glass]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|■|7:1}}|Temp=13,600°U (3632°F/2001°C)|Notes=}}

{{MS table row|Type=Ash|Matl=[[Ash]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|≡|7:0:0}}|Temp=None|Notes=}}
{{MS table row|Type=Ash|Matl=[[Potash]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|≡|7:0:1}}|Temp=None|Notes=}}
{{MS table row|Type=Ash|Matl=[[Pearlash]]|Appear={{Raw Tile|X|7:7:1}} {{Raw Tile|≡|7:0:1}}|Temp=None|Notes=}}
|}

'''Notes:'''
:1. Each stone is one of 16 [[color scheme|colors]] in the game. Different un-mined stone of the same color have a different symbol to distinguish between them. Once mined, the individual stones themselves can sometimes look identical if the color is the same. Use {{k|k}} to loo{{k|k}} at items or the terrain for specific information.
:2. '''°U''' = degrees in [[Main:Urist|Urist]], the measure of temperature within the Dwarf Fortress world. As far as is known, there is no functional difference between a material that melts at {{ct|12005}} or {{ct|55000}} — they are both equally "magma safe".
:3. There are three iron ores in the game (four if you count [[Goblinite]]). Of these, only [[hematite]] and [[magnetite]] are magma safe.
:4. Sphalerite has ''no'' melting point, but ''sublimates'' at {{ct|12133}}. This still qualifies as being magma-safe.
:5. [[Nether-cap]] logs have a fixed temperature of {{ct|10000}}, rendering them fully magma safe, except that nether-cap products [[dump]]ed into magma are destroyed.

{{Magma FAQ}}
{{Category|Physics}}
{{Category|Magma safe materials}}

Dye

2017-09-11T21:03:11Z

TheCrazyHamsteR: added dye values

{{Quality|Superior|22:46, 20 September 2016 (UTC)}}
{{av}}

'''Dye''' can be used at the [[Dyer's shop]] to change the [[Color#Color_tokens|color]] of [[cloth]] or [[cloth|thread]].
Dye is made by milling certain [[crop|plants]] at a [[Millstone]] or [[Quern]]. Usually all [[trading|caravans]] will bring dye for [[trade]] too. Importing dye however is only useful if you have a somewhat skilled [[dyer]], otherwise little value is added and the work wasted. It is better to buy or grow the 'source' plants if available and mill them yourself. Of course, the nice colours are a value in themselves, if you don't stuff it all in bins.

Dyes are [[stockpile]]d as "Food/Milled Plants", along with [[flour]]s. On the [[stocks]] screen, dyes are listed under [[powder]].

In theory, dyed objects can be [[color#Color tokens|colors]] other than the basic 16. However, the game displays them using the basic color that is the nearest match (dimple dye is (dark) blue, and emerald dye is light green).

{| {{prettytable|style=margin-left:auto;margin-right:auto}}
|- style="background:#ddd"
!Plant
!Dye
!colspan=2|Color
!Value
|-
|[[Dimple cup]]
|Dimple Dye
|Midnight Blue
| bgcolor="#003366" |    
|20[[Currency|☼]]
|-
|[[Blade weed]]
|Emerald Dye
|Emerald
| bgcolor="#50c878" |    
|20[[Currency|☼]]
|-
|[[Hide root]]
|Redroot Dye
|Red
| bgcolor="#ff0000" |    
|10[[Currency|☼]]
|-
|[[Sliver barb]]
|Sliver Dye
|Black
| bgcolor="#000000" |    
|20[[Currency|☼]]
|}

Dyes can be applied either to woven cloth or to the raw thread. There is not known to be any difference in the end product based on the point at which the dye was applied during the production process. Dyes can't be applied to finished goods made from cloth, such as clothing, bags, or crafts.

==See also==
*[[Textile industry]]

{{Translation
| dwarven = atír
| elvish = afithi
| goblin = osmu
| human = asseg
}}

{{Category|Materials}}

23a:Mayor

2017-09-11T20:42:01Z

TheCrazyHamsteR:

{{quality|Fine|15:43, 8 May 2012 (UTC)}}{{Noble
| noble=Mayor
| quarters=Decent Quarters
| dining=Decent Dining Room
| office=Decent Office
| chests=2
| cabinets=1
| racks=1
| stands=1
| mandates=1
| demands=2
| arrival=
* 50 population
* Diverse tasks
| function=
* Enable Sieges
}}{{av}}

The [[mayor]] [[noble]] arrives once your population reaches 50 and you have completed enough diverse tasks (see below), changing your fortress from a Village to a Town. Your [[sheriff]] will also be promoted to [[captain of the guard]] at this point. The mayor will also make guild [[mandate]]s if he receives complaints from [[guild]] leaders (if said workers are not given enough work to do).

The presence of the mayor is also required in order to permit the arrival of the [[Count]]. Once you are eligible to have a Mayor, the [[Goblin]]s will begin to attack your fortress.

You must complete a sufficient quantity of various jobs during the previous year in order to trigger the arrival of the Mayor. The criteria appear to be 4 of the following: 25 crafting jobs, 25 metal-related jobs, 25 wood-related jobs, 10 gem jobs, 25 stone jobs, 25 food jobs. The [[40d:Baron|Baron]] in version 0.28.181.40d uses the same criteria.

{{nobles}}

Baron

2017-09-11T20:37:25Z

TheCrazyHamsteR:

{{Quality|Superior|20:12, 20 May 2013 (UTC)}}
{{Noble
| noble= Baron
| office= Decent Office
| quarters= Decent Quarters
| dining= Decent Dining Room
| tomb= Tomb
| chests=2
| cabinets=1
| racks=1
| stands=1
| mandates=1
| demands=2
| arrival=
* 20 population
* 100k created wealth
* 10k exported wealth
| function=
* Meet with [[diplomat]]s
* Appoints a [[Champion]]
}}{{av}}

When a fortress meets certain requirements, the [[liaison]] will offer to make it a barony. The player will then have the option to choose a citizen to promote to the rank of '''baron''', which will take effect when the liaison leaves the map. This offer can be temporarily rejected (by choosing the "we'd rather keep our distance" option or by canceling out of the selection screen after agreeing), deferring the choice until the liaison's next visit. Until the offer is accepted and a candidate nominated, the liaison(s) will not negotiate trade agreements. The promotion screen (see example below) displays only the names and titles of potential candidates, so it may be easiest to choose a candidate in advance of the liaison's offer when more information is available.

It is also possible for a citizen to inherit a baron(ess) title, even from another site, immediately giving that citizen noble status. This can potentially result in the fortress becoming overrun with baron(esse)s that will never leave for the sites that they are the rulers of.

If the appointed baron(ess) is [[marriage|married]], then the spouse will become the baron(ess) consort, and will be considered an unlisted noble (doesn't appear in the {{k|n}}oble menu, but is listed as a [[noble]] in the {{k|u}}nits menu).

Once appointed, the local baron(ess) can issue [[mandate]]s and [[demand]]s, and these will be strongly influenced by his or her personal [[preference]]s. Of particular note, a baron(ess) with no item preferences will never issue any mandates (but may still make demands{{verify}}). If a non-mandater is appointed, it may be a good idea to supply additional happy [[thought]]s for him/her to replace those that would have been experienced from having mandates met.

The selected baron(ess) may still perform useful labour from his/her normal life (as a miner, for example). However, as the baron is supposed to be a [[Noble#Notes|lazy noble]], this seems to be an unintended, broken behaviour in all 0.34.xx versions (so far) and might be fixed in future releases.

If a baron dies, goes insane, or has an [[unfortunate accident]], players will not be able to appoint a new baron and consequently cannot get other nobles which are upgraded from baron, i.e. [[count]] and [[duke]]. However, in at least some situations, the fortress can still eventually become the seat of the [[monarch|monarchy]] of its civilization, in which case a baron (or count/duke) for the fortress at least sometimes arrives as part of the monarch's entourage.

[[File:Barony appointment.PNG|200px|thumb|right|A picture detailing how a baron is appointed]]

== Requirements ==
*Have a caravan leave when your population is 20 or more
*Exported 10k wealth
*Created 100k wealth (imported wealth does not count)

If a player meets the above requirements and still can't promote anyone, this may be due to a glitch. This affects some games and requires that the trade caravan depart before meeting with the liaison in order to get the barony option. Try keeping your mayor and liaison separate until after the caravan has left the map.

{{gamedata| [POSITION:BARON]
[NAME_MALE:baron:barons]
[NAME_FEMALE:baroness:baronesses]
[SPOUSE_MALE:baron consort:barons consort]
[SPOUSE_FEMALE:baroness consort:baronesses consort]
[NUMBER:AS_NEEDED]
[LAND_HOLDER:1]
[LAND_NAME:a barony]
[RESPONSIBILITY:LAW_MAKING]
[RESPONSIBILITY:RECEIVE_DIPLOMATS]
[SUCCESSION:BY_HEIR]
[APPOINTED_BY:MONARCH]
[REPLACED_BY:COUNT]
[PRECEDENCE:40]
[SPECIAL_BURIAL]
[MENIAL_WORK_EXEMPTION]
[MENIAL_WORK_EXEMPTION_SPOUSE]
[SLEEP_PRETENSION]
[PUNISHMENT_EXEMPTION]
[FLASHES]
[BRAG_ON_KILL]
[CHAT_WORTHY]
[DO_NOT_CULL]
[KILL_QUEST]
[COLOR:5:0:0]
[ACCOUNT_EXEMPT]
[DUTY_BOUND]
[DEMAND_MAX:2]
[MANDATE_MAX:1]
[REQUIRED_BOXES:2]
[REQUIRED_CABINETS:1]
[REQUIRED_RACKS:1]
[REQUIRED_STANDS:1]
[REQUIRED_OFFICE:500]
[REQUIRED_BEDROOM:500]
[REQUIRED_DINING:500]
[REQUIRED_TOMB:500]}}
{{Nobles}}
{{Category|Aristocrats}}

Entity token

2017-09-11T20:15:28Z

TheCrazyHamsteR: /* Available Resources */

{{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 DEATH sphere favours the apparition of necromant (and so : 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 (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. 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 (i.e. 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. If the civ is a fortress mode entity (has the [SITE_CONTROLLABLE] token), it will allow the civ to plant them in farm plots in fortress mode. 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. If the civ is a fortress mode entity (has the [SITE_CONTROLLABLE] token), it will allow the civ to plant them in farm plots in fortress mode. 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. If the civ is a fortress mode entity (has the [SITE_CONTROLLABLE] token), it will allow the civ to plant them in farm plots in fortress mode.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade. If the civ is a fortress mode entity (has the [SITE_CONTROLLABLE] token), it will allow the civ to plant them in farm plots in fortress mode.

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

|}

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

Undead

2017-09-10T22:29:11Z

TheCrazyHamsteR: uses of caged undead

{{Quality|Superior|18:33, 23 August 2014 (UTC)}}

{{av}}
The '''animated dead''' (or '''undead''') {{Tile|Ñ|3:0}} are the [[corpse|bodies]] of formerly living creatures animated through fell magic. These [[night creature|night creatures]] can be created intentionally by a [[necromancer]] to serve him, or arise naturally from the dark energies of [[surroundings|evil regions]].

==What is an undead?==
An undead may be formed of either the rotting husk or the bones and shell of a being. The former is considered a zombie, and the latter a skeleton. Although [[vampire]]s are no longer performing the bodily functions of a living being, they are not considered the "animated dead", this term being reserved for a corpse which has begun to move and act on its own or by the will of another, but lacking any form of intelligence beyond a primitive urge to hunt and kill any living thing it can find. Where zombies and skeletons cannot think or behave in any sophisticated manner beyond "kill everything", vampires are willful beings, generally indistinguishable from living persons (and capable of great deception to ensure that nobody learns about their condition). [[Ghost]]s are called Undead in-game, but they are also not considered animated dead (as they lack a corporeal form).

As long as the remains of a creature contain a body part capable of grasping, be it a hand or head or the entire upper half, those remains can be animated. This can lead to animated hands and heads, which seems comical until you consider the implications of a swarm of such monstrosities and the havoc that they might wreak. Even some parts of creatures which should be incapable of autonomous movement can be raised, such as the hair or skin or even ''[[mussel]] shells''. They are, however, predictably nonlethal, mostly serving as a B-movie terror monster to scare your dwarves into running around. A body part can be resurrected as a zombie even if it has already done so and been de-animated again. However, pulping damage (that is, "exploding into gore", "cloven asunder", "torn into shreds" and so on) to the head, neck, lower body, or upper body will turn the corpse into a "mangled corpse", ensuring that the zombie cannot rise up again. Likewise, destroying the structural integrity of an animate body-part will stop its reanimation.

==Traits==
Upon animation, an undead gains a [[syndrome]] that fundamentally changes its physical characteristics and behaviour. Some of the traits they generally possess are:
*Severely increased [[attribute|strength and toughness]] and reduced [[speed]];
*Opposition to life, will be hostile to any non-undead and non-inorganic creatures in their vicinity;
*Lack of emotion, pain, thought, or need for sustenance or breath;
*Undead status ({{token|NOT_LIVING}}), sterility, and inability to attribute rust or gain.

Undead retain the wounds that killed them in life, as well as any they have sustained since or from a temporary de-animation. Undead vary in levels of strength depending on their form. Certain types of animal are likely the most dangerous that it is common to encounter, and can have dangerous strength, speed, aggression, and piercing attacks. The undead of butcherable creatures can still be butchered once de-animated, as long as they have not rotted; doing so will prevent them from re-animating again, though their untanned skins and hair can potentially become undead. These husks can be difficult to kill, but surrounding a butcher's shop with cage traps will usually ramify the problems. In addition, undead husks appear to retain the trading value of the original animal.

Larger undead with who were [[building destroyer]]s in life can still destroy buildings, though undead with special attacks like webbing will not be able to use them (zombie [[dragon]]s, however, still use their breath). Undead thieves can still pick locks, but will not path to a locked door unless in pursuit of the living. If found underground, undead will usually path into a fort if they can.

Undead from [[necromancer]] [[Tower (necromancy)|tower]]s are reported to carry ''[[armor]] and [[weapon]]s'', giving the terror of the announcement ''"The dead walk! Hide while you can!"'' far more weight than before.

===Thralls, Husks, and Zombies===
Certain kinds of evil [[weather]] can instantly turn any [[syndrome]]-vulnerable creature into a bloodthirsty undead killer, opposed to all life. These creatures are referred to be the sort of weather that transformed them, an identifier as a thrall, husk, or zombie, and their original creature name-- for example, a ''stray guineahen unholy gloom husk''. The specific procedurally generated syndromes of thralling evil clouds are functionally identical to that of animate dead, with the same extreme gains in physical stats, lack of pain or breath, etc.

Because the interaction can happen without first killing the target, thrall-like creatures retain any armor or weapons they were carrying. Perhaps worst of all, they may still be contaminated with the material leading to the transformation, "infecting" those with whom they wrestle in a chain reaction that can rapidly destroy a fortress if they are not stopped immediately.

==Destruction==
The undead should in general be considered a serious threat, far beyond the average [[goblin]] garbage. They are far greater in strength and durability than the living, are tireless, feel no pain, have no useful articulations to damage, ignore injuries to their now-useless organs, do not fall unconscious, and are impervious to the effects of morale. All of these traits make the undead highly dangerous; one can compare the effect to fighting a smaller and somewhat more fragile [[bronze colossus]], albeit one that is not guaranteed to stay dead when slain.

You would not wish to attempt to kill them with puncture wounds for this reason, and likewise, choking is ineffective against their lack of breath. Pulping or severing ("flies/sails off in an arc!" etc.) an important structural body-part (head, neck, upper body, lower body) is guaranteed to kill an undead. Blunt weapons are effective weapons to use for animated corpses for they are not only less likely to sever off parts for further reanimation, but are likely to inflict pulping damage, mangling the zombies so badly that they cannot rise up again. Of those available to dwarves, maces are more efficient at pulping than warhammers. Flails are better still if one can acquire them. Beheading appears to sometimes work less reliably - this is possibly related to the neck being cut off rather than the head itself, which the game does not register as decapitation{{Verify}}. Crossbow bolts can kill the undead if one of the previously mentioned important body-parts is destroyed by the shot, but as shots cannot aim at specific organs this method often relies on chance. Cutting apart the physical form of undead can be dangerous if the source of reanimation is still active and present. The more body parts are about, the more fodder for animation is present. In this case, it is wisest to either butcher the corpses (if they can be butchered), throw them into [[magma]], or [[dwarven atom smasher|pulverize them with a drawbridge]], which will destroy the bodies so thoroughly that they cannot be reanimated again. A thrall may be "safely" fought with cutting weapons however, as long as there is no risk of infection at hand. Undead animals can be disposed of by cage-trapping them and trading them away to passing merchants.

Undead from necromancer sieges should be treated with far more caution, as they can carry equipment. These are exceedingly dangerous, for their already heightened strength and toughness are further augmented by weapons-grade metal. You may want to eschew direct combat altogether in this situation, especially as necromancer sieges already tend to summon the walking dead in pages of a hundred, and one is enough to rout an entire squad.

[[Evil weather]] thralls may also require utmost caution. Any thrall carrying a melee weapon or armour (let alone any combat skills of its own, which it will retain the use of) can dispatch a full squad in short order even with average combat skills, making direct confrontation an unwise choice- Armok help you if the thrall in question used to be one of your best soldiers. A particularly dire possibility is that, if the responsible evil cloud is in dust form, the thrall is still contaminated with whatever substance transformed it. If this is the case, any dwarves sent to fight the thrall will become thralls themselves if the thrall tries to wrestle them. From there, the new thralls might spread the contaminant further still, which can easily lead to a [[Fun|full-fledged zombie apocalypse]].

In these and other dire cases, it is often better to not fight them directly at all, instead resorting to traps, [[dwarven atom smasher|atom smashers]] and other indirect ways to neutralise them. It is not advised to directly fight a zombie horde that outnumbers your military, even a highly trained one. A legendary squad can take down zombies in roughly equal numbers, but a continuous onslaught of undead [[Fun|will quickly show a major disadvantage of living soldiers in over-exertion]]. [[Magma]], that classic solution to all dwarven problems, is another effective weapon, as is fire in general. The sheer heat of magma will eventually destroy the corpse, rendering it unable to rise again. Magma kills zombies fairly slowly though.

[[Morale]] is a big obstacle to directly confronting a zombie horde. Without enough [[discipline]], a troop sent to fight them may instead decide to flee in terror from such abominations of nature. As you may imagine, this can lead to endless amounts of [[Fun]], for unlike your dwarves, the undead cannot feel fear or any other emotion, and any dead dwarves may in turn rise up and add to the horde's numbers. It is important that any undead-fighting squad consists of severely hardened and disciplined soldiers. Any soldiers you bring to embark on an evil biome should have ''at least'' two points in [[discipline]], as morale is currently buggy and leads to ordinary dwarves fleeing even from living wildlife{{bug|7161}}. This may also be worked around with a little [[modding]], by adding at least {{token|NATURAL_SKILL:DISCIPLINE:1|c}} to all civilised races and trainable pets. Additionally, the very act of fighting undead makes dwarves more vulnerable to insanity (particularly if the undead was acquainted with the dwarf fighting it in its former life), which must be countered with as many sources of good thoughts if possible.

Reports have been made of zombies animated by the ambient evil of a region deanimating on their own when wandering away from such a vile place. However, there are also reports of undead wildlife being encountered in areas bordering such places.

==Uses==
Undead caught in [[cage trap]]s can be used for fortress defense and executions if you are able to recapture them afterwards. They are hostile to every living creature, including [[siege|siegers]], [[megabeast]]s, [[forgotten beast]]s, [[elf|hippies]], [[snatcher|pedophiles]], [[noble|annoying residents]], and [[cavern]] inhabitants. Build a cunning trap involving caged undead [[elephant]]s, and release them upon an unsuspecting victim! Zombie elephant insurance not included.

==Undead Fun Facts==

* Undead can animate from hauled corpses.
* Undead will not attack vampires.
* Undead will not attack inorganic enemies like the [[bronze colossus]].
* Undead risen from starved animals in cages are not caged.
* Undead attack all organic megabeasts as well as invaders, except necromancers (as their sorcery allows them to control undead easily).
* Creatures capable of evading traps or bypassing locked doors retain that ability as undead.
* Enthralled dwarves from your fortress are not affected by traps that were known to them in life.
* Undead animals, even their animated body parts, retain their original animal value and can be traded to merchants for extra profit.
* Dwarves who like an animal will also enjoy that undead animal.
* Enthralled dwarves in a fortress which is retired or abandoned can appear as part of a migrant wave, causing lots of [[Fun]].
* '''With the addition of jumping, they can jump over 2 thick moats'''.

==Bugs==
* Certain types of undead tissue such as hair and feathers cannot be damaged, nor can they damage dwarves. However, dwarves will be stuck fighting the undead hair till they die from over-exertion.{{bug|5356}}
* Dwarves will not report someone missing as dead even if the corpse is gnawing on their ear.
* Animated creatures can somehow become stuck in mid-air, and will not move at all, even if killed. Spatters of blood from the animated party also float in this manner. This has been known to occur in cases ranging from a deer's animated head to a goblin's partial skeleton.

{{Translation| dwarven = nasnökor | elvish = senoanaÿa | goblin = rotûstru | human = obmuthro}}

{{Creatures}}
{{category|Creatures}}

Exploit

2017-09-10T21:31:21Z

TheCrazyHamsteR: found one more

{{Quality|Superior|05:12, 17 May 2015 (UTC)}}
{{av}}

An '''exploit''' is a quirk of a game that allows players to gain what other players may consider an unfair advantage, usually by making use of a feature that is not working properly or which defies logic. 'Exploiting the game' is distinct from '[[cheating]]' because exploits occur within the game as written and do not need any external [[utilities]] or [[modding]]. Whether a player chooses to make use of an exploit or not depends on their personal taste; given that ''[[Dwarf Fortress]]'' is a single-player game, the user alone can decide what liberties to take and what options to shun. Among DF players there is much discussion about what actually should be considered an exploit, going from making [[dwarven syrup]] instead of [[dwarven sugar]], growing crops in winter, or even underground, as the one extreme, to justifying 'water wheel batteries' as the other. This page takes a rather relaxed approach in that you considering it an exploit is basically enough to add it, if you don't get too much opposition.

== Atom smasher ==
{{main|Dwarven atom smasher}}
Lowering a raised [[drawbridge]] can be used to obliterate most creatures or items beneath it. The drawbridge will be destroyed if it is used to crush a creature of too large a size.

==Manager exercise program==
As a [[manager]], skill is gained as tasks are approved, not completed. Simply by queuing lots of jobs ({{key|j}} {{key|m}} {{key|q}}) (and providing a meager office), the manager will quickly level to [[legendary]] as an [[Organizer]]. The tasks can then be removed once approved.

==Merchant swindles==
There are a variety of ways to steal cargo from [[merchant]]s without seizing it; all amount to naked theft. Tearing down the [[trade depot]] while the merchants are there is the easiest way.

Also, marking items for [[dump]]ing, using view creature mode ({{key|v}}), the stocks menu ({{key|z}}), items in room mode ({{key|t}}), or mass dump mode ({{key|d}})-({{key|b}})-({{key|d}}) then marking the entire depot, lets you relieve merchants of their goods. Just reclaim the items from your garbage dump [[zone]] later. You can even take clothing and equipment off merchant and guards this way.

You can make a wall around the merchants (and even the poor animals) and let them starve to death, letting you take what ever you want. Wait quite a while for them to starve. They will become [[Insanity|very angry]] if you do, so never open the door once they are on the brink of death.

However, the merchants will consider any lost goods to be stolen goods regardless of the method used to take possession of or destroy them.{{Verify}} See [[40d:Trading#Note_that_the_civ|the 40d page]] and [http://www.bay12forums.com/smf/index.php?topic=43771.msg829692#msg829692 This forum post]. So unless you specifically want to take the clothing off the backs of the merchants or steal from your own civ, you might as well just seize the goods anyway.

== Quantum stockpiles ==
{{main|Quantum stockpile}}
A quantum stockpile (QSP) allows you to store an infinite number of items in a single tile. QSPs can make for super efficient storage, allowing more compact fortresses, shorter hauling routes, more efficient manufacturing flows, stocktaking at a glance with look {{K|k}} and [http://www.bay12forums.com/smf/index.php?topic=92241.msg3276117#msg3276117 possibly higher FPS].

== Building destroyer door ==
Forbid something a dwarf is carrying as he goes through a door, and he'll drop it. The door won't close and won't stop any normal creature from going through, but building destroyers seem to stop in their tracks, waiting for it to close before moving on. Note: your civilians can pass the creature safely, but attacking it cancels your protection. {{Verify}}

== HFS's back door ==
{{main|Semi-molten rock#Tunnelling down through multiple layers of Semi-molten rock|l1=Semi-molten rock § Tunnelling down through multiple layers of Semi-molten rock}}
There's a convoluted way to dig down through [[semi-molten rock]] and evade the head-on encounter with [[hidden fun stuff]]. Doing this can enable you to, among other things, mine undiggable [[slade]] and duplicate rare minerals. See the page [[semi-molten rock]] for details.

== Forgotten beast zoo ==
Wall off all the passageways into your lowest level at the outermost square of the map - except one, which leads to a little vestibule surrounded by fortifications. Wave hello to the various ungainly "[[forgotten beast]]s" which accumulate inside.

Alternatively, by using a [[giant cave spider]] or web-spewing forgotten beast to place [[web]]s on cage traps you can capture and display non-web-spewing forgotten beasts, titans, and more.

== Dwarven water reactor ==
{{main|Water wheel#Perpetual motion|l1=Water wheel § Perpetual motion}}
A [[screw pump]] requires 10 power to move water; a [[water wheel]] supplies 100 power if it's got water moving it. Arrange the former to feed the latter, while the latter powers the former, and you can get [[Water wheel#Perpetual motion|perpetual motion]] going - with a surplus of [[power]] available.

== Urist McAdventurer the shield-wall ==
Adventurers are not limited in the number of items they can hold in their hands, allowing them to equip a virtually unlimited number of shields or bucklers with little effect to the adventurer's performance. This offers multiple chances to block attacks (vastly reducing the number that cause damage) and quickly trains up the shield user skill, further increasing the effectiveness of those shields. There is an indirect limit on how many shields you can equip based on how the total weight of your adventurer's items affects your speed, but the tradeoff between wearing a dozen (or more) shields is well worth the minor reduction in speed.

The current version has made this exploit more complicated due to the ability to holster/draw weapons and shields, which is needed for [[climber|climbing]] and to avoid hostility from local guards. While an infinite number of weapons or shields can be strapped to your body, only the first two such items will be drawn, requiring a free hand for each. Retrieving multiple shields after unequipping them requires manually drawing each individual shield.

== Infinite drink in adventure mode ==
Thirst can be quenched indefinitely in adventure mode by emptying a waterskin when you only have 1 unit of liquid left and refilling it from the pool that forms; giving you 3 units of drink. This is especially useful if you managed to find alcohol and fill your waterskin with some, as alcohol never freezes in cold weather.

== Backpack of holding ==
In adventurer mode, if you try to pick something up while both your hands are already holding something, it'll go straight in your backpack, even if it would not have fit had you first picked it up and then tried to put it inside. That means you can stuff as much as you want into your backpack. It will still effect your weight and speed, however.

== And we'll throw in the barrel or bag for free ==
On [[embark]] buying things which are stored in [[barrel]]s gets the barrel for free, with at most 10 items per barrel, so, for example, the 15 units of randomly chosen [[meat]] which come with the default supplies will get you two free barrels, one completely filled with 10 units of meat and one half filled with 5 units of meat; you get another two free barrels from the 15 units of randomly chosen [[Creature#Aquatic|fish]]. You can get rid of all of that food, then for the same cost select one unit each of meat from 30 different kinds of animals, giving you 30 free barrels instead of only 4, since each different kind of animal meat is put in its own barrel. Note that different types of meat from the same kind of animal goes into a single barrel, so choosing 1 yak brain + 1 yak eye + 1 yak spleen will get you only one free barrel instead of three.

The same thing goes for things stored in [[bag]]s. Each unit of [[sand]] comes in its own bag, and since each unit of sand costs only 1 embark point while bags cost a minimum of 10 embark points each, you can get bags for ten times cheaper by buying sand, then [[dumping]] out the sand after embark.

== Infinite metal ==
Because one bar of metal produces 25 bolts and a single bolt can be melted to 0.1 bars of metal, you can create unlimited adamantine wafers in your fortress using a [[Stupid_dwarf_trick#Bolt_Splitting_Operation|clever setup]] with marksdwarves to separate the stacks of adamantine bolts into single bolts. See this [http://www.bay12forums.com/smf/index.php?topic=51423.0 forum thread] for more details.

Weapon traps filled with crossbows will be loaded with individual bolts (10 per crossbow). Bolts can not be designated to melt while loaded in the trap. It requires deconstruction of the trap. The components will scatter on deconstruction so surrounding the trap with an ammo stockpile set to links only and using dfhack automelt can semi-automate the process. Any metal components of the trap may also be melted.

Coins may also be split at a [[trade depot]] and melted down individually for up to a 50x return. Smelt a stack of coins, then trade it to a caravan. You can then buy the stack back in pieces, and each individual smaller stack will melt and produce .1 bars. One bar produces 500 coins, but splitting it into stacks of 1 coin each would create 500 melt jobs, producing 50 bars in return. The process is discussed in greater detail, both with and without use of macros on this [http://www.bay12forums.com/smf/index.php?topic=111680.0 forum thread]. While potentially time consuming, this new method both results in far more bars produced per stack (potentially a net profit of 49 bars instead of 1.5), and can duplicate any metal, not just military ones while simultaneously training your broker. Combined with a magma smelter and properly written macros, this method turns a smelter into a free metal generator. Those who are less patient may instead opt to simply melt the coin stacks immediately after they are minted - while this yields only a 10% gain, it is far less time consuming.

For multiplying weapons/armor-grade metals, forging and melting giant axe blades, large serrated discs, and leggings will yield a 50% gain per item; note that this does ''not'' work with adamantine, since adamantine goods require 3 times as many wafers, instead leading to a 70% loss per item.

See the [[Melt item]] article for the best yields when melting down items made of mundane metals for the current version.

== Quick trade goods ==
Since [[trap component#spiked ball|spiked balls]] have an extremely high base [[item value]] of ''126'', they can be produced en masse from cheap [[wood]] or other materials and sold off to unsuspecting merchants. This makes for quick cash in any fortress that has a skilled carpenter and an excess of wood on hand.

In fact, any [[trap component]]s make extremely high-value trade goods, especially since metal components require only 1 [[bar]]. (They also increase the [[value]] of [[noble]]'s rooms, and are useful in defense.)

[[Prepared meal]]s can also be quick and valuable trade goods. Purchase an abundance of raw food when the traders arrive, and set your [[kitchen]] to work cooking that food into lavish meals. Then haul the stacks of meals back to the depot and trade them for whatever supplies you really want. The caravan will buy back meals composed of their own ingredients at 25x to 100x their initial value.

== Silk farm ==
{{main|Silk farming}}
A silk farm can serve as a safe and endless source of silk thread from [[giant cave spider]]s or other [[forgotten beast|web-spewing beasts]]. Its essence is a room with a bait creature separated from a web-spewing creature by fortifications. The webber will attempt to attack the bait by shooting [[web]]s through the fortifications. Weavers can collect the webs as silk thread and create silk cloth.

== Dwarven road-dar ==
Dwarven radar is a handy way of checking for caverns and other special features using the [[farm plot]]s, paved [[road]]s, and [[activity zone]]s. Know where the caverns are before you designate your carefully planned, fully symmetric living quarters!

For more details, see the [http://www.bay12forums.com/smf/index.php?topic=93694.0 forum thread].

== Danger room ==
{{Main|Danger room}}
An [[Trap#Upright Spear/Spike|upright spike trap]] full of non-masterwork training spears (''not'' menacing spikes or metal spear, or even [[elf|Elven]] wooden spears) is linked to a [[lever]], which is pulled repeatedly. Dwarves are stationed on the trap. The dwarves quickly learn how to dodge, block and parry these "attacks", gaining [[combat skill]]s much more quickly than through normal [[training]]. Unless they die.

== Coinstar room ==
{{Main|Danger room#Coinstar room|l1=Danger room § Coinstar room}}
A coinstar or popcorn room trains [[armor user]] skills via repeated (unblockable/undodgeable) impacts of small objects such as [[coin]]s. [[Seed]]s, [[sock]]s, [[leaves]], and other small, light objects will also work. Channel a 1x2 trench (leaving ramps), and build two 1x1 '''retracting''' bridges on the bottom of the trench. Connect the bridges to a lever. Add coins (stacks of 15 or smaller are 100% safe) and dwarves.

== Wildlife control ==
Wild animals will not spawn when a certain number of them is still present on the map (2 for default 4x4 embark, for larger sites it's higher). This works also for cavern creatures (each cavern independently), or even for roaming [[HFS]] denizens, and can be exploited to prevent new creatures from a particular layer from spawning. Capture enough wild creatures in [[cage trap]]s, and release them somewhere they couldn't escape from. As long as they're there, no more beasts will show up. Note that thieving and [[gremlin|mischievous]] creatures are an exception to this, as their arrival is timed and unaffected by the number of other wildlife.

{{Category|Game}}

Cave-in

2017-09-10T02:12:43Z

TheCrazyHamsteR:

{{Quality|Masterwork|21:52, 20 September 2016 (UTC)}}
{{av}}
{{buggy}}
:{{DFtext|A section of the cavern has collapsed!|4:0:1}}

A '''cave-in''' is when walls, floors, and other terrain plummet downwards to lower [[Z-axis|Z-levels]] under the influence of [[gravity]]. A cave-in will occur if constructions or ground tiles are detached from all support ([[bridge]]s and [[hatch]]es do not provide support). Since it is only a placeholder, the system is highly unrealistic—you can hold up a giant megafortress by a slender pillar of soap. [[Main:Toady One|Toady One]] has stated he intends to implement more realistic cave-ins in future versions.

Cave-ins can be disabled in the [[d_init.txt]] file by changing [CAVEINS:YES] to [CAVEINS:NO].

== How cave-ins work ==

Any ''disconnected'' [[construction]] or section of [[rock]] or [[soil]] will cave in. The game checks for connections along the X, Y, and Z axes (that's left/right, up/down, and above/below). Any construction, even [[Stairs]] (natural or constructed), and [[support]]s (naturally) provide support/connections. [[Tree]] trunks provide support on all axes. [[Stairs|Upstairs]] will provide support for the z-level above even if there is no downstairs above, acting as an invisible floor. '''Diagonal connections and [[bridge]]s do not provide support.''' Ramps will not provide support to the tile above them, but will act as a connection for the adjacent tiles on the same level.

Note that supports and fortifications, but '''not''' [[statue]]s, create an invisible floor on the level above them. No dwarf can enter the invisible floor, but it will hold an area attached to the floor tiles in four directions alongside it or the constructed/natural wall above it.

== Results of a cave-in ==

===Falling terrain===
* Any unsupported terrain crashes down through multiple [[floor]]s and [[ramp]]s, and stops only upon reaching a wall, up or up/down stair, a fortification, a multi-tile tree, or a support.
* Falling tiles do not stay connected in one mass; each falling column will fall as far as it can as described above.
* Falling natural [[floor]]s, [[stair]]s and [[ramp]]s will be destroyed, leaving behind a natural floor of the highest such terrain; natural stone walls pile up; and constructions deconstruct, leaving behind their building materials.
* [[Tree]]s, [[shrub]]s and saplings that fall are obliterated. Falling [[grass]] of all types (including [[cave moss]] and [[floor fungus]]) gets turned into undifferentiated green "Grass".
* Anything falling into a fluid sinks to the bottom. Therefore, it is not a good idea to punch a skylight into your meeting area if you forgot that e.g. your [[gem]] pile was directly below and you had a [[magma]] tube three Z levels afterwards... you get the idea.
* Falling Soil layers will change into the lowest soil type on map.
* Aquifer tiles will continue producing water, and other tile properties will remain the same in the fallen terrain.

=== Below the cave-in===
* Any [[creature]] caught directly underneath (on the same tile underneath) a cave-in is killed, the only exception being [[Ghost]]s.
* Most [[plant]]s under a cave-in are obliterated, but not multi-tile [[tree]]s.
* Any item caught under falling natural walls is destroyed completely. Natural floors and constructed walls and floors have a chance of destroying items.{{verify}}
* All [[building]]s and most [[construction]]s under the falling area are destroyed, as are natural ramps and unsupported floors. Only walls, supports, up and up/down stairs, and fortifications (both mined and constructed) remain intact.
* Supported natural terrain will remain intact during the cave-in (terrain unsupported from below will collapse).
* Any fluid displaced by falling natural walls is not destroyed, but transported to directly on top of the fallen walls. This principle can be used to construct [[magma piston]]s.
* Any mined minerals or stone in the area directly under the cave-in will be forced out from under the cave-in (or even up a few z-levels too, if the cave-in falls a long distance).
* Dropping rock layers on top of a cavern-soil floor will remove the soil; [[irrigation]] will be required to resume [[tree farm]]ing.

=== Above the cave-in===
* Buildings above the cave-in will deconstruct if they are no longer supported.
* Anything standing on the area that caves in falls and may get away with being stunned. The fall victim has a chance of being unable to walk away, somewhat proportional to the distance fallen but not set in stone. <s>No</s> Pun intended.
=== Other effects===
* A large amount of dust is generated. Any creature caught by the dust from the collapse is knocked [[unconscious]] and can be thrown a few tiles even up z-levels, which may cause them to fall off, say, a narrow bridge fifty z-levels above the ground, or can mash them into a fine paste against the wall. Dwarves will receive an unhappy thought from choking on dust clouds (which won't matter if they're dead).
* [[Magma mist]] will be generated in all tiles of magma that were in the path of the cave-in.
* Any terrain that is rendered unsupported by the cave-in will cause a subsequent cave-in.

== Avoiding cave-ins ==

Do not make unconnected sections of rock.

Actually, you're quite unlikely to cause cave-ins unless you are actively trying to cause them. In which case, you'd be wondering how to avoid cave-ins that ''cause damage'' to your folks. That's simple: Add a [[support]] under the stone mass, and link it to a distant [[lever]]. When you're done, hide everyone, pull the lever and watch the fireworks. If you're feeling lazier, use statues to keep dwarves off the wrong squares. Provided they move directly away from the cave-in area, the dust may not catch them - and they don't blunder off edges and die unless the dust catches them.

One of the more common accidental cave-ins results when you're taking out the floor in a checker-pattern (dwarves [[channel]]ing may sometimes tend to make this mistake) and the area below isn't supported, resulting in a situation like the diagram below:

Floor -1
▒▒▒▒▒▒
▒ ▒
▒ X +▒ <-- The X is a floor tile. It's not attached, so it will fall down.
▒ +>▒
▒ ▒
▒▒▒▒▒▒

Floor -2
▒▒▒▒▒▒
▒....▒
▒...▒▒ <-- Causing this area to receive a cave-in flow and knocking out any dwarves in its reach.
▒...<▒
▒....▒
▒▒▒▒▒▒

Another thing to watch out for is if you want to dig away a hill above ground, to make room for your fancy overground fort. You may dig away the hill on one level, and then have a huge platform of "floor" on the z-level above that falls on your [[miner]] if they get disconnected from the ground. Easy thing to miss the first time you do it. To avoid this, channel ''from the surface downwards'', which doesn't remove anything that isn't supported - though you might still mine out something that was supporting a floor you ''weren't'' mining, so be careful. Miners also don't check that there's nobody standing on the floor that will shortly cease to exist - meaning that several miners channelling floors in the same area are a danger to each other. So you should allow only one dwarf to mine out floors in an area at a time.

== Using cave-ins ==
Intentional cave-ins serve several purposes:
* '''Defense'''
*: Use cave-ins to block off water approaches to underground cavern levels. Combined with walls higher up, a cavern can (with great effort) be rendered completely safe from all intruding vermin.<sup>1</sup>
* '''Death'''
*: Since a cave-in kills all [[creatures]] instantly, it can provide a [[Unfortunate accident|convenient]] or amusing way to off a group of creatures. This is also one of the most effective ways of dealing with [[titan]]s and [[forgotten beast]]s with dangerous [[syndrome]]s, especially airborne contaminants (deadly dust/vapors) and poisonous blood. For certain randomly generated creatures, they may be so indestructible that a cave-in is the ''only'' way to kill them. Also, it's a great way to 'spare' an [[Wound|'injured']] dwarf who likes 'laying' in a bed all to [[Noble|himself.]]
* '''Removal of floor tiles'''
*: Causing a cave-in will destroy non-reinforced (no wall or support underneath) floor tiles directly underneath the falling terrain - this is a good way to hollow out a large area. All that's left to do is a little bit of cleanup on the edges, but look at all the channeling you saved yourself!
* '''Breaking through multiple aquifer levels'''
*: Showcase with two levels: [[User:Rhenaya/HowtoDualAquifer]]
* '''Trapping [TRAPAVOID] creatures:'''
*: Since the dust from a cave-in can knock creatures unconscious, and any unconscious creature triggers a trap (including your dwarves and other friendly creatures), combine a cave-in with nearby cage traps for the capture. Note that this is only useful for kobolds and gremlins, as all other creatures which avoid traps are also immune to being knocked unconscious.
* '''Moving Water / Magma faster than [[Screw_pump#Pump_stack|Pump Stack]]s'''
*: Main article: [[Magma piston]]

=== Caving-in the toplevel/terrain from inside ===

You can cause terrain above you to cave in without going outside by first mining up stairs below the "borderline" you want to channel, channel the tiles above them, and removing the stairs afterwards.
The tiles above the up stairs can be mined from below while standing on the stair, so you don't have to go outside. Ramps would also work for that alone, but the ramps would allow enemies to enter, whereas the up-stairs alone do not allow passage to above as there is no corresponding down-stair above them.

<sup>1</sup>Not literal [[vermin]], those won't be blocked.

== Bugs ==
*Layer-material can change when collapsing soil layers.{{bug|1206}}
*Forest fires cause constant collapses.{{bug|6829}}
*Rarely, a cave-in may happen right at the start of the game. This can have several effects depending on where it happens, including releasing underground tree spores.

{{Category|Physics}}

Main Page/gallery

2017-09-10T02:07:39Z

TheCrazyHamsteR:

This is a gallery of images that will be randomly displayed on the [[Main Page]].
<gallery><onlyinclude>
File:13 Gobby4.jpg|Preparing a ballista.
File:Belal Example.png|Belal's 16x16 tileset
File:Cathedral.jpg|Use utilities like 3Dwarf to render your fortresses
File:Communal.gif|Communal living: who needs walls?
File:Goblin_slaying_Mayor.png|This is how we handle diplomatic relations with goblins.
File:RingfissuresYear4-26.jpg|A baby crawling through the aftermath of a human siege at Ringfissures
File:Oceanside-202-05.jpg|The dwarves have found a way to paint their walls. It's a shame they ran out of paint when they were half-way done.
File:Focusgroup 16.PNG|With friends like these...
File:Zombiecod.png|Some fish are better left alone.
File:Attend party.png|No matter what your orders may be, your dwarves know the real matters of importance.
File:GiantSpiderAttack.png|Maybe Little Miss Muffet was a dwarf?
File:Shootcommon 1063 main.png|All the comforts of home.
File:Girdertan7.gif|Remember, only you can prevent forest fires!
File:Doom.png|GODS DANGIT MELBUL AND YOUR WATERFALLS!
File:Outdoor_Scuplture_Garden-Vomitorium.png|Ah... the great outdoors.
File:Colossus in Arena.png|A colossus makes short work of captured goblins in an arena.
File:Palace of Seducing.PNG|Is that a euphemism?
File:Damaged baby.jpg|Pain and hardship start at a young age in dwarven culture.
File:DF Cheese.jpg|The vanity of dwarven engravers is not to be underestimated.
File:Champions.png|Goblins have a very fickle relationship with their body parts. A skilled Axedwarf can quickly have them calling for a divorce.
File:Regicide.PNG|The King is dead. Long live the King!
File:Addition.PNG|A mechanical binary addition engine.
File:One-legged-Wolf.png|I can make it on my own!
File:Heads.png|Hydras probably have severe psychological issues regarding decapitation.
File:Vomit_Trail.png|Dwarves are a lot like ants. Except that instead of using pheromones to mark their trails they use vomit and useless crap.
File:Artifact_Storage.png|This bin is worshiped by three different kobold civilisations. Kobold children everywhere dream of stealing it.
File:Thirsty_Dwarves.gif|A booze stockpile is a meeting zone in its own right.
File:Doors!.png|Ianuamania; madness relating to the obsessive placement of doors.
File:Harbor.png|Wharf Fortress.
File:Heads-on-statues.PNG|Who needs pikes to put heads on when you have statues?
File:Aspirations.png|What every child one day wishes to be!
File:olonbekorn_003.jpg|Fifteen seconds after the player founds a "Cold" fortress, the File:World Gen algorithm discovers climate change.
File:Df2010isfabulous.PNG|Oh, the names humans give themselves...
File:Cacamefight.gif|Cacame gives a human sieger and his horse the power of flight. The human politely lets his horse go first.
File:7x191.PNG|The Almighty Dwarven Calculator solves only the most prestigious equations.
File:Historical Finger.png|It was the most crucial point of that battle. Really. Every educated dwarf should know that.
File:Snowball_fight.png|Tragic snowball fight is... oh wait, it was an elf
File:Herbs.png|Most dwarven soldiers are kept awake by the things they had done in battle, others make sure their deeds rob the goblins of sleep.
File:MagmaTomb.png|Dwarves live so that they may die a gruesome and pointless death. But once their bodies are interred in their magma-tomb it was all worth it.
File:Crundles.png|Crundles, the wolves of the underground.
File:Catacombs.png|Accommodating dwarves in the afterlife is central to what managing a fortress is about.
File:Dwarven_Housing.png|A true dwarf does not care for pretty designs or "privacy". For a dwarf, a bedroom is a hole where he dumps his body for rest and his Useless crap for storage, to never touch again.
File:CityState.gif|I am sure the constitutionalists haven't finished the debate on the desirability of the king running for democratic office.
File:Dwarves Sparring.PNG|Wooden training axes are for elves! Real dwarves use masterwork steel when sparring!
File:Evil microcline.png|Oh no! The microcline's possessing my dwarves! Or maybe the ghost, I guess.
File:Nutsdangeled.png|The world of Dwarf Fortress is full of interesting places; some are dangerous, some are peaceful, and some are... well...
File:Struck_cancels_smelt.png|Urist McLazyFurnaceOperator cancels Smelt Available Ore: needs ore
File:High_sucker.jpg|Cheese making and divine service will make you feel successful.
File:Leg-shot.png|An excellent weapon choice
File:FlareChannel.png|The legendary dwarven fortress [http://www.bay12forums.com/smf/index.php?topic=43679.0 FlareChannel]
File:Useless bridges.png|It's a good thing that those bridges are there, otherwise it would be really hard to cross those rivers.
File:Construct5.png|The [http://www.bay12forums.com/smf/index.php?topic=38264.msg904145#msg904145 Constructtargets Gem], a 39 Z-level [[megaproject]] made of 4460 clear glass blocks.
File:Deadly sock.png|That's one impressive sock.
File:Praise disease.png|Praise disease.
File:Cat singularity.png|Approaching cat singularity
File:Unfillable Dam.jpeg|[http://www.bay12forums.com/smf/index.php?topic=39541.msg677616#msg677616 Unfillable Dam] [[megaproject]] created by Baboonanza
File:Roadtruss.jpg|[http://bbs.stardestroyer.net/viewtopic.php?f=24&t=154510 Roadtruss], a [[tower]] [[megaproject]] by Crossroads Inc.
File:Lurebolt-1.jpg|[https://www.reddit.com/r/dwarffortress/comments/3dogvh/five_oclock_and_all_is_well/ Lurebolt], a [[tower]] created by Keupo
File:Armoc_Invaders_intro.png|[[User:BaronW#Armok_Invaders|Armok Invaders]], a playable "[[wikipedia:Space Invaders|Space Invaders]]" style game built with [[computing|dwarven computing]] by [[User:BaronW|BaronW]]
File:Burned_beast.png|The [[fire]] does not discriminate.
File:MechanicVolcanoBirdsEyeComposite.jpg|[[User:Vattic/Mechanical_Volcano_Explained|Mechanical Volcano]] [[megaproject]] by Vattic.
File:Carp escape.jpg|Never forget the [[40d:Carp|carp of old]].
File:Crutch Self Defense.png|Crippled does not mean defenseless as far as dwarves are concerned.
File:Figurine Combat.png|Dwarven action figures: also usable in action sequences!
File:Drowning_chamber.png|[[Drowning chamber|Taste the water, you filthy goblins!]]
File:horse law.png|Never underestimate [[horse]]s.
File:14177z5.jpg|Fisherdwarves have it [[Sea lamprey|rough]].
File:23a_warthog_hunting.png|Why do you need hunters, when you have swords?
</onlyinclude></gallery>

File:23a warthog hunting.png

2017-09-10T02:05:37Z

TheCrazyHamsteR: Wild animals are mostly pushovers. Even untrained military can kill them with ease, and provide a nice amount of meat and bones. So why do you need hunters, when you have swords?

== Summary ==
Wild animals are mostly pushovers. Even untrained military can kill them with ease, and provide a nice amount of meat and bones. So why do you need hunters, when you have swords?
== Licensing ==
{{Non-free Dwarf Fortress Screenshot}}

23a:Cassiterite

2017-09-10T00:54:37Z

TheCrazyHamsteR:

{{23a Ore|name=Cassiterite|tile=£|color=6:7:0
|uses =
* [[Ore]] of [[tin]]
* Smelting [[bronze]]
|location = Anywhere in the mountain}}
{{av}}{{Quality|Exceptional}}

:{{DFtext|You have struck tin ore.|6:0:1}}

'''Cassiterite''' is the ore that can be [[smelt]]ed into [[tin]]. This ore can also be smelted with [[malachite]] to create [[bronze]].

Each embark region contains 19 veins of cassiterite, scattered throughout the mountainside.

== Smelting ==
Cassiterite is a required ingredient to make several types of metal alloy bars from ore at a [[smelter]]:

* [[Tin]] bars
* [[Bronze]] bars - with [[malachite]]

<gallery>
File:Cassiterita.jpeg|Cassiterite, 3-4 cm
File:Cassiterite2bis.jpg|Cassiterite on quartz
File:Prehistoric Times of Bohemia, Moravia and Slovakia - NM Prague 15.JPG|Cassiterite on a rock
</gallery>

{{stones}}

The Non-Dwarf's Guide to Rock

2017-09-09T22:03:07Z

TheCrazyHamsteR:

{{Quality|Exceptional|17:15, 3 May 2015 (UTC)}}
{{av}}

Wondering what that new kind of rock your dwarves just struck is good for? Possibly nothing, but when you're just getting started it can be tough to tell the trash from the treasure. The following table summarizes the types of stone and ore found in Dwarf Fortress; [[gem]]s are covered in their own article.

The ''Uses'' column lists any special uses or properties of this particular stone type; if no uses are listed, you can always use the stone for general construction and crafting. Note that many "low-value" materials are still ''very'' useful in a Dwarf Fortress. "Colors" are useful for color coding or [[style project|creative aesthetic uses]].

For more detailed and expanded information, see the [[Stone]], [[Ore]], [[Metal|Metals & Alloys]], [[Vein|Veins & Clusters]], and [[Smelting]] pages, or the article on any particular stone, metal or ore.

During the game, you can press {{key|z}} and then navigate to "stone". The list there covers all types of rocks and ores, and tells you what rocks can be smelted into.

==Table of Rocks==

''(Some materials are worth an additional comment; these are numbered, with footnotes below the table.)''

{|class="sortable" border = 1 cellspacing="0" cellpadding="5"

| align="center" style="background:#f0f0f0;"|'''Name'''
| align="center" style="background:#f0f0f0;"|'''Type'''
| align="center" style="background:#f0f0f0;"|'''Uses'''
| class="unsortable" align="center" style="background:#f0f0f0;"|'''Appearance*'''
|-
| [[Raw adamantine|Adamantine, raw]]||ore, special<sup>1</sup>||Becomes [[Adamantine]]<sup>1</sup>, by far the most valuable substance||{{Raw Tile|£|3:7:1}} {{Raw Tile|*|3:1}}
|-
| [[Alabaster]]||stone||Low-value stone; used for making [[plaster]]||{{Raw Tile|^|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Native aluminum|Aluminum, native]]||ore, high-value||Smelt into [[Aluminum]], a high-value decorative [[metal]]||{{Raw Tile|^|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Alunite]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Andesite]]||layer stone||Low-value stone||{{Raw Tile|∞|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Anhydrite]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|v|7:7:1}} {{Raw Tile|•|7:0}}
|-
| [[Basalt]]||layer stone||Low-value [[magma-safe]] stone||{{Raw Tile|#|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Bauxite]]||stone||Low-value [[magma-safe]] stone; only source of some high-value gems||{{Raw Tile|+|4:7:0}} {{Raw Tile|•|4:0}}
|-
| [[Bismuthinite]]||ore, rare||Smelt into [[bismuth]], ingredient of [[bismuth bronze]]||{{Raw Tile|%|7:7:1}} {{Raw Tile|*|7:0}}
|-
| [[Bituminous coal]]||stone||Smelt into [[Fuel]], flammable||{{Raw Tile|☼|0:7:1}} {{Raw Tile|☼|0:1}}
|-
| [[Borax]]||stone||Low-value stone||{{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Brimstone]]||stone||Low-value stone||{{Raw Tile|%|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Calcite]]||stone||[[Flux]], mid-value [[magma-safe]] stone||{{Raw Tile|"|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Cassiterite]]||ore, uncommon||Smelt into [[Tin]], a low-value metal; ingredient of [[Bronze]]s; [[magma-safe]]||{{Raw Tile|£|6:7:0}} {{Raw Tile|*|6:0}}
|-
| [[Chalk]]||layer stone||[[Flux]], mid-value stone||{{Raw Tile|░|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Chert]]||layer stone|| Low-value [[magma-safe]] stone||{{Raw Tile|=|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Chromite]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|=|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Cinnabar]]||stone||Low-value stone||{{Raw Tile|£|4:7:1}} {{Raw Tile|*|4:1}}
|-
| [[Claystone]]||layer stone||Low-value stone||{{Raw Tile|,|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Cobaltite]]||stone||Low-value stone||{{Raw Tile|£|1:7:1}} {{Raw Tile|*|1:1}}
|-
| [[Conglomerate]]||layer stone||Low-value stone||{{Raw Tile|∞|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Native copper|Copper, native]]||ore, low-value||Smelt into useful [[Copper]]; ingredient of [[Bronze]]s||{{Raw Tile|£|6:7:0}} {{Raw Tile|*|6:0}}
|-
| [[Cryolite]]||stone||Low-value stone||{{Raw Tile|-|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Dacite]]||layer stone||Low-value stone||{{Raw Tile|.|0:7:1}} {{Raw Tile|•|7:0}}
|-
| [[Diorite]]||layer stone||Low-value stone||{{Raw Tile|░|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Dolomite]]||layer stone||[[Flux]], mid-value [[magma-safe]] stone||{{Raw Tile|`|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Gabbro]]||layer stone||Low-value [[magma-safe]] stone; only source of some [[ore]]s & [[gem]]s||{{Raw Tile|▒|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Galena]]||ore||Smelt into [[Lead]], a low-value metal, with a 50% chance<sup>2</sup> for [[Silver]]; [[magma-safe]]||{{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Garnierite]]||ore, uncommon||Smelt into [[Nickel]], a low-value [[magma-safe]] metal ||{{Raw Tile|£|2:7:1}} {{Raw Tile|*|2:1}}
|-
| [[Gneiss]]||layer stone||Low-value stone||{{Raw Tile|=|7:7:1}} {{Raw Tile|•|7:0}}
|-
| [[Native gold|Gold, native]]||ore||Smelt into [[Gold]], a high-value [[metal]]||{{Raw Tile|£|6:7:1}} {{Raw Tile|*|6:1}}
|-
| [[Granite]]||layer stone||Low-value stone; only source of some ores; relatively rich in content||{{Raw Tile|▓|7:0}} {{Raw Tile|•|7:0}}
|-
| [[Graphite]]||stone||Low-value stone, flammable||{{Raw Tile|o|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Gypsum]]||stone||Low-value stone; used for making [[plaster]]||{{Raw Tile|#|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Hematite]]||ore||Smelt into [[Iron]], a mid-value metal; ingredient for [[Steel]]; [[magma-safe]]||{{Raw Tile|£|4:7:0}} {{Raw Tile|*|4:0}}
|-
| [[Horn silver]]||ore||Smelt into [[Silver]], a mid-value metal||{{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Hornblende]]||stone||Low-value stone||{{Raw Tile|"|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Ilmenite]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|.|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Ice]]<sup>3</sup>||stone/water<sup>3</sup>||Frozen Water||{{Raw Tile|█|3:3:1}} {{Raw Tile|•|3:1}}
|-
| [[Jet]]||stone||Low-value stone||{{Raw Tile|░|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Kaolinite]]||stone||Low-value [[magma-safe]] stone; used for making [[porcelain]]||{{Raw Tile|=|4:7:0}} {{Raw Tile|•|4:0}}
|-
| [[Kimberlite]]||stone|| Low-value stone; only source of [[Faint yellow diamond|diamond]]s||{{Raw Tile|%|1:7:0}} {{Raw Tile|•|1:0}}
|-
| [[Lignite]]||stone||Smelt into [[Fuel]], flammable||{{Raw Tile|*|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Limestone]]||layer stone||[[Flux]], mid-value stone||{{Raw Tile|▓|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Limonite]]||ore, high-value||Smelt into [[Iron]], a mid-value metal; ingredient for [[Steel]]||{{Raw Tile|£|6:7:1}} {{Raw Tile|*|6:1}}
|-
| [[Magnetite]]||ore, high-value||Smelt into [[Iron]], a mid-value metal; ingredient for [[Steel]]; [[magma-safe]]||{{Raw Tile|~|0:7:1}} {{Raw Tile|*|0:1}}
|-
| [[Malachite]]||ore, low-value||Smelt into useful [[Copper]]; ingredient of [[Bronze]]s||{{Raw Tile|£|2:7:0}} {{Raw Tile|*|2:0}}
|-
| [[Marble]]||layer stone||[[Flux]], mid-value stone||{{Raw Tile|▓|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Marcasite]]||stone||Low-value stone||{{Raw Tile|%|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Mica]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|v|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Microcline]]||stone||Low-value stone||{{Raw Tile|%|3:7:1}} {{Raw Tile|•|3:1}}
|-
| [[Mudstone]]||layer stone||Low-value stone||{{Raw Tile|≈|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Obsidian]]||layer stone||High-value [[magma-safe]] stone;Sharpenable hard rock (used to create stone [[short sword]]s); <br />signifies nearby [[magma]] if not a layer||{{Raw Tile|▒|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Olivine]]||stone||Low-value [[magma-safe]] stone; may contain [[Platinum]]||{{Raw Tile|%|2:7:0}} {{Raw Tile|•|2:0}}
|-
| [[Orpiment]]||stone||Low-value stone||{{Raw Tile|-|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Orthoclase]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|%|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Periclase]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|,|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Petrified wood]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|%|4:7:1}} {{Raw Tile|•|4:1}}
|-
| [[Phyllite]]||layer stone||Low-value stone||{{Raw Tile|-|0:7:1}} {{Raw Tile|•|7:0}}
|-
| [[Pitchblende]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|*|5:7:0}} {{Raw Tile|•|5:0}}
|-
| [[Native platinum|Platinum, native]]||ore, high-value||Smelt into [[Platinum]], a highest-value decorative [[metal]]||{{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Puddingstone]]||stone|| Low-value stone||{{Raw Tile|Θ|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Pyrolusite]]||stone||Low-value stone||{{Raw Tile|%|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Quartzite]]||layer stone||Low-value [[magma-safe]] stone||{{Raw Tile|-|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Realgar]]||stone||Low-value stone||{{Raw Tile|%|4:7:1}} {{Raw Tile|•|4:1}}
|-
| [[Rhyolite]]||layer stone||Low-value stone||{{Raw Tile|,|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Rock salt]]||layer stone||Low-value stone||{{Raw Tile|#|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Rutile]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|`|5:7:0}} {{Raw Tile|•|5:0}}
|-
| [[Saltpeter]]||stone||Low-value stone||{{Raw Tile|x|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Sandstone]]||layer stone||Low-value [[magma-safe]] stone||{{Raw Tile|#|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Satinspar]]||stone||Low-value stone; used for making [[plaster]]||{{Raw Tile|-|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Schist]]||layer stone||Low-value stone||{{Raw Tile|`|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Selenite]]||stone||Low-value stone; used for making [[plaster]]||{{Raw Tile|;|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Serpentine]]||stone||Low-value stone||{{Raw Tile|≈|2:7:0}} {{Raw Tile|•|2:0}}
|-
| [[Shale]]||layer stone||Low-value stone||{{Raw Tile|.|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Siltstone]]||layer stone||Low-value stone||{{Raw Tile|%|6:7:0}} {{Raw Tile|•|6:0}}
|-
| [[Native silver|Silver, native]]||ore||Smelt into [[Silver]], a mid-value metal||{{Raw Tile|£|7:7:1}} {{Raw Tile|*|7:1}}
|-
| [[Slade]]||stone, special||Not workable by dwarves||{{Raw Tile|░|0:1}} {{Raw Tile|*|0:1}}
|-
| [[Slate]]||layer stone||Low-value stone||{{Raw Tile|%|0:7:1}} {{Raw Tile|•|0:1}}
|-
| [[Sphalerite]]||ore, uncommon||Smelt into [[Zinc]], a low-value metal; ingredient for [[Brass]]||{{Raw Tile|£|0:7:1}} {{Raw Tile|*|0:1}}
|-
| [[Stibnite]]||stone||Low-value stone||{{Raw Tile|%|7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Sylvite]]||stone||Low-value stone||{{Raw Tile|=|6:7:1}} {{Raw Tile|•|6:1}}
|-
| [[Talc]]||stone||Low-value [[magma-safe]] stone||{{Raw Tile|||7:7:1}} {{Raw Tile|•|7:1}}
|-
| [[Tetrahedrite]]||ore, low-value||Smelt into useful [[Copper]]; ingredient of [[Bronze]]s;<br /> has a 20% additional chance<sup>2</sup> of [[Silver]]; smelt into [[Billon]]||{{Raw Tile|£|0:7:1}} {{Raw Tile|*|0:1}}
|}

:''(* Each stone is one of 16 [[color scheme|colors]] in the game. Different un-mined stone of the same color have a different symbol to distinguish between them. Once mined, the individual stones themselves can sometimes look identical if the color is the same. Use {{k|k}} to loo{{k|k}} at items or the terrain for specific information.)''

'''Notes:'''
# '''Adamantine''' is not exactly like other metals, although it works almost the same. It has a value multiplier of x300 (yes, three ''hundred''). See [[adamantine]] for a full discussion of this unusual and wondrous material.
# '''% chance''' for additional metals: when [[Galena]] and [[Tetrahedrite]] are smelted, they produce (respectively) four lead or copper bars, 100% of the time. They also produce 0-4 ''additional'' bars of the second metal, with the percent chance to produce each additional bar listed above.
# '''Ice''' has some ''very'' unusual properties in Dwarf Fortress, and can be disastrous if misused. See article on [[ice]] for a more complete discussion.

===The Value of Rocks & Metals===
You won't find the terms "low-value" or "highest-value" used in the game, but they're handy here for rough comparison. "[[Value]]s" are all relative to each other, on a common scale. The "material value" number multiplies any final product that is created with that material by that number. An average generic statue (base value 25) is worth much more than an average generic throne (base value 10), but a throne carved from raw [[native gold|gold nuggets]] (10 x 30 = 300) will be worth far more than a common-stone statue (25 x 1 = 25). ''(Note - "[[quality]]" also factors in to total value of a final product, as do some other considerations, but those are outside the scope of this intro article).'' Bottom line - when in doubt, go for the more valuable stuff.

Common '''stones''' ''(the vast majority)'' have a value multiplier of x1, mid-value ''(all [[flux]] stones like marble)'' are x2, and high-value ''([[obsidian]] only)'' is x3. This affects things like stone tables and doors, statues or stonecrafts - anything made from stone. Metal [[ore]]s have varying values, from 2-40, and can either be treated as stone or smelted into bars of metal.

For '''metals''', low-value ''(like copper or nickel)'' is x2. Mid-value ''(silver or iron)'' is around x10, high-value ''(gold, steel)'' is x30, and highest-value ''(platinum, aluminum)'' is x40.

Note that the raw mined ore and the smelted pure metal often have different value multipliers, but not always. [[Alloy]]s like brass or bronze are often more valuable than the sum of their pure metal ingredients, and have a true spectrum of values between 3-23. ''(Alloy values are not listed in this article.)''

Any metal can be crafted into decorations, furniture, or buildings. Only copper, bronzes, iron, steel, and adamantine can make weapons, armor, and picks, with silver also able to be forged into melee weapons.

''(For comparison, all [[wood]] has a value of x1, equal to common stone.)''



See also:
:* [[Exploratory mining]]

{{Category|Guides}}{{Category|Stone|*}}

23a:Malachite

2017-09-09T16:48:30Z

TheCrazyHamsteR:

{{quality|Exceptional|15:13, 18 April 2011 (UTC)}}{{23a Ore|name=Malachite|tile=£|color=2:7:0
|uses =
* [[Ore]] of [[copper]]
* Smelting [[bronze]] and [[brass]]
|location = Anywhere in the mountain}}
{{av}}

:{{DFtext|You have struck copper ore.|6:0:1}}

'''Malachite''' is an [[ore]] of [[copper]]. It can also be [[smelter|smelted]] into [[bronze]] and [[brass]] using [[cassiterite]] and [[sphalerite]], respectively.

Malachite is the most abundant ore - each embark region contains 27 veins of it, scattered throughout the mountainside.

"Malachite" is also the name of the fifth month of the dwarven [[calendar]], covering mid-Summer.

<gallery>
File:9135 - Milano - Museo storia naturale - Malachite - Foto Giovanni Dall'Orto 22-Apr-2007.jpg|Malachite
File:Malachit getupft.jpg|Smooth malachite
File:Ermitáž (32).jpg|Malachite vase
</gallery>

{{stones}}

23a:Galena

2017-09-09T16:47:17Z

TheCrazyHamsteR:

{{quality|Exceptional|18:20, 8 November 2010 (UTC)}}{{23a Ore|name=Galena|tile=£|color=0:7:1|itemcolor=7:0
|uses =
* [[Ore]] of [[silver]]
* Smelting [[electrum]]
|location = Anywhere in the mountain}}
{{av}}

:{{DFtext|You have struck silver!|6:0:1}}

'''Galena''' is an [[ore]] of [[silver]]. Once the [[dungeon master]] [[noble]] arrives, it may also be [[smelt]]ed with [[native gold]] to form [[electrum]].

Each embark region contains 20 veins of galena, scattered throughout the mountainside.

"Galena" is also the name of the sixth month of the [[dwarf|dwarven]] [[calendar]], covering late Summer.

If a fortress is lost to adamantine mining, all [[raw adamantine]] will be turned to galena when the [[demon]] is killed by an [[adventurer mode|adventurer]].

<gallery>
File:GalenaFromKansas.jpg|Galena
File:Chalkopiryt, galena, kalcyt Rumunia1.JPG|Galena (silver colored) in calcite and chalk
File:Fluorine verte et galène1 (Angleterre).jpg|Galena (metallic grey) with other crystals
</gallery>

{{stones}}