Dwarf Fortress Wiki - User contributions [en]

v0.34:Material definition token

2012-02-22T06:43:53Z

Ydaraishy:

{{quality|Exceptional|18:11, 28 April 2011 (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

|-
| PREFIX
| * string
| 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.'''

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

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

|-
| TEMP_DIET_INFO
|
| Unknown

|-
| POWDER_DYE
| [[color]] token
| Defines the material as a type of dye.

|-
| 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 ('█').

|-
| 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 ('•').

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

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

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

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

|-
| 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:GREY]

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

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

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

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

|-
| IMPACT_YIELD
|
*value
| Specifies how hard of an impact the material can withstand before it will deform. Used for blunt-force combat. Defaults to 10000.

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

|-
| IMPACT_STRAIN_AT_YIELD or IMPACT_ELASTICITY
|
*value
| Specifies how much the material will deform when subjected to an impact.{{verify}} 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)

|-
| COMPRESSIVE_YIELD
|
*value
| Specifies how hard the material can be compressed before it will deform. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.

|-
| COMPRESSIVE_FRACTURE
|
*value
| Specifies how hard the material can be compressed before it will break. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.

|-
| COMPRESSIVE_STRAIN_AT_YIELD or COMPRESSIVE_ELASTICITY
|
*value
| Specifies how much the material will deform when compressed.{{verify}} [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 0.

|-
| TENSILE_YIELD
|
*value
| Specifies how hard the material can be stretched before it will deform. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.

|-
| TENSILE_FRACTURE
|
*value
| Specifies how hard the material can be stretched before it will break. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.

|-
| TENSILE_STRAIN_AT_YIELD or TENSILE_ELASTICITY
|
*value
| Specifies how much the material will deform when stretched.{{verify}} [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 0.

|-
| TORSION_YIELD
|
*value
| Specifies how hard the material can be twisted before it will deform. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.

|-
| TORSION_FRACTURE
|
*value
| Specifies how hard the material can be twisted before it will break. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.

|-
| TORSION_STRAIN_AT_YIELD or TORSION_ELASTICITY
|
*value
| Specifies how much the material will deform when twisted.{{verify}} [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 0.

|-
| SHEAR_YIELD
|
*value
| Specifies how hard the material can be sheared before it will deform. Used for cutting calculations. Defaults to 10000.

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

|-
| SHEAR_STRAIN_AT_YIELD or SHEAR_ELASTICITY
|
*value
| Specifies how much the material will deform when sheared.{{verify}} Used for cutting calculations. Defaults to 0.

|-
| BENDING_YIELD
|
*value
| Specifies how hard the material can be bent before it will deform. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.

|-
| BENDING_FRACTURE
|
*value
| Specifies how hard the material can be bent before it will break. [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 10000.

|-
| BENDING_STRAIN_AT_YIELD or BENDING_ELASTICITY
|
*value
| Specifies how much the material will deform when bent.{{verify}} [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.] Defaults to 0.

|-
| MAX_EDGE
|
*value
| How sharp the material is. Used in cutting calculations. Applying a value of at least 10000 to a stone will allow weapons to be made from that stone. Defaults to 10000.

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

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

|-
| SPEC_HEAT
|
*specific heat capacity
| Rate at which the material heats up or cools down. See [[SPEC HEAT]] for more information. Defaults to NONE.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| MOLAR_MASS
|
*value
| Supposedly not used. Defaults to NONE.

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

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

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

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

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

|-
| REACTION_CLASS
|
*reaction reference
| Used to classify all items made of the material so that reactions can use them as generic reagents.

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

|-
| SOAP_LEVEL
|
*value
| Unknown. Defaults to 0.
|}

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

|-
| IMPLIES_ANIMAL_KILL
|
| Lets the game know that an animal was likely killed in the production of this item. Elves (and other entities that are ethically opposed to killing animals) will likely not bring these for trade.

|-
| ALCOHOL_PLANT or ALCOHOL
|
| Classifies the material as plant alcohol, allowing it to be stored in food stockpiles under "Drink (Plant)".

|-
| ALCOHOL_CREATURE
|
| Classifies the material as creature alcohol, allowing it to be stored in food stockpiles under "Drink (Animal)".

|-
| CHEESE_PLANT
|
| Classifies the material as plant cheese, allowing it to be stored in food stockpiles under "Cheese (Plant)".

|-
| CHEESE_CREATURE or CHEESE
|
| Classifies the material as creature cheese, allowing it to be stored in food stockpiles under "Cheese (Animal)".

|-
| POWDER_MISC_PLANT or POWDER_MISC
|
| Classifies the material as plant powder, allowing it to be stored in food stockpiles under "Milled Plant".

|-
| POWDER_MISC_CREATURE
|
| Classifies the material as creature powder, allowing it to be stored in food stockpiles under "Bone Meal".

|-
| STOCKPILE_GLOB or 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).

|-
| STOCKPILE_GLOB_PASTE
|
| Permits globs of the material in paste form to be stored in food stockpiles under "Paste".

|-
| STOCKPILE_GLOB_PRESSED
|
| Permits globs of the material in pressed form to be stored in food stockpiles under "Pressed Material".

|-
| LIQUID_MISC_PLANT or LIQUID_MISC
|
| Classifies the material as a plant extract, allowing it to be stored in food stockpiles under "Extract (Plant)".

|-
| LIQUID_MISC_CREATURE
|
| Classifies the material as a creature extract, allowing it to be stored in food stockpiles under "Extract (Animal)".

|-
| LIQUID_MISC_OTHER
|
| Classifies the material as a miscellaneous liquid, allowing it to be stored in food stockpiles under "Misc. Liquid" along with lye.

|-
| STRUCTURAL_PLANT_MAT
|
| Classifies the material as plant, allowing it to be stored in food stockpiles under "Plants".

|-
| SEED_MAT
|
| Classifies the material as plant seed, allowing it to be stored in food stockpiles under "Seeds".

|-
| LEAF_MAT
|
| Classifies the material as plant leaf, allowing it to be stored in food stockpiles under "Leaves".

|-
| BONE
|
| Classifies the material as bone, allowing it to be used by craftsdwarves.

|-
| WOOD
|
| Classifies the material as wood, allowing it to be used by carpenters. May also make elves angry if you try to trade it to them.

|-
| THREAD_PLANT
|
| Classifies the material as plant fiber, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".

|-
| TOOTH
|
| Classifies the material as tooth, allowing it to be used by craftsdwarves.

|-
| HORN
|
| Classifies the material as horn, allowing it to be used by craftsdwarves.

|-
| PEARL
|
| Classifies the material as pearl, allowing it to be used by craftsdwarves.

|-
| SHELL
|
| Classifies the material as shell, allowing it to be used by craftsdwarves.

|-
| LEATHER
|
| Classifies the material as leather, allowing it to be used by craftsdwarves.

|-
| SILK
|
| Classifies the material as silk, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".

|-
| SOAP
|
| Classifies the material as soap, permitting it to be stored in Bar/Block stockpiles with Soap enabled.{{verify}}

|-
| GENERATES_MIASMA
|
| Material generates miasma when it rots

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

|-
| ROTS
|
| Material will rot if not stockpiled appropriately

|-
| BLOOD_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "blood", both in Adventurer mode tile descriptions ("Here we have a Dwarf in a slurry of blood.") and for unhappy thoughts from drinking water ("He was forced to drink bloody water lately").

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

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

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

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

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

|-
| EDIBLE_VERMIN
|
| Can be eaten by vermin.

|-
| EDIBLE_RAW
|
| Can be eaten raw.

|-
| EDIBLE_COOKED
|
| Can be cooked and then eaten.

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

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

|-
| ITEMS_METAL
|
| Effect unknown

|-
| ITEMS_BARRED
|
| [[Bone]] items (clothes with [BARRED]) can be made from this material.

|-
| ITEMS_SCALED
|
| [[Shell]] items (clothes with [SCALED]) can be made from this material.

|-
| ITEMS_LEATHER
|
| [[Leather]] items (clothes with [LEATHER]) can be made from this material.

|-
| ITEMS_SOFT
|
| Soft clothing items, backpacks and quivers, and siege engine parts can be made from this material.

|-
| ITEMS_HARD
|
| Furniture, medical supplies, and crafts can be made out of this material.

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

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

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

|-
| YARN
|
| Classifies the material as yarn, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".

|-
| 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)".

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

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

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

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

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

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

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

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

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

|-
| ITEMS_DELICATE
|
| Used internally by amber and coral.

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

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

==Syndrome tokens==

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

|-
| SYN_NAME
| text
| defines the name of the syndrome

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection (by a creature)

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact (e.g. poison dust or liquid)

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation (e.g. poison vapor or gas)

|-
| SYN_AFFECTED_CLASS
|
| adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| SYN_IMMUNE_CLASS
|
| makes the class of creatures immune to the syndrome

|-
| SYN_AFFECTED_CREATURE
| creature
| adds a specific creature to those affected.

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

v0.34:Syndrome

2012-02-22T05:10:33Z

Ydaraishy: added info for new creatures

{{quality|Masterwork|21:09, 26 April 2011 (UTC)}}{{av}}

A '''syndrome''' is a disease or effect that a poor hapless creature might get through encountering certain creatures, extracts or vindictive modders. They generally cause unpleasant and frequently fatal [[symptoms]] over a short to long period of time, but some will clear up over time or with the assistance of a [[doctor]]. A [[Health care|Hospital]] is required to diagnose and potentially treat the syndrome. [[File:Snakebite.png|200px|thumb|right|An example of a syndrome in effect. This hippo did not ultimately survive the encounter despite one bite being the only injury sustained.]]

==List of syndromes==
{| {{prettytable}}
|- bgcolor="#dddddd"
! Syndrome
! Venom
! Acquired
! Short-term Symptoms
! Long-term Symptoms
! Chronic Symptoms
|-
| Adder bite
| adder venom (injected)
| Being bitten by an [[adder]], [[giant adder]] or [[adder man]]
| Strong pain
| Swelling<br>Blisters<br>Nausea
|
|-
| Bark scorpion sting
| bark scorpion venom (injected)
| Being stung by a [[bark scorpion]], [[giant bark scorpion]] or [[bark scorpion man]]
| Strong pain
| none
| none
|-
| Black mamba bite
| black mamba venom (injected)
| Being bitten by a [[black mamba]], [[giant black mamba]] or [[black mamba man]]
| Dizziness<br>Drowsiness<br>Strong pain<br>Fever<br>Unconsciousness<br>Complete paralysis<sup>1</sup>
|
|
|-
| Blob blisters
| cave blob fluid<br />(contact or ingested)
| Touching a [[cave blob]]
| Mild pain<br/>Mild blisters
| None
| None
|-
| Brown recluse spider bite
| brown recluse spider venom (injected)
| Being bitten by a [[brown recluse spider]], [[giant brown recluse spider]] or [[brown recluse spider man]]
| Nausea<br>Fever<br>Pain<br>
| Severe localised necrosis
|
|-
| Bumblebee sting
| bumblebee venom (injected)
| Being stung by a [[bumblebee]] worker
| Pain<br>Strong swelling
|
|
|-
| Bushmaster bite
| bushmaster venom (injected)
| Being bitten by a [[bushmaster]], [[giant bushmaster]] or [[bushmaster man]]
| Strong pain<br>Mild bleeding<br>Dizziness<br>Nausea<br>Unconsciousness<br>Complete paralysis<sup>1</sup>
|
|
|-
| Cave floater sickness
| cave floater gas<br />(inhaled or ingested)
| Expelled from [[cave floater]]
| Mild nausea
| Fever<br/>Strong drowsiness (delayed)<br/>Strong dizziness (delayed)
| None
|-
| Cave spider bite
| cave spider venom<br />(injected)
| Being bitten by a [[cave spider]]
| None
| None
| Very mild dizziness
|-
| Copperhead snake bite
| copperhead snake venom (injected)
| Being bitten by a [[copperhead snake]], [[giant copperhead snake]] or [[copperhead snake man]]
| Pain<br>Swelling<br>Nausea
|
|
|-
| Giant cave spider bite
| giant cave spider venom<br />(injected)
| Being bitten by a [[giant cave spider]]
| Complete paralysis<sup>1</sup><br/>'''Being eaten by the GCS'''
| None, not that it really matters.
| None
|-
| Gila monster bite
| gila monster venom (injected)
| Being bitten by a [[gila monster]], [[giant gila monster]] or [[gila monster man]]
| Pain<br>Mild swelling
|
|
|-
| Gnomeblight
| [[gnomeblight]]<br />(contact, inhaled, injected, or ingested)
| Unknown. Affects gnomes only
| None
| Severe systemic necrosis<sup>2</sup>
| None
|-
| Giant desert scorpion sting
| giant desert scorpion<br />(injected)
| Being stung by a [[giant desert scorpion]]
| None
| Necrosis of the brain and nervous system<sup>2</sup>
| None
|-
| Helmet snake bite
| helmet snake venom<br />(injected)
| Being bitten by a [[helmet snake]]
| Minor bleeding
| Fever<br/>Nausea<br/>Dizziness<br/>Localized swelling<br/>Localized oozing<br/>Localized bruising<br/>Strong pain<br/>Intense localized necrosis<br/>Possible loss of limb
| None
|-
| Honey bee sting
| honey bee venom (injected)
| Being stung by a [[honey bee]] worker
| Pain<br>Strong swelling
|
|
|-
| Iron man cough
| iron man gas<br />(inhaled)
| Expelled by [[iron man]]
| Coughing blood
| None
| None
|-
| King cobra bite
| king cobra venom<br />(injected)
| Being bitten by a [[king cobra]]
| Complete paralysis<sup>1</sup><br/>Pain, dizziness, drowsiness
| None
| None
|-
| Phantom spider bite
| phantom spider venom<br />(injected)
| Being bitten by a [[phantom spider]]
| None
| Numbness and mild dizziness
| None
|-
| Platypus sting
| platypus venom<br />(injected)
| Being kicked by a [[platypus]], [[giant platypus]] or [[platypus man]]
| Pain and swelling
| Extreme pain, swelling possibly to the point of necrosis
| None
|-
| Rattlesnake bite
| rattlesnake venom<br />(injected)
| Being bitten by a [[rattlesnake]], [[giant rattlesnake]] or [[rattlesnake man]]
| Pain, nausea, blisters, swelling, bruising
| Severe localized necrosis
| None
|-
| Serpent man bite
| serpent man venom<br />(injected)
| Being bitten by a [[serpent man]]
| Complete paralysis<sup>1</sup>
| None
| None

|-
| beast sickness<sup>3</sup>
| random
| Encounters with [[forgotten beast]]s
| random
| random
| random
|-
| titan sickness<sup>3</sup>
| random
| Encounters with [[titan]]s
| random
| random
| random
|-
| demon sickness<sup>3</sup>
| random
| Encounters with [[demon]]s
| random
| random
| random
|}
:<small>1. For small creatures such as humans and dwarves, paralysis tends to result in suffocation.</small>
:<small>2. Necrosis of the brain will eventually result in instant death once the brain rots away completely.</small>
:<small>3. [[Titan]]s, [[forgotten beast]]s, and [[demon]]s have a chance to have a randomized syndrome. These range from pointless (mild blisters from inhaling boiling blood) to instantly deadly (Severe necrosis from a contact poison attached to a breath weapon/creature made of blood.</small>

==The anatomy of a syndrome==
Mechanically, syndromes are bundles of tokens attached to a material - they're confined to creature materials in vanilla DF, but it's a simple matter to add them to inorganic materials. When the material is injected, touched, inhaled, or ingested (depending on the syndrome), the creature suffers the predations of a nasty disease or poison. Here's an example syndrome, taken from the Giant Cave Spider raws.

If you are having troubles getting the syndromes to work (ie, in combat reports, getting "'''supersnake''' n/a splatters~etc"), then simply throw the venom template into the actual creature's raw, which is what the LOCAL_CREATURE_MAT actually calls on; the venom being in the same file.

[USE_MATERIAL_TEMPLATE:POISON:CREATURE_EXTRACT_TEMPLATE]
[STATE_NAME:ALL_SOLID:frozen giant cave spider venom]
[STATE_ADJ:ALL_SOLID:frozen giant cave spider venom]
[STATE_NAME:LIQUID:giant cave spider venom]
[STATE_ADJ:LIQUID:giant cave spider venom]
[STATE_NAME:GAS:boiling giant cave spider venom]
[STATE_ADJ:GAS:boiling giant cave spider venom]
[PREFIX:NONE]
[ENTERS_BLOOD]
[SYNDROME]
[SYN_NAME:giant cave spider bite]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[SYN_IMMUNE_CREATURE:SPIDER_CAVE:ALL]
[SYN_INJECTED]
[CE_PARALYSIS:SEV:100:PROB:100:RESISTABLE:SIZE_DILUTES:START:5:PEAK:10:END:20]

The first line, USE_MATERIAL_TEMPLATE, is creating a new material, called POISON, using the CREATURE_EXTRACT_TEMPLATE as the basis. After this, the STATE_NAME and STATE_ADJ tokens are used to define the names and adjectives assigned to different states of the material - GAS, LIQUID and ALL_SOLID, in this case, though ALL is also a valid token. At this stage, you can use any material tags like MAT_FIXED_TEMP or similar to set further material properties, though this usually isn't necessary.

ENTERS_BLOOD
This tag determines whether a poison enters the blood or not. If it is not included, the poison will splatter (if liquid) or flow (if gas) over the affected body part instead when injected. If you're using a contact poison, leave this out. Necessary for injected poisons.
SYNDROME
This tag ends the material details and begins the definition of the actual syndrome.
SYN_NAME
This one is self-explanatory - the name of the syndrome as it will appear in-game.
SYN_AFFECTED_CLASS
This token defines what CREATURE_CLASS will be affected by the syndrome. Most creatures are classed under GENERAL_POISON. Multiple tokens can be used in a single syndrome.
SYN_IMMUNE_CLASS
As above, but makes class immune.
SYN_IMMUNE_CREATURE
This token defines which creatures CANNOT be affected by the syndrome - useful for addressing specific instances within a population, such as a specific caste or an individual creature that falls under GENERAL_POISON. Syntax is [SYN_IMMUNE_CREATURE:creature:caste]. ALL can be used for the caste.
SYN_AFFECTED_CREATURE
As above, but makes creature or caste susceptible.

SYN_INJECTED, SYN_CONTACT, SYN_INHALED, SYN_INGESTED
This token determines the method of infection - injected syndromes must be injected via a creature attack, while contact syndromes result from any contamination of a creature by material splatter (such as blood), inhaled syndromes must be inhaled in gaseous form (such as from boiling or a creature breath attack), and ingestion syndromes must be eaten or drunk. Any combination of these tags can be used. A fun variation on the usual creature injection routine is to create a material with a SYN_CONTACT syndrome and have a creature use it for blood - this tends to end poorly for any predator that chooses to attack them.

[SPECIALATTACK_INJECT_EXTRACT:LOCAL_CREATURE_MAT:VENOM:LIQUID:100:100]
This is one method for getting a poison into a creature. If [ENTERS_BLOOD] is applied, it will be injected into the bloodstream. Otherwise, it will just splatter over the area. Put this on a creature attack. Substance type (gas, liquid, solid) does not appear to have an effect. The numbers on the end are minimum and maximum.

CE_X, or creature effect tokens, are the real meat and bones of your syndrome. They're detailed below.

==Creature effect tokens==
Each and every syndrome has a number of creature effect tokens, represented by CE_X - these lovely little beauties determine exactly how the poor creature suffering from the syndrome is affected. An example CE token is as follows:

[CE_NECROSIS:SEV:100:PROB:100:LOCALIZED:VASCULAR_ONLY:RESISTABLE:START:50:PEAK:1000:END:2000]

In this example, we have an effect that will always cause severe necrosis in whichever bodypart it touches, so long as that bodypart is vascular and that the creature is not able to resist it in some manner. The effect begins shortly after the syndrome is contracted, peaks 1000 [[time|time units]] afterwards, and finally ceases another 1000 time units later.

As a general rule of thumb, so long as CE_X starts the string and START/PEAK/END end it, the order of the intervening tokens isn't important.

*CE_X
The effect type. This can be a number of different tokens, as detailed in the table below this list.
*SEV:X
The severity of the effect. Higher values appear to be worse, with SEV:1000 CE_NECROSIS causing a part to near-instantly become rotten.
*PROB:X
The probability of the effect actually manifesting in the victim, as a percentage. 100 means always, 1 means a 1 in 100 chance.
*LOCALIZED (Overwrites BP tokens)
This tag causes an effect to ignore all BP tokens and then forces the game to attempt to apply the effect to the limb that came into contact with the contagion - ie. the part that was bitten by the creature injecting the syndrome material, or the one that was splattered by a contact contagion. If an effect can not be applied to the contacted limb (i.e. IMPAIR_FUNCTION on a non-organ) then this token makes the syndrome have no effect. This token also makes inhaled syndromes have no effect.
*BP:BODY_PART:TISSUE (Overwritten by LOCALIZED)
Specifies which body parts and tissues are to be affected by the syndrome. BODY_PART can be BY_CATEGORY:x to target body parts with a matching [CATEGORY:x] [[body token]] (or ALL to affect everything), BY_TYPE:x to target body parts having a particular type (UPPERBODY, LOWERBODY, HEAD, GRASP, or STANCE), or BY_TOKEN:x to target individual body parts by their ID (as specified in the [BP] token). For example, if you wanted to target the lungs of a creature, you would use BP:BY_CATEGORY:LUNG:ALL. The syndrome would act on all bodyparts within the creature with the CATEGORY tag LUNG and affect all tissue layers. For another example, say you wanted to cause the skin to rot off a creature - you could use BP:BY_CATEGORY:ALL:SKIN, targeting the SKIN tissue on all bodyparts. Multiple targets can be given in one syndrome by placing the BP tokens end to end. This is one of the most powerful and useful aspects of the syndrome system, as it allows you to selectively target bodyparts relevant to the contagion, like lungs for coal dust inhalation, or the eyes for exposure to an acid gas. Not everything takes a target!
*VASCULAR_ONLY (Optional)
This syndrome only affects tissue layers with the VASCULAR token.
*MUSCULAR_ONLY (Optional)
This syndrome only affects tissue layers with the MUSCULAR token. Are you seeing a trend here?
*SIZE_DILUTES (Optional)
This token presumably causes the effects of the syndrome to scale with the size of the creature compared to the size of the dose of contagion they received, but has yet to be extensively tested.
*SIZE_DELAYS (Optional)
As above, this token has yet to be tested but presumably delays the onset of a syndrome according to the size of the victim.

The details of this table are still being thrashed out by modders, so if you have anything to add, please don't hesitate to hit the edit button!

Non-targeted syndromes will ignore any BP tokens and LOCALIZED tokens.
{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| CE_BLEEDING
| Yes
| Causes the targeted bodypart to start bleeding, with heavy enough bleeding resulting in the death of the sufferer. Some conditions seem to cause bleeding to be fatal no matter how weak.
|-
| CE_BLISTERS
| Yes
| Covers the targeted bodypart with blisters.
|-
| CE_BRUISING
| Yes
| Causes the targeted bodypart to undergo bruising.
|-
| CE_IMPAIR_FUNCTION
| Yes
| An organ afflicted with this CE is rendered inoperable - for example, if both lungs are impaired the creature can't breathe and will suffocate. This token only affects organs, not limbs.
|-
| CE_NECROSIS
| Yes
| Causes the targeted bodypart to rot, with associated tissue damage and miasma. Badly necrotic limbs will require amputation and heavy rot will eventually result in bleeding. Necrosis has some strange behavior involving bleeding to death that isn't fully understood; a 100% necrotic creature can survive fine with no non-yellow bodyparts but will die of bleeding as soon as they end a round of combat, even if they never take a hit. Because of this, fairly useless unless targeting the lungs or eyes.
|-
| CE_NUMBNESS
| Yes
| Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage.
|-
| CE_OOZING
| Yes
| Causes pus to ooze from the afflicted bodypart.
|-
| CE_PAIN
| Yes
| Afflicts the targeted bodypart with intense pain.
|-
| CE_PARALYSIS
| Yes
| Causes paralysis in the affected body part. Targeted causes sluggishness and significantly reduces speed. Untargeted paralysis is 'complete paralysis' and will cause suffocation in smaller creatures.
|-
| CE_SWELLING
| Yes
| Causes the targeted bodypart to swell up. Extreme swelling may lead to necrosis.
|-
| CE_COUGH_BLOOD
| No
| This effect results in the sufferer periodically coughing blood, which stains the tile they're on and requires cleanup. It doesn't appear to be lethal, but may cause minor bleeding damage.
|-
| CE_DIZZINESS
| No
| Inflicts the Dizziness condition, occasional fainting and a general slowdown in movement and work speed.
|-
| CE_DROWSINESS
| No
| Causes the Drowsiness condition.
|-
| CE_FEVER
| No
| Causes the Fever condition.
|-
| CE_NAUSEA
| No
| Causes the Nausea condition, and heavy vomiting. Can eventually lead to dehydration and death.
|-
| CE_UNCONSCIOUSNESS
| No
| Renders unconscious.
|-
| CE_VOMIT_BLOOD
| No
| This effect results in the sufferer periodically vomiting blood, which stains the tile they're on and requires cleanup. It doesn't appear to be lethal, but may cause minor bleeding damage.
|}

==Inorganic syndromes and you!==
It's perfectly possible - and quite simple - to add a nasty syndrome to a type of rock or metal - you simply add the syndrome tokens to the material definition in the same manner that you would add them to a creature material definition. The only catch is that since your hapless dwarves will only normally encounter the material in metal, gem or boulder form, a bit of creativity must be used to actually get them inside your citizens - that is, you need to make them 'explosively boil' as soon as they're mined or produced. This has the sad side effect of destroying the actual item - sorry, no highly radioactive uranium this release.

The easiest way to accomplish this is to assign the material a low boiling point, usually just under room temperature, and make sure its temperature is fixed to a point above it.
[MAT_FIXED_TEMP:9001]
[BOILING_POINT:9000]
Now, as soon as this substance hits the open air - by being mined, smelted or reaction-produced at a custom workshop - it will EXPLOSIVELY BOIL, flooding a small area with delicious syndrome-rich gas. Creatures who inhale the gas will be immediately hit with the syndrome you thoughtfully attached to the material definition earlier!

There are a number of other tokens you can use to control the colour and naming conventions of your syndrome material, referred to as MATERIAL tokens.

==Breath attacks==
Breath attacks have been changed to use Interactions as of 0.34.01. Instead of [MATERIAL_BREATH_ATTACK], you would now use 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
| Similar to the trailing gas, but easier to breathe in, and condensed, so it will collect on creatures. Creature will attack as normal.
|-
| TRAILING_GAS_FLOW
| Shoots a trail of gas substance at the creature. Fairly easy to dodge. 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. 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 '''solid''' glob of spinning substance at the creature. Essentially the same as SOLID_GLOB. May do less damage.
|-
| SPATTER_POWDER
|
|-
| SPATTER_LIQUID
|
|-
| UNDIRECTED_GAS
| Creature occasionally releases a cloud of 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 substance. 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 large cloud of substance, 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.
|-
| WEB_SPRAY
| Emits a burst of [[web]]s that entangle target creatures.
|-
| DRAGONFIRE
| Emits a wide cone of [[fire]] that burns target creatures.
|-
| FIREJET
| Emits a narrow cone of [[fire]] that burns target creatures.
|-
| FIREBALL
| Emits a fireball that burns the target creature.
|-
| WEATHER_CREEPING_GAS
| Creates a slowly expanding cloud of gas, similar to miasma.
|-
| WEATHER_CREEPING_VAPOR
| Creates a slowly expanding cloud of vapor.
|-
| WEATHER_CREEPING_DUST
| Creates a slowly expanding cloud of dust.
|-
| WEATHER_FALLING_MATERIAL
| Causes it to start raining a particular material.
|}

Keep in mind that you can use multiple breath attacks, which appears to make the creature choose between them at random.

{{Category|Modding}}
[[ru:DF2012:Syndrome]]

v0.34:Creature token

2012-02-21T06:06:17Z

Ydaraishy: Added info about some of the tags.

{{av}}{{Quality|Exceptional}}

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

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

|-
| ALCOHOL_DEPENDENT
| Caste
|
| Creature needs alcohol to get through the working day.

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

|-
| ALTTILE
| Creature
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| AMBUSHPREDATOR
| Caste
|
| Instead of charging relentlessly at prey, a creature with this tag will wait till the prey is within a few squares before charging.{{verify}}

|-
| AMPHIBIOUS
| Caste
|
| Allows a creature to breathe with or without [[water]]. Implies [AQUATIC].

|-
| APP_MOD_DESC_RANGE
| Caste
|
*Range
| [http://www.bay12forums.com/smf/index.php?topic=60554.msg1766793#msg1766793 Forum post describing how description ranges work]

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

|-
| APP_MOD_IMPORTANCE
| Caste
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| APP_MOD_NOUN
| Caste
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

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

|-
| APPLY_CREATURE_VARIATION
| Special
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
| Special
|
| Applies loaded Creature Variation

|-
| AQUATIC
| Caste
|
| Allows a creature to breathe underwater, but causes it to "drown" out of [[water]].

|-
| ARENA_RESTRICTED
| Caste
|
| Does not appear in arena mode list

|-
| ARTIFICIAL_HIVEABLE
| Creature
|
| Can be kept in artificial hives by beekeepers.

|-
| AT_PEACE_WITH_WILDLIFE
| Caste
|
| Does not attack or frighten wildlife.

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

|-
| ATTACK_TRIGGER
| Caste
| pop:exported wealth:created wealth
| Specifies when a [[megabeast]] will attack the fortress.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

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

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

|-
| BEACH_FREQUENCY
| Caste
|
| [[Whale]]s and [[Sea nettle jellyfish|jellyfish]] have this. Controls the beaching frequency of the creature.

|-
| BENIGN
| Caste
|
| Determines whether creature can show up on "tame" maps (includes [[elephant]]s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME
| Creature
|
* [[biome token]]
| Select a [[Biome]] the creature may appear in.

|-
| BLOOD
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| Specifies what the creature's blood is made of.

|-
| BLOODSUCKER
| Caste
| ?
| ?

|-
| 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. Thats all a maggot needs.

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

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

|-
| BODY_SIZE
| Caste
| years:days:size
| sets up size at a given time. Size is in cubic centimeters (milliliters), 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 10000 (10000 mL, ~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

|-
| BODYGLOSS
| Caste
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
| Caste
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE. Civilized creatures (ex. Kobolds) with this tag tend to die out during world generation.

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

|-
| 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 b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| CAN_DO_INTERACTION
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| CAN_LEARN
| Caste
|
| The creature gets skills and professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| CAN_SPEAK
| Caste
|
| Can talk. Note that it is not necessary for a creature to gain social skills. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}

|-
| CANNOT_UNDEAD
| Caste
|
| Alias for NOT_LIVING

|-
| CANOPENDOORS
| Caste
|
| Allows the creature to open doors.

|-
| CARNIVORE
| Caste
|
| Creature ''only'' eats meat. Note that carnivorous species will not be able to survive worldgen if they do not also have NO_EAT.

|-
| CASTE
| Creature
|
*name
| defines a caste

|-
| CASTE_ALTTILE
| Caste
|
*tile number or "letter"
| Caste-specific alternate tile. Expects CASTE_TILE

|-
| CASTE_COLOR
| Caste
|
*fg
*bg
*brightness
| Creature tile color of the caste.

|-
| CASTE_GLOWCOLOR
| Caste
|
*fg
*bg
*brightness
| GLOWTILE color of the caste.

|-
| CASTE_GLOWTILE
| Caste
|
*tile value or "letter"
| Caste-specific glowtile

|-
| CASTE_NAME
| Caste
| singular:plural:adjective
| The name of the caste of the creature in the game.

|-
| CASTE_PROFESSION_NAME
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| Caste
| 'character' or tile number
| Creatures of this caste active in their civilization's military will blink between their default tile and this one.

|-
| CASTE_SOLDIER_TILE
| Caste
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

|-
| CASTE_SPEECH
| Caste
| speech file?
| Possibly a caste-specific instance of the SPEECH token

|-
| CASTE_TILE
| Caste
|
* tile number or "letter"
| Caste-specific creature tile.

|-
| CAVE_ADAPT
| Caste
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CDI
| Caste
| ?
| ?

|-
| CHANGE_BODY_SIZE_PERC
| Caste
|
|

|-
| CHILD
| Caste
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

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

|-
| CLUSTER_NUMBER
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
| CLUTCH_SIZE
| Caste
|
*min
*max
|Number of eggs laid in one sitting.

|-
| COLONY_EXTERNAL
| Caste
|
| Caste hovers around colony.

|-
| COLOR
| Creature
| foreground:background:brightness
| Color of the creature's tile.

|-
| COMMON_DOMESTIC
| Caste
|
| Allows the creature to be brought with immigrants and when creating a new fortress, as long as the creature also includes at least one of the following tokens: PET, PACK_ANIMAL, WAGON_PULLER, MOUNT. In addition, the creature must be NATURAL rather than FANCIFUL

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

|-
| COOKABLE_LIVE
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered / fishcleaned.

|-
| CRAZED
| Caste
| ?
| ?

|-
| COPY_TAGS_FROM
| Special
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| CREATURE_CLASS
| Caste
|
*classname
| Creature class. Can be anything, but only existing use is GENERAL_POISON. Appears to only be used for Syndromes. Supposedly can also be used for entity positions.

|-
| CREATURE_SOLDIER_TILE
| Creature
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| CREATURE_TILE
| Creature
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| CREPUSCULAR
| Caste
|
| Sets if the creature is active at twilight.

|-
| CURIOUSBEAST_EATER
| Caste
|
| Allows a creature to steal and eat edible items from a site.

|-
| CURIOUSBEAST_GUZZLER
| Caste
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| CURIOUSBEAST_ITEM
| Caste
|
| Allows a creature to steal things (apparently the highest value it can find). Semimegabeast thievery is in Legends mode. Lightweight creatures can probably steal heavy items.

|-
| CV_ADD_TAG
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

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

|-
| DEMON
| Caste
|
| Found on generated [[demon]]s. Cannot be specified in user-defined raws.

|-
| DESCRIPTION
| Caste
| text
| A brief description of the creature type.

|-
| DIE_WHEN_VERMIN_BITE
| Caste
|
| Dies upon attacking. Used for bee stings.

|-
| DIFFICULTY
| Caste
| integer
| Toady: "Difficulty determines how deep it places them in adventure mode/reclaim caves, and the chance that they are wounded the first few river attacks." Also increases experience gain during adventure mode.

|-
| DIURNAL
| Caste
|
| Sets if the creature is active in day.

|-
| DIVE_HUNTS_VERMIN
| Caste
|
| Found on [[peregrine falcons]]. The creature hunts vermin by diving from the air. May be bugged due to fortress pets remaining earthbound.

|-
| DOES_NOT_EXIST
| Creature
|
| Creature does not actually exist; used for fanciful creatures.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

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

|-
| EBO_SHAPE
| Caste
| gem shape
| The shape of the extra item of the creature upon butchering. Used with EXTRA_BUTCHER_OBJECT.

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

|-
| EGG_SIZE
| Caste
|
*size
| Determines how long it takes for eggs to hatch{{verify}}. The larger the number, the longer it takes.

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

|-
| EQUIPS
| Caste
|
| Allows the creature to wear or wield items.

|-
| EVIL
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Has no effect on cavern creatures.

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

|-
| EXTRACT
| Caste
|
* [[material token]]
| Defines a creature extract which can be obtained via [[small animal dissection]].

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

|-
| FANCIFUL
| Creature
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with [COMMON_DOMESTIC]

|-
| FEATURE_ATTACK_GROUP
| Caste
|
| Found on subterranean animalmen.

|-
| FEATURE_BEAST
| Caste
|
| Found on [[forgotten beast]]s. Cannot be specified in user-defined raws.

|-
| FEMALE
| Caste
|
| Inside a female caste, sets femaleness. Outside of a caste, sets all individuals female unless overridden by caste.

|-
| FIREIMMUNE
| Caste
|
| Renders a creature immune to being damaged by FIREBREATH's short range cone attack.

|-
| FIREIMMUNE_SUPER
| Caste
|
| The creature is immune to DRAGONFIREBREATH. Implies FIREIMMUNE.

|-
| FISHITEM
| Caste
|
| Needs to be cleaned at a fishery

|-
| FIXED_TEMP
| Caste
| temperature
| The natural heat generated by the creature.

|-
| FLEEQUICK
| Caste
|
| Determines how soon a creature flees in a losing battle. Creatures with this tag will flee at the first sign of resistance.

|-
| FLIER
| Caste
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves 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.

|-
| FREQUENCY
| Creature
|
*number, max 100
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit. Creatures without a frequency statement default to 50. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. Not to be confused with POP_RATIO
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| GENERAL_BABY_NAME
| Creature
| singular:plural
| name at creature level

|-
| GENERAL_CHILD_NAME
| Creature
| singular:plural
| name at creature level

|-
| GENERAL_MATERIAL_FORCE_MULTIPLIER
| Caste
| ?
| ?

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

|-
| GETS_INFECTIONS_FROM_ROT
| Caste
|
| Creature can get infections from necrotic tissue.

|-
| GETS_WOUND_INFECTIONS
| Caste
|
| Creature's wounds can become infected.

|-
| GLOWCOLOR
| Creature
|
*foreground
*background
*brightness
| The colour of the GLOWTILE of the creature.

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

|-
| GNAWER
| Caste
| verb (gnawed)
| The creature chews on food barrels and bags.

|-
| GOBBLE_VERMIN_CLASS
| Caste
| class
| The creature eats vermin of the specified caste.

|-
| GOBBLE_VERMIN_CREATURE
| Caste
| creature:caste
| The creature eats a specified vermin.

|-
| GO_TO_END
| Special
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

|-
| GO_TO_START
| Special
|
| When using tags from an existing creature, inserts new tags at the beginning of the creature.

|-
| GO_TO_TAG
| Special
|
| When using tags from an existing creature, inserts new tags after the specified tag.

|-
| GOOD
| Creature
|
| Determines whether creature can show up on "good" areas. Eg. unicorn.

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

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

|-
| GRAZER
| Caste
|
*number
| Animals is a grazer. The higher the number, the less frequently it needs to eat in order to survive.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| 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 may require the creature to have a lair to work properly.

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

|-
| HAS_NERVES
| Caste
|
| This makes the creature susceptible to severed motor and sensory nerves when muscles are torn in limb, grasp and stance parts. Some butchering yields nervous tissue.

|-
| HASSHELL
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

|-
| HIVE_PRODUCT
| Creature
|
*number
*[[time]]
*[[item token]]s
| What product is harvested from [[Beekeeping industry|beekeeping]].

|-
| HOMEOTHERM
| Caste
|
| Default 'NONE'. The creature's normal body [[temperature]]

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

|-
| IMMOBILE
| Caste
|
| The creature cannot move. Found on [[sponges]].

|-
| IMMOBILE_LAND
| Caste
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breathe on land.

|-
| IMMOLATE
| Caste
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| INTELLIGENT
| Caste
|
| Shortcut for [CAN_SPEAK] + [CAN_LEARN].

|-
| ITEMCORPSE
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| ITEMCORPSE_QUALITY
| Caste
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| LAIR
| Caste
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. 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.

|-
| LAIR_CHARACTERISTIC
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| LAIR_HUNTER
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| LAIR_HUNTER_SPEECH
| Caste
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| 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). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| LARGE_ROAMING
| Creature
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| LAYS_EGGS
| Caste
|
| Creature lays eggs instead of giving birth to live young.

|-
| LAYS_UNUSUAL_EGGS
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
| Caste
|
* [[material token]]
*healing rate
| Defines the material and healing rate of ligaments.

|-
| LIGHT_GEN
| Caste
|
| The creature will generate light, such as in adventurer mode at night.

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

|-
| LISP
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz.")

|-
| LITTERSIZE
| Caste
|
* minumum
* maximum
| Determines the random chance of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| LOCKPICKER
| Caste
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| LOOSE_CLUSTERS
| Creature
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| MAGICAL
| Caste
|
| Unknown.

|-
| MAGMA_VISION
| Caste
|
| Creature's able to see while covered in magma.

|-
| MALE
| Caste
|
| The species or caste is all male.

|-
| MANNERISM_??
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
Refer to [[Creature mannerism token]]s

|-
| MATERIAL
| Creature
|
*material id
| Begins defining a new material.{{verify}}

|-
| MATERIAL_FORCE_MULTIPLIER
| Caste
| ?
| ?

|-
| MATUTINAL
| Caste
|
| Sets if the creature is active in dawn.

|-
| MAXAGE
| Caste
| min:max
| Range of time in years in which death from old age may occur. Once a creature reaches the min value, it has a random chance each season of dying from old age. Unknown if the chance increases with further age.

|-
| MEANDERER
| Caste
|
| Gives a creature random movement.

|-
| MEGABEAST
| Caste
|
| Appears on fortress territory in Fortress Mode occasionally. Can also be worshipped.

|-
|MENT_ATT_CAP_PERC
| Caste
|
*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).

|-
| MENT_ATT_RANGE
| Caste
|
*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.

|-
| MENT_ATT_RATES
| Caste
|
*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.

|-
| MILKABLE
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
| Caste
|
| Alias for MISCHIEVOUS

|-
| MISCHIEVOUS
| Caste
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MODVALUE
| Caste
|
| Seemingly no longer used - holdover from previous versions.

|-
| MOUNT
| Caste
|
| Creature may be used as a mount.

|-
| MOUNT_EXOTIC
| Caste
|
| You need the Dungeon master noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
| Caste
|
| Makes litters with more than one offspring rare.

|-
| MUNDANE
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present, and determining whether a creature will attack creatures with the AT_PEACE_WITH_WILDLIFE token.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

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

|-
| NATURAL
| Caste
|
| Alias for NATURAL_ANIMAL

|-
| NATURAL_ANIMAL
| Caste
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| Caste
| skill: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. Requires CAN_LEARN or INTELLIGENT to function (changed in .25 or earlier that CAN_LEARN is no longer required).

|-
| 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. Setting the number of night creatures to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| NIGHT_CREATURE_HUNTER
| Caste
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET <s>of the opposite sex</s>(seems to choose anyone of any sex of the caste/s that have the CONVERTED_SPOUSE tag), convert them, and then have children with them(if possible). NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed. Setting the number of night creatures to zero in the world gen parameters will remove only the randomly-generated night creatures.

|-
| NO_AUTUMN
| Caste
|
| does not appear this season.

|-
| NO_CONNECTIONS_FOR_MOVEMENT
| Caste
| ?
| ?

|-
| NO_DIZZINESS
| Caste
|
| Creature cannot become dizzy

|-
| NO_DRINK
| Caste
|
| Creature does not need to drink.

|-
| NO_EAT
| Caste
|
| Creature does not need to eat.

|-
| NO_FEVERS
| Caste
|
| Creature cannot suffer fevers

|-
| NO_GENDER
| Caste
|
| Creature has no gender.

|-
| NO_PHYS_ATT_GAIN
| Caste
| ?
| ?

|-
| NO_PHYS_ATT_RUST
| Caste
| ?
| ?

|-
| NO_SLEEP
| Caste
|
| Creature does not need to sleep.

|-
| NO_SPRING
| Caste
|
| does not appear this season.

|-
| NO_SUMMER
| Caste
|
| does not appear this season.

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
| Caste
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| NO_WINTER
| Caste
|
| does not appear this season.

|-
| NOBONES
| Caste
|
| Creature has no bones.

|-
| NOBREATHE
| Caste
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOCTURNAL
| Caste
|
| Sets if the creature is active in night.

|-
| NOEMOTION
| Caste
|
| The creature has no emotions, and does not rage.

|-
| NOEXERT
| Caste
|
| Creature can't become tired or over-exerted.

|-
| NOFEAR
| Caste
|
| Creature doesn't feel fear and will never run away from battle.

|-
| NOMEAT
| Caste
|
| Creature will not drop meat on butcher.

|-
| NONAUSEA
| Caste
|
| Creature can't vomit.

|-
| NOPAIN
| Caste
|
| Creature doesn't feel pain.

|-
| NOSKIN
| Caste
|
| Creature will not drop skin on butcher.

|-
| NOSKULL
| Caste
|
| Creature will not drop skull on butcher, rot, or decay of severed head.

|-
| NOSMELLYROT
| Caste
|
| Does not produce miasma when rotting

|-
| NOSTUCKINS
| Caste
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
| Caste
|
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

|-
| NOT_BUTCHERABLE
| Caste
|
| Cannot be butchered

|-
| NOT_LIVING
| Caste
|
| Cannot be raised from the dead. Also prevents ghosts of that creature appearing.

|-
| NOTHOUGHT
| Caste
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==O==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| OPPOSED_TO_LIFE
| Caste
| ?
| ?

|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| PACK_ANIMAL
| Caste
|
| Allows the creature to be used as a pack animal. Currently only used by merchants. Also prevents creature from dropping hauled items on its own -- do not use for player-controllable creatures.

|-
| PARALYZEIMMUNE
| Caste
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
| Caste
|
|

|-
| PEARL
| Caste
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| Caste
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. Wood and cloth objects roll a 0-9 and if it's greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

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

|-
| PET
| Caste
|
| Allows the creature to be tamed. Also allows all females of the species to breed regardless of marital status.

|-
| PET_EXOTIC
| Caste
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| Caste
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

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

|-
|PHYS_ATT_CAP_PERC
| Caste
|
*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).

|-
| PHYS_ATT_RANGE
| Caste
|
*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.

|-
| PHYS_ATT_RATES
| Caste
|
*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.

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

|-
| PLUS_MATERIAL
| Creature
|
*material
| Adds a material to selected materials. Used immediately after SELECT_MATERIAL.

|-
| POP_RATIO
| Caste
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| Creature
| min:max
| old guess: "The minimum/maximum numbers of how many of these creatures can show up on a map per year."<br>Toady: "Pop number is the number per square of the region, I think."

|-
| POWER
| Caste
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

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

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

|-
| PRONE_TO_RAGE
| Caste
| number
| Untested effect, though it clearly affects how likely a creature is to become enraged. Number may be percentage chance of becoming enraged during combat. As described in file_changes.txt, creatures with this token "follow its normal behavior, but flip out on occasion, higher rate = more flipping out".

|-
| PUS
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| Specifies what the creature's wounds will ooze when infected.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

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

|-
| REMAINS
| Caste
| singular:plural
| What creature's remains are called.

|-
| REMAINS_COLOR
| Caste
|
| What color creature's remains are.

|-
| REMAINS_ON_VERMIN_BITE_DEATH
| Caste
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
| Caste
|
| Unknown.

|-
| REMOVE_MATERIAL
| Creature
|
*material token
| Removes a material from a creature.

|-
| REMOVE_TISSUE
| Creature
|
*material token
| Removes a tissue from a creature.

|-
| RETRACT_INTO_BP
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract a body part when threatened.

|-
| RETURNS_VERMIN_KILLS_TO_OWNER
|
| Used with HUNTS_VERMIN, causes the creature to return killed vermin to its owner.

|-
| ROOT_AROUND
| Caste
| ?
| ?

|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| SAVAGE
| Creature
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
| Caste
|
* [[material token]]
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

|-
| SELECT_ADDITIONAL_CASTE
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used immediately after SELECT_CASTE.

|-
| SELECT_CASTE
| Creature
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
| Creature
|
*Material token
| Selects a locally defined material. Can be ALL.

|-
| SEMIMEGABEAST
| Caste
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Appears on fortress territory in Fortress Mode occasionally. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
| Caste
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| Begins a selection of body parts.

|-
| SET_TL_GROUP
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

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

|-
| SKILL_LEARN_RATE
| Caste
| [[skill_token]]:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

|-
| SKILL_LEARN_RATES
| Caste
| percentage
| The rate at which this creature learns all skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| SKILL_RATE
| Caste
| [[skill_token]]:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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]. [SLOW_LEARNER] changes the 100 to a 50. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
| Caste
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
| Caste
|
| If a creature has this token, it'll leave "remains" instead of a corpse.

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

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

|-
| SPECIFIC_FOOD
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Indicates that the creature is only capable of eating a particular type of food.

|-
| SPEECH
| Creature
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in data\speech.

|-
| SPEECH_FEMALE
| Creature
| speech file
| Boasting speeches relating to killing females of this creature.

|-
| SPEECH_MALE
| Creature
| speech file
| Boasting speeches relating to killing males of this creature.

|-
| SPEED
| Caste
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [[Speed]] for more information.

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

|-
| SPOUSE_CONVERSION_TARGET
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
| Caste
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SUPERNATURAL
| Caste
| ?
| ?

|-
| SWIM_SPEED
| Caste
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
| Caste
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
| Caste
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| TENDONS
| Caste
|
* [[material token]]
*healing rate
| Defines the material and healing rate of tendons.

|-
| THICKWEB
| Caste
|
| The creature's webs can catch larger creatures.

|-
| TISSUE
| Creature
| name
| Begins defining a tissue in the creature file.

|-
| TITAN
| Caste
|
| Found on [[titan]]s. Cannot be specified in user-defined raws.

|-
| TL_COLOR_MODIFIER
| Caste
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TLCM_GENETIC_MODEL
| Caste
|
| tissue layer color modifier is passed to offspring genetically?

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

|-
| TLCM_NOUN
| Caste
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
| Caste
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
| Caste
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
| Caste
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
| Caste
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
| Caste
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
| Caste
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| Creature
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

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

|-
| UBIQUITOUS
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
| Creature
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
| Caste
|
| Creature swims under the water and can't be seen. Currently appears to have no effect as of 31.25.

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

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

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

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

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

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

|-
| UTTERANCES
| Caste
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| VEGETATION
| Caste
|
| unknown

|-
| VERMIN_BITE
| Caste
|
*chance of occurance{{verify}}
*verb (bitten, stung, etc)
* [[material token]]
| Vermin bites, and injects something.

|-
| VERMIN_EATER
| Creature
|
| The vermin creature will attempt to eat exposed food. See PENETRATEPOWER. Distict from VERMIN_ROTTER.

|-
| VERMIN_FISH
| Creature
|
| The vermin appears in water and will attempt to swim around.

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

|-
| VERMIN_HATEABLE
| Caste
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
| Caste
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
| Caste
|
| The creature will not be observed randomly roaming about the map.

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

|-
| VERMIN_ROTTER
| Creature
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
| Creature
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
| Creature
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
| Caste
|
| Shortcut for [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

|-
| VESPERTINE
| Caste
|
| Sets if the creature is active in evening.

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

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| WAGON_PULLER
| Caste
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
| Caste
|
* [[material token]]
| Allows the creature to create webs, and defines what the webs are made of.

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

|-
| ATTACK_SKILL
| Caste
|
*skill used ([[Skill token]])
| defines the attack skill used

|-
| ATTACK_VERB
| Caste
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_CONTACT_PERC
| Caste
|
*% value
| amount of available tissue used in attack, or possibly percent chance the attack makes contact

|-
| ATTACK_PENETRATION_PERC
| Caste
|
*% value
| probably amount of material that makes contact when penetration is done, or possibly percent chance the attack penetrates (as in sharp items. Default is 0, so it can be left out for blunt attacks, if this is what it does)

|-
| ATTACK_PRIORITY
| Caste
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_VELOCITY_MODIFIER
| Caste
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|-
| ATTACK_FLAG_CANLATCH
| Caste
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in its definition is made.

|-
| ATTACK_FLAG_WITH
| Caste
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_FLAG_EDGE
| Caste
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_INTERACTION
| Caste
| ?
| ?

|-
| SPECIALATTACK_SUCK_BLOOD
| Caste
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.
|}

==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 tissue properties. (See also [[Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| PLUS_TISSUE_LAYER
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| SELECT_TISSUE
| Creature
|
*tissue token
| Selects a tissue for editing.

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

|-
| SET_LAYER_TISSUE
| Caste
|
| Sets a tissue layer to be made of a different tissue.

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

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

|-
| 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
[TISSUE:GAS]
[TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]

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

|-
| TISSUE_STYLE_UNIT
| Caste
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_CONNECTS
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
| TL_HEALING_RATE
| Caste
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
| TL_MAJOR_ARTERIES
| Caste
|
| Gives Major Artery attribute to selected layers.

|-
| TL_PAIN_RECEPTORS
| Caste
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
| TL_RELATIVE_THICKNESS
| Caste
|
| Seems to set new relative thickness for selected tissue layers.

|-
| TL_VASCULAR
| Caste
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[Body detail plan token]]
*[[Body token]]
*[[Material definition token]]
*[[Syndrome]]
*[[Tissue definition token]]

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

v0.34:Surroundings

2012-02-21T04:36:33Z

Ydaraishy:

{{quality|Exceptional|20:48, 4 October 2011 (UTC)}} {{av}}

'''Surroundings''' affect the types of [[plant]] life, wild [[animals]] and [[creatures]] which will appear in play within a given [[biome]]. It is possible to start a [[fortress]] that overlaps multiple alignment types (for example a terrifying [[forest]] and a calm [[shrubland]]). Some players consider this desirable, as it provides diversity in your little corner of the world, but it also has its dangers in the form of more ferocious wildlife.

Some plants and animals are unique to a certain type of surroundings and will only be found if those surroundings are present on the map. Note that most creatures also require a specific [[climate]] to spawn in. Again, it's important to check the specific biomes making up your site. Once a [[creature]] spawns on the map, it is under no compulsion to stay in its own biome and can roam as it pleases. Because of this, the specifics of what means what can be difficult to pin down sometimes.

== Combinations of surroundings ==

{| {{prettytable}}
|-style="background:#dddddd"
|style="background:#aaaaaa"| ||'''Benign'''||'''Neutral'''||'''Savage'''
|-
|style="background:#dddddd"|'''Good'''||Serene||Mirthful||Joyous Wilds
|-
|style="background:#dddddd"|'''Neutral'''||Calm||Wilderness||Untamed Wilds
|-
|style="background:#dddddd"|'''Evil'''||Sinister||Haunted||Terrifying
|}

===Neutral===

:including <span style="background-color:black;color:{{fgcolor|7:0}}">'''Calm'''</span>, <span style="background-color:black;color:{{fgcolor|2:0}}">'''Wilderness'''</span> and <span style="background-color:black;color:{{fgcolor|6:1}}">'''Untamed Wilds'''</span>

'''Neutral''' regions are the easiest to understand. They generally mimic the real world, with recognizable wildlife depending on the area. They can be quite dangerous depending on the region, holding anything from generally non-aggressive but physically powerful enemies such as [[gorilla]]s and [[elephant]]s to the very aggressive and very dangerous [[giant eagle]]s. As one might expect, ''Benign Neutral'' zones are really very safe, while ''Savage Neutral'' areas can pose some major difficulties, depending on the dominating climate and landforms. You'll find most of the standard aboveground plants in these alignments, such as [[prickle berry|prickle berries]], [[rope reed]], [[wild strawberries]] and the like.

===Good===

:including <span style="background-color:black;color:{{fgcolor|1:1}}">'''Serene'''</span>, <span style="background-color:black;color:{{fgcolor|2:1}}">'''Mirthful'''</span> and <span style="background-color:black;color:{{fgcolor|3:1}}">'''Joyous Wilds'''</span>

'''Good''' biomes tend to have less aggressive and weaker [[creatures]], except for the [[unicorn]]. Good regions also support the wild [[sun berry]], which makes the best [[alcohol]] in the game. There are generally slight changes between ''Benign Good'' and ''Savage Good''.

=====Distinctive flora & fauna=====
* Animals: [[mountain gnome]], [[satyr]], [[unicorn]], [[merperson]], [[gorlak]]
* Plants: [[sun berry]]
* Trees: [[feather tree]]
* Vermin: [[fluffy wambler]], [[fairy]], [[pixie]]

===Evil===

:including <span style="background-color:black;color:{{fgcolor|5:0}}">'''Sinister'''</span>, <span style="background-color:black;color:{{fgcolor|5:1}}">'''Haunted'''</span> and <span style="background-color:black;color:{{fgcolor|5:1}}">'''Terrifying'''</span>

'''Evil''' regions are much more dangerous than their ''Neutral'' and ''Good'' counterparts across the board. At their root, ''Evil'' regions are modified ''Neutral'' regions. In addition to a pack of other [[creatures]] that are nasty, dangerous, and spiteful such as [[beak dog]]s, [[harpy|harpies]], and [[ogre]]s, ''Evil'' regions modify their ''Neutral'' base by infecting many (but not all) of the indigenous [[creatures]] with various forms of [[undead|undeath]]. [[Undead]] cannot be killed through conventional means (dismemberment reanimates the individual body parts, creating even more enemies than before) and must be either butchered and tanned or exposed to magma in order to kill them permanently. Any non-undead creature that dies in an evil biome will reanimate as an undead creature after it is killed, including sentient beings, and any severed body parts and loose skin will also come to life as an individual enemy. Clearly, hunting undead animals for food is pointless, and finding kills in a countryside crawling where things won't stay dead is suicidal. Undead shrubs are useless for gathering, too. Even the weather is dangerous, as the toxic rains and dangerous clouds of creeping murk inflict various syndromes on par with those of [[forgotten beasts]]. Even ''Benign Evil'' is very difficult for beginning players to earn a niche to work in, so it should be reserved for a challenge play only.

=====Distinctive flora & fauna=====
* Animals: [[ogre]], [[dark gnome]], [[beak dog]], [[foul blendec]], [[grimeling]], [[harpy]], [[troll]], [[strangler]], [[nightwing]], [[ice wolf]], [[blizzard man]], [[sea monster]], [[manera]]
* Plants: [[sliver barb]], [[eyeball grass]], [[wormy tendril]]
* Trees: [[glumprong]]
* Vermin: [[demon rat]], [[blood gnat]], [[knuckle worm]], [[phantom spider]]

===Savage===
'''Savage''' surroundings are typically more dangerous than their Neutral or Benign counterparts, due to the "wildlife" (naturally occurring creatures) found therein. Savage regions contain many giant versions of normal wildlife, as well as sentient humanoid versions. A "Savage Good" region is called Joyous Wilds, a "Savage Neutral" region is called Untamed Wilds, and a "Savage Evil" region is called (and can be truly) Terrifying.

=====Distinctive flora & fauna=====
* Animals: [[giant eagle]], [[giant cheetah]], [[giant leopard]], [[giant jaguar]], [[giant tiger]], [[giant lion]], [[tigerman]], [[slugman]], [[snailman]], [[leechman]], [[giant desert scorpion]], [[sasquatch]], [[sea serpent]]
* Plants: [[whip vine]]
* Trees: [[Tree#List_of_Trees|highwood]]
* Vermin: [[two-legged rhino lizard]], [[moghopper]], [[fox squirrel]], [[acorn fly]]